CliffMetrics
- Author: SAGA Interface by O.Conrad (c) 2019, CliffMetrics by Payo et al. (c) 2018
- Menu: Terrain Analysis | Coastal Morphology
Description
CliffMetrics (Automatic Cliff Metrics delineation) delineates the location of the coastline, coastline normals, and cliff top and toe location along these normals.
References
- Payo, A. (2020): SAGA-CliffMetric User guide. Download.
- Payo, A., Jigena Antelo, B., Hurst, M., Palaseanu-Lovejoy, M., Williams, C., Jenkins, G., Lee, K., Favis-Mortlock, D., Barkwith, A., Ellis, M.A. (2018): Development of an automatic delineation of cliff top and toe on very irregular planform coastlines (CliffMetrics v1.0). Geoscientific Model Development 11, 4317___4337. doi: 10.5194/gmd-11-4317-2018..
Parameters
| Name | Type | Identifier | Description | Constraints | |
|---|---|---|---|---|---|
| Input | Elevation | grid, input | DEM | - | - |
| User Defined Coastline Points | shapes, input, optional | COAST_INITIAL | if non empty, cliffmetric will use the user defined coastal line to draw the transects | - | |
| Output | Sediment Top Elevation | grid, output | SEDIMENT_TOP | - | - |
| Coastline | grid, output, optional | RASTER_COAST | - | - | |
| Normals | grid, output, optional | RASTER_NORMAL | - | - | |
| Coastline | shapes, output | COAST | - | - | |
| Coastline-Normal Profiles | shapes, output | NORMALS | - | - | |
| Cliff Top Points | shapes, output | CLIFF_TOP | - | - | |
| Cliff Toe Points | shapes, output | CLIFF_TOE | - | - | |
| Coast Points | shapes, output | COAST_POINT | - | - | |
| Invalid Coastline-Normal Profiles | shapes, output, optional | INVALID_NORMALS | - | - | |
| Coastline Curvature | shapes, output, optional | COAST_CURVATURE | - | - | |
| Profile Data | table, output | PROFILES | - | - | |
| Options | Grid System | grid system | PARAMETERS_GRID_SYSTEM | - | - |
| Sea handiness | choice | CoastSeaHandiness | as you traverse the coastline, on which side of shoreline the sea is? | Available Choices: [0] right [1] left Default: 0 | |
| Start edge coastline | choice | StartEdgeUserCoastLine | on which edge of the DTM the start of coastline is? | Available Choices: [0] North [1] East [2] South [3] West Default: 0 | |
| End edge coastline | choice | EndEdgeUserCoastLine | on which edge of the DTM the end of coastline is? | Available Choices: [0] North [1] East [2] South [3] West Default: 0 | |
| Still Water Level | floating point number | StillWaterLevel | Still water level (m) used to extract the shoreline. | Minimum: 0.000000 Default: 1.000000 | |
| Coastline Smoothing Algorithm | choice | CoastSmooth | Vector coastline smoothing algorithm. | Available Choices: [0] none [1] running mean [2] Savitsky-Golay Default: 1 | |
| Coastline Smoothing Window Size | integer number | CoastSmoothWindow | Size of coastline smoothing window, resulting kernel size will be: 1 + 2 * size. | Minimum: 1 Default: 30 | |
| Polynomial Order for Savitsky-Golay | integer number | SavGolCoastPoly | Order of coastline profile smoothing polynomial for Savitsky-Golay smoothing: usually 2 or 4, max is 6. | Minimum: 1 Maximum: 6 Default: 4 | |
| Scale Raster Output Values | boolean | ScaleRasterOutput | If needed, scale GIS raster output values. | Default: 1 | |
| Random Edge for Coastline Search | boolean | RandomCoastEdgeSearch | Random edge for coastline search. | Default: 1 | |
| Length of Coastline Normals | floating point number | CoastNormalLength | Length of coastline normals (m). | Minimum: 0.010000 Default: 500.000000 | |
| Vertical Tolerance | floating point number | EleTolerance | Vertical tolerance to avoid false cliff tops and toes. | Minimum: 0.010000 Default: 0.500000 | |
| Main Output File Directory | file path | OutPath | - | - |
Command Line
Usage: saga_cmd ta_cliffmetrics 0 [-DEM] [-SEDIMENT_TOP ] [-RASTER_COAST ] [-RASTER_NORMAL ] [-COAST_INITIAL ] [-CoastSeaHandiness ] [-StartEdgeUserCoastLine ] [-EndEdgeUserCoastLine ] [-COAST ] [-NORMALS ] [-CLIFF_TOP ] [-CLIFF_TOE ] [-COAST_POINT ] [-INVALID_NORMALS ] [-COAST_CURVATURE ] [-PROFILES ] [-StillWaterLevel ] [-CoastSmooth ] [-CoastSmoothWindow ] [-SavGolCoastPoly ] [-ScaleRasterOutput ] [-RandomCoastEdgeSearch ] [-CoastNormalLength ] [-EleTolerance ] [-OutPath ] -DEM: Elevation grid, input -SEDIMENT_TOP: Sediment Top Elevation grid, output -RASTER_COAST: Coastline grid, output, optional -RASTER_NORMAL: Normals grid, output, optional -COAST_INITIAL: User Defined Coastline Points shapes, input, optional -CoastSeaHandiness: Sea handiness choice Available Choices: [0] right [1] left Default: 0 -StartEdgeUserCoastLine: Start edge coastline choice Available Choices: [0] North [1] East [2] South [3] West Default: 0 -EndEdgeUserCoastLine: End edge coastline choice Available Choices: [0] North [1] East [2] South [3] West Default: 0 -COAST: Coastline shapes, output -NORMALS: Coastline-Normal Profiles shapes, output -CLIFF_TOP: Cliff Top Points shapes, output -CLIFF_TOE: Cliff Toe Points shapes, output -COAST_POINT: Coast Points shapes, output -INVALID_NORMALS: Invalid Coastline-Normal Profiles shapes, output, optional -COAST_CURVATURE: Coastline Curvature shapes, output, optional -PROFILES: Profile Data table, output -StillWaterLevel: Still Water Level floating point number Minimum: 0.000000 Default: 1.000000 -CoastSmooth: Coastline Smoothing Algorithm choice Available Choices: [0] none [1] running mean [2] Savitsky-Golay Default: 1 -CoastSmoothWindow: Coastline Smoothing Window Size integer number Minimum: 1 Default: 30 -SavGolCoastPoly: Polynomial Order for Savitsky-Golay integer number Minimum: 1 Maximum: 6 Default: 4 -ScaleRasterOutput: Scale Raster Output Values boolean Default: 1 -RandomCoastEdgeSearch: Random Edge for Coastline Search boolean Default: 1 -CoastNormalLength: Length of Coastline Normals floating point number Minimum: 0.010000 Default: 500.000000 -EleTolerance: Vertical Tolerance floating point number Minimum: 0.010000 Default: 0.500000 -OutPath: Main Output File Directory file path