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