Model help:TopoFlow-Diversions
TopoFlow-Diversions
This is the diversions component for a D8-based, spatial hydrologic model.
Model introduction
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.
Model parameters
Input
Parameter | Description | Unit |
---|---|---|
Component status | Enabled / Disabled | [-] |
Input directory | The location of the input files | [-] |
Output directory | The location for the output files | [-] |
Site prefix | [-] | |
Case prefix | [-] | |
Use sources toggle | Option to use sources | [-] |
Sources file | source information file | [-] |
Use sinks toggle | Option to use sinks | [-] |
Sinks file | sink information file | [-] |
Use canals toggle | Option to use canals | [-] |
Canal file | canal information file | [-] |
Uses ports
• Channels (surface water flow in a network of channels with trapezoidal cross-section)
Provides ports
This will be something that the CSDMS facility will add
Main equations
A list of the key equations. HTML format is supported; latex format will be supported in the future
Symbol | Description | Unit |
---|---|---|
ID | source pixel ID as long integer, calendar index (for sources and sinks) | - |
nd | number of durations and flow rates (for sources and sinks, cannals) | - |
durations | vector of durations (for sources and sinks, canals) | T |
flow rates | vector of discharges (for sources and sinks, canals) | L3 / T |
ID1 | start pixel ID as long integer; calendar index (for canals) | - |
ID2 | end pixel ID as long integer; calendar index (for canals) | - |
Notes
To use flow diversions, you must provide the required information in specially-formatted text files. Where required, vector-valued input variables such as durations are specified as a list of space-delimited numbers on one line (i.e. terminated by a single end-of-line character). The term pixel ID refers to the integer value that is assigned to a given pixel (i.e. grid cell) when all pixels in the corresponding DEM are numbered sequentially in calendar order , that is, from top row to bottom row and from left to right within each row. Pixel IDs start at zero and are read and processed as long (4-byte) integers.
Canals are currently assumed to be lossless, so that the flow rates at the two ends are identical, but lagged by the travel time.
Examples
An example run with input parameters, BLD files, as well as a figure / movie of the output
Follow the next steps to include images / movies of simulations:
- Upload file: http://csdms.colorado.edu/wiki/Special:Upload
- Create link to the file on your page: [[Image:<file name>]].
See also: Help:Images or Help:Movies
Developer(s)
References
Key papers