Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
1 change: 1 addition & 0 deletions docs/source/_static/images/4bucketmodel.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -26,11 +26,12 @@ language_info:

This section walks through the steps in generating and updating the
[hydrology](../../../../virtual_ecosystem/models/hydrology/hydrology_model.py)
model which is part of the default Virtual Ecosystem configuration. The key processes
are illustrated in {numref}`hydrology`.
model which is part of the default Virtual Ecosystem configuration. The flow of key
inputs, state variables, and processes are illustrated in {numref}`hydrology`.

The processes [within a grid cell](#within-grid-cell-hydrology) are loosely based
on the LISFLOOD model {cite}`van_der_knijff_lisflood_2010`. The processes
on the LISFLOOD model {cite}`van_der_knijff_lisflood_2010`. These structure and flows of
this '4-Bucket Model' are summarised in {numref}`bucket_model`. The processes
[across the model grid](#across-grid-hydrology) are loosely based on
the [pysheds](https://github.com/mdbartos/pysheds) package.

Expand All @@ -40,9 +41,9 @@ the [pysheds](https://github.com/mdbartos/pysheds) package.
:class: bg-primary
:width: 600px

Hydrology processes in Virtual Ecosystem (click to zoom). Yellow boxes
represent atmospheric input variables, green box and arrows indicate where water
enters and leaves the plant model.
Hydrology inputs, state variables, and processes in Virtual Ecosystem (click to zoom).
Yellow boxes represent atmospheric input variables, green box and arrows indicate where
water enters and leaves the plant model.
:::

```{note}
Expand Down Expand Up @@ -89,6 +90,20 @@ infiltration, bypass flow, percolation (= vertical flow), {term}`soil moisture`
{term}`soil matric potential`, horizontal
sub-surface flow out of the grid cell, and changes in groundwater storage.

:::{figure} ../../_static/images/4bucketmodel.svg
:name: bucket_model
:alt: 4-Bucket Model
:class: bg-primary
:width: 600px

The 4-Bucket Model represented within grid cell hydrology processes in the Virtual
Ecosystem. Red solid arrows indicate downward vertical flow, red dashed arrows show
vertical upward flow. The blue arrows indicate horizontal flow out of the
grid cell with solid lines representing water that flows out of each layer in the
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@vgro it supposed to be red solid arrows indicate upward vertical flow, red dashed arrows show
downward vertical flow.

Copy link
Copy Markdown
Collaborator Author

@vgro vgro Jul 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you're right, well spotted. I fixed it in #949

current time step and dashed lines representing water that originates from upstream
grid cells (previous time step) and flows through the grid cell directly to the stream.
:::

### Canopy interception

Canopy interception is estimated using the following storage-based equation after
Expand Down