Temperature Responses & Photorespiratory Compensation
Thermal kinetics evaluate scalar rate laws (ConstantResponse, Arrhenius, PeakedArrhenius) at leaf temperature T [K] without embedded reference temperatures or gas constants. Rate bundles assemble all temperature-dependent capacities and Michaelis–Menten constants for Farquhar–von Caemmerer–Berry C3 biochemistry (C3TemperatureResponse, C3Rates) and Johnson & Berry (2021) Cytochrome CytochromeCapacity, CytochromeTemperatureResponse, CytochromeRates), paired with prescribed or explicitly oxygen-scaled photorespiratory compensation points
Walkthroughs: Bonan 11.1 curves, Oxygen response.
Scalar Thermal Response Laws
LeafPhotosynthesis.AbstractTemperatureResponse Type
AbstractTemperatureResponseSupertype of temperature-response laws evaluated by temperature_response: Arrhenius, PeakedArrhenius, ConstantResponse and CytochromeCapacity.
Implementation
A new law subtypes AbstractTemperatureResponse and adds a method temperature_response(law, temperature); the rate bundles accept it in every field.
LeafPhotosynthesis.ConstantResponse Type
ConstantResponse(value)
ConstantResponse(; value)Wrap a temperature-independent continuous scalar parameter value for uniform temperature_response dispatch alongside Arrhenius and PeakedArrhenius.
Requires a finite continuous scalar (AbstractFloat or dual number) and propagates typeof(value + zero(temperature)) so automatic differentiation preserves homogeneous rate types.
Examples
julia> using LeafPhotosynthesis: temperature_response
julia> r = ConstantResponse(0.75);
julia> temperature_response(r, 303.15)
0.75LeafPhotosynthesis.Arrhenius Type
Arrhenius{FT}(; value_ref, activation_energy, temperature_ref, gas_constant)
Arrhenius(value_ref, activation_energy, temperature_ref, gas_constant)Construct an Arrhenius temperature response temperature_ref (T_ref [K]).
activation_energy (E_a) has units of J mol⁻¹ and gas_constant (R) has units of J mol⁻¹ K⁻¹; value_ref (k_ref) carries the units of the quantity being scaled. All scientific parameters are supplied explicitly. Throws ArgumentError unless value_ref and activation_energy are finite and temperature_ref and gas_constant finite and positive.
Examples
julia> using LeafPhotosynthesis: temperature_response
julia> law = Arrhenius(60.0, 65330.0, 298.15, 8.314);
julia> temperature_response(law, 298.15)
60.0LeafPhotosynthesis.PeakedArrhenius Type
PeakedArrhenius(; arrhenius, deactivation_energy, entropy)
PeakedArrhenius(arrhenius, deactivation_energy, entropy)Construct an Arrhenius temperature response with high-temperature thermal inhibition normalized at arrhenius.temperature_ref (T_ref [K]):
deactivation_energy (H_d) is in J mol⁻¹ and entropy (ΔS) is in J mol⁻¹ K⁻¹. Throws ArgumentError unless both are finite.
LeafPhotosynthesis.temperature_response Function
temperature_response(response, temperature)Evaluate response at leaf temperature [K]; the result has the units of the response's reference value. Temperature must be finite and positive: any other value gives NaN (also for ConstantResponse). A response and a temperature of different binary precisions are a MethodError.
Biochemical Rate Bundles
LeafPhotosynthesis.C3TemperatureResponse Type
C3TemperatureResponse(; vcmax, jmax, respiration, kc, ko, gamma_star)Bundle the six C3 biochemical temperature responses (vcmax, jmax, respiration, kc, ko, and gamma_star).
Every field is an AbstractTemperatureResponse; gamma_star may also be an explicit AbstractCompensationPoint component.
LeafPhotosynthesis.C3Rates Type
C3Rates{FT}(; vcmax, jmax, respiration, kc, ko, gamma_star)
C3Rates(vcmax, jmax, respiration, kc, ko, gamma_star)Store evaluated C3 biochemical kinetic parameters at leaf temperature and, when selected, biochemical-site O₂.
vcmax,respiration: μmol CO₂ m⁻² leaf s⁻¹.jmax: μmol electrons m⁻² leaf s⁻¹.kc,ko,gamma_star: Pa.
LeafPhotosynthesis.CytochromeCapacity Type
CytochromeCapacity(; site_density, turnover_rate)
CytochromeCapacity(site_density, turnover_rate)Parameterize Cytochrome b₆f maximum plastoquinol-oxidation capacity from active site density site_density [μmol sites m⁻² leaf] and catalytic turnover law turnover_rate [mol e⁻ mol⁻¹ sites s⁻¹] (Johnson & Berry 2021):
LeafPhotosynthesis.CytochromeTemperatureResponse Type
CytochromeTemperatureResponse(; vcmax, vqmax, respiration, kc, ko, gamma_star,
linear_atp_per_electron, cyclic_atp_per_electron)Bundle temperature and oxygen response laws for Cytochrome b₆f C3 biochemistry (Johnson & Berry 2021).
Every field is an AbstractTemperatureResponse: vqmax a CytochromeCapacity or any law returning μmol e⁻ m⁻² leaf s⁻¹, linear_atp_per_electron (η_L) and cyclic_atp_per_electron (η_C) a ConstantResponse or a temperature law; gamma_star may also be an AbstractCompensationPoint.
LeafPhotosynthesis.CytochromeRates Type
CytochromeRates{FT}(; vcmax, vqmax, respiration, kc, ko, gamma_star,
linear_atp_per_electron, cyclic_atp_per_electron)
CytochromeRates(vcmax, vqmax, respiration, kc, ko, gamma_star,
linear_atp_per_electron, cyclic_atp_per_electron)Store evaluated Cytochrome b₆f kinetic capacities and ATP coupling efficiencies at leaf temperature [K] and biochemical-site O₂ [Pa]:
vcmax,respiration: μmol CO₂ m⁻² leaf s⁻¹.vqmax: μmol electrons m⁻² leaf s⁻¹.kc,ko,gamma_star: Pa.linear_atp_per_electron(η_L),cyclic_atp_per_electron(η_C): mol ATP (mol e⁻)⁻¹.
LeafPhotosynthesis.biochemical_rates Function
biochemical_rates(responses, temperature[, oxygen]) -> C3Rates or CytochromeRatesEvaluate the kinetic rate parameters of responses (C3TemperatureResponse or CytochromeTemperatureResponse) at leaf temperature [K] and, when given, biochemical-site oxygen partial pressure [Pa], returning a C3Rates or a CytochromeRates.
The three-argument form passes oxygen to compensation_point for gamma_star; the two-argument form evaluates temperature-only laws, so it is a MethodError for an OxygenScaledCompensationPoint. A custom rate bundle needs only the two-argument method: the three-argument call falls back to it.
Photorespiratory Compensation Point
LeafPhotosynthesis.AbstractCompensationPoint Type
AbstractCompensationPointSupertype for photorespiratory CO₂ compensation point (Γ* [Pa]) parameterizations.
LeafPhotosynthesis.PrescribedCompensationPoint Type
PrescribedCompensationPoint(response)
PrescribedCompensationPoint(; response)Wrap a temperature-only Γ* law response [Pa] calibrated at a fixed O₂ level.
The caller must supply an oxygen partial pressure compatible with response's calibration; this component does not infer oxygen scaling and is distinct from the signed or clipped carbon-assimilation policy.
LeafPhotosynthesis.OxygenScaledCompensationPoint Type
OxygenScaledCompensationPoint(response, reference_oxygen)
OxygenScaledCompensationPoint(; response, reference_oxygen)Scale a reference Γ* temperature law linearly with biochemical-site oxygen:
response evaluates Γ*(T, O_ref) [Pa] at the finite positive biochemical O₂ partial pressure reference_oxygen [Pa]. No ambient O₂ default or stoichiometric recalibration is introduced, and evaluation without an explicit oxygen argument is unsupported. The scalar law returns exact zero at oxygen == 0.
LeafPhotosynthesis.compensation_point Function
compensation_point(response, temperature, oxygen)Evaluate the photorespiratory CO₂ compensation point Γ* [Pa] at leaf temperature [K] and biochemical-site oxygen partial pressure [Pa].
Plain temperature laws delegate to temperature_response; implement a method on compensation_point when adding a new AbstractCompensationPoint.