SAGA-GIS Tool Library Documentation (v9.2.0)

Tool SAFETYFACTOR

This tool computes a slope stability (expressed as a factor-of-safety) raster according to the traditional infinite slope model theory (see cf Selby, 1993) The resulting raster represents the ratio of resisting forces/driving forces (fs) on a potential shear plane with fs lesser 1 unstable, fs greater 1 stable. Except for a slope raster (in radians), all input variables can be specified either globally or distributed (through grids). The tool creates a continuous fs raster (values above 10 are truncated), and a binary stability grid with nodata = stable, 1 = unstable (optional).

Parameters

 NameTypeIdentifierDescriptionConstraints
InputSlope grid (rad)grid, inputAA slope angle grid (in radíans)-
Min thickness grid (m) (*)grid, input, optionalBminA grid representing minimum cell layer thicknesses to potential shear plane (in meters)-
Max thickness grid (m) (*)grid, input, optionalBmaxA grid representing maximum cell layer thicknesses to potential shear plane (in meters)-
Min saturation grid (-) (*)grid, input, optionalCminA grid representing minimum cell relative water saturation of layer (dimensionless)-
Max saturation grid (-) (*)grid, input, optionalCmaxA grid representing maximum cell relative water saturation of layer (dimensionless)-
Min friction grid (degree) (*)grid, input, optionalDminA grid representing minimum cell frictional shear strength of layer (in degrees)-
Max friction grid (degree) (*)grid, input, optionalDmaxA grid representing maximum cell frictional shear strength of layer (in degrees)-
Min density grid (g/cm3) (*)grid, input, optionalEminA grid representing minimum cell bulk density of layer (in grams per cubiccentimeters)-
Max density grid (g/cm3) (*)grid, input, optionalEmaxA grid representing maximum cell bulk density of layer (in grams per cubiccentimeters)-
Min cohesion grid (MPa) (*)grid, input, optionalFminA grid representing minimum cell layer cohesion (in Megapascals)-
Max cohesion grid (MPa) (*)grid, input, optionalFmaxA grid representing maximum cell layer cohesion (in Megapascals)-
OutputFS valuesgrid, outputGResulting factor-of-safety (-) grid-
FS classes (*)grid, output, optionalHResulting stability (0/1) grid-
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Min global thickness (m)floating point numberfBminConstant value if no raster setDefault: 1.000000
Max global thickness (m)floating point numberfBmaxConstant value if no raster setDefault: 1.000000
Min global saturation (-)floating point numberfCminConstant value if no raster setDefault: 0.000000
Max global saturation (-)floating point numberfCmaxConstant value if no raster setDefault: 0.000000
Min global friction (degree)floating point numberfDminConstant value if no raster setDefault: 33.000000
Max global friction (degree)floating point numberfDmaxConstant value if no raster setDefault: 33.000000
Min global density (g/cm3)floating point numberfEminConstant value if no raster setDefault: 1.600000
Max global density (g/cm3)floating point numberfEmaxConstant value if no raster setDefault: 1.600000
Min global cohesion (MPa)floating point numberfFminConstant value if no raster setDefault: 0.000000
Max global cohesion (MPa)floating point numberfFmaxConstant value if no raster setDefault: 0.000000
Parameter sampling runsinteger numberfINumber of sampling cyclesDefault: 1
(*) optional

Command-line

Usage: saga_cmd ta_slope_stability 0 [-A <str>] [-Bmin <str>] [-Bmax <str>] [-Cmin <str>] [-Cmax <str>] [-Dmin <str>] [-Dmax <str>] [-Emin <str>] [-Emax <str>] [-Fmin <str>] [-Fmax <str>] [-fBmin <double>] [-fBmax <double>] [-fCmin <double>] [-fCmax <double>] [-fDmin <double>] [-fDmax <double>] [-fEmin <double>] [-fEmax <double>] [-fFmin <double>] [-fFmax <double>] [-fI <num>] [-G <str>] [-H <str>]
  -A:<str>       	Slope grid (rad)
	grid, input
  -Bmin:<str>    	Min thickness grid (m) 
	grid, input, optional
  -Bmax:<str>    	Max thickness grid (m) 
	grid, input, optional
  -Cmin:<str>    	Min saturation grid (-) 
	grid, input, optional
  -Cmax:<str>    	Max saturation grid (-) 
	grid, input, optional
  -Dmin:<str>    	Min friction grid (degree) 
	grid, input, optional
  -Dmax:<str>    	Max friction grid (degree) 
	grid, input, optional
  -Emin:<str>    	Min density grid (g/cm3)
	grid, input, optional
  -Emax:<str>    	Max density grid (g/cm3)
	grid, input, optional
  -Fmin:<str>    	Min cohesion grid (MPa) 
	grid, input, optional
  -Fmax:<str>    	Max cohesion grid (MPa) 
	grid, input, optional
  -fBmin:<double>	Min global thickness (m)
	floating point number
	Default: 1.000000
  -fBmax:<double>	Max global thickness (m)
	floating point number
	Default: 1.000000
  -fCmin:<double>	Min global saturation (-)
	floating point number
	Default: 0.000000
  -fCmax:<double>	Max global saturation (-)
	floating point number
	Default: 0.000000
  -fDmin:<double>	Min global friction (degree)
	floating point number
	Default: 33.000000
  -fDmax:<double>	Max global friction (degree)
	floating point number
	Default: 33.000000
  -fEmin:<double>	Min global density (g/cm3)
	floating point number
	Default: 1.600000
  -fEmax:<double>	Max global density (g/cm3)
	floating point number
	Default: 1.600000
  -fFmin:<double>	Min global cohesion (MPa)
	floating point number
	Default: 0.000000
  -fFmax:<double>	Max global cohesion (MPa)
	floating point number
	Default: 0.000000
  -fI:<num>      	Parameter sampling runs
	integer number
	Default: 1
  -G:<str>       	FS values
	grid, output
  -H:<str>       	FS classes
	grid, output, optional