Skip to content

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
julia
AbstractPhotosynthesis

Supertype for leaf photosynthetic biochemistry components implementing photosynthesize.

source
LeafPhotosynthesis.AbstractC3Photosynthesis Type
julia
AbstractC3Photosynthesis{L,C} <: AbstractPhotosynthesis

Supertype 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.

source
LeafPhotosynthesis.C3Photosynthesis Type
julia
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.

source
LeafPhotosynthesis.CytochromePhotosynthesis Type
julia
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.

source

Rate Colimitation & Sign Policies ​

LeafPhotosynthesis.AbstractColimitation Type
julia
AbstractColimitation

Supertype of the rules colimit uses to combine two competing rates: MinimumLimitation, SerialLimitation and QuadraticLimitation.

source
LeafPhotosynthesis.MinimumLimitation Type
julia
MinimumLimitation()

Select the exact minimum min(a, b) of two competing biochemical capacities.

source
LeafPhotosynthesis.SerialLimitation Type
julia
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.

source
LeafPhotosynthesis.QuadraticLimitation Type
julia
QuadraticLimitation(curvature)

Select the lower root of      for empirical curvature curvature (0 < θ ≤ 1).

Throws ArgumentError if curvature lies outside (0, 1].

source
LeafPhotosynthesis.colimit Function
julia
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
julia> using LeafPhotosynthesis: colimit

julia> colimit(12.0, 20.0, MinimumLimitation())
12.0

julia> colimit(6.0, 3.0, SerialLimitation())
2.0
source
LeafPhotosynthesis.AbstractAssimilationSign Type
julia
AbstractAssimilationSign

Supertype of the treatments of CO₂ assimilation below the photorespiratory compensation point Γ*: SignedAssimilation keeps its sign, NonnegativeAssimilation clips it at zero.

source
LeafPhotosynthesis.SignedAssimilation Type
julia
SignedAssimilation()

Retain signed CO₂ exchange below the photorespiratory compensation point Γ*.

source
LeafPhotosynthesis.NonnegativeAssimilation Type
julia
NonnegativeAssimilation()

Clip pre-respiration CO₂ assimilation at zero below Γ*, as in Bonan supplemental program 11.1.

source

Carbon Demand & Realized Biochemical Turnover ​

LeafPhotosynthesis.carbon_assimilation Function
julia
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  , with electron demand    for C3Rates and    (PSI electrons, see 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 Γ*.

source
LeafPhotosynthesis.biochemical_turnover Function
julia
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.

source