Model:OverlandFlow: Difference between revisions

From CSDMS
(Created page with "{{Model identity |Model also known as=Landlab OverlandFlow component |Model type=Single }} {{Start models incorporated}} {{End a table}} {{Model identity2 |ModelDomain=Terrest...")
 
m (Text replacement - "{{End headertab}}" to "{{End headertab}} {{{{PAGENAME}}_autokeywords}}")
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Model identity
{{Model identity
|Model also known as=Landlab OverlandFlow component
|Model also known as=Landlab OverlandFlow component
|ModelFramework=LandLab
|Model type=Single
|Model type=Single
}}
}}
Line 8: Line 9:
|ModelDomain=Terrestrial, Hydrology
|ModelDomain=Terrestrial, Hydrology
|Spatial dimensions=2D
|Spatial dimensions=2D
|Spatialscale=Landscape-Scale, Watershed-Scale, Reach-Scale
|Spatialscale=Landscape-Scale, Reach-Scale, Watershed-Scale
|One-line model description=Component simulating overland flow using a 2-D numerical approximation of the shallow-water equations following the de Almeida et al., 2012 algorithm for storage-cell inundation modeling.
|One-line model description=Component simulating overland flow using a 2-D numerical approximation of the shallow-water equations following the de Almeida et al., 2012 algorithm for storage-cell inundation modeling.
|Extended model description=The Landlab OverlandFlow component is based on a simplified inertial approximation of the shallow water equations, following the solution of de Almeida et al. (2012). This explicit two-dimensional hydrodynamic algorithm simulates a flood wave across a model domain, where water discharge and flow depth are calculated at all locations within a structured (raster) grid. This component generates a hydrograph at all grid locations, and allows for flow to move in one of the four cardinal directions (D4) into/out of a given model node.
|Extended model description=The Landlab OverlandFlow component is based on a simplified inertial approximation of the shallow water equations, following the solution of de Almeida et al. (2012). This explicit two-dimensional hydrodynamic algorithm simulates a flood wave across a model domain, where water discharge and flow depth are calculated at all locations within a structured (raster) grid. This component generates a hydrograph at all grid locations, and allows for flow to move in one of the four cardinal directions (D4) into/out of a given model node.
Line 31: Line 32:
|Start year development=2012
|Start year development=2012
|Does model development still take place?=No
|Does model development still take place?=No
|DevelopmentCode=Only maintenance
|DevelopmentCodeYearChecked=2020
|Model availability=As code, As teaching tool
|Model availability=As code, As teaching tool
|Source code availability=Through web repository
|Source code availability=Through web repository
Line 76: Line 79:
{{Additional comments model}}
{{Additional comments model}}
{{CSDMS staff part
{{CSDMS staff part
|OpenMI compliant=Not yet
|OpenMI compliant=Yes
|IRF interface=Not yet
|IRF interface=Yes
|CMT component=Not yet
|CMT component=Yes
|PyMT component=Yes
}}
}}
{{Start coupled table}}
{{Start coupled table}}
{{End a table}}
{{End a table}}
{{End headertab}}
{{End headertab}}
{{{{PAGENAME}}_autokeywords}}
<!-- PLEASE USE THE "EDIT WITH FORM" BUTTON TO EDIT ABOVE CONTENTS; CONTINUE TO EDIT BELOW THIS LINE -->
<!-- PLEASE USE THE "EDIT WITH FORM" BUTTON TO EDIT ABOVE CONTENTS; CONTINUE TO EDIT BELOW THIS LINE -->
{{#ifexist:Template:{{#sub:{{PAGENAME}}|0|1}}{{#sub:{{lc:{{PAGENAME}}}}|1}} download stats | ==Download statistics==
{{#ifexist:Template:{{#sub:{{PAGENAME}}|0|1}}{{#sub:{{lc:{{PAGENAME}}}}|1}} download stats | ==Download statistics==
Line 94: Line 99:
<br>{{AddReferenceUploadButtons}}<br><br>
<br>{{AddReferenceUploadButtons}}<br><br>
{{#ifexist:Template:{{PAGENAME}}-citation-indices|{{{{PAGENAME}}-citation-indices}}|}}<br>
{{#ifexist:Template:{{PAGENAME}}-citation-indices|{{{{PAGENAME}}-citation-indices}}|}}<br>
{{Include_references_models_cargo}}  
{{Include_featured_references_models_cargo}}<br>


== Issues ==
== Issues ==

Latest revision as of 19:13, 16 September 2020



OverlandFlow


Metadata

Also known as Landlab OverlandFlow component
Model type Single
Model part of larger framework LandLab
Note on status model
Date note status model
Incorporated models or components:
Spatial dimensions 2D
Spatial extent Landscape-Scale, Reach-Scale, Watershed-Scale
Model domain Terrestrial, Hydrology
One-line model description Component simulating overland flow using a 2-D numerical approximation of the shallow-water equations following the de Almeida et al., 2012 algorithm for storage-cell inundation modeling.
Extended model description The Landlab OverlandFlow component is based on a simplified inertial approximation of the shallow water equations, following the solution of de Almeida et al. (2012). This explicit two-dimensional hydrodynamic algorithm simulates a flood wave across a model domain, where water discharge and flow depth are calculated at all locations within a structured (raster) grid. This component generates a hydrograph at all grid locations, and allows for flow to move in one of the four cardinal directions (D4) into/out of a given model node.
Keywords:
Name Jordan Adams
Type of contact Model developer
Institute / Organization University of Colorado
Postal address 1
Postal address 2
Town / City Boulder
Postal code 80301
State Colorado
Country United States
Email address jordan.adams@colorado.edu
Phone
Fax


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

Python

Other program language
Code optimized Single Processor
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development 2012
Does model development still take place? No
If above answer is no, provide end year model development
Code development status Only maintenance
When did you indicate the 'code development status'? 2020
Model availability As code, As teaching tool
Source code availability
(Or provide future intension) 		Through web repository
Source web address https://github.com/landlab/landlab/tree/master/landlab/components/overland_flow
Source csdms web address
Program license type BSD or MIT X11
Program license type other
Memory requirements variable
Typical run time variable


Describe input parameters This component operates on a Landlab RasterModelGrid instance, and requires that the user has downloaded and installed Landlab. Parameters listed below are required. Ones noted as (optional) will revert to the prescribed default values as described in the documentation.

Input parameters include:

grid : A Landlab RasterModelGrid, representing the topography h_init : (optional) Thickness of initial thin layer of water on the surface alpha : (optional) Time step coeffcient, described in Bates et al., 2010 and de Almeida et al., 2012. mannings_n : (optional) Manning's roughness coefficient. g : (optional) Acceleration due to gravity (m/s^2). theta : (optional) Weighting factor from de Almeida et al., 2012. rainfall_intensity : (optional) Rainfall intensity.

Input format ASCII
Other input format
Describe output parameters The Landlab OverlandFlow component outputs data as Landlab fields - numpy arrays containing data with the associated CSDMS standard name, listed below:

'surface_water__depth' : NumPy array of length nnodes. Water depths at a given time step. 'surface_water__discharge' : NumPy array of length nlinks. Water discharge values at a given time step. 'water_surface__gradient' : NumPy array of length nlinks. Water surface gradient at a given time step.

Output format
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 Routes a hydrograph (changing water discharges through time) across a gridded model terrain. At each location, water discharge is calculated at each time step as a function of surface roughness, local water depths and water surface slopes.
Describe key physical parameters and equations The key algorithms and parameters are described in length the Geoscientific Model Development paper by Adams et al., (2017).
Describe length scale and resolution constraints The model works best at watershed-scale domains, 100 km^2 and less have been tested. Of course, this is highly dependent on the grid resolution.
Describe time scale and resolution constraints The model works best for event to decadal time scales on a personal machine.
Describe any numerical limitations and issues


Describe available calibration data sets The model is tested against the known analytical solution (see Adams et al., 2017 for more details). It is unit-tested against this analytical solution every time Landlab is updated.
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? Yes
Upload manual if available: Media:OverlandFlow Users Manual.pdf
Model website if any
Model forum / discussion board
Comments


This part will be filled out by CSDMS staff

OpenMI compliant Yes
BMI compliant Yes
WMT component Yes
PyMT component Yes
Is this a data component
Can be coupled with:
Model info
Authors
Jordan Adams
Source code
Model citations
Nr. of publications: 1
Total citations: 46
h-index: 1
m-quotient: 0.12
QR-code

Link to this page
Other models by author



Introduction

History

References



Nr. of publications: 1
Total citations: 46
h-index: 1
m-quotient: 0.12



Featured publication(s)YearModel describedType of ReferenceCitations
Adams, Jordan M.; Gasparini, Nicole M.; Hobley, Daniel E. J.; Tucker, Gregory E.; Hutton, Eric W. H.; Nudurupati, Sai S.; Istanbulluoglu, Erkan; 2017. The Landlab v1.0 OverlandFlow component: a Python tool for computing shallow-water flow across watersheds. Geoscientific Model Development, 10, 1645–1663. 10.5194/gmd-10-1645-2017
(View/edit entry)		2017 Landlab
OverlandFlow
 Model overview 46
See more publications of OverlandFlow


Issues

Help

Input Files

Output Files

Retrieved from "https://csdms.colorado.edu/csdms_wiki/index.php?title=Model:OverlandFlow&oldid=299732"