Model:TopoFlow-Diversions: Difference between revisions
From CSDMS
No edit summary |
m (Text replacement - "{{End headertab}}" to "{{End headertab}} {{{{PAGENAME}}_autokeywords}}") |
||
(44 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
{{Model identity | |||
|Model type=Single | |||
}} | |||
{{Start models incorporated}} | |||
{{End a table}} | |||
{{Model identity2 | |||
|ModelDomain=Hydrology | |||
|Spatial dimensions=2D | |||
|Spatialscale=Landscape-Scale, Watershed-Scale | |||
|One-line model description=Diversions component for a D8-based, spatial hydrologic model. | |||
|Extended model description=This process component is part of a spatially-distributed hydrologic model called TopoFlow, but it can now be used as a stand-alone model. TopoFlow supports three different types of flow diversions: sources, sinks and canals. Sources are locations such as natural springs where water enters the watershed at a point by some process other than those that are otherwise modeled. Similarly, sinks are locations where water leaves the watershed at a point. Canals are generally man-made reaches such as tunnels or irrigation ditches that transport water from one point to another, typically without following the natural gradient of the terrain that is indicated by the DEM. The upstream end is essentially a sink and the downstream end a source. | |||
}} | |||
{{Start model keyword table}} | |||
{{Model keywords | |||
|Model keywords=basins | |||
}} | |||
{{End a table}} | |||
{{Modeler information | {{Modeler information | ||
|First name=Scott | |First name=Scott | ||
Line 7: | Line 24: | ||
|Town / City=Boulder | |Town / City=Boulder | ||
|Postal code=80305 | |Postal code=80305 | ||
|Country=United States | |||
|State=Colorado | |State=Colorado | ||
|Email address=Scott.Peckham@colorado.edu | |Email address=Scott.Peckham@colorado.edu | ||
|Phone=303-492-6752 | |Phone=303-492-6752 | ||
}} | }} | ||
{{Model technical information | {{Model technical information | ||
Line 27: | Line 36: | ||
|Start year development=2001 | |Start year development=2001 | ||
|Does model development still take place?=Yes | |Does model development still take place?=Yes | ||
|DevelopmentCode=Active | |||
|DevelopmentCodeYearChecked=2020 | |||
|Model availability=As code, As teaching tool | |Model availability=As code, As teaching tool | ||
|Source code availability=Through | |Source code availability=Through web repository | ||
|Source web address=https://github.com/peckhams/topoflow | |||
|Program license type=Apache public license | |Program license type=Apache public license | ||
|Memory requirements=Standard | |Memory requirements=Standard | ||
|Typical run time=Minutes to hours | |Typical run time=Minutes to hours | ||
Line 38: | Line 47: | ||
{{Input - Output description | {{Input - Output description | ||
|Describe input parameters=For sources and sinks, the following information must be provided, each on its own line: | |Describe input parameters=For sources and sinks, the following information must be provided, each on its own line: | ||
ID (source pixel ID as long integer; calendar index) | ID (source pixel ID as long integer; calendar index) | ||
nd (number of durations and flow rates) | nd (number of durations and flow rates) | ||
durations (vector of durations in minutes) | durations (vector of durations in minutes) | ||
flow rates (vector of discharges in m^3/sec) | flow rates (vector of discharges in m^3/sec) | ||
For canals, the following information must be provided, again with each entry on a separate line in the text file: | For canals, the following information must be provided, again with each entry on a separate line in the text file: | ||
ID1 (start pixel ID as long integer; calendar index) | ID1 (start pixel ID as long integer; calendar index) | ||
ID2 (end pixel ID as long integer; calendar index) | ID2 (end pixel ID as long integer; calendar index) | ||
time (travel time between ID1 and ID2, in minutes) | time (travel time between ID1 and ID2, in minutes) | ||
nd (number of durations and flow rates) | nd (number of durations and flow rates) | ||
durations (vector of durations in minutes) | durations (vector of durations in minutes) | ||
flow rates (vector of discharges in m^3/sec) | flow rates (vector of discharges in m^3/sec) | ||
Canals are currently assumed to be lossless, so that the flow rates at the two ends are identical, but lagged by the travel time. | Canals are currently assumed to be lossless, so that the flow rates at the two ends are identical, but lagged by the travel time. | ||
Line 68: | Line 77: | ||
{{Process description model | {{Process description model | ||
|Describe length scale and resolution constraints=Recommended grid cell size is around 100 meters, but can be parameterized to run with a wide range of grid cell sizes. DEM grid dimensions are typically less than 1000 columns by 1000 rows. | |Describe length scale and resolution constraints=Recommended grid cell size is around 100 meters, but can be parameterized to run with a wide range of grid cell sizes. DEM grid dimensions are typically less than 1000 columns by 1000 rows. | ||
|Describe time scale and resolution constraints=The basic stability condition is: dt < (dx / u_min), where dt is the | |Describe time scale and resolution constraints=The basic stability condition is: dt < (dx / u_min), where dt is the timestep, dx is the grid cell size and u_min is the smallest velocity in the grid. This ensures that flow cannot cross a grid cell in less than one time step. Typical timesteps are on the order of seconds to minutes. Model can be run for a full year or longer, if necessary. | ||
|Describe any numerical limitations and issues=This model/component needs more rigorous testing. | |Describe any numerical limitations and issues=This model/component needs more rigorous testing. | ||
}} | }} | ||
Line 87: | Line 96: | ||
}} | }} | ||
{{Documentation model | {{Documentation model | ||
|Manual model available=Yes | |Manual model available=Yes | ||
|Model website if any=This site. | |Model website if any=This site. | ||
Line 93: | Line 101: | ||
{{Additional comments model | {{Additional comments model | ||
|Comments=About this component: | |Comments=About this component: | ||
*This component was developed as part of the TopoFlow hydrologic model, which was originally written in IDL and had a point-and-click GUI. For more information on TopoFlow, please goto: | *This component was developed as part of the TopoFlow hydrologic model, which was originally written in IDL and had a point-and-click GUI. For more information on TopoFlow, please goto: https://csdms.colorado.edu/wiki/Model:TopoFlow. | ||
*When used from within the CSDMS Modeling Tool (CMT), this component has "config" button which launches a graphical user interface (GUI) for changing input parameters. The GUI is a tabbed dialog with a Help button at the bottom that displays HTML help in a browser window. | *When used from within the CSDMS Modeling Tool (CMT), this component has "config" button which launches a graphical user interface (GUI) for changing input parameters. The GUI is a tabbed dialog with a Help button at the bottom that displays HTML help in a browser window. | ||
*This component also has a configuration (CFG) file, with a name of the form: <case_prefix>_channels_diff_wave.cfg. This file can be edited with a text editor. | *This component also has a configuration (CFG) file, with a name of the form: <case_prefix>_channels_diff_wave.cfg. This file can be edited with a text editor. | ||
Line 99: | Line 107: | ||
*This model has an OpenMI-style interface, similar to OpenMI 2.0. Part of this interface is inherited from "CSDMS_base.py". | *This model has an OpenMI-style interface, similar to OpenMI 2.0. Part of this interface is inherited from "CSDMS_base.py". | ||
}} | }} | ||
{{CSDMS staff part | |||
|OpenMI compliant=No but planned | |||
|IRF interface=Yes | |||
|CMT component=Yes | |||
|CCA component=Yes | |||
}} | |||
{{Start coupled table}} | |||
{{CSDMS coupled models | |||
|Animation model name=TopoFlow | |||
}} | |||
{{CSDMS coupled models | |||
|Animation model name=TopoFlow-Channels-Diffusive Wave | |||
}} | |||
{{CSDMS coupled models | |||
|Animation model name=TopoFlow-Channels-Dynamic Wave | |||
}} | |||
{{CSDMS coupled models | |||
|Animation model name=TopoFlow-Channels-Kinematic Wave | |||
}} | |||
{{End a table}} | |||
{{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 --> | ||
==Introduction== | ==Introduction== | ||
== History == | == History == | ||
== | == References == | ||
<br>{{AddReferenceUploadButtons}}<br><br> | |||
{{#ifexist:Template:{{PAGENAME}}-citation-indices|{{{{PAGENAME}}-citation-indices}}|}}<br> | |||
{{Include_featured_references_models_cargo}}<br> | |||
== Issues == | == Issues == | ||
== Help == | == Help == | ||
[[Model help:TopoFlow-Diversions]] | |||
== Input Files == | == Input Files == | ||
== Output Files == | == Output Files == | ||
Latest revision as of 20:19, 16 September 2020
TopoFlow-Diversions
Metadata
|
|
Introduction
History
References
Nr. of publications: | 1 |
Total citations: | 11 |
h-index: | 1 |
m-quotient: | 0.07 |
Featured publication(s) | Year | Model described | Type of Reference | Citations |
---|---|---|---|---|
Peckham, S.D.; 2009. Chapter 25 Geomorphometry and Spatial Hydrologic Modelling. In: (eds.)Developments in Soil Science.. 579–602. (View/edit entry) | 2009 | TopoFlow TopoFlow-Channels-Diffusive Wave TopoFlow-Channels-Dynamic Wave TopoFlow-Channels-Kinematic Wave TopoFlow-Diversions TopoFlow-Evaporation-Energy Balance TopoFlow-Evaporation-Priestley Taylor TopoFlow-Evaporation-Read File TopoFlow-Infiltration-Green-Ampt TopoFlow-Infiltration-Richards 1D TopoFlow-Infiltration-Smith-Parlange TopoFlow-Meteorology TopoFlow-Saturated Zone-Darcy Layers TopoFlow-Snowmelt-Degree-Day TopoFlow-Snowmelt-Energy Balance |
Model overview | 11 |
See more publications of TopoFlow-Diversions |
Issues
Help
Model help:TopoFlow-Diversions