API

abstract type AbstractHydraulicOrgan{FT}

Hierarchy of AbstractHydraulicOrgan

• LeafHydraulics
• RootHydraulics
• StemHydraulics

mutable struct LeafHydraulics{FT}

A struct that contains leaf hydraulics information.

Fields

• N::Int64

• area::Any

: Leaf area [m²]

• k_ox::Any

: Maximal extra-xylary hydraulic conductance [mol s⁻¹ MPa⁻¹ m⁻²]

• k_sla::Any

: Maximal leaf hydraulic conductance per leaf area [mol s⁻¹ MPa⁻¹ m⁻²]

• vc::Land.PlantHydraulics.AbstractXylemVC{FT} where FT

: Vulnerability curve

• p_crt::Any

: Critical xylem pressure [MPa]

• flow::Any

: Flow rate in the xylem [mol s⁻¹]

• p_dos::Any

: Leaf xylem water pressure at the downstream end of leaf xylem [MPa]

• p_leaf::Any

: Leaf end water pressure at air-water interface [MPa]

• p_ups::Any

: Leaf xylem water pressure at the leaf base (upstream) [MPa]

• k_element::Vector

: List of leaf k_max per element [mol s⁻¹ MPa⁻¹ m⁻²]

• k_history::Vector

: List of leaf kr history per element

• p_element::Vector

: List of xylem water pressure [MPa]

• p_history::Vector

: List of xylem water pressure history (normalized to 298.15 K) [MPa]

• f_st::Any

: Relative surface tension

• f_vis::Any

: Relative viscosity

• T_old::Any

: Temperature memory [K]

• T_sap::Any

: Upstream sap temperature [K]

• pv::Land.PlantHydraulics.AbstractCapacity{FT} where FT

: Pressure volume curve for storage

• p_storage::Any

: Pressure of storage

• v_maximum::Any

: Total capaciatance at Ψ = 0 [mol m⁻²]

• v_storage::Any

: Current capaciatance at Ψ_leaf [mol m⁻²]

• q_in::Any

: Flow rate into the tissue (used for non-steady state) [mol m⁻² s⁻¹]

• q_out::Any

: Flow rate out of the tissue (used for non-steady state) [mol m⁻² s⁻¹]

mutable struct RootHydraulics{FT}

A struct that contains root hydraulics information.

Fields

• N::Int64

• area::Any

: Root cross-section area [m²]

• k_max::Any

: Maximal hydraulic conductance [mol s⁻¹ MPa⁻¹]

• k_s::Any

: Maximal xylem hydraulic conductivity [mol s⁻¹ MPa⁻¹ m⁻²]

• vc::Land.PlantHydraulics.AbstractXylemVC{FT} where FT

: Vulnerability curve

• Δh::Any

: Root z difference [m]

• k_rhiz::Any

: Rhizosphere conductance [mol s⁻¹ MPa⁻¹]

• sh::Union{Land.PlantHydraulics.BrooksCorey{FT}, Land.PlantHydraulics.VanGenuchten{FT}} where FT

: Soil hydraulics

• flow::Any

: Flow rate in the xylem [mol s⁻¹]

• p_dos::Any

: Xylem water pressure at the downstream end of xylem [MPa]

• p_rhiz::Any

: Xylem-rhizosphere interface water pressure [MPa]

• p_ups::Any

: Soil matrix potential [MPa]

• p_osm::Any

: Soil osmotic potential at 298.15 K `[MPa]

• k_element::Vector

: List of k_max per element [mol s⁻¹ MPa⁻¹ m⁻²]

• k_history::Vector

: List of kr history per element

• p_element::Vector

: List of xylem water pressure [MPa]

• p_gravity::Vector

: List of pressure drop caused by gravity [MPa]

• p_history::Vector

: List of xylem water pressure history (normalized to 298.15 K) [MPa]

• f_st::Any

: Relative surface tension

• f_vis::Any

: Relative viscosity

• T_old::Any

: Temperature memory [K]

• T_sap::Any

: Upstream sap temperature [K]

• pv::Land.PlantHydraulics.AbstractCapacity{FT} where FT

: Pressure volume curve for storage

• p_storage::Vector

: Pressure of storage per element

• v_maximum::Vector

: Maximal storage per element [mol]

• v_storage::Vector

: Storage per element [mol]

• q_element::Vector

: List of xylem water flow [mol m⁻²]

• q_buffer::Vector

: List of buffer water flow [mol m⁻²]

• q_diff::Vector

: List of diiferntial water flow [mol m⁻²]

• q_in::Any

: Flow rate into the tissue (used for non-steady state) [mol s⁻¹]

• q_out::Any

: Flow rate out of the tissue (used for non-steady state) [mol s⁻¹]

mutable struct StemHydraulics{FT}

A struct that contains stem hydraulics information.

Fields

• N::Int64

• area::Any

: Stem cross-section area [m²]

• k_max::Any

: Maximal hydraulic conductance [mol s⁻¹ MPa⁻¹]

• k_s::Any

: Maximal xylem hydraulic conductivity [mol s⁻¹ MPa⁻¹ m⁻²]

• vc::Land.PlantHydraulics.AbstractXylemVC{FT} where FT

: Vulnerability curve

• Δh::Any

: Stem height difference [m]

• flow::Any

: Flow rate in the xylem [mol s⁻¹]

• p_dos::Any

: Xylem water pressure at the downstream end of xylem [MPa]

• p_ups::Any

: Xylem water pressure at the base (upstream) [MPa]

• k_element::Vector

: List of k_max per element [mol s⁻¹ MPa⁻¹ m⁻²]

• k_history::Vector

: List of kr history per element

• p_element::Vector

: List of xylem water pressure [MPa]

• p_gravity::Vector

: List of pressure drop caused by gravity [MPa]

• p_history::Vector

: List of xylem water pressure history (normalized to 298.15 K) [MPa]

• f_st::Any

: Relative surface tension

• f_vis::Any

: Relative viscosity

• T_old::Any

: Temperature memory [K]

• T_sap::Any

: Upstream sap temperature [K]

• pv::Land.PlantHydraulics.AbstractCapacity{FT} where FT

: Pressure volume curve for storage

• p_storage::Vector

: Pressure of storage per element

• v_maximum::Vector

: Maximal storage per element [mol]

• v_storage::Vector

: Storage per element [mol]

• q_element::Vector

: List of xylem water flow [mol m⁻²]

• q_in::Any

: Flow rate into the tissue (used for non-steady state) [mol s⁻¹]

• q_out::Any

: Flow rate out of the tissue (used for non-steady state) [mol s⁻¹]

abstract type AbstractPlantOrganism{FT}

Hierachy of AbstractPlantOrganism

• GrassLikeOrganism
• PalmLikeOrganism
• TreeLikeOrganism

mutable struct GrassLikeOrganism{FT}

A plant hydraulic system like a grass, which contains multiple root layers, and multiple canopy layers. No trunk or branch system applies.

Fields

• n_root::Int64

: Root Layers

• n_canopy::Int64

: Canopy Layers

• roots::Array{Land.PlantHydraulics.RootHydraulics{FT}, 1} where FT

: Roots system

• leaves::Array{Land.PlantHydraulics.LeafHydraulics{FT}, 1} where FT

: Leaves

• root_index_in_soil::Vector{Int64}

: Corresponding soil layer per root layer

• canopy_index_in_air::Vector{Int64}

: Corresponding air layer per canopy layer

• cache_k::Vector

: Conductances for each layer at given flow

• cache_p::Vector

: Pressure for each layer at given flow

• cache_q::Vector

: Flow rate

mutable struct PalmLikeOrganism{FT}

A plant hydraulic system like a palm, which contains multiple root layers, one trunk, and multiple canopy layers. No branch system applies.

Fields

• n_root::Int64

: Root Layers

• n_canopy::Int64

: Canopy Layers

• roots::Array{Land.PlantHydraulics.RootHydraulics{FT}, 1} where FT

: Roots system

• trunk::Land.PlantHydraulics.StemHydraulics

: Trunk

• leaves::Array{Land.PlantHydraulics.LeafHydraulics{FT}, 1} where FT

: Leaves

• root_index_in_soil::Vector{Int64}

: Corresponding soil layer per root layer

• canopy_index_in_air::Vector{Int64}

: Corresponding air layer per canopy layer

• cache_k::Vector

: Conductances for each layer at given flow

• cache_p::Vector

: Pressure for each layer at given flow

• cache_q::Vector

: Flow rate

mutable struct TreeLikeOrganism{FT}

A plant hydraulic system like a tree, which contains multiple root layers, one trunk, and multiple branch and canopy layers.

Fields

• n_root::Int64

: Root Layers

• n_canopy::Int64

: Canopy Layers

• roots::Array{Land.PlantHydraulics.RootHydraulics{FT}, 1} where FT

: Roots system

• trunk::Land.PlantHydraulics.StemHydraulics

: Trunk

• branch::Array{Land.PlantHydraulics.StemHydraulics{FT}, 1} where FT

: Branch system

• leaves::Array{Land.PlantHydraulics.LeafHydraulics{FT}, 1} where FT

: Leaves

• root_index_in_soil::Vector{Int64}

: Corresponding soil layer per root layer

• canopy_index_in_air::Vector{Int64}

: Corresponding air layer per canopy layer

• cache_k::Vector

: Conductances for each layer at given flow

• cache_p::Vector

: Pressure for each layer at given flow

• cache_q::Vector

: Flow rate

mutable struct TreeSimple{FT}

A plant hydraulic system with one root, one stem, and one leaf for testing purpose

Fields

• root::Land.PlantHydraulics.RootHydraulics

: Root

• stem::Land.PlantHydraulics.StemHydraulics

: Stem

• leaf::Land.PlantHydraulics.LeafHydraulics

: Leaf

• krs::Vector

: Relative hydraulic conductance

create_grass(
            z_root::FT,
            z_canopy::FT,
            soil_bounds::Array{FT,1},
            air_bounds::Array{FT,1}
) where {FT<:AbstractFloat}

Create a GrassLikeOrganism, given

• z_root Maximal root depth (negative value)
• z_canopy Maximal canopy height (positive value)
• soil_bounds Array of soil layer boundaries starting from 0
• air_bounds Array of air layer boundaries starting from 0

create_palm(z_root::FT,
            z_trunk::FT,
            z_canopy::FT,
            soil_bounds::Array{FT,1},
            air_bounds::Array{FT,1}
) where {FT<:AbstractFloat}

Create a PalmLikeOrganism, given

• z_root Maximal root depth (negative value)
• z_trunk Maximal trunk height (positive value)
• z_canopy Maximal canopy height (positive value)
• soil_bounds Array of soil layer boundaries starting from 0
• air_bounds Array of air layer boundaries starting from 0

create_tree(z_root::FT,
            z_trunk::FT,
            z_canopy::FT,
            soil_bounds::Array{FT,1},
            air_bounds::Array{FT,1}
) where {FT<:AbstractFloat}

Create a TreeLikeOrganism, given

• z_root Maximal root depth (negative value)
• z_trunk Maximal trunk height (positive value)
• z_canopy Maximal canopy height (positive value)
• soil_bounds Array of soil layer boundaries starting from 0
• air_bounds Array of air layer boundaries starting from 0

abstract type AbstractXylemVC{FT<:AbstractFloat}

Hierachy of AbstractXylemVC

• LogisticSingle
• PowerSingle
• WeibullSingle
• WeibullDual

mutable struct WeibullDual{FT} <: Land.PlantHydraulics.AbstractXylemVC{FT}

Struct that contains dual Weibull function parameters.

Fields

• b1::Any

: B of first part [MPa]

• c1::Any

: C of first part

• f1::Any

: F of first part

• b2::Any

: B of second part [MPa]

• c2::Any

: C of second part

• f2::Any

: F of second part

mutable struct WeibullSingle{FT} <: Land.PlantHydraulics.AbstractXylemVC{FT}

Struct that contains single Weibull function parameters.

Fields

• b::Any

: B of first part [MPa]

• c::Any

: C of first part

mutable struct LogisticSingle{FT} <: Land.PlantHydraulics.AbstractXylemVC{FT}

Struct that contains single modified logistc function parameters.

Fields

• a::Any

: Multiplier to exp

• b::Any

: Multiplier to P [MPa⁻¹]

mutable struct PowerSingle{FT} <: Land.PlantHydraulics.AbstractXylemVC{FT}

Struct that contains single power function parameters.

Fields

• a::Any

: Multiplier to power function, [MPa⁻ᵇ]

• b::Any

: Power to pressure

xylem_k_ratio(
            vc::AbstractXylemVC{FT},
            p_25::FT,
            vis::FT
) where {FT<:AbstractFloat}

Returns the relative hydraulic conductance, given

• vc Xylem vulnerability curve
• p Xylem pressure at 298.15 K in [MPa]
• p_25 Equivalent xylem pressure at 298.15 K in [MPa]
• vis Relative viscosity. If missing, vis = 1.

xylem_p_crit(vc::AbstractXylemVC{FT}, f_st::FT) where {FT<:AbstractFloat}

Returns the relative hydraulic conductance, given

• vc Xylem vulnerability curve
• st Relative surface tension. If missing, vis = 1.

abstract type AbstractSoilVC{FT}

Hierachy of AbstractSoilVC:

• BrooksCorey
• VanGenuchten

mutable struct BrooksCorey{FT<:AbstractFloat}

Brooks Corey soil parameters

Fields

• stype::String

: Soil type

• b::Any

: Soil b

• ϕs::Any

: ϕ at saturation [MPa]

• Θs::Any

: Soil water content (Θ) at saturation

• Θr::Any

: Residual soil water content

mutable struct VanGenuchten{FT<:AbstractFloat}

Van Gunechten soil parameters

Fields

• stype::String

: Soil type

• α::Any

: Soil α is related to the inverse of the air entry suction, α > 0

• n::Any

: Soil n is Measure of the pore-size distribution

• m::Any

: Soil m = 1 - 1/n

• Θs::Any

: Soil water content (Θ) at saturation

• Θr::Any

: Residual soil water content

create_soil_VC(
            vc::AbstractSoilVC{FT},
            name::String,
            α::Number,
            n::Number,
            Θs::Number,
            Θr::Number
) where {FT<:AbstractFloat}
create_soil_VC(
            vc::AbstractSoilVC{FT},
            name::String
) where {FT<:AbstractFloat}

Create a AbstractSoilVC type of soil VC, given

• vc AbstractSoilVC type identifier
• name Soil type name. Supported names include
  • "Sand"
  • "Loamy Sand"
  • "Sandy Loam"
  • "Loam"
  • "Sandy Clay Loam"
  • "Silt Loam"
  • "Silt"
  • "Clay Loam"
  • "Silty Clay Loam"
  • "Sandy Clay"
  • "Silty Clay"
  • "Clay"
• α Soil α
• n Soil n
• Θs SWC at saturation
• Θr Residual SWC

fit_soil_VC!(
            vc_vG::VanGenuchten{FT},
            vc_BC::BrooksCorey{FT}
) where {FT<:AbstractFloat}

Update BrooksCorey setup from known VanGenuchten parameters, given

• vc_vG VanGenuchten type soil VC
• vc_BC BrooksCorey type soil VC

soil_erwc(sh::AbstractSoilVC{FT}, p_25::FT) where {FT<:AbstractFloat}

Returns the Effective relative water content of the soil $\frac{Θ - Θr}{Θs - Θr}$, given

• sh BrooksCorey or VanGenuchten type soil hydraulics
• p_25 Matrix water potential equivalent to 25 degree C, with surface tension

correction

soil_rwc(sh::AbstractSoilVC{FT}, p_25::FT) where {FT<:AbstractFloat}

Returns the relative soil water content, given

• sh BrooksCorey or VanGenuchten type soil hydraulics
• p_25 Matrix water potential equivalent to 25 degree C, with surface tension

correction

soil_swc(sh::AbstractSoilVC{FT}, p_25::FT) where {FT<:AbstractFloat}

Returns the soil water content, given

• sh BrooksCorey or VanGenuchten type soil hydraulics
• p_25 Matrix water potential equivalent to 25 degree C, with surface tension

correction

soil_k_ratio_erwc(
            sh::AbstractSoilVC{FT},
            erwc::FT
) where {FT<:AbstractFloat}

Return the soil k relative to maximal k, given

• sh BrooksCorey or VanGenuchten type soil hydraulics
• erwc Effective relative soil water content ($\frac{Θs - Θr}{Θs - Θ}$)

soil_k_ratio_rwc(sh::AbstractSoilVC{FT}, rwc::FT) where {FT<:AbstractFloat}

Return the soil k relative to maximal k, given

• sh BrooksCorey or VanGenuchten type soil hydraulics
• rwc Relative soil water content

soil_k_ratio_swc(sh::AbstractSoilVC{FT}, swc::FT) where {FT<:AbstractFloat}

Return the soil k relative to maximal k, given

• sh BrooksCorey or VanGenuchten type soil hydraulics
• swc Relative soil water content

soil_k_ratio_p25(
            sh::AbstractSoilVC{FT},
            p_25::FT
) where {FT<:AbstractFloat}

Return the soil k relative to maximal k, given

• sh AbstractSoilVC type soil hydraulics
• p_25 Matrix water potential equivalent to 25 degree C, with surface tension

soil_p_25_erwc(sh::AbstractSoilVC{FT}, erwc::FT) where {FT<:AbstractFloat}

Returns the Relative water content of the soil, given

• sh BrooksCorey or VanGenuchten type soil hydraulics
• erwc Effectibe relative soil water content ($\frac{Θs - Θr}{Θs - Θ}$)

Note that this function returns the matrix potential of water, not water potential. Also, the potential is that at 25 degree C, not yet been corrected for temperature effect on surface tension.

soil_p_25_rwc(sh::AbstractSoilVC{FT}, rwc::FT) where {FT<:AbstractFloat}

Returns the Relative water content of the soil, given

• sh BrooksCorey or VanGenuchten type soil hydraulics
• rwc Relative soil water content

Note that this function returns the matrix potential of water, not water potential. Also, the potential is that at 25 degree C, not yet been corrected for temperature effect on surface tension.

soil_p_25_swc(sh::AbstractSoilVC{FT}, rwc::FT) where {FT<:AbstractFloat}

Returns the Relative water content of the soil, given

• sh BrooksCorey or VanGenuchten type soil hydraulics
• swc Soil water content

Note that this function returns the matrix potential of water, not water potential. Also, the potential is that at 25 degree C, not yet been corrected for temperature effect on surface tension.

end_pressure(
            leaf::LeafHydraulics{FT},
            flow::FT
) where {FT<:AbstractFloat}
end_pressure(
            root::RootHydraulics{FT},
            flow::FT
) where {FT<:AbstractFloat}
end_pressure(
            stem::StemHydraulics{FT},
            flow::FT
) where {FT<:AbstractFloat}
end_pressure(
            tree::TreeSimple{FT},
            flow::FT
) where {FT<:AbstractFloat}
end_pressure(
            tree::TreeSimple{FT},
            f_sl::FT,
            f_sh::FT,
            r_sl::FT
) where {FT<:AbstractFloat}

Return the xylen end pressure(s) from flow rate(s), given

• leaf LeafHydraulics type struct
• flow Flow rate (per leaf area for LeafHydraulics)
• root RootHydraulics type struct
• stem StemHydraulics type struct
• tree TreeSimple type struct
• f_sl Flow rate to sunlit leaves
• f_sh Flow rate to shaded leaves
• r_sl Fraction of sunlit leaves

Note, gravity is accounted for in root and stem; rhizosphere conductance is accounted for in root; extra-xylary conductance is not accounted for in leaf here because it calculates xylem end pressure.

pressure_profile!(
            leaf::LeafHydraulics{FT},
            flow::FT;
            update::Bool = true
) where {FT<:AbstractFloat}
pressure_profile!(
            root::RootHydraulics{FT},
            flow::FT;
            update::Bool = true
) where {FT<:AbstractFloat}
pressure_profile!(
            root::RootHydraulics{FT},
            q_in::FT,
            flow::Array{FT,1};
            update::Bool = true
) where {FT<:AbstractFloat}
pressure_profile!(
            stem::StemHydraulics{FT},
            flow::FT;
            update::Bool = true
) where {FT<:AbstractFloat}
pressure_profile!(
            stem::StemHydraulics{FT},
            flow::Array{FT,1};
            update::Bool = true
) where {FT<:AbstractFloat}
pressure_profile!(
            tree::TreeSimple{FT},
            p_soil::FT,
            flow::FT;
            update::Bool = true
) where {FT<:AbstractFloat}
pressure_profile!(
            tree::TreeSimple{FT},
            p_soil::FT,
            f_sl::FT,
            f_sh::FT,
            r_sl::FT;
            update::Bool = true
) where {FT<:AbstractFloat}

Update the pressure profile, given

• leaf LeafHydraulics type struct
• root RootHydraulics type struct
• stem StemHydraulics type struct
• tree TreeSimple type struct
• p_soil Soil water potential
• flow Flow rate (per leaf area for LeafHydraulics)
• f_sl Flow rate to sunlit leaves
• f_sh Flow rate to shaded leaves
• r_sl Fraction of sunlit leaves
• update Optional. If true, update drought legacy. Default is true for TreeSimple but false for others using capacitance

inititialize_legacy!(
            hs::Union{LeafHydraulics,RootHydraulics,StemHydraulics})
inititialize_legacy!(tree::GrassLikeOrganism)
inititialize_legacy!(tree::PalmLikeOrganism)
inititialize_legacy!(tree::TreeLikeOrganism)
inititialize_legacy!(tree::TreeSimple)

Initialize the drought legacy effects in the xylem, given

• hs [AbstractHydraulicOrgan] type struct
• tree TreeSimple type struct

abstract type AbstractFlowMode

Hierarchy of AbstractFlowMode

• SteadyStateMode
• NonSteadyStateMode

struct NonSteadyStateMode <: AbstractFlowMode

struct SteadyStateMode <: AbstractFlowMode

buffer_rate(pv::AbstractCapacity{FT}) where {FT<:AbstractFloat}

Return the buffer rate, given

• pv AbstractCapacity type struct

Note that only symplastic water can be used as capacitance

xylem_flow(root::RootHydraulics{FT},
           pressure::FT,
           ini::FT = FT(1)
) where {FT<:AbstractFloat}

Calculate the flow rate from a given tree base pressure, given

• root RootHydraulics type struct
• pressure Given tree base pressure in [MPa]
• ini Initial guess

root_pk(root::RootHydraulics{FT},
        flow::FT
) where {FT<:AbstractFloat}
root_pk(root::RootHydraulics{FT},
        q_in::FT,
        flow::Array{FT,1}
) where {FT<:AbstractFloat}

Return root xylem end pressure and root hydraulic conductance (reverse of summed resistance), given

• root RootHydraulics struct
• flow Given flow rate(s) in the root layer, array for non-steady state with capacitance enabled
• q_in Flow rate into the root

roots_flow!(roots::Array{RootHydraulics{FT},1},
            ks::Array{FT,1},
            ps::Array{FT,1},
            qs::Array{FT,1},
            flow::FT,
            recalculate::Bool
) where {FT<:AbstractFloat}
roots_flow!(roots::Array{RootHydraulics{FT},1},
            ks::Array{FT,1},
            ps::Array{FT,1},
            qs::Array{FT,1},
            flow::FT
) where {FT<:AbstractFloat}
roots_flow!(plant::Union{GrassLikeOrganism{FT},
                         PalmLikeOrganism{FT},
                         TreeLikeOrganism{FT}},
            flow::FT
) where {FT<:AbstractFloat}

Recalculate the flow rates in the root from the pressure and conductance profiles in each root at non-steady state, given

• roots Array of RootHydraulics structs
• ks Container for conductance in each root layer
• ps Container for end xylem pressure in each layer
• qs Container for flow rate out of each layer
• flow Total flow rate out of the roots
• recalculate A paceholder indicator of recalculating root flow (useless)
• plant AbstractPlantOrganism type struct

xylem_risk(hs::LeafHydraulics{FT}, flow::FT) where {FT<:AbstractFloat}

Evaluate the hydraulic risk at the end of leaf xylem, given

• hs LeafHydraulics type struct
• flow Flow rate (per leaf area)

critical_flow(
            hs::LeafHydraulics{FT},
            ini::FT = FT(0.5)
) where {FT<:AbstractFloat}
critical_flow(
            tree::TreeSimple{FT},
            ini::FT = FT(0.5)
) where {FT<:AbstractFloat}

Calculate the critical flow rate (K ≈ 0), given

• hs LeafHydraulics type struct
• ini Initial guess
• tree TreeSimple type struct

Note, for the safety of no NaN, update critical_flow when ΔP >= -0.01

plant_conductances!(tree::TreeSimple{FT}) where {FT<:AbstractFloat}

Update plant total hydraulic information in each element and whole plant, given

• tree TreeSimple type struct

temperature_effects!(
            hs::LeafHydraulics{FT}
) where {FT<:AbstractFloat}
temperature_effects!(
            hs::AbstractHydraulicOrgan{FT}
) where {FT<:AbstractFloat}
temperature_effects!(
            hs::AbstractHydraulicOrgan{FT},
            T::FT
) where {FT<:AbstractFloat}
temperature_effects!(
            tree::TreeSimple{FT}
) where {FT<:AbstractFloat}

Update temperature effetcs on hydralic system, given

• hs AbstractHydraulicOrgan type struct
• T Given temperature
• tree TreeSimple type struct

abstract type AbstractCapacity{FT<:AbstractFloat}

Hierachy of AbstractCapacity

• PVCurveLinear
• PVCurveSegmented

mutable struct PVCurveLinear{FT<:AbstractFloat} <: Land.PlantHydraulics.AbstractCapacity{FT<:AbstractFloat}

Struct that contains information for linear PV curve

Fields

• slope::AbstractFloat

: Slope of the linear PV curve (relative to maximum) [MPa⁻¹]

• k_refill::AbstractFloat

: Conductance for refilling (relative to maximum) [MPa⁻¹ s⁻¹]

mutable struct PVCurveSegmented{FT} <: Land.PlantHydraulics.AbstractCapacity{FT}

p_from_volume(
            pv::AbstractCapacity{FT},
            rvol::FT,
            T::FT
) where {FT<:AbstractFloat}

Calculate equilibrium pressure from relative volume, given

• pv AbstractCapacity type of struct

update_PVF!(hs::LeafHydraulics{FT}, Δt::FT) where {FT<:AbstractFloat}
update_PVF!(hs::StemHydraulics{FT}, Δt::FT) where {FT<:AbstractFloat}
update_PVF!(hs::RootHydraulics{FT}, Δt::FT) where {FT<:AbstractFloat}
update_PVF!(hs::RootHydraulics{FT},
            Δt::FT,
            nss::Bool
) where {FT<:AbstractFloat}
update_PVF!(roots::Array{RootHydraulics{FT},1},
            ks::Array{FT,1},
            ps::Array{FT,1},
            qs::Array{FT,1},
            q_sum::FT,
            Δt::FT
) where {FT<:AbstractFloat}
update_PVF!(tree::GrassLikeOrganism{FT}, Δt::FT) where {FT<:AbstractFloat}
update_PVF!(tree::PalmLikeOrganism{FT}, Δt::FT) where {FT<:AbstractFloat}
update_PVF!(tree::TreeLikeOrganism{FT}, Δt::FT) where {FT<:AbstractFloat}

Update pressure, capacitance, and flow rates in hydraulic system, given

• hs AbstractHydraulicOrgan or AbstractPlantOrganism type struct
• Δt Time interval
• nss NonSteadyStateMode placeholder (useless)
• ks Container for conductance in each root layer
• ps Container for end xylem pressure in each layer
• qs Container for flow rate out of each layer
• q_sum Total flow rate out of the roots
• tree GrassLikeOrganism, PalmLikeOrganism, or TreeLikeOrganism type struct

Note that this function only updates the equilibrium pressure in the tissue, but not the xylem flow pressure. The difference between the two pressures is used to drive water exchange between xylem and capacictance tissues.