Scaling#

Provides scaling functions to convert common parameters to model parameters, and convenience functions for unit conversions of transpiration.

Config parameters that will be provided by the user:

  • \(\mathrm{LAI_p^{(sp)} \ [m^2_{leaf (sp)} / m^2_{ground}]}\): species-specific plot-level LAI

  • \(\mathrm{SD [trees \ hectare^{-1}]}\): stand density [# trees per hectare]

  • DBH (stem diameter at breast height [cm])

  • Sapwood depth [cm]

  • \(\mathrm{A_c^{(sp)} [m^2]}\): Mean crown area (species-specific)

Calculated parameters:

  • species-specific crown-level LAI (LAIc_sp) [m2 leaf (sp) / m2 ground]

  • sapwood area [m2]

  • xylem area index (Aind_x) : [m2 xylem m-2 ground]

calc_Aind_x(xylem_cross_sectional_area, mean_crown_area_sp)#

Calculates the crown-level xylem area index [m2 xylem m-2 crown projection]

Parameters:

  • xylem_cross_sectional_area (float) – sapwood area [m2]

  • mean_crown_area_sp (float) – Mean crown area of species (crown projection to ground) [m2]

calc_LAIc_sp(LAIp_sp, mean_crown_area_sp, stand_density_sp)#

Calculates the crown-level species-specific LAI (LAIc_sp [m2 leaf (sp) / m2 ground projection of crown]), using the plot-level species-specific LAI (LAIp_sp [m2 leaf (sp) / m2 ground in plot]), mean crown area of the species [m2], and the stand density of the species in the plot [# of trees of sp / hectare].

\[LAI_c^{(sp)} = \frac{LAI_p^{(sp)}}{A_c \times 10^{-4} \times SD^{(sp)}}\]
Parameters:

  • LAIp_sp (float) – Plot-level species-specific LAI [m2 leaf (sp) / m2 ground in plot]

  • mean_crown_area_sp (float) – Mean crown area of the species [m2]

  • stand_density_sp (float) – Stand density of the species in the plot [# of trees of sp / hectare]

Returns:

LAIc_sp – Crown-level species-specific LAI [m2 leaf (sp) / m2 ground projection of crown]

Return type:

float

calc_xylem_cross_sectional_area(DBH_cm, active_xylem_depth_cm)#

Calculate xylem cross-sectional area from DBH and active xylem depth

Parameters:

  • DBH (float or array) – Diameter at breast height [cm]

  • active_xylem_depth (float or array) – Active xylem depth [cm]

Returns:

xylem_cross_sectional_area – Cross-sectional area of active xylem [m2]

Return type:

float or array

convert_sapflux_cm3hr_to_mm30min(sapflux_cm3hr)#

Converts aggregated plot-scale sapfluxnet data (in units of m3h20 m-2ground hr-1 to mm 30min-1

Parameters:

sapflux_cm3hr ([cm3h2o hr-1 m-2 plot]) –

Return type:

scaled sapflux in mm 30min-1