Model help:TopoFlow-Infiltration-Richards 1D: Difference between revisions
m (→Provides ports) |
m (Text replacement - "http://csdms.colorado.edu/wiki/" to "https://csdms.colorado.edu/wiki/") |
||
(18 intermediate revisions by 3 users not shown) | |||
Line 3: | Line 3: | ||
1) Log in to the wiki | 1) Log in to the wiki | ||
2) Create a new page for each model, by using the following URL: | 2) Create a new page for each model, by using the following URL: | ||
* | * https://csdms.colorado.edu/wiki/Model help:<modelname> | ||
* Replace <modelname> with the name of a model | * Replace <modelname> with the name of a model | ||
3) Than follow the link "edit this page" | 3) Than follow the link "edit this page" | ||
Line 465: | Line 465: | ||
==Uses ports== | ==Uses ports== | ||
• Meteorology | • Meteorology <br /> | ||
• Snow (Snowmelt) <br /> | |||
• Snow (Snowmelt) | • Evap (Evaporation) <br /> | ||
• Satzone (Subsurface flow in saturated zone) <br /> | |||
• Evap (Evaporation) | • Channels (surface water flow in a network of channels) <br /> | ||
• Satzone (Subsurface flow in saturated zone) | |||
• Channels (surface water flow in a network of channels | |||
==Provides ports== | ==Provides ports== | ||
• Infil (Infiltration) | • Infil (Infiltration) <br /> | ||
• Configure (tabbed dialog GUI to change settings) <br /> | |||
• Configure (tabbed dialog GUI to change settings) | • Run (only if used as the Driver) <br /> | ||
• Run (only if used as the Driver) | |||
==Main equations== | ==Main equations== | ||
Line 489: | Line 483: | ||
|width=50px align="right"|(1) | |width=50px align="right"|(1) | ||
|} | |} | ||
* Conservation of mass, with source/sink term J | * Conservation of mass, with source/sink term J (subscripts are partial derivatives) | ||
::::{| | ::::{| | ||
|width=500px|<math>v_{z}= J - \theta_{t} </math> | |width=500px|<math>v_{z}= J - \theta_{t} </math> | ||
|width=50px align="right"|(2) | |width=50px align="right"|(2) | ||
|} | |} | ||
* Effective saturation or scaled water content, | * Effective saturation or scaled water content (in [0,1]. Equals 0 when θ = θ<sub>r</sub>. Equals 1 when θ = θ<sub>s</sub>.)) | ||
::::{| | ::::{| | ||
|width=500px|<math>\Theta_{e}= \left ( \theta - \theta_{r}\right) / \left ( \theta_{s} - \theta_{r} \right) </math> | |width=500px|<math>\Theta_{e}= \left ( \theta - \theta_{r}\right) / \left ( \theta_{s} - \theta_{r} \right) </math> | ||
Line 506: | Line 500: | ||
* Pressure head | * Pressure head | ||
::::{| | ::::{| | ||
|width=500px|<math>\Psi= \Psi_{B} \left ( \Theta_{e}^{\frac{- | |width=500px|<math>\Psi= \Psi_{B} \left ( \Theta_{e}^{\frac{-c}{\lambda}} - 1 \right)^{\frac{1}{c}} - \Psi_{A} </math> | ||
|width=50px align="right"|(5) | |width=50px align="right"|(5) | ||
|} | |} | ||
Line 584: | Line 578: | ||
| θ | | θ | ||
| soil moisture | | soil moisture | ||
| | | none | ||
|- | |- | ||
| ψ | | ψ | ||
Line 592: | Line 586: | ||
| K | | K | ||
| hydraulic conductivity | | hydraulic conductivity | ||
| | | m / s | ||
|- | |- | ||
| v | | v | ||
Line 602: | Line 596: | ||
</div> | </div> | ||
</div> | </div> | ||
==Notes== | ==Notes== | ||
'''''Notes on Input Parameters''''' | |||
For each variable, you may choose from the droplist of data types. For the "Scalar" data type, enter a numeric value with the units indicated in the dialog. For the other data types, enter a filename. Values in files must also use the indicated units. | For each variable, you may choose from the droplist of data types. For the "Scalar" data type, enter a numeric value with the units indicated in the dialog. For the other data types, enter a filename. Values in files must also use the indicated units. | ||
Line 610: | Line 607: | ||
The current version allows up to 3 different soil layers, each with its own soil properties and number of vertical nodes. The soil layer number is indicated at the top of the dialog and you use the Next and Back buttons to view settings for the various layers. | The current version allows up to 3 different soil layers, each with its own soil properties and number of vertical nodes. The soil layer number is indicated at the top of the dialog and you use the Next and Back buttons to view settings for the various layers. | ||
'''''Notes on the Equations''''' | |||
All variables and their units can be seen by expanding the Nomenclature section above. | |||
These equations are used to compute the time evolution of 1D (vertical, subsurface) profiles for (1) soil moisture, θ, (2) pressure head, ψ, (3) hydraulic conductivity, K and (4) vertical flow rate, v. TopoFlow solves these equations separately to get time-evolving profiles for every grid cell in a DEM. The result is a 3D grid for each of these four variables that spans the unsaturated zone. The third equation above just defines a variable that is used in the 4th and 5th equations, so the coupled set constitutes 4 equations to be solved for 4 unknowns. These equations can be combined into one nonlinear, parabolic, second-order PDE (partial differential equation) known as the one-dimensional Richards' equation. | These equations are used to compute the time evolution of 1D (vertical, subsurface) profiles for (1) soil moisture, θ, (2) pressure head, ψ, (3) hydraulic conductivity, K and (4) vertical flow rate, v. TopoFlow solves these equations separately to get time-evolving profiles for every grid cell in a DEM. The result is a 3D grid for each of these four variables that spans the unsaturated zone. The third equation above just defines a variable that is used in the 4th and 5th equations, so the coupled set constitutes 4 equations to be solved for 4 unknowns. These equations can be combined into one nonlinear, parabolic, second-order PDE (partial differential equation) known as the one-dimensional Richards' equation. | ||
Line 619: | Line 619: | ||
Subscripts in the first two equations indicate partial derivatives with respect to the vertical coordinate, z. Note that z is the vertical distance below the ground surface, in meters. | Subscripts in the first two equations indicate partial derivatives with respect to the vertical coordinate, z. Note that z is the vertical distance below the ground surface, in meters. | ||
More information on how soil is modeled in TopoFlow along with published soil property tables can be found on this soil properties page | More information on how soil is modeled in TopoFlow along with published soil property tables can be found on this | ||
[[Model help:TopoFlow-Soil Properties Page|soil properties page]]. | |||
Two other, simpler methods for modeling infiltration are described on the help pages for the | Two other, simpler methods for modeling infiltration are described on the help pages for the [https://csdms.colorado.edu/wiki/Model_help:TopoFlow-Infiltration-Green-Ampt Green-Ampt method] and the [https://csdms.colorado.edu/wiki/Model_help:TopoFlow-Infiltration-Smith-Parlange Smith-Parlange 3-parameter method]. | ||
==Examples== | ==Examples== | ||
Line 627: | Line 628: | ||
<span class="remove_this_tag">Follow the next steps to include images / movies of simulations:</span> | <span class="remove_this_tag">Follow the next steps to include images / movies of simulations:</span> | ||
* <span class="remove_this_tag">Upload file: | * <span class="remove_this_tag">Upload file: https://csdms.colorado.edu/wiki/Special:Upload</span> | ||
* <span class="remove_this_tag">Create link to the file on your page: <nowiki>[[Image:<file name>]]</nowiki>.</span> | * <span class="remove_this_tag">Create link to the file on your page: <nowiki>[[Image:<file name>]]</nowiki>.</span> | ||
Line 641: | Line 642: | ||
==Links== | ==Links== | ||
'''''Related Help Pages''''' | |||
* [[Model help:TopoFlow-Infiltration-Green-Ampt]] | |||
* [[Model help:TopoFlow-Infiltration-Smith-Parlange]] | |||
* [[Model help:TopoFlow-Saturated_Zone-Darcy_Layers]] | |||
* [[Model help:TopoFlow-Soil Properties Page]] | |||
'''''Model Metadata''''' | |||
* [[Model:TopoFlow-Infiltration-Richards_1D]] | * [[Model:TopoFlow-Infiltration-Richards_1D]] | ||
* [[Model:TopoFlow]] | * [[Model:TopoFlow]] | ||
[[Category:Modules]] | [[Category:Modules]] |
Latest revision as of 17:19, 19 February 2018
TopoFlow-Infiltration-Richards 1D
This module is the infiltration process component (Richards 1D method) 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.
Model parameters
Uses ports
• Meteorology
• Snow (Snowmelt)
• Evap (Evaporation)
• Satzone (Subsurface flow in saturated zone)
• Channels (surface water flow in a network of channels)
Provides ports
• Infil (Infiltration)
• Configure (tabbed dialog GUI to change settings)
• Run (only if used as the Driver)
Main equations
- Darcy's law for vertical flow rate
[math]\displaystyle{ v= K \ast \left ( 1 - \Psi\right) }[/math] (1)
- Conservation of mass, with source/sink term J (subscripts are partial derivatives)
[math]\displaystyle{ v_{z}= J - \theta_{t} }[/math] (2)
- Effective saturation or scaled water content (in [0,1]. Equals 0 when θ = θr. Equals 1 when θ = θs.))
[math]\displaystyle{ \Theta_{e}= \left ( \theta - \theta_{r}\right) / \left ( \theta_{s} - \theta_{r} \right) }[/math] (3)
- Hydraulic conductivity
[math]\displaystyle{ K= K_{s} \ast \Theta_{e}^{\frac{\eta}{\lambda}} }[/math] (4)
- Pressure head
[math]\displaystyle{ \Psi= \Psi_{B} \left ( \Theta_{e}^{\frac{-c}{\lambda}} - 1 \right)^{\frac{1}{c}} - \Psi_{A} }[/math] (5)
Symbol | Description | Unit |
---|---|---|
Ks | saturated hydraulic conductivity | [m / s] |
Ki | initial hydraulic conductivity (typically much less than Ks) | [m / s] |
θs | soil water content at ψ = 0 (often set to the soil porosity, φ) | [-] |
θi | initial soil water content | [-] |
θr | residual soil water content (must be < θi) | [-] |
ψB | bubbling pressure head (also called air-entry pressure, ψae) | m |
ψA | pressure head offset parameter | m |
λ | pore-size distribution parameter (alt. notation - 1/b) | - |
η | unit less, equals to 2 + ( 3*λ ) | |
c | transitional Brooks-Corey curvature parameter | |
dznodes | vertical distance between nodes | m |
nnodes | number of subsurface vertical nodes | |
J | source / sink | |
θt | - | |
Θe | effective saturation or scaled water content (unitless in [0,1]) |
Output
Symbol | Description | Unit |
---|---|---|
θ | soil moisture | none |
ψ | pressure head | m |
K | hydraulic conductivity | m / s |
v | vertical flow rate | m / s |
Notes
Notes on Input Parameters
For each variable, you may choose from the droplist of data types. For the "Scalar" data type, enter a numeric value with the units indicated in the dialog. For the other data types, enter a filename. Values in files must also use the indicated units.
Single grids and grid sequences are assumed to be stored as RTG and RTS files, respectively. Time series are assumed to be stored as text files, with one value per line. For a time series or grid sequence, the time between values must coincide with the timestep provided.
The current version allows up to 3 different soil layers, each with its own soil properties and number of vertical nodes. The soil layer number is indicated at the top of the dialog and you use the Next and Back buttons to view settings for the various layers.
Notes on the Equations
All variables and their units can be seen by expanding the Nomenclature section above.
These equations are used to compute the time evolution of 1D (vertical, subsurface) profiles for (1) soil moisture, θ, (2) pressure head, ψ, (3) hydraulic conductivity, K and (4) vertical flow rate, v. TopoFlow solves these equations separately to get time-evolving profiles for every grid cell in a DEM. The result is a 3D grid for each of these four variables that spans the unsaturated zone. The third equation above just defines a variable that is used in the 4th and 5th equations, so the coupled set constitutes 4 equations to be solved for 4 unknowns. These equations can be combined into one nonlinear, parabolic, second-order PDE (partial differential equation) known as the one-dimensional Richards' equation.
The infiltration rate is simply the vertical flow rate at the ground surface, denoted by v0.
Soil moisture is simply another term for the water content in the case where the porous medium is a soil.
Subscripts in the first two equations indicate partial derivatives with respect to the vertical coordinate, z. Note that z is the vertical distance below the ground surface, in meters.
More information on how soil is modeled in TopoFlow along with published soil property tables can be found on this soil properties page.
Two other, simpler methods for modeling infiltration are described on the help pages for the Green-Ampt method and the Smith-Parlange 3-parameter method.
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: https://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
Dingman, S.L. (2002) Physical Hydrology, 2nd ed., Prentice-Hall, Upper Saddle River, New Jersey, 646 pp.
Smith, R.E. (2002) Infiltration Theory for Hydrologic Applications, Water Resources Monograph 15, AGU, 212 pp.
Links
Related Help Pages
- Model help:TopoFlow-Infiltration-Green-Ampt
- Model help:TopoFlow-Infiltration-Smith-Parlange
- Model help:TopoFlow-Saturated_Zone-Darcy_Layers
- Model help:TopoFlow-Soil Properties Page
Model Metadata