Skip to content

Scientific references and provenance ​

The initial C3 calculation uses the Farquhar-style Rubisco/electron limitations and temperature/light responses represented in Gordon Bonan's supplemental program 11.1 for Climate Change and Terrestrial Ecosystem Modeling.

The new core is written independently around explicit mathematical operations; no upstream source files are bundled. Bonan's scientific parameter values and experimental settings are attributed in the TOML file. An upstream license was not present in the inspected Bonan tree; do not vendor its MATLAB files or datasets without establishing redistribution terms. LeafPhotosynthesis.jl itself is licensed under the Apache License, Version 2.0; it is not registered in the General registry yet.

The test oracle recomputes the reference equations with BigFloat, mole fractions, and the direct quadratic formula. It does not execute MATLAB. A future reference run should preserve interpreter/version, upstream revision, exact settings, and output hashes separately from this equation-based validation.

Core stomatal and oxygen components ​

  • Farquhar, von Caemmerer & Berry (1980), §4.2 Eq.38: compensation-point oxygen dependence; DOI10.1007/BF00386231. The component scales an explicitly supplied reference-O₂ calibration; no thermal coefficients from the paper replace the Bonan exercise settings.

  • Moreno-Echeverry et al. (2026): recent Γ*(T) estimation study in sunflower, motivating replaceable calibration; not implemented as a universal parameter set.

  • Liu, Wang, Magney, and Frankenberg (2024): analytical prescribed-conductance diffusion–biochemistry coupling and first-order prognostic stomatal response. The example timescales are illustrative, not fitted parameters or a reproduction of the paper's experiments.

  • Gauthier et al. (2018): oxygen production/uptake accounting. Core stoichiometry and the respiratory-quotient assumption are explicitly listed in the example parameter file.

  • Historical CliMA/Land composition: inspected as an early component-design reference, not current ClimaLand code or an implementation to port. It combines typed model choices with mutable leaf state.

  • Current ClimaLand shared photosynthesis interface: the locally reviewed version is d81db246d. It is a coupling reference, with separate Farquhar/P-model implementations. Its clipped net-assimilation helper is not our signed respiratory carbon-flux convention.

Fluorescence and Cytochrome photochemistry ​

  • van der Tol, Berry, Campbell, and Rascher (2014): steady-state PSII rate competition and empirical KN(x) Cotton and Flexas Drought parameterizations (Eq. 19, Table 1).

  • Johnson and Berry (2021): mechanistic steady-state Cytochrome plastoquinol oxidation, linear/cyclic ATP–NADPH coupling, connected-units PSII feedback quenching, and oxidized- PSI fluorescence (jenjohnson/johnson-berry-2021-pres, MIT license, inspected for equation and parameter verification only; no upstream files bundled).

  • Gu, Han, Wood, Chang, and Sun (2019): PSII lake-model relations between fluorescence yield, the open reaction-center fraction , NPQ and linear electron flow (Eqs. 14, 16, 17, 20, 21), and the light-reaction form of C3 assimilation (Eqs. 23, 24). Figs. 1c, 2a and 4c were digitized for the tests.

  • Flexas et al. (2002) and Escalona, Flexas & Medrano (1999, Aust. J. Plant Physiol. 26:421–433): steady-state normalized chlorophyll fluorescence () light responses, stomatal vs. non-stomatal drought progression, high- / low- reversion, and DTT xanthophyll inhibition in Vitis vinifera L. cv. Tempranillo.