SAGA 9.6.1 | Tool Library Documentation

Gravitational Process Path Model


Description

The Gravitational Process Path (GPP) model can be used to simulate the process path and run-out area of gravitational processes based on a digital terrain model (DTM). The conceptual model combines several components (process path, run-out length, sink filling and material deposition) to simulate the movement of a mass point from an initiation site to the deposition area. For each component several modeling approaches are provided, which makes the tool configurable for different processes such as rockfall, debris flows or snow avalanches.

The tool can be applied to regional-scale studies such as natural hazard susceptibility mapping but also contains components for scenario-based modeling of single events. Both the modeling approaches and precursor implementations of the tool have proven their applicability in numerous studies, also including geomorphological research questions such as the delineation of sediment cascades or the study of process connectivity.

Please provide the reference cited below in your work if you are using the GPP model.

Addendum:
The article is not clear about the way the impact on the slope is exactly modelled when the 'Shadow Angle' or '1-parameter' friction model is used. Besides the 'Threshold Angle Free Fall' criterion to determine the location of the first impact, it is also assumed that the particle must leave its own release area (given by its ID) in order to impact. This is actually a conceptual design, taking into account that free fall usually occurs in steep rock faces (release areas), and the fact, that such rockfaces are not characterised very well in a 2.5D elevation model. You can work around that conceptual design by providing a grid describing the 'slope impact areas' as input. Using such a grid disables the 'Threshold Angle Free Fall' parameter.

New in version 1.1:
Since version 1.1 the model supports the monitoring of potentially endangered objects like infrastructure and reports from which process paths and release areas objects might be hit. In order to enable this backtracking, the user must provide an 'Objects' grid as input. The grid can be used to store different types or classes of objects, using one-hot categorical data encoding for each object class, i.e. powers of ten: 1, 10, 100, 1000, etc. (all other cells NoData). The 'Hazard Paths' and 'Hazard Sources' output grid will store combinations of these numbers if several different classes were hit from a grid cell, allowing to analyse which object classes might be hit from which location.

New in version 1.2:
Since version 1.2 the model supports the optional output of a grid with the material flux. This requires a 'Material' grid as input. The grid shows the height of the material that has passed in total through each grid cell.

Version 1.3:
Version 1.3 includes a fix for material deposition along the process path (amounts and the update of available material for subsequent runs) and improves the output of material flux.

Version 1.4:
Since version 1.4 two separate 'Endangered Objects' output grids are created, one encoding the process path cells, the other only the source cells from which objects have been hit. These optional output parameters also have been renamed ('HAZARD_PATHS', 'HAZARD_SOURCES') to improve the legibility of the parameter interface. A third grid, showing the total amount of material in each source cell that has hit objects from that position, has also been added. This output requires a material grid as input in order to calculate material flux. To determine the total amount, the highest material flux observed to hit an object per path and iteration is summed up and converted back to a material height per cell (comparable to the amount specified in the material input grid.)


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputDEMgrid, inputDEMDigital elevation model [m].-
Release Areasgrid, inputRELEASE_AREASRelease areas encoded by unique integer IDs, all other cells NoData [-].-
Materialgrid, input, optionalMATERIALHeight of material available in each start cell [m].-
Friction Anglegrid, input, optionalFRICTION_ANGLE_GRIDSpatially distributed friction angles [degree]. Optionally used with the Geometric Gradient, Fahrboeschung's angle or Shadow Angle friction model.-
Slope Impact Areasgrid, input, optionalSLOPE_IMPACT_GRIDSlope impact grid, impact areas encoded with valid values, all other NoData. Optionally used with the Shadow Angle or the 1-parameter friction model.-
Friction Parameter Mugrid, input, optionalFRICTION_MU_GRIDSpatially distributed friction parameter mu [-], optionally used with the 1-parameter friction model or the PCM Model.-
Mass to Drag Ratiogrid, input, optionalFRICTION_MASS_TO_DRAG_GRIDSpatially distributed mass to drag ratio [m], optionally used with the PCM Model.-
Objectsgrid, input, optionalOBJECTSPotentially endangered objects (like infrastructure) to monitor, using one-hot categorical data encoding for each object class [1, 10, 100, 1000, ...].-
OutputProcess Areagrid, outputPROCESS_AREADelineated process area with encoded transition frequencies [count].-
Depositiongrid, output, optionalDEPOSITIONHeight of the material deposited in each cell [m]. Optional output in case a grid with material amounts is provided as input.-
Maximum Velocitygrid, output, optionalMAX_VELOCITYMaximum velocity observed in each cell [m/s]. Optional output of the 1-parameter friction model and the PCM Model.-
Stopping Positionsgrid, output, optionalSTOP_POSITIONSStopping positions, showing cells in which the run-out length has been reached [count].-
Hazard Pathsgrid, output, optionalHAZARD_PATHSProcess path cells from which objects were hit. Cell values indicate which object classes were hit [combination of object classes]. Optional output in case a grid with potentially endangered objects is provided as input.-
Hazard Sourcesgrid, output, optionalHAZARD_SOURCESSource (release area) cells from which objects were hit. Cell values indicate which object classes were hit [combination of object classes]. Optional output in case a grid with potentially endangered objects is provided as input.-
Hazard Sources Materialgrid, output, optionalHAZARD_SOURCES_MATERIALSource (release area) cells from which objects were hit. Cell values indicate the material amount [m/cell] that has hit objects from that source cell. Optional output in case grids with material amounts and potentially endangered objects are provided as input.-
Material Fluxgrid, output, optionalMATERIAL_FLUXAmount of material that has passed through each cell [m]. Optional output in case a grid with material amounts is provided as input.-
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
ModelchoicePROCESS_PATH_MODELChoose a process path model.Available Choices: [0] Maximum Slope [1] Random Walk Default: 1
Slope Thresholdfloating point numberRW_SLOPE_THRESIn case the local slope is greater as this threshold [degree], no lateral spreading is modeled.Minimum: 0.001000 Maximum: 90.000000 Default: 40.000000
Exponentfloating point numberRW_EXPONENTThe exponent [-] is controlling the amount of lateral spreading in case the local slope is in between zero and the slope threshold.Minimum: 1.000000 Default: 2.000000
Persistence Factorfloating point numberRW_PERSISTENCEFactor [-] used as weight for the current flow direction. A higher factor reduces abrupt changes in flow direction.Minimum: 1.000000 Default: 1.500000
Iterationsinteger numberGPP_ITERATIONSThe number of model runs from each start cell [-].Minimum: 1 Default: 1000
Processing OrderchoiceGPP_PROCESSING_ORDERChoose the processing order.Available Choices: [0] RAs in Sequence [1] RAs in Sequence per Iteration [2] RAs in Parallel per Iteration Default: 2
Seed Valueinteger numberGPP_SEEDThe seed value used to initialize the pseudo-random number generator. A value of 1 will initialize the generator with the current time, higher numbers will always produce the same succession of values for each seed value [-].Minimum: 1 Default: 1
ModelchoiceFRICTION_MODELChoose a friction model.Available Choices: [0] None [1] Geometric Gradient (Heim 1932) [2] Fahrboeschung Principle (Heim 1932) [3] Shadow Angle (Evans & Hungr 1988) [4] 1-parameter friction model (Scheidegger 1975) [5] PCM Model (Perla et al. 1980) Default: 0
Threshold Angle Free Fallfloating point numberFRICTION_THRES_FREE_FALLThe minimum slope angle [degree] between start cell and current cell for modeling free fall with the Shadow Angle or the 1-parameter friction model.Minimum: 0.000000 Default: 60.000000
Method ImpactchoiceFRICTION_METHOD_IMPACTChoose the velocity calculation on slope impact with the 1-parameter friction model.Available Choices: [0] Energy Reduction (Scheidegger 1975) [1] Preserved Component of Velocity (Kirkby & Statham 1975) Default: 0
Reductionfloating point numberFRICTION_IMPACT_REDUCTIONThe energy reduction [%] on slope impact with the 1-parameter friction model.Minimum: 0.000000 Maximum: 100.000000 Default: 75.000000
Friction Anglefloating point numberFRICTION_ANGLEFriction angle [degree] used as Geometric Gradient, Fahrboeschung's angle or Shadow Angle.Minimum: 0.000000 Maximum: 90.000000 Default: 30.000000
Mufloating point numberFRICTION_MUThe (constant) friction parameter mu [-] used with the 1-parameter friction model or the PCM Model.Minimum: 0.000000 Default: 0.250000
Mode of MotionchoiceFRICTION_MODE_OF_MOTIONChoose the mode of motion on hillslope with the 1-parameter friction model.Available Choices: [0] Sliding [1] Rolling Default: 0
Mass to Drag Ratiofloating point numberFRICTION_MASS_TO_DRAGThe (constant) mass to drag ratio [m] used with the PCM Model.Minimum: 0.000000 Default: 200.000000
Initial Velocityfloating point numberFRICTION_INIT_VELOCITYThe initial velocity [m/s] used with the PCM Model.Minimum: 0.000000 Default: 1.000000
ModelchoiceDEPOSITION_MODELChoose a deposition model.Available Choices: [0] None [1] On Stop [2] Slope & On Stop [3] Velocity & On Stop [4] min(Slope,Velocity) & On Stop Default: 0
Initial Deposition on Stopfloating point numberDEPOSITION_INITIALThe percentage of available material (per run) initially deposited at the stopping position [%].Minimum: 0.000000 Maximum: 100.000000 Default: 20.000000
Slope Thresholdfloating point numberDEPOSITION_SLOPE_THRESThe slope angle below which the deposition of material is starting [degree].Minimum: 0.000000 Maximum: 90.000000 Default: 20.000000
Velocity Thresholdfloating point numberDEPOSITION_VELOCITY_THRESThe velocity below which the deposition of material is starting [m/s].Minimum: 0.000000 Default: 15.000000
Maximum Deposition along Pathfloating point numberDEPOSITION_MAXThe percentage of available material (per run) which is deposited at most (slope or velocity equal zero) [%].Minimum: 0.000000 Maximum: 100.000000 Default: 20.000000
Minimum Path Lengthfloating point numberDEPOSITION_MIN_PATHThe minimum path length which has to be reached before material deposition is enabled [m].Minimum: 0.000000 Default: 100.000000
Minimum Slopefloating point numberSINK_MIN_SLOPEThe minimum slope to preserve on sink filling [degree].Minimum: 0.000000 Maximum: 90.000000 Default: 2.500000

Command Line


Usage: saga_cmd sim_geomorphology 0 [-DEM ] [-RELEASE_AREAS ] [-MATERIAL ] [-FRICTION_ANGLE_GRID ] [-SLOPE_IMPACT_GRID ] [-FRICTION_MU_GRID ] [-FRICTION_MASS_TO_DRAG_GRID ] [-OBJECTS ] [-PROCESS_AREA ] [-DEPOSITION ] [-MAX_VELOCITY ] [-STOP_POSITIONS ] [-HAZARD_PATHS ] [-HAZARD_SOURCES ] [-HAZARD_SOURCES_MATERIAL ] [-MATERIAL_FLUX ] [-PROCESS_PATH_MODEL ] [-RW_SLOPE_THRES ] [-RW_EXPONENT ] [-RW_PERSISTENCE ] [-GPP_ITERATIONS ] [-GPP_PROCESSING_ORDER ] [-GPP_SEED ] [-FRICTION_MODEL ] [-FRICTION_THRES_FREE_FALL ] [-FRICTION_METHOD_IMPACT ] [-FRICTION_IMPACT_REDUCTION ] [-FRICTION_ANGLE ] [-FRICTION_MU ] [-FRICTION_MODE_OF_MOTION ] [-FRICTION_MASS_TO_DRAG ] [-FRICTION_INIT_VELOCITY ] [-DEPOSITION_MODEL ] [-DEPOSITION_INITIAL ] [-DEPOSITION_SLOPE_THRES ] [-DEPOSITION_VELOCITY_THRES ] [-DEPOSITION_MAX ] [-DEPOSITION_MIN_PATH ] [-SINK_MIN_SLOPE ]
  -DEM:                         	DEM
	grid, input
  -RELEASE_AREAS:               	Release Areas
	grid, input
  -MATERIAL:                    	Material
	grid, input, optional
  -FRICTION_ANGLE_GRID:         	Friction Angle
	grid, input, optional
  -SLOPE_IMPACT_GRID:           	Slope Impact Areas
	grid, input, optional
  -FRICTION_MU_GRID:            	Friction Parameter Mu
	grid, input, optional
  -FRICTION_MASS_TO_DRAG_GRID:  	Mass to Drag Ratio
	grid, input, optional
  -OBJECTS:                     	Objects
	grid, input, optional
  -PROCESS_AREA:                	Process Area
	grid, output
  -DEPOSITION:                  	Deposition
	grid, output, optional
  -MAX_VELOCITY:                	Maximum Velocity
	grid, output, optional
  -STOP_POSITIONS:              	Stopping Positions
	grid, output, optional
  -HAZARD_PATHS:                	Hazard Paths
	grid, output, optional
  -HAZARD_SOURCES:              	Hazard Sources
	grid, output, optional
  -HAZARD_SOURCES_MATERIAL:     	Hazard Sources Material
	grid, output, optional
  -MATERIAL_FLUX:               	Material Flux
	grid, output, optional
  -PROCESS_PATH_MODEL:          	Model
	choice
	Available Choices:
	[0] Maximum Slope
	[1] Random Walk
	Default: 1
  -RW_SLOPE_THRES:           	Slope Threshold
	floating point number
	Minimum: 0.001000
	Maximum: 90.000000
	Default: 40.000000
  -RW_EXPONENT:              	Exponent
	floating point number
	Minimum: 1.000000
	Default: 2.000000
  -RW_PERSISTENCE:           	Persistence Factor
	floating point number
	Minimum: 1.000000
	Default: 1.500000
  -GPP_ITERATIONS:              	Iterations
	integer number
	Minimum: 1
	Default: 1000
  -GPP_PROCESSING_ORDER:        	Processing Order
	choice
	Available Choices:
	[0] RAs in Sequence
	[1] RAs in Sequence per Iteration
	[2] RAs in Parallel per Iteration
	Default: 2
  -GPP_SEED:                    	Seed Value
	integer number
	Minimum: 1
	Default: 1
  -FRICTION_MODEL:              	Model
	choice
	Available Choices:
	[0] None
	[1] Geometric Gradient (Heim 1932)
	[2] Fahrboeschung Principle (Heim 1932)
	[3] Shadow Angle (Evans & Hungr 1988)
	[4] 1-parameter friction model (Scheidegger 1975)
	[5] PCM Model (Perla et al. 1980)
	Default: 0
  -FRICTION_THRES_FREE_FALL: 	Threshold Angle Free Fall
	floating point number
	Minimum: 0.000000
	Default: 60.000000
  -FRICTION_METHOD_IMPACT:      	Method Impact
	choice
	Available Choices:
	[0] Energy Reduction (Scheidegger 1975)
	[1] Preserved Component of Velocity (Kirkby & Statham 1975)
	Default: 0
  -FRICTION_IMPACT_REDUCTION:	Reduction
	floating point number
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 75.000000
  -FRICTION_ANGLE:           	Friction Angle
	floating point number
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 30.000000
  -FRICTION_MU:              	Mu
	floating point number
	Minimum: 0.000000
	Default: 0.250000
  -FRICTION_MODE_OF_MOTION:     	Mode of Motion
	choice
	Available Choices:
	[0] Sliding
	[1] Rolling
	Default: 0
  -FRICTION_MASS_TO_DRAG:    	Mass to Drag Ratio
	floating point number
	Minimum: 0.000000
	Default: 200.000000
  -FRICTION_INIT_VELOCITY:   	Initial Velocity
	floating point number
	Minimum: 0.000000
	Default: 1.000000
  -DEPOSITION_MODEL:            	Model
	choice
	Available Choices:
	[0] None
	[1] On Stop
	[2] Slope & On Stop
	[3] Velocity & On Stop
	[4] min(Slope,Velocity) & On Stop
	Default: 0
  -DEPOSITION_INITIAL:       	Initial Deposition on Stop
	floating point number
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 20.000000
  -DEPOSITION_SLOPE_THRES:   	Slope Threshold
	floating point number
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 20.000000
  -DEPOSITION_VELOCITY_THRES:	Velocity Threshold
	floating point number
	Minimum: 0.000000
	Default: 15.000000
  -DEPOSITION_MAX:           	Maximum Deposition along Path
	floating point number
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 20.000000
  -DEPOSITION_MIN_PATH:      	Minimum Path Length
	floating point number
	Minimum: 0.000000
	Default: 100.000000
  -SINK_MIN_SLOPE:           	Minimum Slope
	floating point number
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 2.500000