Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
49 commits
Select commit Hold shift + click to select a range
c87bd76
fixes the conflation of soil and microbial maintenance respiration by…
ayushman1210 Dec 10, 2025
6d8de9d
formated the file with clang
ayushman1210 Dec 10, 2025
c3fee14
Fix and standardize parameters.md — notation, tables, units, and row…
ayushman1210 Dec 10, 2025
631d808
Merge branch 'master' into fix/docs
ayushman1210 Jan 4, 2026
bd52c84
Merge branch 'master' into fix/docs
ayushman1210 Jan 6, 2026
18773cb
Merge branch 'master' into fix/docs
ayushman1210 Jan 12, 2026
e063a05
changes
ayushman1210 Jan 12, 2026
0e50ef3
changes
ayushman1210 Jan 12, 2026
de23674
Merge branch 'master' into fix/docs
ayushman1210 Jan 12, 2026
9816543
Merge branch 'master' into fix/docs
ayushman1210 Jan 16, 2026
96e6d52
Merge branch 'master' into fix/docs
ayushman1210 Jan 17, 2026
fad1464
Merge branch 'master' into fix/docs
ayushman1210 Jan 21, 2026
9d14674
Merge branch 'master' into fix/docs
ayushman1210 Jan 24, 2026
6e4e358
Merge branch 'master' into fix/docs
dlebauer Jan 27, 2026
f285732
All missing parameter symbols have been successfully added to paramet…
ayushman1210 Jan 27, 2026
2870e67
Fix clang-format alignment on soilMaintRespiration assignment (lines …
ayushman1210 Jan 27, 2026
3d6931f
Fix clang-format continuation indentation on soilMaintRespiration ass…
ayushman1210 Jan 27, 2026
0a0af99
Fix clang-format style: operator-first continuation line formatting
ayushman1210 Jan 27, 2026
bf2f442
Merge branch 'master' into fix/docs
ayushman1210 Jan 29, 2026
5e7425c
fixes
ayushman1210 Jan 29, 2026
a777f94
clang-format
ayushman1210 Jan 29, 2026
cf8468c
Merge branch 'master' into fix/docs
ayushman1210 Jan 30, 2026
ebbe06b
Merge branch 'master' into fix/docs
ayushman1210 Feb 3, 2026
32d05b8
Merge branch 'master' into fix/docs
ayushman1210 Feb 10, 2026
37f9fbe
Merge branch 'master' into fix/docs
ayushman1210 Feb 13, 2026
7c88cca
Merge branch 'master' into fix/docs
ayushman1210 Feb 14, 2026
e691458
updated the parameter.md file
ayushman1210 Feb 14, 2026
55ad884
Align parameters docs with issue #81 scope and PR feedback
dlebauer Feb 20, 2026
4f36d00
Remove sipnet.c and state.h changes from PR203
dlebauer Feb 20, 2026
407db77
Merge origin/master into codex/pr203-clean and resolve parameters docs
dlebauer Feb 20, 2026
4ace456
Align parameters.md with model-structure scope
dlebauer Feb 20, 2026
80a122d
Mark non-implemented params with fraktur notation
dlebauer Feb 20, 2026
0053252
Update docs/parameters.md
dlebauer Feb 20, 2026
63c6a0f
Update docs/parameters.md
dlebauer Feb 20, 2026
29f0dcb
Update docs/parameters.md
dlebauer Feb 20, 2026
28e7a5f
capitalize "notes"
dlebauer Feb 20, 2026
854f8dd
capitalize "notes"
dlebauer Feb 20, 2026
c21b546
Update docs/parameters.md
dlebauer Feb 20, 2026
47beff5
capitalize "notes"
dlebauer Feb 20, 2026
445fad9
replace degree symbol with \circ
dlebauer Feb 20, 2026
46b0613
fix eqn refs
dlebauer Feb 20, 2026
ec62076
consistent caps for RH RA
dlebauer Feb 20, 2026
1c496b7
Clarify transpiration notation and leaf-water cap docs
dlebauer Feb 21, 2026
21a8c50
Update docs/parameters.md
ayushman1210 Feb 21, 2026
db30b7a
Update docs/parameters.md
ayushman1210 Feb 21, 2026
c36bd03
changes as suggested by maintainer updated parameters.md and model-st…
ayushman1210 Feb 21, 2026
c0c4091
Apply suggestion from @dlebauer
dlebauer Feb 22, 2026
f6398a4
Apply suggestion from @dlebauer
dlebauer Feb 22, 2026
c6a7dc5
Address unresolved PR 203 notation and parameter doc comments
dlebauer Feb 23, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 30 additions & 8 deletions docs/model-structure.md
Original file line number Diff line number Diff line change
Expand Up @@ -737,10 +737,9 @@ $F^W_{\text{precip,soil}}$ is added to soil water in \eqref{eq:Braswell_A4}.
ET = E + T
\end{equation}

Evapotranspiration ($ET$) is calculated as the sum of evaporation ($E$) and transpiration ($T$), which are defined
below:
Evapotranspiration ($ET$) is calculated as the sum of evaporation ($E$) and transpiration ($T=F^W_{\text{trans}}$). These fluxes are defined below:

### Evaporation
#### Evaporation

There are two components of evaporation: (1) immediate evaporation from intercepted precipitation or canopy irrigation
and (2) soil surface evaporation.
Expand All @@ -751,6 +750,29 @@ and (2) soil surface evaporation.
F^W_{\text{intercept,evap}} = f_{\text{intercept}}\,(F^W_{\text{precip}} + F^W_{\text{irrig,canopy}})
\end{equation}

##### Canopy interception evaporation (optional leaf water pool)

If `LEAF_WATER` is enabled (CLI: `--leaf-water`), SIPNET limits immediate evaporation from canopy interception
using an LAI-scaled cap on the interception-evaporation flux. In `calcPrecip()`, potential interception evaporation is:

\begin{equation}
E_{\text{int,pot}} = f_{\text{intercept}} \cdot F^W_{\text{precip}}
\end{equation}

and is capped by an LAI-scaled maximum interception-evaporation flux:

\begin{equation}
E_{\text{int,max}} = LAI \cdot WHC_{\text{leaf}}
\end{equation}

so that:

\begin{equation}
E_{\text{int}} = \min(E_{\text{int,pot}}, E_{\text{int,max}})
\end{equation}

Any rainfall not evaporated immediately becomes throughfall to the soil.

**Soil Evaporation**

Soil evaporation is computed as:
Expand All @@ -770,12 +792,12 @@ r_d = \frac{\text{rdConst}}{u},

Negative (condensation) values are clipped to zero. If snow > 0 then $F^W_{\text{soil,evap}}=0$.

#### Evaporation
#### Total Evaporation

Total evaporation is calculated as the sum of intercepted water, soil evaporation, and sublimation:

\begin{equation}
E = F^W_{\text{trans}} + F^W_{\text{intercept,evap}} + F^W_{\text{soil,evap}} + F^W_{\text{sublim}}
E = F^W_{\text{intercept,evap}} + F^W_{\text{soil,evap}} + F^W_{\text{sublim}}
\end{equation}

### Transpiration
Expand All @@ -794,13 +816,13 @@ Water Use Efficiency (WUE) is defined as the ratio of a constant $K_{\text{WUE}}
#### Potential Transpiration

\begin{equation}
T_{\text{pot}} = \frac{\text{GPP}_{\text{pot}}}{\text{WUE}}
F^W_{\text{trans,pot}} = \frac{\text{GPP}_{\text{pot}}}{\text{WUE}}
\label{eq:Braswell_A14}
\end{equation}

This is equation (A14) from Braswell, et al. (2005).

Potential transpiration $(T_{\text{pot}})$ is calculated as the potential gross primary
Potential transpiration $(F^W_{\text{trans,pot}})$ is calculated as the potential gross primary
production $(\text{GPP}_{\text{pot}})$ divided by WUE.

#### Actual Transpiration
Expand All @@ -812,7 +834,7 @@ F^W_\text{trans} = \min(F^W_\text{trans, pot}, f \cdot W_\text{soil})

This is equation (A15) from Braswell, et al. (2005).

Actual transpiration $(F^W_\text{trans})$ is the minimum of potential transpiration $(F^W_{\text{pot}})$ and the
Actual transpiration $(F^W_\text{trans})$ is the minimum of potential transpiration $(F^W_{\text{trans,pot}})$ and the
fraction $(f)$ of the total soil water $(W_\text{soil})$ that is removable in one day.

## Dependence Functions for Temperature and Moisture
Expand Down
Loading
Loading