Carbon Assimilation, Rate Limitation & Turnover
Photosynthetic demand components (C3Photosynthesis, CytochromePhotosynthesis, both subtypes of AbstractC3Photosynthesis, whose leaf entry points are shared) combine Rubisco-limited and electron-transport-limited assimilation via explicit colimitation rules (MinimumLimitation, SerialLimitation, QuadraticLimitation) and respiration sign policies (SignedAssimilation, NonnegativeAssimilation). biochemical_turnover diagnoses gross carboxylation, photorespiratory oxygenation, and realized linear electron flow separately from light-limited electron capacity, remaining regular across the CO₂ compensation point.
Walkthroughs: Biochemical turnover, Bonan 11.1 curves.
Photosynthesis Demand Components
LeafPhotosynthesis.AbstractPhotosynthesis Type
AbstractPhotosynthesisSupertype for leaf photosynthetic biochemistry components implementing photosynthesize.
LeafPhotosynthesis.AbstractC3Photosynthesis Type
AbstractC3Photosynthesis{L,C} <: AbstractPhotosynthesisSupertype for C3 biochemistry that co-limits Rubisco carboxylation and a light-driven electron supply with carbon co-limitation L (AbstractColimitation) and treatment C (AbstractAssimilationSign) of assimilation below Γ*.
C3Photosynthesis and CytochromePhotosynthesis are its subtypes. The leaf entry points photosynthesize, biochemical_turnover, gas_exchange, equilibrium_gas_exchange, assimilation_sensitivity and the coupled oxygen_exchange are written once for this supertype. The methods through which they reach a subtype are internal, not an extension interface: a new electron-supply model is added inside the package.
LeafPhotosynthesis.C3Photosynthesis Type
C3Photosynthesis(; temperature, electron_transport, stoichiometry, limitation,
assimilation_sign)
C3Photosynthesis(temperature, electron_transport, stoichiometry, limitation,
assimilation_sign)Compose Farquhar–von Caemmerer–Berry C3 biochemistry from concrete temperature (C3TemperatureResponse), electron_transport (ElectronTransportParameters), stoichiometry (C3Stoichiometry), limitation (AbstractColimitation) and assimilation_sign (AbstractAssimilationSign) components.
C3Photosynthesis holds immutable parameters only, with no per-leaf arrays, scratch buffers, or hidden empirical defaults. Components of different binary precisions are a MethodError.
LeafPhotosynthesis.CytochromePhotosynthesis Type
CytochromePhotosynthesis(; temperature, electron_transport, stoichiometry,
limitation, assimilation_sign)
CytochromePhotosynthesis(temperature, electron_transport, stoichiometry,
limitation, assimilation_sign)Compose steady-state C3 photosynthesis governed by Cytochrome b₆f plastoquinol oxidation, PSI photochemistry, and coupled linear/cyclic ATP–NADPH stoichiometry (Johnson & Berry 2021) from immutable components: temperature (CytochromeTemperatureResponse), electron_transport (CytochromeElectronParameters), stoichiometry (CytochromeStoichiometry), the carbon limitation (AbstractColimitation) and assimilation_sign (AbstractAssimilationSign). Components of different binary precisions are a MethodError.
Rate Colimitation & Sign Policies
LeafPhotosynthesis.AbstractColimitation Type
AbstractColimitationSupertype of the rules colimit uses to combine two competing rates: MinimumLimitation, SerialLimitation and QuadraticLimitation.
LeafPhotosynthesis.MinimumLimitation Type
MinimumLimitation()Select the exact minimum min(a, b) of two competing biochemical capacities.
LeafPhotosynthesis.SerialLimitation Type
SerialLimitation()Select first-order series rate co-limitation (a * b / (a + b) for a, b ≥ 0, and zero when both capacities vanish), corresponding to the θ → 0 rectangular hyperbola used by Johnson & Berry (2021) for Cytochrome b₆f and PSI in series.
LeafPhotosynthesis.QuadraticLimitation Type
QuadraticLimitation(curvature)Select the lower root of curvature (0 < θ ≤ 1).
Throws ArgumentError if curvature lies outside (0, 1].
LeafPhotosynthesis.colimit Function
colimit(a, b, limitation)Combine competing rates a and b using limitation (MinimumLimitation, SerialLimitation, or QuadraticLimitation). Rates and curvature of different binary precisions are a MethodError. At a tie of MinimumLimitation the first rate is returned, so a derivative there is that of a.
Examples
julia> using LeafPhotosynthesis: colimit
julia> colimit(12.0, 20.0, MinimumLimitation())
12.0
julia> colimit(6.0, 3.0, SerialLimitation())
2.0LeafPhotosynthesis.AbstractAssimilationSign Type
AbstractAssimilationSignSupertype of the treatments of CO₂ assimilation below the photorespiratory compensation point Γ*: SignedAssimilation keeps its sign, NonnegativeAssimilation clips it at zero.
LeafPhotosynthesis.SignedAssimilation Type
SignedAssimilation()Retain signed CO₂ exchange below the photorespiratory compensation point Γ*.
LeafPhotosynthesis.NonnegativeAssimilation Type
NonnegativeAssimilation()Clip pre-respiration CO₂ assimilation at zero below Γ*, as in Bonan supplemental program 11.1.
Carbon Demand & Realized Biochemical Turnover
LeafPhotosynthesis.carbon_assimilation Function
carbon_assimilation(rates, co2, oxygen, electrons, stoichiometry, limitation, assimilation_sign)Compute C3 carbon assimilation fluxes [μmol CO₂ m⁻² leaf s⁻¹] at prescribed biochemical-site co2 and oxygen partial pressures [Pa] and available electron flux electrons [μmol electrons m⁻² leaf s⁻¹].
The electron-limited flux is C3Rates and cytochrome_carbon_coefficients) for CytochromeRates.
Return (; rubisco_limited, electron_limited, assimilation, respiration, net_assimilation), where positive net_assimilation denotes net CO₂ uptake and assimilation already accounts for photorespiratory CO₂ release prior to subtracting mitochondrial respiration. Co-limitation acts on nonnegative biochemical capacities before multiplying by CO₂ excess so realized turnover remains well-defined across Γ*.
LeafPhotosynthesis.biochemical_turnover Function
biochemical_turnover(rates, co2, oxygen, electrons, stoichiometry, limitation, SignedAssimilation())
biochemical_turnover(photosynthesis, environment, excitation=BroadbandExcitation())
biochemical_turnover(leaf, environment, excitation=BroadbandExcitation())Compute realized C3 gross biochemical turnover prior to cancellation between Rubisco carboxylation and photorespiratory CO₂ release.
Return (; carboxylation, photorespiratory_co2, respiration, linear_electron_flow), with carbon fluxes in μmol CO₂ m⁻² leaf s⁻¹ and electron fluxes in μmol electrons m⁻² leaf s⁻¹. CytochromePhotosynthesis adds the realized psi_electron_flow and cyclic_electron_flow. Environment entry points append the available linear electron_transport and, for CytochromePhotosynthesis, psi_electron_supply, psii_open_fraction and psi_to_psii_ratio, as photosynthesize does; input outside the physical domain gives NaN in every field. Only SignedAssimilation defines this turnover contract.