SAGA-GIS Tool Library Documentation (v7.3.0)

Tool WEDGEFAIL


This tool determines terrain elements where failure (slide- or topple movements) on geological discontinuies are kinematically possible through the spatial application of common frictional feasibility criteria (Günther et al. 2012 and references therein). Both the orientation of slope elements specified through aspect- and dip grids (in radians) are required together with the orientation of one planar structure defined through global- or grid dip direction and dip data, or two planar structures defined by plunge direction and plunge information of their intersection line (in degrees). The shear strength of the discontinuities is specified using global or grid-based friction angle data. Optionally, a cone value can be set allowing for some variance in discontinuity dip orientations. The tool operates in slide (testing for plane and wedge sliding) or topple (testing for plane and wedge toppling) modes.

Reference:
Günther A., Wienhöfer J., Konietzky H. (2012) Automated mapping of rock slope geometry, kinematics and stability with RSS-GIS. Natural Hazards, 61, 29-49..

Parameters

 NameTypeIdentifierDescriptionConstraints
InputDEMGrid (input)DEMA DEM-
Dip/Plunge direction grid (degree) (*)Grid (optional input)CA dip- or plunge direction grid (in degrees)-
Dip/Plunge grid (degree) (*)Grid (optional input)DA dip- or plunge grid (in degrees)-
Min friction angle grid (degree) (*)Grid (optional input)EminA minimum discontinuity friction angle grid (in degrees)-
Max friction angle grid (degree) (*)Grid (optional input)EmaxA maximum discontinuity friction angle grid (in degrees)-
OutputFailuresGrid (output)FResulting failure cells (-) grid-
OptionsGrid systemGrid systemPARAMETERS_GRID_SYSTEM--
Global dip/plunge direction (degree)Floating pointfCConstant value if no raster setDefault: 0.000000
Global dip/plunge (degree)Floating pointfDConstant value if no raster setDefault: 35.000000
Min global friction angle (degree)Floating pointfEminConstant value if no raster setDefault: 35.000000
Max global friction angle (degree)Floating pointfEmaxConstant value if no raster setDefault: 35.000000
Cone radius (degree)IntegerffRadius of optional cone variance (in degrees)Default: 0
Parameter sampling runsIntegerfINumber of sampling cyclesDefault: 1
ModeChoiceMETHODSet failure modeAvailable Choices:
[0] Slide
[1] Topple
Default: 0
(*) optional

Command-line

Usage: saga_cmd ta_slope_stability 4 [-DEM <str>] [-C <str>] [-D <str>] [-Emin <str>] [-Emax <str>] [-fC <double>] [-fD <double>] [-fEmin <double>] [-fEmax <double>] [-ff <num>] [-F <str>] [-fI <num>] [-METHOD <str>]
  -DEM:<str>     	DEM
	Grid (input)
  -C:<str>       	Dip/Plunge direction grid (degree) 
	Grid (optional input)
  -D:<str>       	Dip/Plunge grid (degree) 
	Grid (optional input)
  -Emin:<str>    	Min friction angle grid (degree) 
	Grid (optional input)
  -Emax:<str>    	Max friction angle grid (degree) 
	Grid (optional input)
  -fC:<double>   	Global dip/plunge direction (degree)
	Floating point
	Default: 0.000000
  -fD:<double>   	Global dip/plunge (degree)
	Floating point
	Default: 35.000000
  -fEmin:<double>	Min global friction angle (degree)
	Floating point
	Default: 35.000000
  -fEmax:<double>	Max global friction angle (degree)
	Floating point
	Default: 35.000000
  -ff:<num>      	Cone radius (degree)
	Integer
	Default: 0
  -F:<str>       	Failures
	Grid (output)
  -fI:<num>      	Parameter sampling runs
	Integer
	Default: 1
  -METHOD:<str>  	Mode
	Choice
	Available Choices:
	[0] Slide
	[1] Topple
	Default: 0