Tool CliffMetrics

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..

Author: SAGA Interface by O.Conrad (c) 2019, CliffMetrics by Payo et al. (c) 2018
Menu: Terrain Analysis|Coastal Morphology

Parameters

	Name	Type	Identifier	Description	Constraints
Input	Elevation	Grid, input	`DEM`	-	-
Input	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	`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	`CoastSmoothWindow`	Size of coastline smoothing window, resulting kernel size will be: 1 + 2 * size.	Minimum: 1 Default: 30
	Polynomial Order for Savitsky-Golay	Integer	`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	`CoastNormalLength`	Length of coastline normals (m).	Minimum: 0.010000 Default: 500.000000
	Vertical Tolerance	Floating point	`EleTolerance`	Vertical tolerance to avoid false cliff tops and toes.	Minimum: 0.010000 Default: 0.500000
	Main Output File Directory	File path	`OutPath`	-	-
(*) optional

Command-line

Usage: saga_cmd ta_cliffmetrics 0 [-DEM <str>] [-SEDIMENT_TOP <str>] [-RASTER_COAST <str>] [-RASTER_NORMAL <str>] [-COAST_INITIAL <str>] [-CoastSeaHandiness <str>] [-StartEdgeUserCoastLine <str>] [-EndEdgeUserCoastLine <str>] [-COAST <str>] [-NORMALS <str>] [-CLIFF_TOP <str>] [-CLIFF_TOE <str>] [-COAST_POINT <str>] [-INVALID_NORMALS <str>] [-COAST_CURVATURE <str>] [-PROFILES <str>] [-StillWaterLevel <double>] [-CoastSmooth <str>] [-CoastSmoothWindow <num>] [-SavGolCoastPoly <num>] [-ScaleRasterOutput <str>] [-RandomCoastEdgeSearch <str>] [-CoastNormalLength <double>] [-EleTolerance <double>] [-OutPath <str>]
  -DEM:<str>                   	Elevation
	Grid, input
  -SEDIMENT_TOP:<str>          	Sediment Top Elevation
	Grid, output
  -RASTER_COAST:<str>          	Coastline
	Grid, output, optional
  -RASTER_NORMAL:<str>         	Normals
	Grid, output, optional
  -COAST_INITIAL:<str>         	User Defined Coastline Points
	Shapes, input, optional
  -CoastSeaHandiness:<str>     	Sea handiness
	Choice
	Available Choices:
	[0] right
	[1] left
	Default: 0
  -StartEdgeUserCoastLine:<str>	Start edge coastline
	Choice
	Available Choices:
	[0] North
	[1] East
	[2] South
	[3] West
	Default: 0
  -EndEdgeUserCoastLine:<str>  	End edge coastline
	Choice
	Available Choices:
	[0] North
	[1] East
	[2] South
	[3] West
	Default: 0
  -COAST:<str>                 	Coastline
	Shapes, output
  -NORMALS:<str>               	Coastline-Normal Profiles
	Shapes, output
  -CLIFF_TOP:<str>             	Cliff Top Points
	Shapes, output
  -CLIFF_TOE:<str>             	Cliff Toe Points
	Shapes, output
  -COAST_POINT:<str>           	Coast Points
	Shapes, output
  -INVALID_NORMALS:<str>       	Invalid Coastline-Normal Profiles
	Shapes, output, optional
  -COAST_CURVATURE:<str>       	Coastline Curvature
	Shapes, output, optional
  -PROFILES:<str>              	Profile Data
	Table, output
  -StillWaterLevel:<double>    	Still Water Level
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -CoastSmooth:<str>           	Coastline Smoothing Algorithm
	Choice
	Available Choices:
	[0] none
	[1] running mean
	[2] Savitsky-Golay
	Default: 1
  -CoastSmoothWindow:<num>     	Coastline Smoothing Window Size
	Integer
	Minimum: 1
	Default: 30
  -SavGolCoastPoly:<num>       	Polynomial Order for Savitsky-Golay
	Integer
	Minimum: 1
	Maximum: 6
	Default: 4
  -ScaleRasterOutput:<str>     	Scale Raster Output Values
	Boolean
	Default: 1
  -RandomCoastEdgeSearch:<str> 	Random Edge for Coastline Search
	Boolean
	Default: 1
  -CoastNormalLength:<double>  	Length of Coastline Normals
	Floating point
	Minimum: 0.010000
	Default: 500.000000
  -EleTolerance:<double>       	Vertical Tolerance
	Floating point
	Minimum: 0.010000
	Default: 0.500000
  -OutPath:<str>               	Main Output File Directory
	File path