tleaves {tealeaves}

tleaves: find leaf temperatures for multiple parameter sets

Description

tleaves: find leaf temperatures for multiple parameter sets

tleaf: find leaf temperatures for a single parameter set

Usage

tleaves(
  leaf_par,
  enviro_par,
  constants,
  progress = TRUE,
  quiet = FALSE,
  set_units = TRUE,
  parallel = FALSE
)

tleaf(leaf_par, enviro_par, constants, quiet = FALSE, set_units = TRUE)

Arguments

leaf_par

A list of leaf parameters. This can be generated using the make_leafpar function.

enviro_par

A list of environmental parameters. This can be generated using the make_enviropar function.

constants

A list of physical constants. This can be generated using the make_constants function.

progress

Logical. Should a progress bar be displayed?

quiet

Logical. Should messages be displayed?

set_units

Logical. Should units be set? The function is faster when FALSE, but input must be in correct units or else results will be incorrect without any warning.

parallel

Logical. Should parallel processing be used via future_map?

Value

tleaves:

A tibble with the following units columns

Input:
abs_l	Absorbtivity of longwave radiation (unitless)
abs_s	Absorbtivity of shortwave radiation (unitless)
g_sw	Stomatal conductance to H2O (\mumol H2O / (m^2 s Pa))
g_uw	Cuticular conductance to H2O (\mumol H2O / (m^2 s Pa))
leafsize Leaf characteristic dimension	(m)
logit_sr	Stomatal ratio (logit transformed; unitless)
P	Atmospheric pressure (kPa)
RH	Relative humidity (unitless)
S_lw	incident long-wave radiation flux density (W / m^2)
S_sw	incident short-wave (solar) radiation flux density (W / m^2)
T_air	Air temperature (K)
wind	Wind speed (m / s)
Output:
T_leaf	Equilibrium leaf tempearture (K)
value	Leaf energy balance (W / m^2) at tleaf
convergence	Convergence code (0 = converged)
R_abs	Total absorbed radiation (W / m^2; see .get_Rabs)
S_r	Thermal infrared radiation loss (W / m^2; see .get_Sr)
H	Sensible heat flux density (W / m^2; see .get_H)
L	Latent heat flux density (W / m^2; see .get_L)
E	Evapotranspiration (mol H2O/ (m^2 s))

tleaf:

A data.frame with the following numeric columns:

T_leaf	Equilibrium leaf temperature (K)
value	Leaf energy balance (W / m^2) at tleaf
convergence	Convergence code (0 = converged)
R_abs	Total absorbed radiation (W / m^2; see .get_Rabs)
S_r	Longwave re-radiation (W / m^2; see .get_Sr)
H	Sensible heat flux density (W / m^2; see .get_H)
L	Latent heat flux density (W / m^2; see .get_L)
E	Evapotranspiration (mol H2O/ (m^2 s))

Examples

# tleaf for single parameter set:

leaf_par <- make_leafpar()
enviro_par <- make_enviropar()
constants <- make_constants()
tleaf(leaf_par, enviro_par, constants)

# tleaves for multiple parameter set:

enviro_par <- make_enviropar(
  replace = list(
    T_air = set_units(c(293.15, 298.15), K)
  )
)
tleaves(leaf_par, enviro_par, constants)