CliffMetrics
| Author(s) | SAGA Interface by O.Conrad (c) 2019, CliffMetrics by Payo et al. (c) 2018 |
| Library ID | ta_cliffmetrics |
| Tool ID | 0 |
| Version | 1.0 |
| 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
CliffMetrics-SAGA: Wiki Documentation
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