Model:IncrementalDebrisFlowVolumeAnalyzer

IncrementalDebrisFlowVolumeAnalyzer

Metadata

Also known as	Yield Rate Threshold Locator
Model type	Tool
Model part of larger framework
Note on status model
Date note status model

Incorporated models or components:

Spatial dimensions	2D, 3D
Spatial extent	Watershed-Scale, Reach-Scale, Patch-Scale, Grain-Scale, Point-Based
Model domain	Terrestrial, Hydrology
One-line model description	Estimate incremental volume changes (erosion and deposition) along the path of a debris flow.
Extended model description	This model generates investigation polygons which are used to estimate and store incremental erosion and deposition volumes along the path of a debris flow at user-defined resolution. The user will need: 1) a .LAS or .TIF of topographic change, 2) a DEM of the AOI, and 3) a shapefile (polyline) of the debris flow path of interest. Each incremental volume is georeferenced and stored within a shapefile attribute associated with a catchment area and distance from outlet for analysis.

Keywords:	hazards, erosion, lateral erosion, erosion/deposition, flow path,

Name	Lauren Guido
Type of contact	Model developer
Institute / Organization	Colorado School of Mines
Postal address 1
Postal address 2
Town / City	Golden
Postal code	80401
State
Country	United States
Email address	laurenmiller@mines.edu
Phone
Fax

Supported platforms
Other platform
Programming language	Python
Other program language
Code optimized
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development	2023
Does model development still take place?	Yes
If above answer is no, provide end year model development
Code development status	Active
When did you indicate the 'code development status'?	2024
Model availability	As code
Source code availability (Or provide future intension)	Through web repository
Source web address	https://github.com/laurenguido/IncrementalDerisFlowVolumeAnalyzer
Source csdms web address
Program license type	BSD or MIT X11
Program license type other
Memory requirements
Typical run time	AOI/batch dependent

Describe input parameters	- las_file or raster_path: file paths for change detection data, depending on the desired change detection (Las2Ras can be used to convert las_file for use as raster_path) - cell_size: raster resolution for Las2Ras (m) -method: method of interpolation for Las2Ras - grid and dem: file path for pre-event DEM - debris_flow_path: file path for debris flow path shapefile (polyline) - spacing: reach spacing/resolution of query points and investigation polygons (meters) - buffer_width: width of buffer within which volumes will be estimated (meters) - LoD: limit of detection of change detection data (meters) -polygon_ids: IDs of polygons with tributaries for plotting
Input format	ASCII
Other input format
Describe output parameters	- output_raster: rasterized change detection data from .las - acc_d8: flow accumulation raster - fdir_d8: flow direction raster - output_shapefile_path: query point shapefile - output_shapefile: buffered flow path shapefile - investigation_polygons_shapefile: investigation polygon shapefile (first generated, then populated with volume and geomorphometric data under the same name)
Output format	ASCII
Other output format
Pre-processing software needed?	Yes
Describe pre-processing software	If not available, change detection may need to be completed in advance of model use. The model includes a tool to convert .LAS files to .TIF if point cloud change detection is used. A flow-routed debris flow path shapefile is the only other item which may not be readily accessible. DEMs can be found on OpenTopography or similar and should not require pre-processing software.
Post-processing software needed?	No
Describe post-processing software
Visualization software needed?	No
If above answer is yes
Other visualization software

Describe processes represented by the model	This tool estimates the volume of material eroded and deposited at user-defined increments along a debris flow channel. This model performs best in the analysis of channelized, highly erosive flows, and does not capture processes such as minor riling or sheetwash laden with sediment well, as these processes are typically below the limits of change detection used in the application.
Describe key physical parameters and equations	Standard flow routing and uniform sampling principles are used to govern the processes of this model.
Describe length scale and resolution constraints	Resolution constrains are primarily imposed by the resolution of change detection being used. It is recommended that channel reach spacing is kept at least >5x the resolution of the change detection data.
Describe time scale and resolution constraints	Temporal resolution constrains are again primarily associated with the temporal resolution of the change detection data used (span between pre- and post- data, number of storms and/or debris flow events contributing to the volumes being estimated).
Describe any numerical limitations and issues

Describe available calibration data sets
Upload calibration data sets if available:
Describe available test data sets
Upload test data sets if available:
Describe ideal data for testing

Do you have current or future plans for collaborating with other researchers?	This model is being used for ongoing research into controls on erosion, deposition, and yield rate changes in post-wildfire debris flows. This primarily contributes to a PhD dissertation, but is being applied by other researchers to their work as well.

Is there a manual available?	No
Upload manual if available:
Model website if any	https://github.com/laurenguido/IncrementalDerisFlowVolumeAnalyzer
Model forum / discussion board

Comments	Please reach out to Lauren Guido (laurenmiller@mines.edu) with any questions. A second version of the script(s) prepared for batch processing has been developed and may be made available upon request.

This part will be filled out by CSDMS staff