Model:SWEHR

From CSDMS


SWEHR


Metadata

Also known as
Model type Single
Model part of larger framework
Note on status model
Date note status model
Incorporated models or components:
Spatial dimensions 2D
Spatial extent Watershed-Scale, Reach-Scale, Patch-Scale
Model domain Terrestrial, Hydrology
One-line model description A coupled model for infiltration, fluid flow, and sediment transport.
Extended model description The model couples the shallow water equations with the Green-Ampt infiltration model and the Hairsine-Rose soil erosion model. Fluid flow is also modified through source terms in the momentum equations that account for changes in flow behavior associated with high sediment concentrations. See McGuire et al. (2016, Constraining the rates of raindrop- and flow-driven sediment transport mechanisms in postwildfire environments and implications for recovery timescales) for a complete model description and details on the numerical solution of the governing equations.
Keywords:
Name Luke McGuire
Type of contact Model developer
Institute / Organization University of Arizona
Postal address 1 1040 E 4th St
Postal address 2
Town / City Tucson
Postal code 85721
State Arizona
Country United States
Email address lmcguire@email.arizona.edu
Phone
Fax


Supported platforms
Unix, Linux, Mac OS, Windows
Other platform
Programming language

C

Other program language
Code optimized Single Processor
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development 2014
Does model development still take place? Yes
If above answer is no, provide end year model development
Code development status
When did you indicate the 'code development status'?
Model availability As code
Source code availability
(Or provide future intension)
Through CSDMS repository
Source web address
Source csdms web address https://github.com/csdms-contrib/swehr
Program license type GPL v2
Program license type other
Memory requirements
Typical run time Can vary from seconds to hours


Describe input parameters [[Describe input parameters model::The following parameters need to be specified (in order) in a file called "input.txt":

nx – number of grid cells in x direction ny – number of grid cells in y direction dx – grid spacing F – Fraction of stream power effective in entrainment manning0 – minimum manning coefficient tend – end time for simulation a – detachability of original soil ad – redetachability of deposited soil h0 – critical flow depth in HR model mtstar0 – shielding parameter in HR model rnum – number of entries in rainfall input file rint – time interval (in seconds) associated with each rainfall intensity in the rainfall input file sclass – number of particle size classes Jentrain – energy expended entraining a unit mass of cohesive sediment

Other required input files: rain.txt: A file containing rainfall intensity in [m]/[s]. The file should contain "rnum" entries. The time interval associated with each rainfall intensity should be specified as "rint" in the input.txt file.

topoin.txt: elevation data for each point in the grid

particlepercentin.txt: A vector containing K entries that specify the percentage of soil consisting of sediment in each of the K particle size classes

particlesizein.txt: A vector containing K entries that specify the representative particle diameter associated with each of the K particle size classes]]

Input format ASCII
Other input format
Describe output parameters The code outputs the following text files:

“topoout.txt” – elevation for each grid point at the end of the simulation “depth.txt” – flow depth at each grid point at the end of the simulation “uh.txt” – value of conserved variable UH at each grid point “vh.txt” – value of conserved variable VH at each grid point “ch.txt” – value of conserved variable CH at each grid point “m.txt” – mass of sediment in the deposited layer at each grid point “c.txt” – sediment concentration at each grid point “vel.txt” – flow velocity at each grid point “stage.txt” – time series data (time (s), flow depth, flow velocity, and sediment concentration) at the outlet pixel “maxvel.txt” – maximum flow velocity recorded at each grid point throughout the simulation “maxdepth.txt” -- maximum flow depth recorded at each grid point throughout the simulation “saveflow.txt” – time series data (flow depth, flow velocity, sediment concentration) at user specified grid points “topomovie.txt” – elevation data at different times throughout the simulation (specified in the code by “printinterval”) “depthmovie.txt” – flow depth at different times throughout the simulation “velocitymovie.txt” – flow velocity at different times throughout the simulation “cmovie.txt” – sediment concentration at different times throughout the simulation “Mmovie.txt” – mass of sediment in the deposited layer at different times throughout the simulation

Output format ASCII
Other output format
Pre-processing software needed? No
Describe 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 The model simulates infiltration, fluid flow, and sediment transport. Fluid behavior is influenced by sediment concentration.
Describe key physical parameters and equations The model couples the shallow water equations with the Green-Ampt infiltration model and the Hairsine-Rose soil erosion model. Fluid flow is also modified through source terms in the momentum equations that account for changes in flow behavior associated with high sediment concentrations. See McGuire et al. (2016, Constraining the rates of raindrop- and flow-driven sediment transport mechanisms in postwildfire environments and implications for recovery timescales) for a complete model description and details on the numerical solution of the governing equations.
Describe length scale and resolution constraints The model is designed to be used at the watershed scale or smaller.
Describe time scale and resolution constraints The model is ideal for simulating sediment transport in response to a single rainstorm.
Describe any numerical limitations and issues The Courant number must be less than 1 at all times to maintain stability.


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?
Is there a manual available? No
Upload manual if available:
Model website if any
Model forum / discussion board
Comments


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
Is this a data component
DOI model 10.5281/zenodo.824087
For model version 1.0
Year version submitted 2017
Link to file https://csdms.colorado.edu/pub/models/doi-source-code/swehr-1.0.tar.gz
Can be coupled with:
Model info

Nr. of publications: 2
Total citations: 35
h-index: 1
m-quotient: 0.11

Link to this page



Introduction

History

References




Nr. of publications: 2
Total citations: 35
h-index: 1
m-quotient: 0.11



Featured publication(s)YearModel describedType of ReferenceCitations
McGuire, Luke A.; Kean, Jason W.; Staley, Dennis M.; Rengers, Francis K.; Wasklewicz, Thad A.; 2016. Constraining the relative importance of raindrop- and flow-driven sediment transport mechanisms in postwildfire environments and implications for recovery time scales: POSTWILDFIRE SEDIMENT TRANSPORT. Journal of Geophysical Research: Earth Surface, 121, 2211–2237. 10.1002/2016JF003867
(View/edit entry)
2016 SWEHR
Model overview 35
McGuire, L.; 2017. SWEHR version 1.0. , , https://csdms.colorado.edu/pub/models/doi-source-code/swehr-1.0.tar.gz. 10.5281/zenodo.824087
(View/edit entry)
2017 SWEHR
Source code ref. 0
See more publications of SWEHR


Issues

Help

Input Files

Output Files