Skip to content

Excitation, Electron Transport & Stoichiometry ​

Excitation types (BroadbandExcitation, PrescribedPSIIExcitation, PrescribedDualExcitation) pass absorbed photon fluxes from external leaf/canopy optics into photosystems II and I without embedding spectral pigment tables inside LeafModel. Potential electron supply is evaluated either from empirical non-rectangular hyperbola parameters (ElectronTransportParameters, electron_transport) or from Cytochrome series kinetics with linear and cyclic ATP/NADPH stoichiometry (CytochromeElectronParameters, CytochromeStoichiometry).

Walkthroughs: Excitation contract, Cytochrome b6f mechanics.

Photosystem Excitation Inputs ​

LeafPhotosynthesis.AbstractExcitation Type
julia
AbstractExcitation

Supertype for leaf photosystem light-allocation conventions, kept separate from the leaf gas and temperature environment.

source
LeafPhotosynthesis.BroadbandExcitation Type
julia
BroadbandExcitation()

Partition total absorbed PAR using the electron-transport component's broadband psii_fraction parameter without adding state or extra parameters.

Examples

julia
julia> using LeafPhotosynthesis: valid_excitation

julia> valid_excitation(BroadbandExcitation(), 800.0)
true
source
LeafPhotosynthesis.PrescribedPSIIExcitation Type
julia
PrescribedPSIIExcitation(photons)
PrescribedPSIIExcitation{FT}(photons)
PrescribedPSIIExcitation(; photons)

Carry externally allocated PSII excitation photons [μmol photons m⁻² leaf s⁻¹] on the same one-sided leaf-area basis and PAR spectral interval as LeafEnvironment.absorbed_par.

Pigment and antenna allocation are already included, so broadband psii_fraction is not applied again. Invalid values are stored without throwing for GPU compatibility; valid_excitation rejects non-finite or negative values and photons > absorbed_par. A binary precision other than that of the model and environment is a MethodError of the entry point.

source
LeafPhotosynthesis.PrescribedDualExcitation Type
julia
PrescribedDualExcitation(psii_photons, psi_photons)
PrescribedDualExcitation(; psii_photons, psi_photons)

Carry externally allocated PSII (psii_photons) and PSI (psi_photons) excitation fluxes [μmol photons m⁻² leaf s⁻¹] on the same leaf-area basis and PAR spectral interval as LeafEnvironment.absorbed_par.

valid_excitation requires finite nonnegative absorbed_par, psii_photons ≥ 0, psi_photons ≥ 0, psii_photons + psi_photons ≤ absorbed_par (permitting non-photosynthetic pigment absorption when strict inequality holds). A binary precision other than that of the model and environment is a MethodError.

source
LeafPhotosynthesis.valid_excitation Function
julia
valid_excitation(excitation, total_absorbed_par) -> Bool

Return true if excitation and total_absorbed_par lie in the domain shared across photosynthesis, turnover, diffusion, oxygen, and fluorescence entry points: finite nonnegative light, and prescribed photon fluxes that are finite, nonnegative and no larger than total_absorbed_par. Different binary precisions are a MethodError.

source
LeafPhotosynthesis.psii_excitation Function
julia
psii_excitation(electron_parameters, total_absorbed_par, excitation)

Return the PSII photon flux [μmol photons m⁻² leaf s⁻¹] delivered to PSII reaction centers prior to multiplication by photochemical yield, or typed NaN when valid_excitation fails.

source
LeafPhotosynthesis.psi_excitation Function
julia
psi_excitation(electron_parameters, total_absorbed_par, excitation)

Return the PSI photon flux [μmol photons m⁻² leaf s⁻¹] delivered to PSI reaction centers prior to multiplication by PSI photochemical yield, or typed NaN when valid_excitation fails.

PrescribedPSIIExcitation intentionally has no psi_excitation method because non-photosynthetic pigment absorption prevents inferring PSI photons as PAR - Q₂.

source

Potential Electron Supply ​

LeafPhotosynthesis.ElectronTransportParameters Type
julia
ElectronTransportParameters(; psii_fraction, psii_yield, limitation)
ElectronTransportParameters(psii_fraction, psii_yield, limitation)

Specify the broadband PSII photon fraction psii_fraction (∈ [0, 1]), maximum PSII electron yield per delivered photon psii_yield (∈ [0, 1]), and rate co-limitation model limitation.

Leaf absorptance belongs to optics and is not included in psii_fraction. Throws ArgumentError if psii_fraction or psii_yield is outside [0, 1].

source
LeafPhotosynthesis.electron_transport Function
julia
electron_transport(parameters, absorbed_par, jmax, excitation=BroadbandExcitation())

Compute available linear electron transport [μmol electrons m⁻² leaf s⁻¹] from absorbed PAR [μmol photons m⁻² leaf s⁻¹] and capacity jmax [μmol electrons m⁻² leaf s⁻¹].

BroadbandExcitation() delivers the fraction psii_fraction of absorbed_par to PSII; prescribed excitation conventions bypass broadband psii_fraction. Every convention returns typed NaN when valid_excitation is false; parameters, light and excitation of different binary precisions are a MethodError.

source
LeafPhotosynthesis.CytochromeElectronParameters Type
julia
CytochromeElectronParameters(; psii_fraction, psi_maximum_yield, limitation)
CytochromeElectronParameters(psii_fraction, psi_maximum_yield, limitation)

Specify broadband PSII photon partition psii_fraction (β ∈ (0, 1)), open-center PSI maximum photochemical yield psi_maximum_yield (Φ_P1,max ∈ (0, 1)), and rate co-limitation model limitation (SerialLimitation for Johnson & Berry 2021, Eq. 20).

source
LeafPhotosynthesis.cytochrome_electron_supply Function
julia
cytochrome_electron_supply(parameters, total_absorbed_par, vqmax,
    excitation=BroadbandExcitation())

Evaluate potential PSI electron supply psi_electron_supply [μmol e⁻ m⁻² leaf s⁻¹] co-limited by Cytochrome b₆f capacity vqmax, together with the steady-state open PSII reaction-center fraction psii_open_fraction (q₂, Johnson & Berry 2021, Eq. 22).

Single-photosystem illumination (iszero(Q₂) != iszero(Q₁)) lies outside the coupled Z-scheme steady-state domain and returns NaN fields.

source

ATP/NADPH & Cyclic Electron Stoichiometry ​

LeafPhotosynthesis.C3Stoichiometry Type
julia
C3Stoichiometry{FT}(; electrons_per_carboxylation, oxygenation_cost)
C3Stoichiometry(electrons_per_carboxylation, oxygenation_cost)

Specify dimensionless C3 stoichiometric coefficients in the electron-limited denominator  .

Both parameters must be supplied explicitly from parameter files. Throws ArgumentError unless electrons_per_carboxylation > 0 and oxygenation_cost ≥ 0 are finite.

source
LeafPhotosynthesis.CytochromeStoichiometry Type
julia
CytochromeStoichiometry{FT}(; electrons_per_carboxylation,
    electrons_per_photorespiratory_co2, atp_per_carboxylation,
    atp_per_photorespiratory_co2)
CytochromeStoichiometry(electrons_per_carboxylation,
    electrons_per_photorespiratory_co2, atp_per_carboxylation,
    atp_per_photorespiratory_co2)

Specify C3 Calvin–Benson and photorespiratory linear-electron and ATP demands per CO₂ event (classically 4, 8, 3, 7 in Johnson & Berry 2021, Eq. 24). Throws ArgumentError unless all four are finite and positive.

source
LeafPhotosynthesis.cytochrome_cyclic_coefficients Function
julia
cytochrome_cyclic_coefficients(linear_atp_per_electron, cyclic_atp_per_electron,
    stoichiometry::CytochromeStoichiometry) -> (cef_c1, cef_c2)

Compute cyclic PSI electron requirements per carboxylation and per photorespiratory CO₂ release directly from the ATP deficit prior to adding linear electron demand so a_c == η_L * e_c evaluates to exact zero in Float32.

source
LeafPhotosynthesis.cytochrome_carbon_coefficients Function
julia
cytochrome_carbon_coefficients(rates::CytochromeRates,
    stoichiometry::CytochromeStoichiometry) -> (c1, c2)

Compute effective PSI electron costs (c1, c2) multiplying Cc and Γ* in   .

source
LeafPhotosynthesis.psi_to_psii_electron_ratio Function
julia
psi_to_psii_electron_ratio(rates::CytochromeRates, co2,
    stoichiometry::CytochromeStoichiometry)

Compute the steady-state PSI-to-PSII electron flux ratio     required to balance Calvin–Benson and photorespiratory ATP/NADPH stoichiometry at biochemical-site co2 [Pa].

source