diff --git a/.github/workflows/link-check.yml b/.github/workflows/link-check.yml index be8daf08c..cbef067d3 100644 --- a/.github/workflows/link-check.yml +++ b/.github/workflows/link-check.yml @@ -30,6 +30,7 @@ jobs: --format markdown --exclude '^https://doi\.org/' --exclude '^https://russellranch\.ucdavis\.edu' + --exclude '^https://join\.slack\.com' . fail: true env: diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 1b9bf9783..98ee0d11c 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -27,6 +27,7 @@ sections to include in release notes: ### Added - `sipnet-view` tool for visualizing SIPNET output files (#317) +- `leafon` and `leafoff` events for tracking phenological transitions (#326) ### Fixed diff --git a/docs/README.md b/docs/README.md index fa338e4eb..1e0ae9b10 100644 --- a/docs/README.md +++ b/docs/README.md @@ -24,7 +24,7 @@ SIPNET (Simplified Photosynthesis and Evapotranspiration Model) is a lightweight - **Understanding the code:** The [developer docs](model-structure.md) describe architecture, while sections on [testing](developer-guide/testing.md) and [CLI extensions](developer-guide/cli-options.md) cover contributions. - **Project practices:** Review the [Contributing guide](CONTRIBUTING.md), [Code of Conduct](CODE_OF_CONDUCT.md), and [Changelog](CHANGELOG.md) before opening PRs or issues. -Need help? Open an issue on [GitHub](https://github.com/PecanProject/sipnet/issues) or join the [PEcAn community Slack](https://join.slack.com/t/pecanproject/shared_invite/zt-3ile31ylu-r1sMh~esl~7A_AolYNNYLQ). +Need help? Open an issue on [GitHub](https://github.com/PecanProject/sipnet/issues) or join the [PEcAn community Slack](https://join.slack.com/t/pecanproject/shared_invite/zt-3wlzwms7n-mmoLuYsIfaDqp_FRZD1eQQ). ## License diff --git a/docs/model-structure.md b/docs/model-structure.md index 200b8c0de..45a4d3fe3 100644 --- a/docs/model-structure.md +++ b/docs/model-structure.md @@ -1162,6 +1162,32 @@ f_{\text{intercept}} \, F^W_{\text{irrig}}, & I_{\text{irrigation}} = 0 \\ \label{eq:irrig_evap} \end{equation} +### Leaf On/Leaf Off + +Leaf on and leaf off events define the timing of leaf emergence and senescence, respectively. These events directly +specify the amount of carbon added to the leaf carbon pool on the leaf on date, and the fraction of carbon removed from +the leaf carbon pool on the leaf off date. + +When a leaf on event occurs, an amount of carbon (specified by the `leafGrowth` parameter) is transferred from the wood +carbon pool to the leaf carbon pool. As leaf C:N is usually lower than wood C:N, the excess nitrogen +implied by the static C:N ratios is included as part of the plant nitrogen demand. If there is insufficient nitrogen +available for this lump-sum move, nitrogen limitation will occur. + +When a leaf off event occurs, a fraction of the leaf carbon (specified by the `fracLeafFall` parameter) is transferred +from the leaf carbon pool to the litter pool (or soil pool, if the litter pool is not being used). The corresponding +nitrogen (calculated from the leaf C:N ratio) is also transferred to the litter or soil nitrogen pool. + +**Event parameters:** + +| Parameter | Value | Description | +|-----------|----------------------|-------------------| +| Year | integer | Year | +| Day | integer | Day of year | +| Type | `leafon` / `leafoff` | The type of event | + +There are no other parameters needed for these events, as the amount of transfer is determined by the parameters +mentioned above. +