Ground transpiration formula (Water Overlay): Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(41 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Underground evaporation is calculated per cell.
Conceptually, water can transpire from the ground via crops, tree and plant foliage. This is called evapotranspiration. The amount a plant can evaporate depends on the saturation and ground water level, as well as the root structure.
The factor by which roots can extract water from the ground is modeled using the Feddes trapezium, based on the root depths ([[Root depth m (Water Overlay)|Building]] or [[Terrain root depth m (Water Overlay)|Terrain]]).
[[File:Feddes_trapezium.jpg|thumb|right|400px|Feddes trapezium indicating for what water levels and by what factor roots of a plant can extract water from the ground.]]


For all underground evaporation calculation, the ground water depth at time t is used.
The amount a plant, crop or tree evaporates also depends on its growth season. Therefore, the species-specific [[Water transpiration (Function Value)|transpiration factor]] can be set as four [[Season formula (Water Overlay)|seasonal values]].


<math>d_{gw,t} = b_{s} - w_{g,t}</math>
Last but not least, the calculated evapotranspiration factor is multiplied with the [[Evaporation m (Water Overlay)|evaporation amount]] at time <math>t</math>, which is configured for a [[Weather (Water Overlay)|Weather]].
 
The transpired amount is first drawn from the unsaturated zone and then, when the expected amount is not yet reached, from the saturated zone.
 
==Formulas==
 
This transpiration is calculated per cell. For all ground transpiration calculation, the ground water depth at time t is used.
 
<math>d_{gw,t} = B_{c} - w_{g,t}</math>


Feddes oxygen stress factor:
Feddes oxygen stress factor:
Line 25: Line 35:
</math>
</math>


Max potential evaporation:
Seasonal transpiration factor:
 
<math> f_{ts,t} = (1.0 - f_{se,t}) \cdot f_{ts,c} + f_{se,t} \cdot f_{ts,n}</math>
 
Max potential transpiration:


<math>E_{max} = f_t \cdot e_{w,t} \cdot f_o</math>
<math>E_{max} = f_{ts,t} \cdot e_{w,t} \cdot f_o \cdot \Delta t</math>


Evaporation unsaturated:
Transpiration unsaturated:


<math>E_{u} =
<math>E_{u} =
\begin{cases}
\begin{cases}
0.0 & \text{if } d_{gw,t} \text{ is } \geq 0.0 \\
0.0 & \text{if } d_{gw,t} \text{ is } \leq 0.0 \\
min(E_{max}, h_u \cdot \frac{d_{r,1}}{d_{gw,t}}) & \text{otherwise} \\
min(E_{max}, h_u \cdot \frac{d_{r,1}}{d_{gw,t}}) & \text{otherwise} \\
\end{cases}
\end{cases}
</math>
</math>


Potential evaporation saturated:
Potential transpiration saturated:


<math>d_{s} = w_{g,t} - ( b_{s} - d_{gb} )</math>
<math>d_{s} = w_{g,t} - ( B_{c} - d_{b,c} )</math>


<math>d_{r} = max( 0.0 ,  w_{g,t} - ( b_{s} - d_{r,1} ))</math>
<math>d_{r} = max( 0.0 ,  w_{g,t} - ( B_{c} - d_{r,1} ))</math>


<math>E_{p,s} = (E_{max} - E_{u}) \cdot f_s</math>
<math>E_{p,s} = (E_{max} - E_{u}) \cdot f_s</math>


Evaporation saturated zone:
Transpiration saturated zone:


<math>E_{s} = max (0.0 , min ( E_{p,s}, d_{s}\cdot f_{gw}, d_r \cdot f_{gw}) ) </math>
<math>E_{s} = max (0.0 , min ( E_{p,s}, d_{s}\cdot f_{ws}, d_r \cdot f_{ws}) ) </math>


Evaporation total is the sum of evaporation in the saturated and unsaturated zone:
Transpiration total is the sum of transpiration in the saturated and unsaturated zone:


<math>E_g = E_u + E_s</math>
<math>E_g = E_u + E_s</math>


where  
where  
: <math>b_{s}</math> is the datum height of the surface.
: <math>B_{c}</math> = the datum height of the surface of cell c, set by the [[Elevation model (Water Overlay)|elevation]] or a [[Terrain elevation prequel (Water Overlay)|Terrain elevation prequel]].
: <math>w_{g,t}</math> is the ground water level (datum height) at time t.
: <math>w_{g,t}</math> = the ground water level (datum height) at time t.
: <math>d_{gw,t}</math> is the depth of the ground water level, which is equal to the column height of the unsaturated zone at time t.
: <math>d_{gw,t}</math> = the depth of the ground water level, which is equal to the column height of the unsaturated zone at time t.
: <math>f_t</math> is the [[Water evaporation factor (Water Overlay)|transpiration factor]] of the buildings (plants) on the surface, or the surface terrain's [[Terrain_water_evaporation_factor_(Water_Overlay)|transpiration factor]] if none present.
: <math>f_{ts,c}</math> = the [[Water transpiration factor (Water Overlay)|transpiration factor]] at current season c, of the buildings (plants) on the surface, or the surface terrain's [[Terrain water transpiration factor (Water Overlay)|transpiration factor]] if none present.
: <math>e_{w,t}</math> is the [[Evaporation_m_(Water_Overlay)|evaporation rate]] of the [[weather]] at time t
: <math>f_{ts,n}</math> = the [[Water transpiration factor (Water Overlay)|transpiration factor]] at coming season n, of the buildings (plants) on the surface, or the surface terrain's [[Terrain water transpiration factor (Water Overlay)|transpiration factor]] if none present.
: <math>f_o</math> is the calculated feddes oxygen stress factor, calculated using the 3rd and 4th [[Root_depth_m_(Water_Overlay)|root depths]] and the feddes trapezium interpolation model and the ground water depth.
: <math>f_{se,t}</math> = [[Season formula (Water Overlay)|Season fraction]]. Used for interpolating the transpiration factor.
: <math>f_s</math> is the calculated feddes saturated zone root update factor, calculated using the 1st and 2nd [[Root_depth_m_(Water_Overlay)|root depths]] and the feddes trapezium interpolation model and the ground water depth.
: <math>f_{ts,t}</math> = the interpolated seasonal transpiration factor.
: <math>d_{r,n}</math> is the nth [[Root_depth_m_(Water_Overlay)|root depth value]].
: <math>e_{w,t}</math> = the [[Evaporation m (Water_Overlay)|evaporation rate]] of the [[weather]] at time t.
: <math>E_{max}</math> is the potential max evaporation
: <math>f_o</math> = the calculated Feddes oxygen stress factor, based on the 3rd and 4th root depths ([[Root depth m (Water Overlay)|Building]] or [[Terrain root depth m (Water Overlay)|Terrain]]), the Feddes trapezium interpolation model, and the ground water depth.
: <math>E_{u}</math> is the evaporation in the unsaturated zone
: <math>f_s</math> = the calculated Feddes saturated zone root update factor, based on the 1st and 2nd root depths ([[Root depth m (Water Overlay)|Building]] or [[Terrain root depth m (Water Overlay)|Terrain]]), the Feddes trapezium interpolation model, and the ground water depth.
: <math>E_{p,s}</math> is the potential evaporation in the saturated zone
: <math>\Delta t</math> = the computational [[Timestep formula (Water Overlay)|timestep]] in seconds.
: <math>E_{s}</math> is the evaporation in the saturated zone
: <math>d_{b,c}</math> = The ground bottom distance of the cell c, defined by a [[Bottom distance prequel (Water Overlay)|Bottom distance prequel]] or a general [[Ground_bottom_distance_m_(Water_Overlay)|GROUND_BOTTOM_DISTANCE_M]] of the Water Overlay.  
: <math>E_{g}</math> is the total evaporation from the underground.
: <math>d_{s}</math> = the total thickness (column height) of the saturated zone.
: <math>d_{gb}</math> is the [[Ground bottom distance m (Water Overlay)|ground bottom distance]]
: <math>d_{r,n}</math> =  the nth root depth value, defined by [[Root depth m (Water Overlay)|building attributes]] or [[Terrain root depth m (Water Overlay)|terrain attributes]].
: <math>d_{s}</math> is the column height of the saturated zone covered by the roots
: <math>h_u</math> = the amount of water in the unsaturated zone.
: <math>E_{max}</math> = the potential max transpiration.
: <math>E_{u}</math> = the transpired amount in the unsaturated zone.
: <math>E_{p,s}</math> = the potential transpiration in the saturated zone.
: <math>f_{ws}</math> = The [[Terrain water storage percentage (Water Overlay)|WATER_STORAGE_PERCENTAGE]] of the ground terrain type, used here as a fraction.
: <math>E_{s}</math> = the transpired in the saturated zone.
: <math>E_{g}</math> = the total transpired from the ground.


==Related==
==Related==
The following topics are related to this formula.
The following topics are related to this formula.
; Formulas
; Formulas
: [[Groundwater level formula (Water Overlay)|Groundwater level formula]]
: [[Groundwater level formula (Water Overlay)]]
; Models
; Models
: [[Underground model (Water Overlay)|Underground model]]
: [[Ground model (Water Overlay)]]
: [[Evaporation model (Water Overlay)|Evaporation model]]
: [[Evapotranspiration model (Water Overlay)]]


{{article end
|notes=
* The ground water level cannot be lowered further than the defined root depth by evapotranspiration.
}}
{{WaterOverlay formula nav}}
{{WaterOverlay formula nav}}

Latest revision as of 11:17, 15 July 2026

Conceptually, water can transpire from the ground via crops, tree and plant foliage. This is called evapotranspiration. The amount a plant can evaporate depends on the saturation and ground water level, as well as the root structure. The factor by which roots can extract water from the ground is modeled using the Feddes trapezium, based on the root depths (Building or Terrain).

Feddes trapezium indicating for what water levels and by what factor roots of a plant can extract water from the ground.

The amount a plant, crop or tree evaporates also depends on its growth season. Therefore, the species-specific transpiration factor can be set as four seasonal values.

Last but not least, the calculated evapotranspiration factor is multiplied with the evaporation amount at time t, which is configured for a Weather.

The transpired amount is first drawn from the unsaturated zone and then, when the expected amount is not yet reached, from the saturated zone.

Formulas

This transpiration is calculated per cell. For all ground transpiration calculation, the ground water depth at time t is used.

dgw,t=Bcwg,t

Feddes oxygen stress factor:

fo={1.0if dgw,t is dr,3dgw,tdr,4dr,3dr,4if dgw,t is dr,40.0otherwise

Feddes saturated zone root update factor:

fs={0.0if dgw,t is dr,11.0dgw,tdr,2dr,1dr,2if dgw,t is dr,21.0otherwise

Seasonal transpiration factor:

fts,t=(1.0fse,t)fts,c+fse,tfts,n

Max potential transpiration:

Emax=fts,tew,tfoΔt

Transpiration unsaturated:

Eu={0.0if dgw,t is 0.0min(Emax,hudr,1dgw,t)otherwise

Potential transpiration saturated:

ds=wg,t(Bcdb,c)

dr=max(0.0,wg,t(Bcdr,1))

Ep,s=(EmaxEu)fs

Transpiration saturated zone:

Es=max(0.0,min(Ep,s,dsfws,drfws))

Transpiration total is the sum of transpiration in the saturated and unsaturated zone:

Eg=Eu+Es

where

Bc = the datum height of the surface of cell c, set by the elevation or a Terrain elevation prequel.
wg,t = the ground water level (datum height) at time t.
dgw,t = the depth of the ground water level, which is equal to the column height of the unsaturated zone at time t.
fts,c = the transpiration factor at current season c, of the buildings (plants) on the surface, or the surface terrain's transpiration factor if none present.
fts,n = the transpiration factor at coming season n, of the buildings (plants) on the surface, or the surface terrain's transpiration factor if none present.
fse,t = Season fraction. Used for interpolating the transpiration factor.
fts,t = the interpolated seasonal transpiration factor.
ew,t = the evaporation rate of the weather at time t.
fo = the calculated Feddes oxygen stress factor, based on the 3rd and 4th root depths (Building or Terrain), the Feddes trapezium interpolation model, and the ground water depth.
fs = the calculated Feddes saturated zone root update factor, based on the 1st and 2nd root depths (Building or Terrain), the Feddes trapezium interpolation model, and the ground water depth.
Δt = the computational timestep in seconds.
db,c = The ground bottom distance of the cell c, defined by a Bottom distance prequel or a general GROUND_BOTTOM_DISTANCE_M of the Water Overlay.
ds = the total thickness (column height) of the saturated zone.
dr,n = the nth root depth value, defined by building attributes or terrain attributes.
hu = the amount of water in the unsaturated zone.
Emax = the potential max transpiration.
Eu = the transpired amount in the unsaturated zone.
Ep,s = the potential transpiration in the saturated zone.
fws = The WATER_STORAGE_PERCENTAGE of the ground terrain type, used here as a fraction.
Es = the transpired in the saturated zone.
Eg = the total transpired from the ground.

The following topics are related to this formula.

Formulas
Groundwater level formula (Water Overlay)
Models
Ground model (Water Overlay)
Evapotranspiration model (Water Overlay)

Notes

  • The ground water level cannot be lowered further than the defined root depth by evapotranspiration.