Model:IncrementalDebrisFlowVolumeAnalyzer

From CSDMS


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

OpenMI compliant No but possible
BMI compliant No but possible
WMT component No but possible
PyMT component No but possible
Is this a data component No
Can be coupled with:
Model info

Link to this page



Introduction

History

References





See more publications of IncrementalDebrisFlowVolumeAnalyzer

Issues

Help

Input Files

Output Files