Biomass

struct PrescribedBiomassModel{FT, PSAI <: PrescribedAreaIndices, RDTH <: Union{FT, ClimaCore.Fields.Field}} <: AbstractBiomassModel{FT}

A prescribed biomass model where LAI, SAI, RAI, rooting depth, and height are prescribed.

In global run with patches of bare soil, you can "turn off" the canopy model (to get zero root extraction, zero absorption and emission, zero transpiration and sensible heat flux from the canopy), by setting:

• n_leaf = 1
• n_stem = 0
• LAI = SAI = RAI = 0.

If run with PlantHydraulics, this must be consistent with the plant hydraulics model:a plant model can have leaves but no stem, but not vice versa. If n_stem = 0, SAI must be zero.

• plant_area_index: The plant area index model for LAI, SAI, RAI

• rooting_depth: Rooting depth parameter (m) - a characteristic depth below which 1/e of the root mass lies

• height: Canopy height, currently treated as a scalar

PrescribedBiomassModel{FT}(
    domain,
    LAI::AbstractTimeVaryingInput,
    toml_dict::CP.ParamDict;
    SAI::FT = toml_dict["SAI"],
    RAI::FT = toml_dict["RAI"],
    rooting_depth = clm_rooting_depth(domain.space.surface),
    height = toml_dict["canopy_height"]
) where {FT <: AbstractFloat}

Creates a PrescribedBiomassModel on the provided domain, using parameters from toml_dict.

The required argument LAI should be a ClimaUtilities TimeVaryingInput for leaf area index.

The following default parameters are used:

• SAI = 0 (m2/m2) - stem area index
• RAI = 1 (m2/m2) - root area index
• height = 1m

PrescribedBiomassModel{FT}(;LAI::AbstractTimeVaryingInput,
                            SAI::FT,
                            RAI::FT,
                            rooting_depth,
                            height::FT) where {FT}

An outer constructor to help set up the PrescribedBiomassModel from LAI, SAI, and RAI directly, instead of requiring the user to make the area index object first; rooting_depth and height are also required.

PrescribedAreaIndices{FT <:AbstractFloat, F <: AbstractTimeVaryingInput}

A struct containing the area indices of the plants at a specific site; LAI varies in time, while SAI and RAI are fixed in space and time.

• LAI: A function of simulation time t giving the leaf area index (LAI; m2/m2)

• SAI: The constant stem area index (SAI; m2/m2)

• RAI: The constant root area index (RAI; m2/m2)

PrescribedAreaIndices{FT}(
    LAI::AbstractTimeVaryingInput,
    SAI::FT,
    RAI::FT,
) where {FT <: AbstractFloat}

An outer constructor for setting the PrescribedAreaIndices given LAI, SAI, and RAI.