Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

1The carbon and nitrogen cycle

1.1DONE: Vegetation phenology

1.1.1DONE: Classification of plant status

To accurately simulate seasonal ecosystem cycles it is essential to represent the biological life cycle of plants Lieth, 1974Piao et al., 2019. The timing of each of the plant phenological phases is dependent on a combination of physiological characteristics and climatic conditions. In ORCHIDEE, each PFT can progress through the following phases: establishment, bud presence, leaf onset, canopy presence, wood growth cessation (pre-senescence), senescence, dormancy, and death. The phenology models in ORCHIDEE control the timing of leaf onset and senescence. There are no leaf onset or senescence modules associated with evergreen ecosystems where leaf turnover is simply a function of climate and leaf age (equation 245).

1.1.2DONE: Leaf onset

There are four different modules to determine leaf onset (Table 4), where leaf onset is determined by moisture conditions, or temperature conditions (including the number of growing days, the occurrence of chilling days, and growing degree days), or both temperature and moisture conditions.

Table 4:The phenological modules used to determine leaf onset.

ModuleLeaf onset triggerPFTs affected
NGDNumber of growing daysBoreal needleleaf deciduous forest
GDD-NCDGrowing degree days after cold periodTemperate broadleaf deciduous forest, boreal broadleaf deciduous forest
MOIMoisture conditionsTropical broadleaf raingreen forest
MOIGDDBoth temperature (GDD) and moisture conditionsBoreal natural C3 grassland, temperate natural C3 grassland, tropical natural C3 grassland, natural C4 grassland, C3 cropland, C4 cropland

Within the number of growing days (NGD) module, which was originally proposed by Botta et al. (2000) for arctic and boreal biomes, the onset of leaves occurs when the number of growing days exceeds a PFT-specific critical value:

Gn,grow>c0G^{n,grow} > c_0

where Gn,growG^{n,grow} refers to the number of growing days with a mean daily temperature above a threshold, 268.15 K in ORCHIDEE, calculated from the start of the midwinter (shortest day of the year) where, c0c_0 (days) represents a PFT-specific critical value (23.9 days for boreal needleleaf deciduous forests). To ensure it’s spring, temperatures must also be increasing:

Tw>TmT^{w} > T^{m}

where TwT^{w} (K) and TmT^{m} (K) represent the weekly and monthly mean temperatures, respectively.

The growing degree days - number of chilling days (GDD-NCD) module follows the general GDD model Chuine, 2000, which is designed to simulate the accumulation of warm temperatures in the spring needed for budburst and is a common model applied to satisfy temperature conditions for leaf onset to occur Hänninen & Kramer, 2007. As in the number of growing days model, temperatures must also be increasing (i.e., the weekly temperature must be greater than the monthly temperature - equation 239). GDD is calculated as a sum of the mean daily temperatures for days that have a mean daily temperature above a given threshold, starting from a given time point. Leaf onset occurs once the GDD value has crossed a defined threshold. In the GDD-NCD module the GDD is calculated from midwinter (as for the NGD module) but the general GDD module described above is further adapted to account for PFTs that require a period of cold temperatures to trigger budburst Orlandi et al., 2004 by modifying the GDD threshold to account for the number of chilling days. Thus, in the GDD-NCD module the start of the growing season occurs when the growing degree days since midwinter exceeds a calculated GDD threshold:

Gdeg,grow>GthresG^{deg,grow} > G^{thres}

where Gdeg,growG^{deg,grow} (K) represents the growing degree days since midwinter and GthresG^{thres} (K) is a negative exponential that accounts for the number of chilling days with an additional three fixed parameters, following Botta et al., 2000:

Gthres=c1ec2Gn,chillc3,G^{thres} = \frac{c_1}{e^{c_2 \cdot G^{n,chill}}} - c_3,

where c1c_1 (-), c2c_2 (-) and c3c_3 (-) are non PFT-specific model parameters that have been calibrated against satellite data, and are 964, 0.0058, and 12.8, respectively Botta et al., 2000. Gn,chillG^{n,chill} is the number of chilling days since midwinter, where chilling days are defined as the number of days with a mean daily temperature below a PFT-specific threshold (278.15 K and 273.15 K for temperate and boreal broadleaved deciduous forests, respectively) following Cannell & Smith (1986), Murray et al. (1989), and Chuine (2000).

Within the moisture module, the conditions determining the onset of leaf growth depend on either a soil moisture availability criterion (if hydraulic architecture is not used) or a vegetation stress proxy (if hydraulic architecture is used). This means that the growing season can begin if the last moisture minimum was a sufficiently long time ago (equation 242) and either the soil moisture availability (or vegetation stress proxy) is increasing (equation %s) or if the monthly moisture availability (or monthly vegetation stress proxy) is high enough (equation %s).

Mnsm>c4,fVst,w>fVst,m,fVst,mc5,\begin{align} &M^{nsm} > c_4,\\ &f^{Vst,w} > f^{Vst,m},\\ &f^{Vst,m} \ge c_5, \end{align}

where fVst,wf^{Vst,w} (-) and fVst,mf^{Vst,m} (-) are proxies for weekly and monthly vegetation water stress, respectively, with values ranging from 0 (high moisture stress) to 1 (low moisture stress). MnsmM^{nsm} (days) represents the number of days since the last moisture minimum, and c4c_4 (days) and c5c_5 (-) represent PFT-specific threshold parameters. For tropical broadleaf raingreen trees, c4c_4 and c5c_5 are 50 days and 1.0, respectively.

Vegetation water stress is calculated using the soil moisture availability criterion (essentially root profile weighted plant available relative soil moisture) that varies linearly from zero at wilting point to 1 at field capacity:

fVst=i=1nlsmfiroot,funmin(1,max(0,MismMismwMismfMismw))f^{Vst} = \sum_{i=1}^{nlsm} f^{root,fun}_{i} \cdot min\left( 1, max\left( 0, \frac{M^{sm}_{i} - M^{smw}_{i}}{M^{smf}_{i} - M^{smw}_{i}}\right)\right)

where MismM^{sm}_{i} (kg m2m^{-2}) is the soil moisture of the ii-th (m) soil layer (liquid phase), MismfM^{smf}_{i} (kg m2m^{-2}) soil moisture of each layer at field capacity, MismwM^{smw}_{i} (kg m2m^{-2}) is the soil moisture of each layer at wilting point, and firoot,funf^{root,fun}_{i} (-) is the normalized root mass/length fraction in each soil layer (0 - 1) Krinner et al., 2005. The moisture availability criterion (equation 242 - equation %s) correspond to Model 4b in Botta et al. (2000), which assumes that leaf onset in the dry tropics and semi-arid ecosystems occurs only after a certain amount of water has accumulated in the soil.

Within the moisture-growing degree day module (MOI-GDD), both the moisture conditions described above and a GDD threshold criterion must be met for leaf onset to occur. For the moisture conditions parameter c4c_4 is set to 35 days for grasses and 75 days for crops, and parameter c5c_5 is set to 0.98 for C3 grasses and 0.6 for C4 grasses and crops. The GDD test is similar to the general GDD module, described above, where the growing degree days since midwinter must exceed a calculated GDD threshold (i.e. equation 240). In this version of the GDD model Gdeg,growG^{deg,grow} represents the growing degree days calculated using days with a mean daily temperature above 278.15 K since midwinter and the GthresG^{thres} (° C) is calculated using a second-degree polynomial using the long term mean annual air surface temperature MacBean et al., 2015:

Gthres=c6+c7T3year+c8(T3year)2,G^{thres} = c_6 + c_7 \cdot T^{3year} + c_8 \cdot {(T^{3year})}^2,

where c6c_6 (° C), c7c_7 (° C) and c8c_8 (° C) represent GDD PFT-specific parameters and T3yearT^{3year} (° C) is the 3-year average 2 m air temperature. It is not possible to convert GDD between ° C and K and because these PFT parameters are used in ORCHIDEE in ° C, we have also written this relationship here in ° C. Where c6c_6 is 640 ° C, 400 ° C, 400 ° C, 450 ° C for c3 grasslands, c4 grasslands, c3 croplands, and c4 croplands. c7c_7 is 32.0 ° C, 0.0 ° C, 6.25 ° C, and 0.0 ° C for c3 grasslands, c4 grasslands, c3 croplands, and c4 croplands. c8c_8 is 0.1 ° C, 0.0 ° C, 0.0315 ° C, and 0.0 ° C for c3 grasslands, c4 grasslands, c3 croplands, and c4 croplands. As in the NGD and GDD-NCD models, temperatures must also be increasing (equation 239). An alternative to the GDD threshold is that the monthly mean temperature must be above a certain PFT dependent threshold (defined as 283.15 K for all PFTs). Finally, for c4 grasses the monthly mean temperature must also exceed a pre-set temperature of 295.15 K.

1.1.3DONE: Senescence

Leaf senescence occurs due to age, the cessation of the growing season, or the occurrence of crop harvests (Table 5). Leaf senescence can also trigger fruit, root, or stem senescence. In the occurrence of leaf and root senescence, the nitrogen stored in leaves and roots is transferred into the labile nitrogen pool. Evergreen species do not experience seasonal senescence. Furthermore, if there is very low leaf mass during senescence, all leaves are lost.

Table 5:The phenological modules used to determine leaf senescence.

Senescence moduleSenescence triggerPFTs affected
ColdCold temperaturesTemperate broadleaf deciduous forest, boreal broadleaf deciduous forest, boreal needleleaf deciduous forest,
DryWater availabilityTropical broadleaf raingreen forest
MixedPhotosynthesis to plant respiration ratioBoreal natural c3 grassland, temperate natural c3 grassland, tropical natural c3 grassland, natural c4 grassland
CropHarvestc3 cropland, c4 cropland
AgeLeaf ageAll (except bare ground)

Even if the meteorological conditions are favorable for leaf maintenance, plants, and in particular, evergreen trees, must renew their leaves simply because the old leaves become inefficient. Therefore, the old leaves of all PFTs fall off regardless of climatic conditions, following.

ΔMlk=Mlkmin(0.99,ΔtScrit(Scritaileaf)4)\Delta M^{k}_{l} = M^{k}_{l} \cdot \min \left( 0.99,\frac{\Delta{t}} {S^{crit} \cdot \left( \frac{S^{crit}}{a^{leaf}_{i}} \right)^4} \right)

where MlkM^{k}_{l} is the carbon (g C m2^{-2} day1^{-1}) and nitrogen (g N m2^{-2} day1^{-1}) biomass of organs, kk (leaves, roots, fruits, and stems), of circumference class ll. ΔM\Delta M is the fraction of carbon and nitrogen biomass lost, Δt\Delta t is the timestep (1 day), aileafa^{leaf}_{i} (days) is the age of the leaf mass in age class ii, and ScritS^{crit} (days) is the location-specific leaf longevity, dependent on the long-term temperature:

Scrit=min(c1c2,max(c1c3,c1c4(T3yearc5)))S^{crit} = \min \left( c_1 \cdot c_2, \max \left(c_1 \cdot c_3, c_1 - c_4 \cdot \left( T^{3year} - c_5 \right) \right) \right)

where c1c_1 (days) is the PFT-specific leaf longevity and is 180 days for raingreen trees, summergreen trees, and grasses, 730 days for broad-leaved evergreen trees, 910 days for temperate needleleaf trees, 2000 days for boreal needleleaf evergreen trees, and 200 days for crops. c2c_2 (-), c3c_3 (-), and c4c_4 (-) are PFT specific parameters linking leaf longevity to the reference temperature. c2c_2 is 1.5 for grasses and crops, 2.0 for boreal needleleaf evergreen trees, and 1.0 for all other PFTs. c3c_3 is 0.365 for boreal needleleaf evergreen trees, and 0.75 for grasses and crops, and 1.0 for all other PFTs. c4c_4 is 120 for boreal needleleaf evergreen trees, 10 for grasses and crops, and 0 for all other PFTs. c5c_5 (K) is a PFT-specific reference temperature for the calculation of leaf longevity and is 298.15K for tropical trees, 293.15K for temperate broad-leaved evergreen trees, C4 grasses and crops; 288.15K for temperate needleleaf evergreen trees, temperate broad-leaved summergreen trees, C3 grasses and crops; and 278.15K for boreal trees.

This means that older leaves fall more frequently than younger leaves and therefore the leaf age distribution must be recalculated after leaf senescence. The fraction of biomass in each leaf age class is updated using the following equation:

fi,tleaf=fi,t1leafMl,t1leaf+ΔMlkMl,tleaff^{leaf}_{i,t} = \frac {f^{leaf}_{i,t-1}\cdot M^{leaf}_{l,t-1} + \Delta M^{k}_{l}} {M^{leaf}_{l,t}}

where fi,tleaff^{leaf}_{i,t} is the new leaf carbon and nitrogen fraction of leaf biomass in leaf age class ii, fi,t1leaff^{leaf}_{i,t-1} is the old leaf fraction, Ml,tleafM^{leaf}_{l,t} is the new total leaf biomass of circumference class ll, and Mt1leafM^{leaf}_{t-1} is the old total leaf biomass. ΔMlk\Delta M^{k}_{l} is the change in leaf carbon and nitrogen biomass in the considered class due to senescence.

Senescence at the end of the growing season, can be triggered by cooling temperatures, water availability limitations, or both. In the case of senescence at the end of the growing season, leaf senescence is only possible if leaves have reached a certain age (equation 248).

al,mean>c0a^{l,mean} > c0

where al,meana^{l,mean} (days) is the mean leaf age and c0c0 (days) is the PFT-specific parameter for the minimum leaf age for senescence. c0c0 is 90 days for tropical and temperate trees, 60 days for boreal trees, and 30 days for grasses and crops.

Leaf senescence due to cool temperatures at the end of the growing season is triggered by decreasing temperatures (equation 250) and the fall of the monthly air temperature below a threshold temperature (Tm<STT^{m} < S^{T}). The threshold temperature is defined using a second order polynomial of the long-term mean annual air surface temperature:

ST=c6T3year2+c7T3year+c8S^{T} = c_6 \cdot {T^{3year}}^{2} + c_7 \cdot T^{3year} + c_8

where STS^{T} (K) is the critical temperature for leaf senescence, T3yearT^{3year} (K) is the long term annual mean temperature and c6c_6 (-), c7c_7 (-) and c8c_8 (-) are PFT-specific empirical constants in the quadratic temperature senescence equation. c6c_6 and c7c_7 are 0.00375 and 0.1, respectively, for C3 grasses, and 0 for all other PFTs. c8c_8 is 16.0 for temperate broad-leaved summergreen, 14.0 for boreal broad-leaved summergreen, 13.0 for boreal needleleaf summergreen trees, 5.0 for grasses, 12.0 for C3 crops and 13.0 for C4 crops. In addition, temperature must be decreasing, following:

T2w<TmT^{2w} < T^{m}

where T2wT^{2w} (K) and TmT^{m} (K) refer to the mean daily temperatures calculated over the past fortnight and the past month, respectively. Alternatively, leaf senescence due to cooling temperatures is also triggered if the ratio of plant respiration to photosynthesis is above a PFT-specific threshold (equation 251).

Frm,1weekFgpp,1week>c9\frac{F^{rm,1week}}{F^{gpp,1week}} > c_9

where Frm,1weekF^{rm,1week} (gCm2day1gC m^{-2} day^{-1}) represents the mean of daily maintenance respiration and Fgpp,1weekF^{gpp,1week} (gCm2day1gC m^{-2} day^{-1}) represents the mean of daily photosynthesis calculated for the past week, respectively. c9c_9 represents the unitless PFT-specific minimum senescence ratio parameter and is set to 0.75 for C3 grasses, 0.89 for boreal needleleaf summergreen trees, 0.87 for boreal broad-leaved summergreen trees and 1.0 for all other PFTs.

Leaf senescence due to a lack of water availability is triggered by low soil moisture availability. As occurs in leaf onset (sect. 1.1.2), this can be calculated using either the soil moisture availability criterion, if hydraulic architecture is not used, or as a ratio between a proxy for stressed and unstressed ecosystem functioning if hydraulic architecture is used. Leaf senescence is triggered if either the weekly moisture availability (or vegetation stress) falls below a critical threshold (Vst,w<Vst,thresV^{st,w} < V^{st,thres}) or the ratio of plant respiration to photosynthesis is sufficient (equation 251). The critical moisture availability is calculated as a function of last year’s soil moisture (or vegetation stress) minimum and maximum (or vegetation stress) using the following equation:

fVst,thres=min(max(fVst,min1y+c10(fVst,max1yfVst,min1y),c11),c12)f^{Vst,thres} = min( max( f^{Vst,min1y} + c_10 \cdot (f^{Vst,max1y} - f^{Vst,min1y}), c_{11}), c_{12})

where fVst,thresf^{Vst,thres} is the critical moisture availability threshold, fVst,min1yf^{Vst,min1y} and fVst,max1yf^{Vst,max1y} are the minimum and maximum moisture availabilities over the past year, c10c_{10} is a critical relative moisture availability for phenology, c11c_{11} is the PFT-specific critical moisture availability for senescence, and c12c_{12} is the PFT-specific relative soil moisture availability above which there is no humidity-related senescence. c10c_10, c11c_{11} and c12c_{12} are 0.5, 0.3, and 0.8 for tropical broadleaf raingreen trees, respectively.

For grasses, senescence occurs if the ratio of plant respiration to photosynthesis is sufficient (equation 251).

For crops, the moment of leaf senescence equates to the actual harvest and the entire plant is made senescent. To identify the harvest moment for crops, a second order polynomial of the long-term mean annual air surface temperature is used:

Hcrit=T3yearc12(T3yearc12)+c13H^{crit} = \lvert T^{3year} - c_{12} \rvert \cdot (T^{3year} - c_{12}) + c_{13}

where ScritS^{crit} (days) represents the harvest time threshold, and c12c_{12} (K) and c13c_{13} (days) represent PFT-specific parameters. c12c_{12} is 282K and c13c_{13} is 160 days for all crop PFTs. For senescence to occur, the length of the growing season (number of days) must exceed HcritH^{crit}. In addition, the growing degree days since the initiation of the growing season must be sufficient (Ginit>c14G^{init} > c_{14}) where GinitG^{init} (° C) represents the growing degree days since the start of the growing season and c14c_{14} (° C) represents the PFT-specific minimum number of growing degree days. c14c_{14} is 2500 ° C for all crop PFTs.

For grasses, senescence at the end of the growing season is further extended to the whole plant (i.e. all carbon and nitrogen pools) except the carbohydrate reserve. For trees, senescence at the end of the growing season extends to the fine roots at the same rate as they lose their leaves. The rate of biomass loss of both fine roots and leaves (for trees) and leaves, roots, and fruits (for grasses) is prescribed through the equation:

ΔMlk=MlkΔtc15\Delta M^{k}_{l} = M^{k}_{l} \cdot \frac{\Delta{t}} {c_{15}}

where MM is the carbon and nitrogen biomass, ΔM\Delta M is the fraction of carbon and nitrogen biomass lost, Δt\Delta{t} is the times step, c15c_{15} (days) is the PFT-specific time constant of meteorological determined turnover parameter. Where c15c_{15} is 25 days for boreal trees, 15 days for temperate broad-leaved summergreen trees, and 5 days for temperate needleleaf evergreen trees and grasses.

All remaining leaves are shed when leaf biomass falls too low (below a PFT-specific parameter). For deciduous trees not only leaves but also fruits and fine roots are lost at this moment.

1.2DONE: Photosynthesis

The CO2CO_2 assimilation rate (FAF^A, μmolCO2m2s1\mu mol CO_2 m^{-2} s^{-1}), stomatal conductance (gsg_s) and leaf intercellular CO2CO_2 partial pressure (pCip^{C_i}) are calculated for each leaf layer, by jointly solving a set of three equations (see below). Both for c3 and c4 plants, these three equations can be manipulated into the form of a standard cubic equation for FAF^A, for which Yin & Struik (2009) proposed an analytical solution.

(FA)3+p(FA)2+q(FA)+r=0.(F^A)^3+p(F^A)^2+q(F^A)+r=0.

We implemented this analytical solution and the overall formalism for both c3 (Appendix B in Yin & Struik (2009)) and c4 photosynthesis (Appendix C in Yin & Struik (2009)).

1.2.1DONE: C3 photosynthesis

The Farquhar–von Caemmerer–Berry model farquhar1980 predicts the net CO2CO_2 assimilation rate as the minimum of the Rubisco-limited rate (FAcF^{A_c}) and electron (e^-) transport-limited rate (FAjF^{A_j}):

FA=min(FAc,FAj).F^{A}=\min(F^{A_c},F^{A_j}).

These two parts of the model can be written in a single equation as:

FiA=(pCcpΓ)χ1pCc+χ2FiRd,F^A_i=\frac{(p^{C_c}-p^{\Gamma_*})\chi_1}{p^{C_c}+\chi_2}-F^{R_d}_i,

where for the Rubisco-limited part χ1=kVcmax25\chi_1= k^{V_{cmax25}} and χ2=kKmC(1+pCo/kKmO)\chi_2=k^{K_{mC}}(1+p^{C_o}/k^{K_{mO}}), for the e^- transport-limited part χ1=FiJ/4\chi_1=F^J_i/4 and χ2=2pΓ\chi_2=2p^{\Gamma_*}. pCcp^{C_c} and pCop^{C_o} are the carbon dioxide and oxygen partial pressures at the carboxylation sites, pΓ=0.5pCo/cp^{\Gamma_*} = 0.5 p^{C_o}/c1, is the CO2CO_2 compensation point in the absence of dark respiration (FRdF^{R_d}). This latter case assumes a purely linear e^- transport. c1c_1 is a constant representing the relative CO2/O2 specificity factor for Rubisco.

Following Farquhar & Wong (1984), the rate of e^- transport (FJF^J) is described as a non-rectangular hyperbolic function of irradiance:

FiJ=cαLLFIiabs+kJmax(cαLLFIiabs+kJmax)24cθkJmaxcαLLFIiabs2cθ,F^J_i = \frac{c^{\alpha_\mathsf{LL}}F^{I^{abs}_i} + k^{J_\mathsf{max}}-\sqrt{(c^{\alpha_\mathsf{LL}}F^{I^{abs}_i} + k^{J_\mathsf{max}})^2 - 4c^{\theta} k^{J_\mathsf{max}}c^{\alpha_\mathsf{LL}}F^{I^{abs}_i}}}{2c^{\theta}},

where cαLLc^{\alpha_\mathsf{LL}} is the conversion efficiency of absorbed light into JJ at strictly limiting light, kJmaxk^{J_\mathsf{max}} is the maximum capacity of e^- transport, and cθc^{\theta} is the convexity factor for response of JJ to absorbed irradiance.

The leaf photosynthesis is coupled with the stomatal conductance as follows (Yin & Struik (2009)):

gs,i=cg0+FiA+FiRdpiCint(pΓFiRd/kgm)Ghum,g_{s,i}=c^{g_0}+\frac{F^A_i+F^{R_d}_i}{p^{C_{int}}_i-(p^{\Gamma_*}-F^{R_d}_i/k^{g_m})}G^{hum},

were cg0c^{g_0} is the residual stomatal conductance (molCO2m2s1)(molCO_{2} m^{-2} s^{-1}), FRdF^{R_{d}} (μmolCO2m2s1)(\mu molCO_{2} m^{-2} s^{-1}) is the dark respiration, kgmk^{g_m} is the mesophyll conductance and GhumG^{hum} is a function describing the sensitivity of the stomata to either vapour pressure deficit (gVPDg^{VPD}) or leaf water potential (gψg^{\psi}), depending on the selected drought scheme (see 1.3).

According to the first diffusion law of Fick, the CO2CO_2 transfer from pCap^{C_a} (ambient CO2CO_2 partial pressure) to pCcp^{C_c} can be written as:

piCint=pCaFiA(1/cgb+1/gs,i),piCc=piCintFiA/kgm,\begin{align} &p^{C_{int}}_i=p^{C_a}-F^A_i(1/c^{g_b}+1/g_{s,i}),\\ &p^{C_c}_i=p^{C_{int}}_i-F^A_i/k^{g_m}, \end{align}

where cgbc^{g_b} is the leaf boundary-layer conductance.

The three equations 257, 259 and 260 with the three unknowns FAF^A, gsg_s and pCintp^{C_{int}} form the system to be solved for c3 plants.

1.2.2DONE: C4 photosynthesis

For c4 plants, CO2 is fixed by phosphoenolpyruvate (PEP) carboxylase in the mesophyll cell into a c4 compound, which then goes into a bundle-sheath cell, where it is decarboxylated to provide CO2 to Rubisco. The CO2 concentration in the bundle-sheath is high, thus preventing photorespiration.

FiA=FiVpFLFiRm,F^A_i=F^{V_p}_i-F^L-F^{R_m}_i,

where FVpF^{V_p} is the rate of PEP carboxylation, FRmF^{R_m} is the mitochondrial respiration in the mesophyll and fixed to 0.5FRd0.5F^{R_d} and FLF^L is the leakage of CO2CO_2 from the bundle-sheath to the mesophyll through the bundle-sheath conductance cgbsc^{g_{bs}}:

FL=cgbs(pCcpCint).F^L=c^{g_{bs}}(p^{C_c}-p^{C_{int}}).

FVpF^{V_p} can be limited by the PEP carboxylation rate or the e^- transport rate. In the former case, we have:

FVp=min(ckp,pCint,kVpmax)F^{V_p}=\min(c^{k_p},p^{C_{int}},k^{V_{pmax}})

where ckpc^{k_p} is the initial carboxylation efficiency of the PEP carboxylase, and kVpmaxk^{V_{pmax}} is the maximum rate of PEP carboxylation at the saturated pCintp^{C_{int}}.

For the e^- transport-limited case for c4 plants, we use:

FiVp(FiJ2)=cχFiJ2(2+cfQkfcyc)2ch(1kfcyc)=cχFiJ2cz2FiJ=FiJ2(1cfpseudo1kfcyc)\begin{align} &F^{V_p}_i(F^{J_2}_i)=\frac{c^{\chi} F^{J_2}_i(2+c^{f_Q}-k^{f_{cyc}})}{2c^h(1-k^{f_{cyc})}}=\frac{c^{\chi} F^{J_2}_ic^ z}{2}\\ &F^J_i=F^{J_2}_i\left(1-\frac{c^{f_{pseudo}}}{1-k^{f_{cyc}}}\right) \end{align}

where FiJ2F^{J_2}_i is the rate of all e^- transport through photosystem II (PSII), kfcyck^{f_{cyc}} is a fraction of electrons that follows a cyclic e^- transport (CET) around photosystem I (PSI), and cfpseudoc^{f_{pseudo}} is a fraction of electrons at PSI that follow a pseudocyclic e^- transport (PET). Both are not used for carbon reduction and photorespiration (which is negligible in c4 plants). Similarly, cfQc^{f_Q}, a fraction of electrons at reduced plastoquinone that follow the Q-cycle, is not transferred to the plastocyanin. cfpseudoc^{f_{pseudo}} and cfQc^{f_Q} are PFT-specific parameters. For kfcyck^{f_{cyc}} we use:

kfcyc=14(1cχ)(1+cfQ)+3chcfpseudo3ch4(1cχ),k^{f_{cyc}}=1-\frac{4(1-c^{\chi})(1+c^{f_Q})+3c^hc^{f_{pseudo}}}{3c^h-4(1-c^{\chi})},

where cχc^{\chi} is the fraction of e^- transport rate partitioned to the mesophyll reactions, which is set at 0.4, and chc^h is the number of protons required to produce one ATP, which is set at 4.

As for c3 plants, the Rubisco-based assimilation of CO2CO_2 in c4 plants can be limited by either Rubisco activity or by e^- transport rate (equation 256) following the equivalent to equation 257:

FiA=(pCcγpObs)χ1pCc+χ2pObs+χ3FiRd,F^A_i=\frac{(p^{C_c}-\gamma_* p^{O_{bs}})\chi_1}{p^{C_c}+\chi_2 p^{O_{bs}}+\chi_3}-F^{R_d}_i,

where pObsp^{O_{bs}} is the oxygen partial pressure in the bundle-sheath, γ=0.5/cSc/o\gamma_*=0.5/c^{S_{c/o}}, cSc/oc^{S_{c/o}} is the relative CO2/O2 specificity factor for Rubisco. For the Rubisco-limited rate, we have: χ1=kVcmax\chi_1=k^{V_{cmax}}, χ2=kKmC/kKmO\chi_2=k^{K_{mC}}/k^{K_{mO}}, χ3=kKmC\chi_3=k^{K_{mC}}, and for the e^- transport-limited rate: χ1=(1cχ)FiJ2cz/3\chi_1=(1-c^{\chi})F^{J_2}_i c^z/3, χ2=7pΓ/3\chi_2=7p^{\Gamma_*}/3, χ3=0\chi_3=0.

The oxygen partial pressures between intercellular air-space and bundle-sheath are linked through the following equation:

pObs=cαFA0.047cgbs+cOint,p^{O_{bs}}=\frac{c^{\alpha} F^A}{0.047c^{g_{bs}}}+c^{O_{int}},

where cαc^\alpha is the fraction of PSII activity in the bundle-sheath and 0.047 accounts for the diffusivities for O2 and CO2 in water and their respective Henry constants.

To enable an analytical solution Yin & Struik, 2009 propose an equation for c4 stomatal conductance that is slightly different than for c3:

gs,i=cg0+FiA+FiRdpCs(pCx)Ghum,g_{s,i}=c^{g_0}+\frac{F^A_i+F^{R_d}_i}{p^{C_s}-(p^{C_{x*}})}G^{hum},

with CsC_{s}, the CO2CO_2 level at leaf surface and pCsp^{C_{s*}} the CsC_{s}-based CO2CO_2 compensation point in the absence of FRdF^{R_d}.

The three equations 266, 268 and 262 with the three unknowns FAF^A, gsg_s and pCcp^{C_c} form the system to be solved for c4 plants.

1.2.3DONE: Parameter dependency on temperature, nitrogen and water

To account for the nitrogen dependency of kVcmax25k^{V_{cmax25}} we use the nitrogen use efficiency (NUE, defined as kVcmax25k^{V_{cmax25}} per leaf nitrogen content) as derived from observations by Kattge2009:

kVcmax25=kNUEMleaf,Nk^{V_{cmax25}}=k^{NUE}*M^{leaf,N}

where kNUEk^{NUE} is NUE scaled with ftsugarloadf^{sugarload}_{t} (1.4.5, 321) and leaf efficiency weighted for the fraction of leaves in each age class. Leaf efficiency is scaled by the leaf age of each leaf age class.

Most of the photosynthetic parameters are temperature-dependent and their temperature dependency in ORCHIDEE follows either an Arrhenius function (FRdF^{R_d}, pΓp^{\Gamma_*}, kKmCk^{K_{mC}}, kKmOk^{K_{mO}}, cSc/oc^{S_{c/o}}) or a modified Arrhenius function, accounting for a decrease at high temperatures (kJmaxk^{J_{\max}}, kVcmaxk^{V_{c\max}}, Medlyn et al. (2002)). In addition, for c3 plants, we account for an acclimation term on the two entropy factors that are involved in the temperature function for kVcmaxk^{V_{c\max}} and kJmaxk^{J_{\max}} and the ratio between kJmaxk^{J_{\max}} and kVcmaxk^{V_{c\max}} (kattge2007). These parameters are all function of the monthly temperature. Based on Kattge et al (2009), kJmaxk^{J_{\max}} is directly inferred from kVcmaxk^{V_{c\max}} (scaled with the temperature dependency of kJmaxk^{J_{\max}}) and the monthly temperature. There is no acclimation term on any of the parameters used for c4 plants.

The water limitation function GhumG^{hum} is impacting photosynthesis through gsg_{s} (GhumG^{hum}, see 1.3), but it is also limiting kVcmaxk^{V_{c\max}}, kJmaxk^{J_{\max}}, kgmk^{g_m} and FRdF^{R_d}.

FAF^A is scaled from leaf to canopy level by multiplying with diLAId^{LAI}_{i} (see 1.5.7). Apart from the IabsI_{abs}, the other environmental parameters that drive the photosynthesis (temperature, ambient CO2, air humidity) are held constant along the canopy depth. We only account for a leaf nitrogen-related reduction of kVcmaxk^{V_{c\max}} and FRdF^{R_d} along the canopy depth, depending on the fraction of absorbed light flightf_{light}, as calculated in the radiation transfer scheme (see 1.3.2).

The photon flux density absorbed by leaf photosynthetic pigments at canopy level ii (Iabs,iI_{abs,i}) is calculated as:

Iabs,n=SWdownflight,icWtomolcRGtoPAR,I_{abs,n}=\mathsf{SW}_{down}\cdot f_{light,i}\cdot c^{Wtomol}\cdot c^{RGtoPAR},

where cWtomolc^{Wtomol} is a conversion factor between units from Wm2\mathsf{W m^{-2}} to μmol photons m2s1\mathrm{\mu mol\ photons\ m^{-2} s^{-1}}, and cRGtoPARc^{RGtoPAR} is the fraction (=0.5) of SWdownSW_{down} that is photosynthetically active.

1.3DONE: Maintenance respiration

Maintenance respiration refers to the carbon cost that occurs in living plant tissue to maintain a healthy and living state, e.g., resynthesis of enzymes and membrane lipids, maintenance of ion gradients across membranes, and acclimation to environmental changes Amthor, 1984. ORCHIDEE does not distinguish the underlying processes and instead uses a bulk approach ruimy1996 in which maintenance respiration of a specific PFT within a grid cell (FrmF^{rm}; g C m2^{-2} s1^{-1}) is the sum of maintenance respiration of the different plant organs. It is calculated as a function of biomass modulated by the temperature and nitrogen content of the vegetative and reproductive plant organs:

Frm=o=1norganc1Momo,rm,Tmo,rm,N,F^{rm} = \sum_{o=1}^{norgan}{c_1 \cdot M^{o} \cdot m^{o,rm,T} \cdot m^{o,rm,N}},

where oo denotes the plant organ, norgannorgan denotes the total number of plant organs (see 1.4), c1c_1 (s1^{-1}) is a PFT-specific maintenance respiration coefficient prescribing the fraction of biomass that is lost during each time step and MoM^{o} (g C m2^{-2}) is the stand level nitrogen biomass of plant organ oo. c1c_1 is set to zero for the above-ground and below-ground heartwood as well as the carbohydrate reserves as ORCHIDEE assumes that these organs have no maintenance respiration.

mo,rm,Tm^{o,rm,T}, is a temperature modulator (unitless) calculated for each plant organ oo as:

mo,rm,T=1+(c2+c3T3year+c4T3year2)To,m^{o,rm,T} = 1 + (c_2 + c_3 \cdot T^{3year} + c_4 \cdot {T^{3year}}^2) \cdot T^{o},

where T3yearT^{3year} (K) represents the mean air temperature above freezing over the 3 years preceding the time step under consideration. c2c_2, c3c_3, and c4c_4 are PFT-specific parameters. For the above-ground plant organs, the 2-meter air temperature (TairT^{air}; K) is used for ToT^{o}. For below-ground plant organs, ToT^{o} represents the root-zone temperature Tsoil,weightedT^{soil,weighted} (K) calculated as the vertical profile of soil temperature (see 1.7.1) weighted by the vertical profile of the root biomass (see 1.5.10). When ToT^{o} drops below 273.15 K, mo,rm,Tm^{o,rm,T} is set to one, implying that maintenance respiration continues but levels off when freezing.

In equation 271, mo,rm,Nm^{o,rm,N} (unitless) is a modulator for the N concentration of organs oo and is calculated as:

mo,rm,N=fkcnc5kcnmax(min(1+(1fkcnc5kcn)c6,1.2),0.8),m^{o,rm,N} = \frac{f^{cn}_{k}}{{c_5}^{cn}_{k}} \cdot \max(\min( 1 + \left( 1 - \frac{f^{cn}_{k}} {{c_5}^{cn}_{k}} \right) \cdot c_6,\,1.2),\,0.8),

where c6c_6 is a global parameter, c5kcn{c_5}^{cn}_{k} is the reference carbon-to-nitrogen ratio for organ oo, i.e., 45 for leaves, 52 for roots and fruits, and 517 for the sapwood and carbohydrates reserves. fkcnf^{cn}_{k} (unitless) is the actual carbon-to-nitrogen ratio for organ oo which is truncated at 200 if the calculated carbon-to-nitrogen ratio exceeds this threshold.

The parameters c1c_1, c2c_2, c3c_3, c4c_4, but not c5c_5, have been tuned at the PFT-level and c6c_6 at the global level to simulate biomass production efficiencies within the ranges observed by Vicca et al. (2012) and Campioli et al. (2015). Given that ORCHIDEE v4.2 does not simulate the carbon fluxes from the vegetation to the mycorrhizae, the latter is included in FrmF^{rm}. The simulated maintenance respiration flux (FrmF^{rm}) should, therefore, not be compared against observed fluxes as their definitions are not identical.

1.4DONE: Allocation and growth respiration

1.4.1DONE: Allocatable carbon and nitrogen

Following bud burst, photosynthesis produces carbon compounds that are added to the labile carbon pool as long as the plant passed bud burst and is not in presenescence yet (see 1.1):

Mtlab,C=Mt1lab,C+FtgppΔt,M^{lab,C}_{t} = M^{lab,C}_{t-1} + F^{gpp}_{t} \cdot \Delta{t},

where Mtlab,CM^{lab,C}_{t} (g C m2^{-2}) is the labile carbon pool at the current time step tt, Mt1lab,CM^{lab,C}_{t-1} (g C m2^{-2}) is the labile carbon pool at time step t1t-1, FtgppF^{gpp}_{t} (g C m2^{-2} s1^{-1}) is the photosynthetic carbon flux at the current time step, and Δt\Delta{t} is the length of the current time step which is one day given in seconds (s). If the plant is in presenescence or senescence (see 1.1), the photosynthetic flux is added to the reserve pool:

Mtres,C=Mt1res,C+FtgppΔt,M^{res,C}_{t} = M^{res,C}_{t-1} + F^{gpp}_{t} \cdot \Delta{t},

where Mtres,CM^{res,C}_{t} and Mt1res,CM^{res,C}_{t-1} are the carbon contained in the reserve pool at time step tt and t1t-1 (g C m2^{-2}), respectively. The labile carbon pool is then split into an active and none-active pool. The size of the active pool is calculated as a function of plant phenology and temperature. If the plant passed bud break and is not in presenescence yet, the active part of the labile pool was formalized following Ryan (1991), Sitch et al. (2003), and Zaehle & Friend (2010):

Mtotinc=Mlab,Cexp(c1c2c3c1Tairc3),M^{totinc} = M^{lab,C} \cdot \exp\left(\frac{c_1}{c_2-c_3}-\frac{c_1}{T^{air}-c_3}\right),

where c1c_1, c2c_2 and c3c_3 are PFT-specific parameters representing respectively a growth temperature coefficient, the reference temperature above which all carbon in the labile pool is allocated to growth, and the minimum temperature for allocation. The parameters c1c_1, c2c_2 and c3c_3 were set such that no carbon is available for plant growth below -2 ° C, only 3 % of the labile pool is available for allocation at 0 ° C, and at 5 ° C, 100 % of the labile pool is available for allocation. TairT^{air} is the 2-m air temperature at tt, and MtotincM^{totinc} (g C m2^{-2}) is the total biomass increment at the current time step. If the plant passed presenescence, the active part of the labile pool is set to zero.

Prior to allocating, MtotincM^{totinc} is used to sustain the maintenance respiration flux (FrmF^{rm}; g C m2^{-2} s1^{-1}; see 1.3) up to a maximum of 100 % of MtotincM^{totinc}. A first estimate of the growth respiration, i.e., the cost for producing new tissue excluding the carbon required to build the tissue itself Amthor, 1984, is set aside. This first estimate assumes that all the available carbon will be allocated and is calculated as:

Frg,est=Mtotincc4(1+c4)Δt,F^{rg,est} = \frac{ M^{totinc} \cdot c_4}{ (1 + c_4) \cdot \Delta{t}},

where Frg,estF^{rg,est} (g C m2^{-2} s1^{-1}) is the estimated growth respiration and c4c_4 is the fraction of carbon respired to grow one unit of carbon, which is set to 28 % McCree, 1974. Hence, the amount of carbon that is available for biomass growth is:

Mtotinc=Mtotinc(Frm+Frg,est)Δt,M^{totinc} = M^{totinc} - (F^{rm}+F^{rg,est}) \cdot \Delta{t},

where Δt\Delta{t} is the length of the time step for the calculation of biomass allocation (see table 7). Once allocation is finalized, Frg,estF^{rg,est} will be recalculated (section 1.4.4) to obtain the exact growth respiration for the actual biomass increment.

Whether all of the available carbon can be allocated or not depends on the nitrogen availability. The labile N pool is calculated as:

Mtlab,N=Mt1lab,N+Ftroot,NΔt,M^{lab,N}_{t} = M^{lab,N}_{t-1} + F^{root,N}_{t} \cdot \Delta{t},

where Mtlab,NM^{lab,N}_{t} and Mt1lab,NM^{lab,N}_{t-1} (g N m2^{-2}) are the labile nitrogen pools at tt and t1t-1, respectively, and Ftroot,NF^{root,N}_{t} (g N m2^{-2} s1^{-1}) is the nitrogen uptake by the plants at the current time step. Subsequently, MtotincM^{totinc} is adjusted for the available nitrogen after estimating the nitrogen that would be required to allocate MtotincM^{totinc} entirely. This estimate assumes that all tissue has the carbon-to-nitrogen ratio of leaves:

b1=min(1fcn,leaf1c5,0),b_{1} = \min\left(\frac{1}{f^{cn,leaf}} - \frac{1}{c_5},0\right),

where fcn,leaff^{cn,leaf} (unitless) is the actual carbon-to-nitrogen ratio of leaves for the PFT and grid cell under consideration and c5c_5 is the PFT-specific minimal carbon-to-nitrogen ratio for leaves. The maximal elasticity of the carbon-to-nitrogen ratio of leaves b2b_{2} (unitless) is calculated as:

b2=1exp((1.6b11c61c5)4.1),b_{2} = 1 -\exp\left(-\left(1.6 \cdot \frac{b_{1}}{\frac{1}{c_6} - \frac{1}{c_5}}\right)^{4.1}\right),

where c6c_6 is the PFT-specific maximal carbon-to-nitrogen ratio for leaves. Assuming all newly grown biomass has the actual carbon-to-nitrogen ratio of leaves, b3b_{3} (g C m2^{-2}) represents the maximum amount of carbon that could be allocated at time step tt, given the available amount of nitrogen:

b3=Mlab,N0.9fcn,leafb_{3} = \frac{M^{lab,N} \cdot 0.9} {f^{cn,leaf}}

If there is enough nitrogen (thus Mtotinc<b3M^{totinc} < b_{3}), MtotincM^{totinc} can be allocated. If, however, there is not enough nitrogen to allocate the allocatable carbon entirely (thus Mtotinc>b3M^{totinc} > b_{3}), the elasticity of the carbon-to-nitrogen ratio of leaves is used to adjust MtotincM^{totinc}:

b4=Mlab,N0.9fcn,leafMtotinc,b5=min(max(b4,1c7(1b2)),1),b6=max(min(b5fcn,leaf,1c5),1c6),b7=min(Mlab,N0.9,Mtotincb6)Mtotinc=min(Mtotinc,b7b6),\begin{align} &b_{4} = \frac{M^{lab,N} \cdot 0.9 \cdot f^{cn,leaf}} {M^{totinc}}, \\ &b_{5} = \min \left(\max \left(b_{4},1 - c_7 \cdot \left(1 - b_{2} \right) \right),1 \right), \\ &b_{6} = \max \left(\min \left(\frac{b_{5}}{f^{cn,leaf}}, \frac{1}{c_5} \right), \frac{1}{c_6} \right), \\ &b_{7} = \min \left(M^{lab,N} \cdot 0.9, M^{totinc} \cdot b_{6} \right) \\ &M^{totinc} = \min \left(M^{totinc}, \frac {b_{7}} {b_{6}} \right), \end{align}

where c7c_7 is the maximal elasticity of foliage N concentrations and set to 0.25 and MtotincM^{totinc} is the carbon that will be allocated either for restoring plant allometry or for plant growth as described in the following sections.

1.4.2DONE: Plant allometry

Biomass is allocated to leaves, roots, sapwood, heartwood, and fruits. Allocation to leaves, roots and wood respects the pipe-model theory Shinozaki et al., 1964 and thus assumes that producing one unit of leaf mass requires a proportional amount of sapwood to transport water from the roots to the leaves as well as a proportional fraction of roots to take up the water from the soil.

The scaling parameter between leaf and sapwood mass is derived from:

dleaf=klsmwaterdsap,d^{leaf} = k^{ls} \cdot m^{water} \cdot d^{sap},

where dleafd^{leaf} (m2^{2}) is the one-sided leaf area of an individual plant, dsapd^{sap} (m2^{2}) is the sapwood area of an individual plant, klsk^{ls} a calculated parameter (unitless) linking leaf area to sapwood area and, mwaterm^{water} (unitless) is the water stress as calculated in section 1.1. Alternatively, leaf area can be written as a function of leaf mass (MleafM^{leaf}) and the specific leaf area (kslak^{sla}; m2^{2} g C1^{-1}):

dleaf=Mleafkslad^{leaf} = M^{leaf} \cdot k^{sla}

Sapwood mass MsapM^{sap} can be calculated from the sapwood area dsapd^{sap} as follows:

Msap=dsapdhc8,M^{sap} = d^{sap} \cdot d^{h} \cdot c_8,

where dhd^{h} is the tree height (m) and c8c_8 is the sapwood density (g C m3^{-3}). Following substitution of equations 285 and 286 into equation 284, leaf mass can be written as a function of sapwood mass:

Mleaf=MsapfKFdh,M^{leaf} = \frac{M^{sap} \cdot f^{KF}} {d^{h}},

where

fKF=klsmwaterkslac8,f^{KF} = \frac{k^{ls} \cdot m^{water}} {k^{sla} \cdot c_8},

where klsk^{ls} is calculated as a function of the gap fraction as supported by site-level observations Simonin et al., 2006:

kls=c9+fPgap(c10c9).k^{ls} = c_9 + f^{Pgap} \cdot (c_{10} - c_9).

c9c_9 is the minimum observed leaf area to sapwood area ratio, c10c_{10} is the maximum observed leaf area to sapwood area ratio and fPgapf^{Pgap} is the actual gap fraction of the canopy (see 1.5.8). By using the gap fraction as a driver of klsk^{ls} more carbon will be allocated to the leaves until canopy closure is reached.

Following Magnani et al. (2000), sapwood mass and root mass (MrootM^{root}) relate as follows:

Msap=c11dhMroot,M^{sap} = c_{11} \cdot d^{h} \cdot M^{root},

where the parameter c11c_{11} (m1^{-1}) is calculated according to Magnani et al. (2000) (their equation (17)):

c11=c12c14c8c13c15,c_{11} = \sqrt{\frac{c_{12} \cdot c_{14} \cdot c_8} {c_{13} \cdot c_{15}}},

where c12c_{12} is the hydraulic conductivity of roots (m3^{3} kg1^{-1} s1^{-1} MPa1^{-1}), c13c_{13} is the hydraulic conductivity of sapwood (m2^{2} s1^{-1} MPa1^{-1}), c14c_{14} is the longevity of sapwood (days) and c15c_{15} is the root longevity (days). Following substitution of equation 290 into 287 and rearrangement, leaf mass can be written as a function of root mass:

Mleaf=fLFMroot,M^{leaf} = f^{LF} \cdot M^{root},

where

fLF=c11fKF.f^{LF} = c_{11} \cdot f^{KF}.

Parameter values used in equations 284 to 292 are PFT-specific. The allometric relationships between the plant components and the hydraulic architecture of the plant are both based on the pipe-model theory, hence, the same parameter values for the hydraulic conductivity of the plant components, i.e., c12c_{12}, c13c_{13}, are used in their calculations (section 1.1).

1.4.3DONE: Restoring plant allometry

The different biomass pools have different turnover times (section 1.1), are affected differently by the phenological processes, and are managed differently. As a consequence, the actual biomass components may no longer respect the allometric relationships (see 1.4.2). Plant allometry is restored by making use of allometric relationships.

Mlleaf,target=max(fKFMlsapdlh,MlrootfLF,Mlleaf),Mlsap,target=max(MlleafdlhfKF,MlrootfLFdlhfKF,Mlsap),Mlroot,target=max(Mlleaf,targetfLF,fKFMlsapdlhfKF,Mlroot),\begin{align} & M^{leaf,target}_{l} = \max \left( \frac{f^{KF} \cdot M^{sap}_{l}}{d^{h}_{l}}, M^{root}_{l} \cdot f^{LF}, M^{leaf}_{l} \right), \\ & M^{sap,target}_{l} = \max \left( \frac{M^{leaf}_{l}\cdot d^{h}_{l}}{f^{KF}}, \frac{M^{root}_{l} \cdot f^{LF} \cdot d^{h}_{l}}{f^{KF}}, M^{sap}_{l} \right),\\ & M^{root,target}_{l} = \max \left( \frac{M^{leaf,target}_{l}}{f^{LF}}, \frac{f^{KF} \cdot M^{sap}_{l}}{d^{h}_{l} \cdot f^{KF}},M^{root}_{l} \right), \end{align}

where Mlleaf,targetM^{leaf,target}_{l}, Mlsap,targetM^{sap,target}_{l}, and Mlroot,targetM^{root,target}_{l} are, respectively, the leaf, sapwood, and root mass (g C plant1^{-1}) for circumference class ll following the allometric relationships. The carbon required to restore the allometric relationships is calculated as:

Mllinc=Mlleaf,targetMlleaf,Mlsinc=Mlsap,targetMlleaf,Mlrinc=Mlroot,targetMlleaf,Mlinc=Mllinc+Mlrinc+Mlsinc,\begin{align} & M^{linc}_{l} = M^{leaf,target}_{l} - M^{leaf}_{l}, \\ & M^{sinc}_{l} = M^{sap,target}_{l} - M^{leaf}_{l}, \\ & M^{rinc}_{l} = M^{root,target}_{l} - M^{leaf}_{l}, \\ & M^{inc}_{l} = M^{linc}_{l} + M^{rinc}_{l} + M^{sinc}_{l}, \end{align}

where MlincM^{linc}, MsincM^{sinc}, and MrincM^{rinc} are the increment of the leaf, sapwood, and root biomass (g C plant1^{-1}) for circumference class ll and MlincM^{inc}_{l} (g C plant1^{-1}) is the total biomass that is allocated to circumference class ll.

In ORCHIDEE v4.2, forests are modeled to have ncirc{ncirc} circumference classes with dindd^{ind} (plants m2^{-2}) identical trees in each circumference class. Hence, the allocatable biomass needs to be distributed across all individuals in ncirc{ncirc} circumference classes. Following the restoration of the allometric relationships, the biomass remaining to be allocated is calculated as:

Mtotinc=max(l=1ncircdlindMlinc,0)M^{totinc} = \max \left( \sum_{l=1}^{ncirc} d^{ind}_{l} \cdot M^{inc}_{l}, 0 \right)

Within a single time step, biomass is thus allocated until the allometic relationships are restored or MtotincM^{totinc} is consumed. It may take several time steps, especially at the start of the growing season, to restore the allometric relationships.

1.4.4DONE: Plant growth

Once the allometric relationships are restored, the pipe-model can be used to allocate biomass to leaves, sapwood and roots during plant growth. Fruit allocation is calculated first as it does not follow allometric relationships:

Mfinc=c16Mtotinc,M^{finc} = c_{16} \cdot M^{totinc},

where c16c_{16} is a PFT-specific parameter representing the share of carbon that is allocated to the fruits. MfincM^{finc} (g C m2^{-2}) is calculated at the PFT-level and then distributed over the circumference classes ll.

Equations 287 and 292 can be rewritten as:

Mlleaf+MllincMlsap+Mlsinc=fKFdlh+dlhinc,Mlleaf+Mllinc=(Mlroot+Mlrinc)fLF,\begin{align} &\frac{M^{leaf}_{l} + M^{linc}_{l}}{ M^{sap}_{l} + M^{sinc}_{l}} = \frac{f^{KF}}{d^{h}_{l} + d^{hinc}_{l}}, \\ &M^{leaf}_{l} + M^{linc}_{l} = (M^{root}_{l} + M^{rinc}_{l}) \cdot f^{LF}, \end{align}

and allometric relationship is used to describe the relationship between tree height and basal area:

dlh=kheight(4πdlba)c172,d^{h}_{l} = k^{height} \cdot \left( \frac{4}{\pi} \cdot d^{ba}_{l} \right)^{\frac{c_{17}}{2}},

where kheightk^{height} (m) is a grid cell specific parameter giving the tree height for a tree with a diameter of 1 meter (see 1.5.3), c17c_{17} is a PFT-specific parameter for the relationship between basal area and tree height, and dlbad^{ba}_{l} (m2^{2}) is the basal area of an individual tree in circumference class ll. The change in height is then calculated as a function of dlbad^{ba}_{l} and dlbaincd^{bainc}_{l} where dlbaincd^{bainc}_{l} (m2^{2}) is the basal area increment:

dlhinc=(kheight(4π(dlba+dlbainc))c172)dlh,d^{hinc}_{l} = \left(k^{height} \cdot \left( \frac{4}{\pi} \cdot \left( d^{ba}_{l} + d^{bainc}_{l} \right) \right) ^{\frac{c_{17}}{2}}\right) - d^{h}_{l},

The distribution of carbon across the ncircncirc circumference classes depends on the basal area of the model tree within each circumference class ll. Trees with a large basal area are expected to have a higher leaf area and photosynthesis and are, therefore, assigned more carbon for wood allocation than trees with a smaller basal area, according to the rule of Deleuze et al. (2004):

dlbainc=kγ2(dlcircc18kσ+((c18kσ+dlcirc)2(4kσdlcirc))1c19),d^{bainc}_{l} = \frac{k^{\gamma}}{2} \cdot \left( d^{circ}_{l} - c_{18} \cdot k^{\sigma} + \left( \left(c_{18} \cdot k^{\sigma} + d^{circ}_{l} \right)^{2} - \left(4 \cdot k^{\sigma} \cdot d^{circ}_{l} \right) \right)^{\frac{1}{c_{19}}} \right),

where dlbaincd^{bainc}_{l} and kγk^{\gamma} (m) are unknown. dlcircd^{circ}_{l} (m) is the circumference of the model tree in circumference class ll, c18c_{18} is a fixed parameter (unitless), c19c_{19} ranges between 2 and 3.5 in function of ddia,meand^{dia,mean}, and kσk^{\sigma} (m) is a calculated parameter. kσk^{\sigma} is a function of the diameter distribution of the stand at a given time step:

kσ=c20+c21dcirc,med,k^{\sigma} = c_{20} + c_{21} \cdot d^{circ,med},

where c20c_{20} and c21c_{21} are parameters (unitless) and dcirc,medd^{circ,med} is the median circumference of the ncircncirc circumference classes for the PFT and grid cell under consideration.

Equations 293 and 297 to 302 need to be simultaneously solved. An iterative scheme was avoided by linearizing equation 300, which was found to be an acceptable numerical approximation as allocation is calculated at a daily time step, and hence, the changes in height are small and the relationship is locally linear:

dlhinc=dlbaincfs,d^{hinc}_{l} = \frac{d^{bainc}_{l}}{f^{s}},

where fsf^{s} is the slope of the locally linearized equation 300 for all ncircncirc circumference classes and is calculated as:

fs=c22(kheight(4π(dba+c22))c172kheight(4πdba)c172),f^{s} = \frac{c_{22}}{\left( k^{height} \cdot \left(\frac{4}{\pi} \cdot \left( d^{ba}+c_{22} \right) \right)^{\frac{c_{17}}{2}} - k^{height} \cdot \left(\frac{4}{\pi} \cdot d^{ba} \right)^{\frac{c_{17}}{2}} \right)},

where c22c_{22} represents a typical increase in basal area for a single time step. Following linearization of equation 300, equations 293 and 297 to 304 can be substituted and rearranged to obtain a quadratic equation of which the positive root is used as a solution for kγk^{\gamma}. kγk^{\gamma} distributes photosynthates across the different circumference classes and as such controls the intra-species competition within a stand. kγk^{\gamma} thus depends on the total allocatable carbon and needs to be optimized at every time step. Once kγk^{\gamma} has been calculated, dlbaincd^{bainc}_{l}, MllincM^{linc}_{l}, MlrincM^{rinc}_{l} and MlsincM^{sinc}_{l} are calculated. Unallocated carbon, typically in the order of 109^{-9} to 1015^{-15}, is added back to MlabM^{lab} to preserve carbon.

For grasses and crops the height is calculated as a function of their biomass instead of function of basal area as is the case for forest. Likewise, a single circumference class is considered. Hence, intra-specific competition is not accounted for.

MllincM^{linc}_{l}, MlrincM^{rinc}_{l} and MlsincM^{sinc}_{l} propose how the carbon should be allocated to jointly respect plant allometry and intra-specific competition in the case of forest PFTs and plant allometry in the case of grassland and cropland PFTs, supposing that there is enough nitrogen to sustain the proposed growth. Prior to allocating these estimates to their respective pools, it is checked whether there is sufficient labile nitrogen to sustain the proposed allocation. When nitrogen is limiting, the allocation will be linearly adjusted (see below). Given the non-linearity of the pipe-model (section 1.4.2), such adjustments should be avoided and when they occur should be kept small. ORCHIDEE v4.2 reduces the need to adjust the proposed allocation by estimating, at the start of the allocation process (section 1.4.1), the mass of carbon that can be allocated given the available nitrogen. Now that all the required information is available, the subsequent calculations finalize and refine the initial estimate.

Nitrogen allocation starts with the calculation of the allocation fractions:

fleaf,alloc=l=1ncircMllincdlindMtotinc,fsap,above,alloc=c23l=1ncircMlsincdlindMtotinc,fsap,below,alloc=(1c23)l=1ncircMlsincdlindMtotinc,froot,alloc=l=1ncircMlrincdlindMtotinc,ffruit,alloc=l=1ncircMlfincdlindMtotinc,\begin{align} &f^{leaf,alloc} = \frac{\sum_{l=1}^{ncirc} M^{linc}_{l} \cdot d^{ind}_{l}}{M^{totinc}}, \\ &f^{sap,above,alloc} = \frac{ c_{23} \cdot \sum_{l=1}^{ncirc} M^{sinc}_{l} \cdot d^{ind}_{l}}{M^{totinc}}, \\ &f^{sap,below,alloc} = \frac{ (1-c_{23}) \cdot \sum_{l=1}^{ncirc} M^{sinc}_{l} \cdot d^{ind}_{l}}{M^{totinc}}, \\ &f^{root,alloc} = \frac{ \sum_{l=1}^{ncirc} M^{rinc}_{l} \cdot d^{ind}_{l}}{M^{totinc}}, \\ &f^{fruit,alloc} = \frac{ \sum_{l=1}^{ncirc} M^{finc}_{l} \cdot d^{ind}_{l}}{M^{totinc}}, \end{align}

where fleaf,allocf^{leaf,alloc}, fsap,allocf^{sap,alloc}, froot,allocf^{root,alloc}, and ffruit,allocf^{fruit,alloc} (unitless) are PFT-level fractions of the available carbon that are proposed to be allocated to the leaf, sapwood, root and fruit pools, respectively. The allocation within the sapwood pool is divided into above- and belowground sapwood, where the fraction allocated aboveground is given by the PFT-specific parameter c23c_{23}. Following the pipe-model approach that states that increasing the leaf mass has to be complemented by an increase in sapwood and roots to sustain the hydraulic continuity of the plant, the nitrogen cost is calculated as the total nitrogen mass required to allocate 1 g of N to the leaves Zaehle & Friend, 2010Vuichard et al., 2019:

fN,cost=fleaf,alloc+c24fsap,alloc+c25(froot,alloc+ffruit,alloc),f^{N,cost} = f^{leaf,alloc} + c_{24} \cdot f^{sap,alloc} + c_{25} \cdot (f^{root,alloc} + f^{fruit,alloc}),

where c24c_{24} is the carbon-to-nitrogen ratio of wood relative to the carbon-to-nitrogen ratio of leaves and set to 0.087, and c25c_{25} is the carbon-to-nitrogen ratio of roots relative to the carbon-to-nitrogen ratio of leaves and set to 0.86. Given the actual carbon-to-nitrogen ratio of the leaves fcn,leaff^{cn,leaf}, the carbon that could be allocated b6b_{6} (g C m2^{-2}) is calculated as:

b6=Mlab,Nfcn,leaffN,costb_{6} = \frac{M^{lab,N} \cdot f^{cn,leaf}}{f^{N,cost}}

In case there is not enough nitrogen to sustain the proposed biomass increments, i.e., MtotincM^{totinc} is greater than b6b_{6}), MtotincM^{totinc} will be reduced to meet the nitrogen availability by taking into account the elasticity of the carbon-to-nitrogen ration. The carbon that can be allocated MtotincM^{totinc}, given the maximal carbon-to-nitrogen elasticity b8b_{8} (unitless) and the available nitrogen Mlab,NM^{lab,N} (g N m2^{-2}), is calculated as:

b6=Mlab,NfN,costMtotincfcn,leaf,b7=min(max(b6,1b2),1),b8=min(Mlab,N,MtotincfN,costmax(min(b7fcn,leaf,1c5),1c6)),Mtotinc=min(Mtotinc,b8fN,costmax(min(b7fcn,leaf,1c5),1c6))\begin{align} &b_{6} = \frac{M^{lab,N} \cdot f^{N,cost}}{M^{totinc} \cdot f^{cn,leaf}}, \\ &b_{7} = \min \left( \max \left( b_{6},1-b_{2} \right),1 \right), \\ &b_{8} = \min \left( M^{lab,N}, M^{totinc} \cdot f^{N,cost} \cdot \max \left( \min \left( \frac{b_{7}}{f^{cn,leaf}},\frac{1}{c_5} \right), \frac{1}{c_6} \right) \right), \\ &M^{totinc} = \min \left( M^{totinc}, \frac{b_{8}} {f^{N,cost} \cdot \max \left( \min \left( \frac{b_7}{f^{cn,leaf}},\frac{1}{c_5} \right), \frac{1}{c_6} \right) } \right) \end{align}

In case there is sufficient nitrogen to sustain the proposed carbon allocation, MtotincM^{totinc} does not need to be recalculated, but the carbon-to-nitrogen ratio will be decreased to use as much nitrogen as possible until the maximum elasticity of the carbon-to-nitrogen ratio is reached:

b9=min(max(b6,1),1+b2)),b10=min(Mlab,N,MtotincfN,costmax(min(b9fcn,leaf,1c5),1c6)\begin{align} &b_{9} = \min(\max(b_{6},1),1+b_{2})), \\ &b_{10} = \min(M^{lab,N}, M^{totinc} \cdot f^{N,cost} \cdot \max \left( \min \left (\frac{b_{9}}{f^{cn,leaf}}, \frac{1}{c_5} \right), \frac{1}{c_6} \right) \end{align}

The nitrogen constraint is calculated at the PFT-level, and if nitrogen limitation requires a reduction in MtotincM^{totinc}, Ml,tlincM^{linc}_{l,t}, Ml,tsincM^{sinc}_{l,t}, and Ml,trincM^{rinc}_{l,t} are all linearly reduced.

The biomass increments for both carbon and nitrogen are taken from the labile pools and allocated to their respective biomass pools:

Ml,tleaf=Ml,t1leaf+Ml,tlinc,Ml,tsap=Ml,t1sap+Ml,tsinc,Ml,troot=Ml,t1root+Ml,trinc,Mtlab=Mt1labMtfincl=1ncirc(Ml,tlincMl,tsincMl,trinc)dl,tind\begin{align} &M^{leaf}_{l,t} = M^{leaf}_{l,t-1} + M^{linc}_{l,t}, \\ &M^{sap}_{l,t} = M^{sap}_{l,t-1} + M^{sinc}_{l,t}, \\ &M^{root}_{l,t} = M^{root}_{l,t-1} + M^{rinc}_{l,t}, \\ &M^{lab}_{t} = M^{lab}_{t-1} - M^{finc}_{t} - \sum_{l=1}^{ncirc}{(M^{linc}_{l,t} - M^{sinc}_{l,t} - M^{rinc}_{l,t}) \cdot d^{ind}_{l,t}} \end{align}

Sapwood contains mostly physiologically active cells that transport water and minerals from the roots to the leaves through the stem Thomas, 2014. As the sapwood ages, the cells nearest to the center of the trunk accumulate chemical compounds which makes theses cells to give up their transport function to become what is known as heartwood Thomas, 2014. In ORCHIDEE v4.2 the carbon and nitrogen contained in the sapwood is turned over into heartwood with a PFT-specific time constant that represents the longevity of the sapwood. Contrary to the other turnover processes in ORCHIDEE v4.2, sapwood turnover is not added to the litter pool as the biomass is not lost, but converted to heartwood:

Ml,tsap=Ml,t1sap(Δt1c7),Ml,theart=Ml,theart+Ml,t1sapc7.\begin{align} &M^{sap}_{l,t} = M^{sap}_{l,t-1} \cdot \left( \Delta t - \frac{1}{c_7} \right),\\ &M^{heart}_{l,t} = M^{heart}_{l,t} + \frac{M^{sap}_{l,t-1}}{c_7}. \end{align}

The initial estimate of the growth respiration Frg,estF^{rg,est} (equation 277) can be recalculated now that the final allocation has been decided on:

Frg=c4MtotincΔtF^{rg} = \frac{c_4 \cdot M^{totinc}} {\Delta{t}} \\

The carbon that was set aside for growth respiration but not used, i.e., the difference between the initial estimate (Frg,estF^{rg,est}; equation 277) and the final calculation (FrgF^{rg}; equation 311) is moved back into the labile carbon pool:

Mlab,C=Mlab,C+(Frg,estFrg)ΔtM^{lab,C} = M^{lab,C} + (F^{rg,est} - F^{rg}) \cdot \Delta{t}

1.4.5DONE: Labile and reserve pools

The target carbon mass for the labile pool Mlab,targetM^{lab,target} is calculated as a function of the nitrogen biomass of the living plant organs and the actual 2-meter air temperature:

Mlab,target=c26exp(c1c2c3c1Tairc3)(Mleaf,N+Mroot,N+Mfruit,N+Msap,N),Mlab,target=max(Mlab,target,10Fgpp,weekΔt),\begin{align} &M^{lab,target} = c_{26} \cdot \exp(\frac{c_1}{c_2-c_3}-\frac{c_1}{T^{air}-c_3}) \cdot (M^{leaf,N} + M^{root,N}+ M^{fruit,N} + M^{sap,N}), \\ &M^{lab,target} = \max(M^{lab,target}, 10 \cdot F^{gpp,week} \cdot \Delta{t}), \end{align}

where c26c_{26} is a PFT-specific parameter, Mo,NM^{o,N} (g N m2^{-2}) is the nitrogen mass of plant organ oo, and Fgpp,weekF^{gpp,week} is the mean photosynthetic flux over the past week.

The target carbon mass for the reserve pool is calculated as a function of the phenology type of the PFT. For evergreen forests the target reserve pool is calculated as:

Mres,target=min(c27Msap,C,Mleaf,target,C(1+c28fLF)),M^{res,target} = \min(c_{27} \cdot M^{sap,C}, M^{leaf,target,C} \cdot (1+\frac{c_{28}}{f^{LF}})),

where c27c_{27} and c28c_{28} are PFT-specific parameters representing the share of the sapwood and roots, respectively, to the reserve pool, Mres,targetM^{res,target} is the target mass for the reserve carbon pool, and Mleaf,target,CM^{leaf,target,C} (g C m2^{-2}) is the leaf carbon mass for a canopy that is in allometric balance with the sapwood carbon mass. For deciduous forest the target reserve pool is calculated as:

Mres,target=c29Msap,C,M^{res,target} = c_{29} \cdot M^{sap,C},

where c29c_{29} is a PFT-specific parameter representing the share of the sapwood to the reserve pool. The value of c29c_{29} also depends on the plant phenology. The value is higher when the plant is in (pre)senescence. For grassland PFTs the target reserve pool is calculated as:

Mres,target=min(c29(Mr,C+Msap,C),Mleaf,target,C(1+c28fLF).M^{res,target} = \min(c_{29} \cdot (M^{r,C} + M^{sap,C}), M^{leaf,target,C} \cdot (1+\frac{c_{28}}{f^{LF}}).

ORCHIDEE v4.2 fills the reserve and labile pools at the same time but with different (arbitrary) speeds. In ORCHIDEE v4.2 there are two important differences between the reserve and the labile pool: (1) only the labile pool is used in the allocation but storing carbon and nitrogen in the labile pool comes with a carbon cost, i.e., maintenance respiration, and (2) the reserve pool comes without maintenance respiration but the carbon contained in it cannot be allocated. These differences imply that the plant should store as much carbon and nitrogen as needed for growth in its labile pool but no more than that to limit the respiration cost. This trade-off is formalized as:

Mres,targetx2+Mlab,targetx=Mres+Mlab,M^{res,target} \cdot x^{2} + M^{lab,target} \cdot x = M^{res} + M^{lab},

For simplicity it was assumed that carbon can move freely between both pools. The optimal allocation to both pools can be calculated by solving equation 318 for xx.

Mres=max(0.1(Mres,target+Mlab,target),min((Mres,targetx2),0.9(Mres,target+Mlab,target))),Mlab=max(0,Mres,target+Mlab,targetMres).\begin{align} &M^{res} = \max(0.1 \cdot (M^{res,target}+M^{lab,target}), \min((M^{res,target} \cdot x^{2}), 0.9 \cdot (M^{res,target}+M^{lab,target}))), \\ &M^{lab} = \max(0,M^{res,target}+M^{lab,target} - M^{res}). \end{align}

As long as Mres+MlabM^{res} + M^{lab} is below the target, xx is less than one, implying that the available carbon will be preferentially stored in the labile pool. Once the target has been reached, xx exceeds one, implying that the available carbon will be preferentially stored in the reserve pool.

Following carbon allocation to the reserve and labile pool, nitrogen is allocated:

Mlab,target,N=Mlab,target,Cfcn,leaffN,cost,b11=Mlab,NMlab,target,N,Mres,N=Mres,N+b11.\begin{align} &M^{lab,target,N} = \frac{M^{lab,target,C}}{f^{cn,leaf}} \cdot f^{N,cost},\\ &b_{11} = M^{lab,N} - M^{lab,target,N},\\ &M^{res,N} = M^{res,N} + b_{11}. \end{align}

ORCHIDEE v4.2 does not control the carbon-to-nitrogen ratio of the the reserve pool; even if nitrogen is limiting plant growth, carbon may accumulate in the reserve pool. Rather than respiring this excessive carbon Amthor, 2000Chambers et al., 2004, ORCHIDEE decreases its photosynthesis to reduce the further accumulation of carbon. Photosynthesis is reduced when a PFT has more labile and reserve carbon than the target mass of the labile and reserve pools. Reduced photosynthesis when reserve and labile carbon start to accumulate is justified by the observation that too much sugars in the leaves increases sap viscosity which in turn hampers the sap flow in the phloem. Viscosity can be reduced by closing the stomata and transpiring less of the sap flow from the xylem. By closing the stomata, photosynthesis will be reduced Hölttä et al., 2017. Because ORCHIDEE v4.2 does not calculate the phloem sap flow, turgor, or viscosity yet, a ratio fsugarloadf^{sugarload} is used to reduce the nitrogen use efficiency used in the calculation of photosynthesis (see 1.2). If the plant has less carbon in its labile and reserve pools than targeted, the nitrogen use efficiency is increased. Up and down regulation of nitrogen use efficiency is only accounted for between bud break and the start of (pre)senescence.

ftsugarload=Mres,target,C+Mlab,target,CMres,C+Mlab,C,f^{sugarload}_{t} = \frac{M^{res,target,C} + M^{lab,target,C}}{M^{res,C} + M^{lab,C}},

where ftsugarloadf^{sugarload}_{t} (unitless) is a proxy for sugar loading at time step tt. The sugar loading used to regulate the nitrogen use efficiency is the average sugar loading over the last 7 days to avoid sudden changes in the nitrogen use efficiency.

1.5DONE: Vegetation characteristics

1.5.1DONE: Leaf age

ORCHIDEE v4.2 distinguishes four age classes (nlagenlage) where the length (days) of an individual age ii class is PFT-specific and calculated as:

li=b2nlage,l_{i} = \frac{b_{2}}{nlage},

where b2b_{2} is the PFT-specific, location specific critical leaf longevity (days) calculated as:

b1=max(c1c3,c1c4(T3yearc5)),b2=min(c1c2,b1)\begin{align} &b_{1} = \max(c_1 \cdot c_3, c_1 - c_4 \cdot (T^{3year} - c_5)),\\ &b_{2} = \min(c_1 \cdot c_2, b_{1}) \end{align}

where c1c_1 is the parameter prescribing the longevity of a typical leaf or needle at the reference temperature (c5c_5, K) for the PFT under consideration. c2c_2, and c3c_3 are parameters to calculate the upper and lower boundaries of the critical leaf age. The parameter c4c_4 describes the temperature dependency of the critical leaf age in between its lower and upper boundary. The temperature dependency makes b1b_{1} location specific in addition to c1c_1, c2c_2, c3c_3, c4c_4, and c5c_5 being PFT-specific. The temperature dependency enables simulating a range in longevity within in a single PFT.

Newly allocated leaf biomass (MlincM^{linc}) goes into the first age class:

M1leaf=f1leafMleaf+Mlinc,M^{leaf}_{1} = f^{leaf}_{1} \cdot M^{leaf} + M^{linc},

where fileaff^{leaf}_{i} is the fraction of leaf mass in leaf age class ii and f1leaff^{leaf}_{1} is thus the fraction of leaf mass in the first age class. The fractions for the youngest leaf age class is then calculated:

f1leaf=M1leaf(Mleaf+Mlinc).f^{leaf}_{1} = \frac{M^{leaf}_{1}} {(M^{leaf} + M^{linc})}.

The fractions for the remaining leaf age classes are then calculated as:

fileaf=fileafMleaf(Mleaf+Mlinc).f^{leaf}_{i} = \frac{f^{leaf}_{i} \cdot M^{leaf}} {(M^{leaf} + M^{linc})}.

Each time step, the age of the leaves (aileafa^{leaf}_{i}) in age class ii increases with the number of days of the time step (Δt\Delta{t}):

ai,tleaf=ai,t1leaf+Δta^{leaf}_{i,t} = a^{leaf}_{i,t-1} + \Delta{t}

The turnover between the leaf age classes ii is calculated as:

Δfileaf=fi1leafΔtli\Delta{f^{leaf}_{i}} = \frac{f^{leaf}_{i-1} \cdot \Delta{t}} {l_{i}}

The fraction of the leaves in each age class is then updated:

fi1leaf=min(0,fi1leafΔfileaf)fileaf=fileaf+Δfileaf\begin{align} &f^{leaf}_{i-1} = \min(0,f^{leaf}_{i-1} - \Delta{f^{leaf}_{i}}) \\ &f^{leaf}_{i} = f^{leaf}_{i} + \Delta{f^{leaf}_{i}} \end{align}

The leaf age in each age class ii is updated from its previous value:

aileaf=(fileafΔfi+1leaf)aileaf+Δfileafai1leaffileaf+ΔfileafΔfi+1leafa^{leaf}_{i} = \frac{(f^{leaf}_{i} - \Delta{f^{leaf}_{i+1}}) \cdot a^{leaf}_{i} + \Delta{f^{leaf}_{i}} \cdot a^{leaf}_{i-1}} {f^{leaf}_{i} + \Delta{f^{leaf}_{i}} - \Delta{f^{leaf}_{i+1}}}

As there is no turnover in the last age class (nlagenlage), leaf age is updated as follows:

anlageleaf=fnlageleafanlageleaf+Δfnlageleafanlage1leaffnlageleaf+Δfnlageleafa^{leaf}_{nlage} = \frac{f^{leaf}_{nlage} \cdot a^{leaf}_{nlage} + \Delta{f^{leaf}_{nlage}} \cdot a^{leaf}_{nlage-1}} {f^{leaf}_{nlage} + \Delta{f^{leaf}_{nlage}}}

The leaf age fractions are then normalized to avoid numerical issues. Mean leaf age (aleafa^{leaf}) is used in the calculation of photosynthesis (section 1.2) and senescence (section 1.1) and calculated as the mean of all nlagenlage age classes weighted by their mass fractions:

aleaf=i=1nlagefileafaileafa^{leaf} = \sum_{i=1}^{nlage}{f^{leaf}_{i} \cdot a^{leaf}_{i}}

1.5.2DONE: Specific leaf area

The specific leaf area kslak^{sla} (m2^{2} g1^{-1}) is needed to convert leaf mass, which is a prognostic variable in ORCHIDEE, to leaf area which is used in the calculation of, among others, photosynthesis, interception, albedo, and canopy cover. The specific leaf area of a PFT at a given location is calculated as a function of the leaf biomass Vuichard et al., 2019 to better account for the observed variation in specific leaf area Reich et al., 1999Poorter et al., 2012:

ksla=ln(1+c1Mleafc2)c1Mleaf,k^{sla} = \frac{\ln(1 + c_1 \cdot M^{leaf} \cdot c_2)} {c_1 \cdot M^{leaf}},

where c1c_1 is the PFT-specific extinction coefficient of the vertical nitrogen distribution in the canopy Dewar et al., 2012 and c2c_2 is the initial value for the PFT-specific specific leaf area. The user choose to use a fixed PFT-specific specific leaf area as an alternative to the dynamic approach described in this section.

1.5.3DONE: Tree height

In ORCHIDEE v4.2 the diameter and height of an individual tree are calculated from its tree mass by assuming: (1) a PFT-specific form factor to account for the fact that trunks are conical rather than cylindrical, (2) a PFT-specific wood density, and (3) a PFT-specific relationship between the diameter and height of the tree (i.e., equation 299). The relationship between tree diameter and height makes use of the parameter kheightk^{height} which represents the height of a tree with a diameter of 1 meter.

The calculation of kheightk^{height} as a function of precipitation is based on the principles laid out in Kempes et al. (2011). In that paper, transpiration (FTrF^{Tr}) of an individual tree scales to tree height (equation 3 in Kempes et al. (2011)); likewise, the root radius dr,rootd^{r,root} of a tree scales to tree height (equation 4 in Kempes et al. (2011)), and the water available to an individual tree (Fw,availF^{w,avail}) is then calculated as a function of its root radius (equation 5 in Kempes et al. (2011)), shown as below:

FTr=c1dhc2,dr,root=c314dh,Fw,avail=c3π(dr,root2)P\begin{align} &F^{Tr} = c_1 \cdot {d^{h}}^{c_2}, \\ &d^{r,root} = c_3^{\frac{1}{4}} \cdot d^{h}, \\ &F^{w,avail} = c_3 \cdot \pi \cdot ({d^{r,root}}^{2}) \cdot P \end{align}

The maximum tree height will be reached when all the water available to the tree is used for transpiration. Following substitution of equations 334 to %s, maximum tree height can be written as a function of precipitation (PP) and kheightk^{height} is then calculated as:

kheight=max(c6,c4P3yearc5),k^{height} = \max(c_6, c_4 \cdot {P^{3year}}^{c_5}),

where c4c_4 and c5c_5 are global parameters that were parameterized by fitting the annual precipitation sum from the CRUJRA climate forcing Harris et al., 2020Harris et al., 2014Kobayashi et al., 2015 to the GEDI-derived 75 % tree heights Potapov et al., 2021 for the year 2019. After assuming that the diameter of the trees that reached the 75 % percentile height was 0.5 m, the fitted c5c_5, and observed 75 % height were used to recalculate c4c_4 for a tree with a diameter of 1.0 m in line with the definition of kheightk^{height}. c6c_6 represents the minimal value for kheightk^{height} and is used at the start of the simulation when the accumulated precipitation is still unrepresentative for the long-term precipitation of a given location, P3yearP^{3year} is the long-term precipitation represented by the annual precipitation over the last 3 years. Hence, due to its dependency on precipitation, kheightk^{height} is location-dependent rather than PFT-specific.

1.5.4DONE: Vegetation density

For croplands and grasslands, ORCHIDEE v4.2 defines an individual as all plants that occupy a square metre of land. The maximum density of a cropland or grassland in ORCHIDEE is therefore 10,000 individuals per hectare. The vegetation density of croplands, defined as the number of individuals per unit of area, is calculated as:

dind=c1d^{ind} = c_1

where dind^{ind} is the density of the cropland (ind m2^{-2}), and c1_1 is a specific parameter of the PFT that prescribes the density. The fixed density reflects the practice in agriculture to plant at the final density to avoid individual plant mortality before harvest. Although a temporally fixed density for croplands is justifiable, cropland PFTs in ORCHIDEE are global and only distinguish C3 and C4 plants. Maize grown in, for example, humid temperate and semi-arid climates have the same density in ORCHIDEE although the biomass of an individual may differ.

Unlike croplands, the actual density of grasslands is not fixed to a prescribed parameter, but instead is calculated. Grassland density is decreased based on both the reserve and labile carbon, and the adjustment is calculated daily when the reserve and labile carbon in the plant drop below their respective target values and this condition persists over a longer time period. The downwards adjusted density of a grassland is estimated in accordance with the available resources by redistributing the resources among a maximum number of individuals capable of surviving under the given environmental conditions. By decreasing the number of individuals and redistributing the labile and reserve carbon among the surviving plants, their chances of future survival increase. The new, decreased number of individuals is calculated as:

dt+1ind=Mttot,CdtindMtres,targetMtlab,targetMttot,CMtresMtlabiled^{ind}_{t+1} = \frac{M^{tot,C}_{t} \cdot d^{ind}_{t} - M^{res,target}_{t} - M^{lab,target}_{t}}{M^{tot,C}_{t} - M^{res}_{t} - M^{labile}_{t}}

where Mtres,C^{res,C}_{t} (gC ind1^{-1}), Mtlabile,C^{labile,C}_{t} (gC ind1^{-1}), and Mttot,C^{tot,C}_{t} (gC ind1^{-1}) are the carbon biomasses of the reserve, the labile pool, and the sum of all plant compartments of an individual. Mtres,target,C^{res,target,C}_{t} (gC ind1^{-1}) and Mtlab,target,C^{lab,target,C}_{t} (gC ind1^{-1}) refer to the target pools for reserve carbon and labile carbon, respectively, which are calculated as explained in Section 1.4.5. The subscript t and t+1 refer to the value before and after the density adjustment, hence, dtind^{ind}_{t} (ind m2^{-2}) is the initial density, and dt+1ind^{ind}_{t+1} (ind m2^{-2}) is the downwards adjusted density.

Note that the carbon of other compartments, i.e., leaf, aboveground sapwood, root, and fruit in each individual remains constant when the number of individuals is decreased. The nitrogen content of each compartment in an individual is updated by multiplying the previous nitrogen content by the ratio of the previous density to the current density. A minimum density of 0.05 is set to avoid numerical errors. In ORCHIDEE, grassland densities is only decreased during the following phenological stages: pre-senescence, senescence, and dormancy (for a more detailed description of the phenological stages see Section 1.1.1).

When the carbon content in both reserve and labile pools exceeds the target, and there is carbon presents in the fruit pool, grass density will be increased. The carbon from the fruit, reserve, and labile pools will be used to create new individuals. After updating the number of individuals, the labile and reserve pools equal their target values:

dt+1ind=Mttot,CdtindMtres,target,CMtlab,target,CMttot,CMtres,CMtlabile,CMtfruit,Cd^{ind}_{t+1} = \frac{M^{tot,C}_{t} \cdot d^{ind}_{t} - M^{res,target,C}_{t} - M^{lab,target,C}_{t}}{M^{tot,C}_{t} - M^{res,C}_{t} - M^{labile,C}_{t} - M^{fruit,C}_{t}}

where Mtfruit,C^{fruit,C}_{t} (gC ind1^{-1}) is the biomass stored in the fruit pool. The density is only increased during the phenological stage labelled as growth (for a more detailed description of the phenological stages see Section 1.1.1). This approach for increasing grassland density reflects grass recruitment through asexual means, which is suited to treat perennial plants Blair et al., 2013. Note that the carbon of other compartments, i.e., leaf, aboveground sapwood and roots, in each individual remain constant during the density in increased. Nitrogen is treated using the same method as that applied to decreasing density.

In ORCHIDEE v4.2 the simulated grasslands density accounts for spatial and temporal dynamics by accounting for the carrying capacity of the location. For grasslands, the reserve and labile carbon pools are used as a proxy for the carrying capacity of a grid cell. When the density of a grassland increases, recruitment through vegetative reproduction is simulated, but the biomass of the new individuals is identical to the biomass of the already established individuals. Vegetation density of grasslands is an emerging property of the model, as there are no parameters describing the density.

For forests, the resource availability at a given location and PFT determines the maximum number of individuals (dind,maxd^{ind,max}; m2^{-2}) that the site can support. Compared to a site with a low carrying capacity, sites with higher carrying capacities can maintain higher stand densities for the same quadratic mean diameter (dqmdiad^{qmdia}). When the maximum carrying capacity is reached, individual trees die and the resources that become available as a result of this mortality event are used by the remaining trees. This process is known as self-thinning and formalized in the commonly observed self-thinning relationship Reineke, 1933Yoda et al., 1963.

dind,max=(dqmdiakα)1c1,dqmdia=l=1ncircdldia2dlindl=1ncircdlind,\begin{align} &d^{ind,max} = \left(\frac{d^{qmdia}}{k^{\alpha}}\right)^{\frac{1}{c_1}},\\ &d^{qmdia} = \sqrt{\sum_{l=1}^{ncirc}{\frac{{d^{dia}_{l}}^{2} \cdot d^{ind}_{l}} { \sum_{l=1}^{ncirc}{d^{ind}_{l}}}}}, \end{align}

where is c1c_1 is the PFT-specific exponent of the self-thinning relationship and expected to be between -0.66 Westoby, 1984Zeide, 1987 and -0.75 West et al., 1999. kαk^{\alpha} represents the carrying capacity for a given grid cell and PFT. ORCHIDEE v4.2 contains two approaches to simulate the carrying capacity. It is prescribed and thus fixed at the PFT-level, or the carrying capacity depends on the climatic conditions, available plant water, light, and nutrients Zeide, 1987Puettmann et al., 1993Zeide, 2005Pretzsch, 2006. In ORCHIDEE v4.2 the calculation of photosynthesis accounts for all these factors and could therefore be considered as a modifier for the carrying capacity.

During the spinup of the model, kαk^{\alpha} is calculated as:

kα=c2max(min(Fgpp,refc3,1.25),0.75)k^{\alpha} = c_2 \cdot \max(\min\left(\frac{F^{gpp,ref}} {c_3}, 1.25 \right), 0.75)

where c2c_2 is the PFT-specific reference carrying capacity, c3c_3 is the PFT-specific pre-industrial reference photosynthesis, and Fgpp,refF^{gpp,ref} (g C m2^{-2} s2^{-2}) is the pre-industrial reference photosynthesis for a given grid cell and PFT. Fgpp,refF^{gpp,ref} is calculated as the decadal mean photosynthetic flux. As the purpose of a model spinup is to bring the carbon, nitrogen and water pools into equilibrium, the temporal dynamics are deliberately kept to the minimum. Therefore, the spinup establishes the spatial variation in kαk^{\alpha}. During transient, historical, and future simulations, the carrying capacity, and thus the stand density, evolves over time as the growing environment is changing due to global changes such as climate change and nitrogen deposition. The temporal dynamics in kαk^{\alpha} are then calculated as:

kα=kαFgpp,decadeFgpp,refk^{\alpha} = k^{\alpha} \cdot \frac{F^{gpp,decade}}{F^{gpp,ref}}

where Fgpp,refF^{gpp,ref} is the mean photosynthesis over the previous decade. As an alternative to the calculated kαk^{\alpha}, a prescribed PFT-specific parameter can be used to calculate dind,maxd^{ind,max} in equation 339. If a PFT-specific parameter is used, the carrying capacity is no longer a function of global changes.

The relative density index (fRDIf_{RDI}, unitless) expresses the fraction of the actual density against the maximum stand density given the carrying capacity of the location and PFT. Although the concept of relative density is rooted in forest management Garcia, 2012, it can also be applied to unmanaged forest as it has been observed that the actual stand density of unmanaged forests is also below the maximum density based on their carrying capacity luyssaert2011. Nevertheless, the processes responsible for the reduction in stand density differ between managed and unmanaged forests. In managed forest, forestry and natural disturbances are the main drivers of the density reduction whereas in unmanaged forests competition between individual trees and natural disturbances are the main drivers.

ORCHIDEE v4.2 uses three different relative densities in its calculations: the actual (fRDI,actf^{RDI,act}), the lower target (fRDI,lowf^{RDI,low}), and the upper target relative density (fRDI,uppf^{RDI,upp}). If the actual relative density exceeds the upper target for relative density, the stand density (dindd^{ind}) is reduced such that it matches the lower target for relative density (sections 1.6 and 1.4. The processes driving the reduction in stand density depend on the forest management strategy applied to the PFT and grid cell (sections 1.6 and 1.4). The relative densities are calculated as follows:

fRDI,act=dinddind,max,fRDI,low=i=1ndeg(cilowdqmdiai),fRDI,upp=i=1ndeg(ciuppdqmdiai),\begin{align} &f^{RDI,act} = \frac{d^{ind}}{d^{ind,max}},\\ &f^{RDI,low} = \sum_{i=1}^{ndeg}({c^{low}_{i} \cdot {d^{qmdia}}^{i}}),\\ &f^{RDI,upp} = \sum_{i=1}^{ndeg}({c^{upp}_{i} \cdot {d^{qmdia}}^{i}}), \end{align}

cilowc^{low}_{i} and ciuppc^{upp}_{i} are obtained from fitting a polynomial through five management-specific parameters. The five key parameters that define the targeted relative density are: (1) relative density of a newly planted stand, (2) the maximum relative density, (3) the relative density when the diameter reaches its maximum, (4) the largest tree diameter, and (5) diameter above which the initial relative density starts to increase. These parameters are defined for each management strategy in ORCHIDEE v4.2 as well as for unmanaged forests, and may vary by PFT. ndegndeg is the degree of the polynomial function which in turn depends on the forest management strategy (section 1.4. For unmanaged forest a two degree polynomial is used, for the other management strategies the polynomial is fitted with three degrees.

In ORCHIDEE v4.2 the forest density calculation accounts for spatial and temporal dynamics by accounting for the carrying capacity of the grid cell. For forests the carrying capacity is estimated from photosynthesis. Recruitment is calculated as a separate demographic process (Section 1.10.2) and recruits have a lower biomass than the already established vegetation in the stand. Although the parameter representing the carrying capacity is adjusted to the environmental conditions of each grid cell, the shape-parameter of the self-thinning relationship is held constant within the PFT for the length of the simulation. Stand density in forests, therefore, remains strongly guided by the self-thinning relationship.

1.5.5DONE: Circumference distribution

Whenever the model is set-up to run with more than one circumference class (ncircncirc > 1), the total stand density based on the self-thinning relationship (section 1.5.4), has to be distributed over the different circumference classes. Equation 301 of the carbon and nitrogen allocation scheme requires that, at all times, more than one circumference class contains individuals. In ORCHIDEE v4.2, the number of circumference classes is fixed (ncircncirc) to limit the memory use, but the boundaries and number of individuals in each circumference class are updated as the simulation proceeds. Given its flexibility and resemblance with observed circumference distributions pretzsch2009, a Weibull distribution is used to calculate the distribution in both managed and unmanaged forests.

The Weibull distribution is a continuous distribution implying that it also estimates occurrence probabilities of unrealistically large trees. In ORCHIDEE, these unrealistically large trees are avoided by introducing the parameter c1c_1 at which the Weibull is truncated. c1c_1 is prescribed and depends on the forest management strategy. The shape parameter (kshapek^{shape}, unitless) of the Weibull distribution is calculated or prescribed depending on the forest management strategy:

kshape={if rotational even-aged,  dqmdiac2c3+0.5else, c2k^{shape}= \begin{cases} \text{if rotational even-aged, }\ &\frac{d^{qmdia} \cdot c_2}{c_3} + 0.5\\ \text{else,}\ &c_2 \end{cases}

where dqmdiad^{qmdia} (m) is the quadratic mean stand diameter, c2c_2 is a prescribed parameter that depends on PFT, and c3c_3 (m) is the prescribed PFT-specific tree diameter above which a stand is harvested. c3c_3 is the same parameter as c1c_1 in section 1.4.2). The Weibull cumulative distribution function (flindf^{ind}_{l}; unitless) for circumference class ll is:

b1,l=(1exp(c4kshape))(1exp((c4c1ncirc)kshape))flind=b1,ll=1ncircb1,ldlind=flinddind\begin{align} &b_{1,l} = ( 1 - \exp(-c_4^{k^{shape}})) - ( 1 - \exp(-(c_4 - \frac{c_1}{ncirc})^{k^{shape}}))\\ &f^{ind}_{l} = \frac{b_{1,l}}{\sum_{l=1}^{ncirc}{b_{1,l}}}\\ &d^{ind}_{l} = f^{ind}_{l} \cdot d^{ind} \end{align}

where (c4c_4; m) is the center diameter of circumference class ll. This approach allows the circumference distribution to change dynamically, over the course of several decades, as the stand structure evolves. Under rotational even-aged management the distribution is expected to evolve, from a stand structure dominated by many small individuals to a structure centered around the diameter targeted for exploitation (c3c_3). Under continuous cover forestry as well as for unmanaged stands, a structure with many small individuals and fewer large individuals is maintained through time. The circumference class distribution is updated daily after accounting for mortality (section 1.6.3), forestry (section 1.4), land cover change (section 1), and disturbances (section 1).

1.5.6DONE: Forest structure

The simulation of carbon and nitrogen cycling within ORCHIDEE is based on mass flow with a rigorous mass balance check, hence, the mass of the different components are among the prognostic variables. Structural characteristics are diagnostic variables that are, whenever needed, calculated from the mass of the relevant components. Structural characteristics of an individual tree can be calculated from its mass by assuming: (1) a PFT-specific form factor (ffff^{ff}) to account for the fact that trunks are conical rather than cylindrical, (2) a PFT-specific wood density, and (3) a relationship between the diameter and height of the tree that depends on both precipitation and PFT (i.e., equation 299):

Mlstem=Mlsap+Mlheart,Mlstem=dlvolc1,dlvol=dlbadlhfff,dlba=π4dldiac2,dlh=kheightdldiac2,\begin{align} &M^{stem}_{l} = M^{sap}_{l} + M^{heart}_{l},\\ &M^{stem}_{l} = d^{vol}_{l} \cdot c_1, \\ &d^{vol}_{l} = d^{ba}_{l} \cdot d^{h}_{l} \cdot f^{ff}, \\ &d^{ba}_{l} = \frac{\pi}{4} \cdot {d^{dia}_{l}}^{c_2}, \\ &d^{h}_{l} = k^{height} \cdot {d^{dia}_{l}}^{c_2}, \end{align}

where MlstemM^{stem}_{l} (g C plant1^{-1}) is the stem mass of a tree in circumference class ll calculated as the sum of the sapwood (MlsapM^{sap}_{l}; g C plant1^{-1}) and heartwood mass (MlheartM^{heart}_{l}; g C plant1^{-1}). The parameter c1c_1 in equation %s is the wood density (g C m3^{-3}) and thus identical to c1c_1 in equation 286. The parameter c2c_2 in equations %s and %s are identical to c10c_{10} in equation 299. Note that equation 299 can be derived from equation %s by substituting and rearranging equations %s and %s.

Substitution of equations 345 to %s and rearranging results in expressions of individual tree height and diameter as a function of stem mass:

dlh=((4πMlstemfffc1)c22kheight)3c2,dldia=(4πMlstemfffc1kheight)12+c2,dlba=(π4(Mlstemfffc1kheight)2c2)c2c2+2\begin{align} &d^{h}_{l} = \left(\left(\frac{4}{\pi} \cdot \frac{M^{stem}_{l}}{f^{ff} \cdot c_1}\right)^{\frac{c_2}{2}} \cdot k^{height}\right)^{\frac{3}{c_2}}, \\ &d^{dia}_{l} = {\left(\frac{4}{\pi} \cdot \frac{M^{stem}_{l}}{f^{ff} \cdot c_1 \cdot k^{height}}\right)}^{\frac{1}{2+c_2}},\\ &d^{ba}_{l} = \left(\frac{\pi}{4} \cdot \left(\frac{M^{stem}_{l}}{f^{ff} \cdot c_1 \cdot k^{height}}\right)^{\frac{2}{c_2}}\right)^{\frac{c_2}{c_2+2}} \end{align}

The width of a tree ring is calculated daily for each circumference class ll as:

dl,ttrw=dl,tbaπdl,t1baπ,d^{trw}_{l,t} = \sqrt{\frac{d^{ba}_{l,t}}{\pi}} - \sqrt{\frac{d^{ba}_{l,t-1}}{\pi}},

where dl,ttrwd^{trw}_{l,t} (m) is the ring width for a tree in circumference class ll at tt, and dl,tbad^{ba}_{l,t} and dl,t1bad^{ba}_{l,t-1} (m2^{2}) are the basal areas of a tree in circumference class ll at tt and t1t-1 respectively.

1.5.7DONE: Canopy structure

Tree crowns are formalized as prolate spheroids which are ellipsoids rotated along their major which, in ORCHIDEE v4.2, is the vertical axis. The crown of an individual tree belonging to circumference class ll is thus characterized by a vertical (dlcdia,verd^{cdia,ver}_{l}; m) and horizontal crown diameter (dlcdia,verd^{cdia,ver}_{l}; m) which can be calculated from the tree height and thus depends on the stem mass of an individual tree:

dlcdia,ver=c3dlh,dlcdia,hor=c4dlcdia,ver,\begin{align} &d^{cdia,ver}_{l} = c_3 \cdot d^{h}_{l}, \\ &d^{cdia,hor}_{l} = c_4 \cdot d^{cdia,ver}_{l}, \end{align}

where c3c_3 is a PFT-specific parameter that links the crown depth to the tree height and c4c_4 is a PFT-specific parameter that prescribed the relationship between the horizontal and vertical crown diameter. The crown diameters can then be used to calculate the crown volume (dlcvd^{cv}_{l}; m3^{3} plant1^{-1}) and projected crown area (dlcnd^{cn}_{l}; m2^{2} plant1^{-1}):

dlcn=π6dlcdia,verdlcdia,hor2,dlcn=π4dlcdia,hor2\begin{align} & d^{cn}_{l} = \frac{\pi}{6} \cdot d^{cdia,ver}_{l} \cdot {d^{cdia,hor}_{l}}^{2}, \\ & d^{cn}_{l} = \frac{\pi}{4} \cdot {d^{cdia,hor}_{l}}^{2} \end{align}

The crown volume at the stand level (dcnd^{cn}; m3^{3} m2^{-2}) is calculated as:

dcn=l=1ncirc(dlcndlind)d^{cn} = \sum_{l=1}^{ncirc}{(d^{cn}_{l} \cdot d^{ind}_{l})}

Because the parameters c3c_3 and c4c_4 are not density dependent, crown packing (ccpc^{cp}) may exceed unity. A crown packing of more than 1, indicates that the total crown volume at the stand level exceeds the total available space which is the volume confined by the maximum tree height in the stand and the surface area of the stand. If crown packing exceeds 1, the horizontal crown diameters in ORCHIDEE are until a crown packing of 0.74 is obtained. The target of 0.74 represents the maximum possible packing efficiency of equal spheres Hales, 1998. The adjusted crown diameters can then be calculated as:

b1=(6ccpdncirchπc42l=1ncircdlinddcdia,ver3)13,dlcdia,ver=b1c3dlh,dlcdia,hor=c4dlcdia,ver\begin{align} &b_{1} = \left({{\frac{6 \cdot c^{cp} \cdot d^{h}_{ncirc}}{\pi \cdot {c_4}^{2} \cdot \sum_{l=1}^{ncirc}d^{ind}_{l} \cdot {d^{cdia,ver}}^{3}}}}\right)^{\frac{1}{3}},\\ & d^{cdia,ver}_{l} = b_{1} \cdot c_3 \cdot d^{h}_{l}, \\ & d^{cdia,hor}_{l} = c_4 \cdot d^{cdia,ver}_{l} \end{align}

Stand structure controls the amount of light that penetrates to a given depth in the canopy. Light penetration is used in the calculation of albedo (section 1.3), photosynthesis (section 1.2), allocation (section 1.4.2), and recruitment (section 1.10.2). Prior to calculating light penetration (section 1.5.8) the canopy is discretized in nlevnlev canopy layers and the leaf area within each layer ii is calculated.

For forest PFTs the height of the top of the canopy (ztopz_{top}; m) is given by equation 351 and the bottom (zbotz_{bot}; m) is calculated as the difference between b1b_{1} in equation 351 and the maximum vertical crown diameter (max(dlcdia,verd^{cdia,ver}_{l})). The canopy height of grasses and crops, which is the height of the top of the canopy (ztopz_{top}), is assumed linear to leaf area by making use of a PFT-specific parameter. The height of the bottom of their canopy (zbotz_{bot}) is placed at an arbitrary 0.0001 m above the soil. The height of canopy layer ii (ziz_{i}; m) is then calculated as:

b3=ztopzbotnlev,zi=i=1nlev(zbot+b3i)\begin{align} &b_{3} = \frac{z_{top} - z_{bot}}{nlev}, \\ &z_{i} = \sum_{i=1}^{nlev}(z_{bot} + b_{3} \cdot i) \end{align}

For forest PFTs, the partial crown volume within each canopy layer is calculated for each of the nlevnlev layers that were defined at the stand level and each of the ncircncirc circumference classes. It is first checked whether level ii crosses the spheroid:

b4=ztopdlcdia,ver2,b5=zib4,b6=zi+1b4.\begin{align} &b_{4} = z_{top}-\frac{d^{cdia,ver}_{l}}{2},\\ &b_{5} = z_{i} - b_{4},\\ &b_{6} = z_{i+1} - b_{4}. \end{align}

Level ii crosses the spheroid of circumference class ll if b5b_{5} is greater or equal to dlcdia,ver/2d^{cdia,ver}_{l}/2 or b6b_{6} is less or equal to dlcdia,ver/2-d^{cdia,ver}_{l}/2. If level ii crosses the spheroid, the calculations continues as:

b7=min(zi+1b4,dlcdia,ver2),b8=max(zib4,dlcdia,ver2),dl,icv=π(dlcdia,hor2)2(b7b8(b73b833(dlcdia,ver2)2),\begin{align} &b_{7}=\min\left(z_{i+1}-b_{4},\frac{d^{cdia,ver}_{l}}{2}\right), \\ &b_{8}=\max\left(z_{i}-b_{4},\frac{-d^{cdia,ver}_{l}}{2}\right), \\ &d^{cv}_{l,i} = \pi \cdot \left ({\frac{d^{cdia,hor}_{l}}{2}}\right)^{2} \cdot (b_{7}-b_{8}-\left(\frac{{b_{7}}^{3}-{b_{8}}^{3}}{3 \cdot \left({\frac{d^{cdia,ver}_{l}}{2}}\right)^{2}}\right), \end{align}

where dl,icvd^{cv}_{l,i} (m3^{3} plant1^{-1}) represents the partial crown volume for circumference class ll at canopy level ii. Note that b7b_{7} and b8b_{8} have their centers at the origin and that the horizontal and vertical crown radius is used rather than the crown diameters. The partial crown volume at layer ii (dicvd^{cv}_{i}, m3m2m^{3} m^{-2}) is calculated by summing over the circumference classes:

dicv=l=1ncircdl,icvdlindd^{cv}_{i} = \sum_{l=1}^{ncirc}{d^{cv}_{l,i} \cdot d^{ind}_{l}}

For grassland and cropland PFTs, the partial crown volume within each canopy layer is calculated for each of the nlevnlev layers that were defined at the stand level. Note that the canopy of grasslands and croplands is formalized as a cuboid contrary to the spheroid assumed for the forest PFTs. The crown volume within a canopy layer is:

dicv=(zi+1zi)dAd^{cv}_{i} = (z_{i+1} - z_{i}) \cdot d^{A}

where dAd^{A} is the surface area of the PFT (m2^{2}) which is set to 1 m2^{2} in ORCHIDEE v4.2. For all vegetative PFTs, the leaf area within each canopy layer is then calculated as:

diLAI=dicvdLAIdcvd^{LAI}_{i} = \frac{d^{cv}_{i} \cdot d^{LAI}}{d^{cv}}

where dLAI/dcvd^{LAI}/d^{cv} is the foliage area volume density (m2m3m^{2} m^{-3}) which is assumed to be constant across the circumference classes ll and the canopy layers ii. Likewise to forest structure (section 1.5.6), canopy structure and characteristics are diagnostic variables that, whenever needed, are calculated from the mass of the relevant components.

1.5.8DONE: Gap fraction

The gap fraction, which is the basic information in calculating light penetration at different depths in the canopy, is calculated following the statistical approach of Haverd et al. (2012). Following minor adaptations, the implementation of Haverd et al. (2012) was incorporated in ORCHIDEE v4.2. The gap model represents the canopy by a statistical height distribution with varying crown sizes and stem diameters for each circumference class ll. The crown canopies are treated as spheroids containing homogeneously distributed single scatterers. Although this approach to model canopy gaps can explicitly include trunks, ORCHIDEE v4.2 excludes them, as the spectral parameters for our radiation model (section 1.3.2) are extracted from remote sensing data without distinguishing between leafy and woody masses.

The gap probability for trees fPgap,treesf^{Pgap,trees} (unitless) is calculated as a function of height (zz; m) and solar zenith angle (θ\theta; radians):

fθ,zPgap,trees=exp(dθ,zc(1fθ,zPwc)dind),f^{Pgap,trees}_{\theta,z} = \exp{(- {d^{c}_{\theta,z} \cdot (1 - f^{Pwc}_{\theta,z}) \cdot d^{ind}})},

where dθ,zcd^{c}_{\theta,z} (unitless) is the projected crown area for an opaque canopy at height zz for solar angle θ\theta and is calculated from the geometric relationships detailed in Appendix A in Haverd et al. (2012). fθ,zPwcf^{Pwc}_{\theta,z} (unitless) is the mean crown porosity at height zz for solar angle θ\theta. The mean refers to the mean over the tree distribution over the ll circumference classes. fθ,zPwcf^{Pwc}_{\theta,z} is calculated as:

b9=zdlh+dlcdia,ver2b_{9} = z - d^{h}_{l} + \frac{d^{cdia,ver}_{l}}{2}

If b9b_{9} falls between dlcdia,ver/2-d^{cdia,ver}_{l}/2 and dlcdia,ver/2d^{cdia,ver}_{l}/2, then the partial volume of a spheroid above height zz (b10b_{10}, m3^{3} plant1^{-1}), is calculated as the difference of the volume of the whole spheroid and the volume of a partial spheroid below height zz:

b10=43π(dlcdia,hor2)2dlcdia,ver2dlcdia,ver3b9+b933(dlcdia,ver2)2π(dlcdia,hor2)2,\begin{align} b_{10} & = \frac{4}{3} \cdot \pi \cdot \left({\frac{d^{cdia,hor}_{l}}{2}}\right) ^ {2} \cdot {\frac{d^{cdia,ver}_{l}}{2}} - \nonumber \\ &\frac{d^{cdia,ver}_{l}}{3} - b_{9} + \frac{{b_{9}}^{3}}{3 \cdot \left({\frac{d^{cdia,ver}_{l}}{2}}\right)^{2}} \cdot \pi \cdot \left({\frac{d^{cdia,hor}_{l}}{2}}\right)^{2}, \end{align}

If b9b_{9} exceeds dlcdia,ver/2d^{cdia,ver}_{l}/2 the whole volume of the spheroid is above height zz and therefore b10b_{10} is calculated as:

b10=43π(dlcdia,hor2)2dlcdia,ver2b_{10} = \frac{4}{3} \cdot \pi \cdot \left({\frac{d^{cdia,hor}_{l}}{2}}\right) ^ {2} \cdot {\frac{d^{cdia,ver}_{l}}{2}}

Finally dθ,z,lsd^{s}_{\theta,z,l} (m) is the mean path length through all canopy levels above height zz for solar angle θ\theta for circumference class ll and is calculated as:

dθ,z,ls=temp10cos(θ)dθ,zcd^{s}_{\theta,z,l} = \frac{temp{10}}{\cos(\theta) \cdot d^{c}_{\theta,z}}

Since a tree crown is not opaque, the crown porosity is calculated by considering the projection of the leaf area in the direction of the incoming light. A spherical leaf area distribution is assumed which makes the projected leaf area in the direction of the incoming light constant and equal to 0.5 Pinty et al., 2006. The crown porosity is then calculated as:

fθ,z,lPwc=exp(0.5dLAIdθ,z,lsc5dcv),f^{Pwc}_{\theta,z,l} = \exp\left(\frac{-0.5 \cdot d^{LAI} \cdot d^{s}_{\theta,z,l} \cdot c_5}{ d^{cv}}\right),

where c5c_5 is a PFT-specific parameter prescribing the leaf clumping at the level of the plant shoots. By considering the stand density in each circumference class ll, stand level porosity which is used in equation 358, is calculated as:

fθ,zPwc=l=1ncircfθ,z,lPwcdlindf^{Pwc}_{\theta,z} = \sum_{l=1}^{ncirc}{f^{Pwc}_{\theta,z,l} \cdot d^{ind}_{l}}

As ORCHIDEE also simulates crops, grasses, and bare soil, the calculation of fPgapf^{Pgap} was adjusted for these PFTs as well. For grasses and crops, the same formulation is used:

fθ,zPgap,gc=exp(0.5dLAIabovec5cos(θ))f^{Pgap,gc}_{\theta,z} = \exp{\left(\frac{-0.5 \cdot d^{LAIabove} \cdot c_5}{ cos(\theta)}\right)}

where dLAIaboved^{LAIabove} (unitless) is the total amount of LAI above height zz, and c5c_5 accounts for the fact that grasses and crops are treated as homogeneous blocks of vegetation with no internal structure. For bare soil, there is no vegetation to intercept radiation, and therefore fθz,zPgap,bsf^{Pgap,bs}_{\theta_{z},z} is always unity. Depending on the calculations, fPgapf^{Pgap} is either used for a specific height zz and solar angle θ\theta (e.g., albedo in section 1.3.2) or is integrated over all layers (e.g. light reaching the forest floor in section 1.10.2).

1.5.9DONE: Effective leaf area

The effective LAI for canopy layer ii with its bottom at height ziz_{i} for solar angle θ\theta is computed to be used with the two-stream albedo model (section 1.3.2) by using equation 25 in Pinty (2004):

diLAIeff=2cos(θ)log(Pθ,zigap),d^{LAIeff}_{i} = -2 \cdot \cos(\theta) \cdot \log(P^{gap}_{\theta,z_{i}}),

Calculation of diLAIeffd^{LAIeff}_{i} (unitless) is a computationally expensive part of ORCHIDEE v4.2, due to the loops over grid cells, PFTs, circumference classes, canopy levels, and solar angles in addition to using trigonometric functions. Moreover, a value for diLAIeffd^{LAIeff}_{i} is needed every time step so, up to 48 times a day. Computational costs were reduced by calculating diLAIeffd^{LAIeff}_{i} for eight solar angles (i.e., 5 °, 15 °, 25 °, 35 °, 45 °, 55 °, 65 ° and 75 °) exactly, and then fitting a function (i.e., c6+c7θ+c8θ2+c9θ3+c10θ4c_6 + c_7 \cdot \theta + c_8 \cdot \theta^{2} + c_9 \cdot \theta^{3} + c_{10} \cdot \theta^{4}) to preset solar angles to predict the value of diLAIeffd^{LAIeff}_{i} at any solar angle. A least square method is used to fit the parameters c6c_6, c7c_7, c8c_8, c9c_9, and c10c_{10}. This method works well for low solar zenith angles, which are the most important since they will have the most incoming solar radiation.

1.5.10DONE: Root distribution

ORCHIDEE v4.2 calculates two vertical root profiles: a structural and a functional. Each root profile gives the share of the root biomass in each soil layer. The structural root profile is constant over time and is used in processes where the depth of the roots is one of the drivers, i.e., soil water infiltration along roots (section 1.7), input of soil carbon and nitrogen at depth due to the turnover of roots (section 1.8.4), maintenance respiration (section 1.3), and resistance to wind throw (section 1.2). The functional root profile changes over time and is used in processes where the vertical profile roots activity, rather than the vertical profile of root mass, is considered an important driver, i.e., transpiration (6).

The maximum rooting depth (zrootz_{root}) is calculated by considering two constraints: (1) roots do not extend into frozen soils, and (2) crops are assumed to root to 0.8 m, grasslands are assumed to root no deeper than 1 m, and forests are assumed to root down to 2 m. Note that in ORCHIDEE v4.2 the maximum rooting depth does not depend on the root biomass, hence, plants root down to their maximum rooting depth from the start of the simulation.

The structural root profile is calculated as an exponentially decreasing root mass with depth where the shape of the profile is determined by the PFT-specific parameter c1c_1 Rosnay, 1999. The total surface area under an exponential curve between ztopz_top (m) and zrootz_{root} (m) is calculated:

b1=1exp(ztopc1)exp(zrootc1)b_{1} = \frac{1}{\exp(-z_{top} \cdot c_1) - \exp(-z_{root} \cdot c_1)}

The structural root profile (unitless) is then calculated as:

firoot,str=b1(exp(zi1c1)exp(zic1))f^{root,str}_{i} = b_{1} \cdot ( \exp(-z_{i-1} \cdot c_1) - \exp(-z_{i} \cdot c_1))

where ziz_{i} (m) is the depth of the layer ii and zi1z_{i-1} (m) is the depth of the previous layer. The calculation is repeated for all layers ii between ztopz_{top} and zrootz_{root}.

The functional root profile gives the share of the root biomass in each soil layer based on the soil water in each layer. This results in a dynamic root profile that is changing over time. The total active root mass is calculated as:

b2=i=ztopzrootmax(0,MismMismw)b_{2} = \sum_{i=z_{top}}^{z_{root}}\max(0,M^{sm}_{i}-M^{smw}_{i})

The functional root profile (unitless) is then calculated as:

firoot,fun=max(0,MismMismw)b2f^{root,fun}_{i} = \frac{\max(0,M^{sm}_{i}-M^{smw}_{i})}{b_{2}}

1.6DONE: Natural mortality

1.6.1DONE: Defining plant mortality

ORCHIDEE v4.2 distinguishes between plant and PFT mortality. Plant mortality is defined as an event in which part of the individuals within a PFT die without changing the ground area of this PFT. The causes of natural plant mortality accounted for in ORCHIDEE are described in section 1.6.2 and in section 1.4 for anthropogenic plant mortality. ORCHIDEE defines PFT mortality as an event in which all individuals within a PFT die without changing the ground area of that PFT. The causes of natural PFT mortality accounted for in ORCHIDEE are described in section 1.6.3. Anthropogenic causes of the mortality of forest PFTs is described in section and for agricultural PFTs in section 1.3). Events in which all or part of the individuals of a PFT die and the ground area of the PFT changes also distinguish natural and anthropogenic causes. The natural causes of stand replacing disturbances are described in section 1.6. The anthropogenic process ORCHIDEE accounts for and that results in an area change is land cover change which is described in section 1.1).

1.6.2DONE: Natural plant mortality

Natural plant mortality, i.e., an event in which part of the individuals within a PFT die without changing the ground area, is considered when the PFT has not yet been marked for killing due to PFT mortality (section 1.6.3. Two natural sources of plant mortality are considered: (1) self-thinning due to resource competition in forests, and (2) background mortality due to environmental stressors. The daily calculation of the self-thinning mortality for unmanaged forests starts with calculating three relative densities, i.e., the actual (fRDI,actf^{RDI,act}), the lower target (fRDI,lowf^{RDI,low}), and the upper target relative densities (fRDI,uppf^{RDI,upp}), according to equations 342 to %s. If the actual relative density (fRDI,actf^{RDI,act}) is less than its upper target (fRDI,uppf^{RDI,upp}), the actual stand density is within the carrying capacity of the site and is, therefore, maintained. The carrying capacity is exceeded if the actual relative density exceeds its upper target (fRDI,uppf^{RDI,upp}). A reduction in stand density (dindd^{ind}) is then calculated such that the actual relative density matches its lower target for (fRDI,lowf^{RDI,low}):

b1=dindfRDI,lowdind,max,b_{1} = d^{ind} - f^{RDI,low} \cdot d^{ind,max},

where b1b_{1} is the stand density (m2^{-2}) that has to be removed to reach the lower target for relative density and dind,maxd^{ind,max} is the maximum stand density the site can support given the actual quadratic mean diameter of the stand. Since in ORCHIDEE the number of trees are given per unit area, the total number of trees and stand density are identical and thus interchangeable. The use of circumference classes adds realism to the ORCHIDEE v4.2 simulations, but it raises the questions which trees should be targeted by self-thinning mortality? For self-thinning, the mortality distribution (fdist,lf^{dist,l}) over the circumference classes ll is considered to follow the diameter distribution (section 1.5.5). The targeted mortality in each diameter class is then calculated as:

dlind,kill=fdist,lb1,d^{ind,kill}_{l} = f^{dist,l} \cdot b_{1},

where dlind,killd^{ind,kill}_{l} (m2^{-2}) is the stand density that is killed in each circumference class. If self-thinning mortality occurs, environmental mortality is not accounted for. If there is no self-thinning, environmental mortality is accounted for. The model user can choose from two approaches to calculate mortality from environmental stress. In the first default approach the environmental mortality is considered constant:

Mkill=l=1ncircMlplantdlindc1,M^{kill} = \frac{\sum_{l=1}^{ncirc}{M^{plant}_{l} \cdot d^{ind}_{l}}} {c_1},

where MkillM^{kill} is the total biomass that needs to be killed, MlplantM^{plant}_{l} the biomass of trees in circumference class ll, dlindd^{ind}_{l} the stand density in circumference class ll, and c1c_1 is the PFT-specific maximum age (days) for the PFT under consideration.

In the second approach the daily mortality from environmental stress is a function of the productivity of the PFT:

b2=Fnpp,3yeardLAI,b3=max(c4,c21+c3b2),Mkill=l=1ncircb3Mlplantdlind,\begin{align} &b_{2} = \frac{F^{npp,3year}} {d^{LAI}},\\ &b_{3} = \max\left(c_4, \frac{c_2}{1+c_3\cdot b_{2}}\right),\\ &M^{kill} = \sum_{l=1}^{ncirc}{b_{3} \cdot M^{plant}_{l} \cdot d^{ind}_{l}}, \end{align}

where c2c_2 is the maximum mortality, c3c_3 is the reference mortality and c4c_4 is minimum mortality. c2c_2, c3c_3, and c4c_4 are in year1^{-1} and are all PFT-specific. Fnpp,3yearF^{npp,3year} (g C m2^{-2} s1^{-1}) is the 3-year mean net primary production. MkillM^{kill} is the total biomass that needs to be killed but ORCHIDEE v4.2 requires the stand density that has to be killed in each circumference class (dlind,killd^{ind,kill}_{l}; m2^{-2}). Where for self-thinning mortality, mortality was assumed proportional to the stand density in each circumference class, environmental stress was considered to preferentially affect the larger trees, being more prone to cavitation, wind damage, lightening, and heart rot. While killing the larger trees also trees in the other diameter classes were killed following Bellassen et al., 2010:

flkill=fl1killc51(ncirc1),flkill=flkilll=1ncircflkill,dlind,kill=flkillMkillMlplant,\begin{align} &f^{kill}_{l}=f^{kill}_{l-1}\cdot c_5^{1-(ncirc-1)},\\ &f^{kill}_{l} = \frac{f^{kill}_{l}} {\sum_{l=1}^{ncirc}{f^{kill}_{l}}},\\ &d^{ind,kill}_{l} = \frac{f^{kill}_{l} \cdot M^{kill}} {M^{plant}_{l}}, \end{align}

where c5c_5 is the death distribution factor, which is the factor by which the smallest and largest circumference classes differ e.g., a c5c_5 of 10 means that the largest circumference class will lose ten times as much biomass as the smallest circumference class as a result of the mortality.

ORCHIDEE v4.2 accounts already for several sources of mortality, i.e., forestry for managed forests, self-thinning for unmanaged forests, storms and insects for forests and fire for all PFTs and will be further developed to include even more sources. The end goal of these developments is to replace the pure empirical environmental mortality by a more mechanistic approach towards mortality. This is an ongoing process Bellassen et al., 2010Naudts et al., 2015Naudts et al., 2016Luyssaert et al., 2018Chen et al., 2018Marie et al., 2023 and until this goal has been reached, environmental mortality is kept as a fail-safe approach but the value of c1c_1 is increased every time a new source of mortality is added to the model. Likewise, with the addition of new sources of mortality, the current self-thinning mortality is evolving from a poorly defined mixture of sources of mortality towards pure competition driven mortality.

1.6.3DONE: Natural PFT mortality

PFT mortality. i.e., an event in which all individuals within a PFT die without changing the ground area of that PFT, occurs in two cases: carbon starvation and density-driven mortality. In both cases, all individuals in the PFT are marked for killing and PFT ground area does not change.

If at the end of the day, there is no carbon available in the carbohydrate reserve, leaf and labile pools, all individuals in the PFT will be marked for killing. This condition is the result of carbon starvation and typically takes 3 to 5 years to develop in ORCHIDEE v4.2. In this situation, the plants are not able to grow new leaves which are essential to assimilate new carbon from the atmosphere to initiate plant recovery.

In case of high intensity management or natural disturbances, the stand density could become so low that unrealistically large tree diameter would be simulated. In ORCHIDEE v4.2 this situation is prevented through density-driven PFT mortality Bellassen et al. (2010). Density-driven PFT mortality is not an ecological process but a fail-safe approach to keep stand density and tree diameter within observed boundaries.

1.6.4DONE: Moving biomass to litter pools

For each circumference class either none, part, or all of the individuals are marked for killing (dlind,killd^{ind,kill}_{l}; m2^{-2}) (sections 1.6.3 and 1.6.2). Subsequently, the biomass of the individuals that were marked for killing, is moved into the appropriate biomass pools. This section describes mortality in unmanaged PFTs only but the mortality could be caused by: carbon starvation (section 1.6.3), density-driven (section 1.6.3), self-thinning (section 1.6.2), environmental stress 1.6.2), bark beetles 1.3), or wind storms 1.2). Trees marked for killing are moved into the litter pool and the stand density is updated:

Mtlit=Mt1lit+Ml,tplantdl,tind,kill,dl,tind=dl,t1inddl,tind,kill,\begin{align} &M^{lit}_{t} = M^{lit}_{t-1} + M^{plant}_{l,t} \cdot d^{ind,kill}_{l,t}, \\ &d^{ind}_{l,t} = d^{ind}_{l,t-1} - d^{ind,kill}_{l,t}, \end{align}

where MtlitM^{lit}_{t} and Mt1litM^{lit}_{t-1} are the litter mass at respectively time step tt and t1t-1 for a single PFT within a grid cell, and MlplantM^{plant}_{l} (g plant1^{-1}) is the plant mass in circumference class ll. This calculation is repeated for the carbon and nitrogen biomass.

For grasslands and croplands fewer sources of mortality are accounted for in ORCHIDEE v4.2 compared to forest. Moreover, the density of a grassland or cropland is constant in ORCHIDEE. When partial mortality occurs, the individual plant mass is adjusted rather than the number of individuals as is the case in equation %s.

1.7DONE: Litter decomposition

1.7.1DONE: Adding biomass to the litter pools

The litter is formalized as four pools: a metabolic, structural, woody, and a snag, i.e., standing dead trees, pool. These four pools further distinguish an above-ground and a below-ground component with the exception of the snags that only have an aboveground pool. The metabolic litter is the labile or rapidly decomposing fraction of the litter, where the structural litter is the more resistant and, therefore, slowly decomposing fraction. This discretisation thus accounts for differences in the decomposition rates between cytoplasmic compounds of plant cells, and cell walls Corbeels, 2001. The woody pool represents the coarse woody debris, even slower decomposing than the structural pool Enrong et al., 2006, and the snag pool containing the dead standing trees, and assumed to be the slowest pool to decompose Enrong et al., 2006. In ORCHIDEE v4.2 the snag pool is optional. When the snag pool is not accounted for, all dead woody biomass is transferred to the woody litter pool.

The litter pools receive dead biomass as an input: each of the nine dead biomass pool is moved to one or two specific litter pools: the share of leaves, fruit and root biomass that is moved to the metabolic pool is calculated as:

 fo,metab=cmetabfracc1co,LCfcn,leaf,\begin{align} &\ f^{o,metab} = c^{metabfrac} - c_1 \cdot c^{o,LC} \cdot f^{cn,leaf}, \end{align}

where fo,metabf^{o,metab} is the fraction of the input biomass of organ oo that goes into the metabolic pool, with oo being fruit, leaf or root biomass, cmetabfracc^{metabfrac} is a reference fraction along with c1c_1 an empirical coefficient. co,LCc^{o,LC} (g lignin g C1^{-1}) is the lignin to carbon ratio of the organ oo of the input biomass and fcn,leaff^{cn,leaf} is the carbon-to-nitrogen ratio of the input biomass. The remainder, i.e., 1-fo,metabf^{o,metab}, is added to the structural pool. Following mortality, leaves and fruit biomass is entirely added to the above-ground litter pool whereas the mass of dead roots is added to the below-ground litter. The labile and reserve biomass are moved to the above-ground metabolic litter pool. Sixty-eight percent of the heartwood and sapwood biomass that dies is moved into the woody litter pool, the remaining 32 % into the snag litter pool but this proportion needs to be refined as it is based on observed snag proportions Rahman et al., 2008Aakala, 2010Motta et al., 2006Sippola et al., 1998, which also results from the decay rates of the pools. Above-ground and below-ground heartwood and sapwood are already distinguished at the plant level, so following mortality, these mass components are moved in the matching above-ground and below-ground wood litter pools.

The lignin content of the different litter pools is calculated according to:

Min,lignin,i=o=1norganco,LCFin,o,i,\begin{align} &M^{in,lignin,i} = \sum_{o=1}^{norgan} c^{o,LC} \cdot F^{in,o,i}, \end{align}

where Min,lignin,iM^{in,lignin,i} (g C m2^{-2} s1^{-1}) the input of lignin to the litter pool ii, co,LCc^{o,LC} is the PFT-specific lignin to carbon ratio of the biomass pool oo, norgannorgan the number of plant organs and thus biomass pools, and Fin,o,iF^{in,o,i} (g C m2^{-2} s1^{-1}) the carbon input from plant organ oo into litter pool ii.

When a PFT is fertilized with manure, the nitrogen contained in manure is read from a fertilisation map (section 1.9) and added to the soil mineral nitrogen pools. The carbon contained in the manure is calculated from the prescribed carbon to nitrogen ratio of manure and added in the metabolic above-ground litter pool. By doing so, we mimic the application of manure on top soil by farmers that brings C to soil and since manure is considered to be a labile material with high turnover rates, we added it into the metabolic above ground pool. (ADD RATIONALE TO DO DO SO)

1.7.2DONE: Dynamics of the litter pools

The dynamics of the litter pools is based on the CENTURY first order decay model Parton et al., 1993 extended by coarse woody debris and snags, which follow similar dynamics Boulanger2011. Snags start as standing dead wood but due to decay at their stem base near the ground, snags will fall well before they are decomposed Hararuk2020. During snag fall, the mass of the snag is transferred to the above-ground woody litter pool, according to a fall rate with no control of moisture or lignin content (contrarily to the litter pools decay). Each of the pools are divided between an above and a below pool, which decompose in the same way with exception to the decomposition moderator functions (accounting for temperature, decomposer presence, and humidity effects). The litter dynamics are described as:

Militt=k=1norgFin,o,iciMilitmitempmimoist,Militt=k=1norgFin,o,iciMilitmitempmimoistmilignin,Militt=k=1norgFin,o,iciMilitmitempmimoistmilignin+cfMilit,Militt=k=1norgFin,o,iciMilitmitempmimoistmilignincfMilit\begin{align} &\frac{\partial M^{lit}_{i}}{\partial t} = \sum_{k=1}^{norg} F^{in,o,i}-c_{i}\cdot M^{lit}_{i} \cdot m^{temp}_{i} \cdot m^{moist}_{i}, \\ &\frac{\partial M^{lit}_{i}}{\partial t} = \sum_{k=1}^{norg} F^{in,o,i}-c_{i}\cdot M^{lit}_{i} \cdot m^{temp}_{i} \cdot m^{moist}_{i} \cdot m^{lignin}_{i},\\ &\frac{\partial M^{lit}_{i}}{\partial t} = \sum_{k=1}^{norg} F^{in,o,i}-c_{i}\cdot M^{lit}_{i} \cdot m^{temp}_{i} \cdot m^{moist}_{i} \cdot m^{lignin}_{i}+c_{f} \cdot M^{lit}_{i},\\ &\frac{\partial M^{lit}_{i}}{\partial t} = \sum_{k=1}^{norg} F^{in,o,i}-c_{i}\cdot M^{lit}_{i}\cdot m^{temp}_{i} \cdot m^{moist}_{i} \cdot m^{lignin}_{i}-c_{f} \cdot M^{lit}_{i} \end{align}

where MilitM^{lit}_{i} (g C m2^{-2} or g N m2^{-2}) the carbon and nitrogen mass of the litter pool ii. In equations (379), eq:struc_litter, eq:wood_litter, eq:snag_litter ii stands respectively for metabolic, structural, woody and snag. FiinF^{in}_{i} (g C m2^{-2} s1^{-1} or g N m2^{-2} s1^{-1}) are the inputs, cic_{i} the decomposition rates, cfc_{f} the snags fall rate, mimoistm^{moist}_{i} and mitempm^{temp}_{i} the rate modifiers respectively accounting for the effect of soil moisture and soil temperature on decomposition. miligninm^{lignin}_{i} is a modifier that represents the moderating effect on decomposition of the lignin content in the litter pool (miligninm^{lignin}_{i}; g lignin g C1^{-1}). The rate modifiers follow the equations below:

milignin=exp(3Milignin),mimoist,j=max(θmin,min(1,c1θj2+c2θjc3)),mitemp,j=min(1,exp(cQ10soil[TjTsoilref]cQ10)),\begin{align} & m^{lignin}_{i} = \exp(-3 \cdot M^{lignin}_{i}),\\ & m^{moist,j}_{i} = max(\theta_{min}, min(1, -c_{1} \cdot \theta_{j}^{2} + c_{2} \cdot \theta_{j} -c_{3})),\\ & m^{temp,j}_{i} = min(1, \exp(c_{Q10soil} \cdot \frac{[T^{j}-T_{soil}^{ref}]}{c_{Q10}})),\\ \end{align}

j is above or below: when j is above θj\theta_{j} is θ\theta the humidity relative to field capacity, and TjT^{j} is TsurfT^{surf}, the surface temperature, and for j being below θj\theta_{j} is θdecomp\theta^{decomp} and TjT^{j} is TdecompT^{decomp}, the relative humidity and temperature averaged over soil layers and accounting for the decomposers’ presence, both calculated according to (386). cQ10soilc_{Q10soil}, cQ10c_{Q10}, TsoilrefT_{soil}^{ref}, c1c_{1}, c2c_{2}, c3c_{3} are empirical parameters which values can be seen in equations (385), eq:som_decomp_moisture_modifier which are the same as the equations for the below litter pools.

1.7.3DONE: Heterotrophic respiration from litter decomposition

When litter is decomposed, carbon dioxide is released in form of heterotrophic respiration. Heterotrophic respiration is calculated as a fraction of the carbon fluxes going from the litter to the soil carbon pools (section 1.8.1).

 b1=imetabj=1Nsoil(1fi,jsoil)Mideclitter(1milignin)Δt, b2=j=1Nsoil(1fjsoil,metab)Mdeclitter,metabΔt, Fresp,het,litter=b1+b2,\begin{align} &\ b_{1} = \sum_{i \not = metab}\sum_{j=1}^{N_{soil}} \frac{(1 - f^{soil}_{i,j}) \cdot M^{declitter}_{i} \cdot (1 - m^{lignin}_{i})}{\Delta{t}},\\ &\ b_{2} = \sum_{j=1}^{N_{soil}} \frac{(1 - f^{soil,metab}_{j}) \cdot M^{declitter,metab}}{\Delta{t}},\\ &\ F^{resp,het,litter} = b_{1} + b_{2}, \end{align}

where b1b_{1} (g C m2^{-2} s1^{-1}) is the heterotrophic respiration in the pools which involve a lignin fraction thus all but the metabolic litter pool, b2b_{2} is the heterotrophic respiration in the metabolic litter, NsoilN_{soil} the number of soil pools, jj the index of the soil carbon pools, MideclitterM^{declitter}_{i} the carbon from the decayed litter pool ii, miligninm^{lignin}_{i} the lignin content in g lignin g C1^{-1} of the litter pool ii, fjsoil,metabf^{soil,metab}_{j} the fraction of the decayed litter going to the soil (and not the atmosphere via heterotrophic respiration) and Fresp,het,litterF^{resp,het,litter} (g C m2^{-2} s1^{-1}) is the total heterotrophic respiration from the litter decay. All nitrogen released during the decay of the litter pools goes initially into the mineral nitrogen pool of the soil, where it is available for plant uptake, or other nitrogen processes (section 1.8.5).

1.8Soil carbon decomposition, nitrogen transformations, and heterotrophic respiration

The representation of soil carbon in ORCHIDEE is based on the CENTURY model parton1988. In each grid cell and PFT, the soil carbon is split between surface, active, slow, and passive pools. The surface pool has been added in ORCHIDEE to [increase the availability of nitrogen for plants??]. Optionally (see Sec. 1.8.4) the pools can be further split into depth layers, allowing for the representation of the vertical diffusion of organic matter due to cryo- and bioturbation.

The representation of soil nitrogen in ORCHIDEE is based on...

1.8.1DONE: Adding litter to soil carbon and nitrogen pools

Partitioning of decomposed litter between the surface, active, and slow soil organic carbon pools. The passive soil organic carbon pool (not shown here) does not receive litter, but only decomposed organic matter from the other pools.

Figure 13:Partitioning of decomposed litter between the surface, active, and slow soil organic carbon pools. The passive soil organic carbon pool (not shown here) does not receive litter, but only decomposed organic matter from the other pools.

DSG:
For respiration you separate litter and SOC although its the same shape of equations. (FK: TODO, will see what we can do.)
Using f for a parameter will confuse readers. (FK: f is both a fraction and a parameter, so both ’f’ and ’c’ would be appropriate. I agree with whoever made the choice of ’f’, the fraction-nature seems more important to me here than the fact that it’s a constant.)

In each time step, the mass MCdec_littM^\text{dec\_litt}_\text{C} of carbon in the decomposed litter is split between the surface, active, and slow soil organic carbon pools as shown in Fig. 13. The fraction of decomposed carbon from litter pool i,ji,j (i{above,below},j{metab,struct,wood,snag}i \in \{\text{above},\text{below}\}, j \in \{\text{metab},\text{struct},\text{wood},\text{snag}\}) that enters the soil organic matter pool kk is controlled by the parameter fi,j,klitt_SOM_2Df^\text{litt\_SOM\_2D}_{i,j,k}. In addition to this parameter, the distribution of decomposed structural, woody, and snag litter takes into account the PFT-dependent lignin content fi,jligninf^\text{lignin}_{i,j} and allocates the non-lignin fraction to the active and surface pools and the lignin fraction to the slow pool. The resulting input fluxes FC,klitt_SOM_2DF^\text{litt\_SOM\_2D}_{\text{C},k} of soil organic carbon pools are

FC,surfacelitt_SOM_2D=[fabove,metab,surfacelitt_SOM_2D+j{structural,woody,snag}fabove,j,surfacelitt_SOM_2D(1fabove,jlignin)]MCdec_litt/ΔtFC,activelitt_SOM_2D=[fbelow,metab,activelitt_SOM_2D+j{structural,woody,snag}fbelow,j,activelitt_SOM_2D(1fbelow,jlignin)]MCdec_litt/ΔtFC,slowlitt_SOM_2D=i{above,below},j{structural,woody,snag}fi,j,slowlitt_SOM_2Dfi,jligninMCdec_litt/Δt\begin{align} F^\text{litt\_SOM\_2D}_{\text{C},\text{surface}} &= \left[f^\text{litt\_SOM\_2D}_{\text{above},\text{metab},\text{surface}} + \sum_{j \in \{\text{structural},\text{woody},\text{snag}\}}f^\text{litt\_SOM\_2D}_{\text{above},j,\text{surface}} \left(1 - f^\text{lignin}_{\text{above},j}\right)\right] M^\text{dec\_litt}_\text{C} / \Delta{t} \\ F^\text{litt\_SOM\_2D}_{\text{C},\text{active}} &= \left[f^\text{litt\_SOM\_2D}_{\text{below},\text{metab},\text{active}} + \sum_{j \in \{\text{structural},\text{woody},\text{snag}\}}f^\text{litt\_SOM\_2D}_{\text{below},j,\text{active}} \left(1 - f^\text{lignin}_{\text{below},j}\right)\right] M^\text{dec\_litt}_\text{C} / \Delta{t} \\ F^\text{litt\_SOM\_2D}_{\text{C},\text{slow}} &= \sum_{i \in \{\text{above},\text{below}\}, j \in \{\text{structural},\text{woody},\text{snag}\}} f^\text{litt\_SOM\_2D}_{i,j,\text{slow}} f^\text{lignin}_{i,j} M^\text{dec\_litt}_\text{C} / \Delta{t} \end{align}

1.8.2DONE: Dynamics of soil carbon and nitrogen pools

Flow of soil organic carbon between the pools. Each connection shows the fraction of the decomposed organic matter in the source pool that enters the destination pool. In all cases, the remaining decomposed organic matter is respired. Clay and silt refer to soil textural fractions (0–1).

Figure 14:Flow of soil organic carbon between the pools. Each connection shows the fraction of the decomposed organic matter in the source pool that enters the destination pool. In all cases, the remaining decomposed organic matter is respired. Clay and silt refer to soil textural fractions (0–1).

ORCHIDEE keeps track of the concentrations Ml,kSOM_2DM^\text{SOM\_2D}_{l,k} (in g/m2\unit{g/m^2}) of element ll (carbon or nitrogen) in pool kk in each grid cell and PFT (indices suppressed). In each time step, these concentrations are updated according to the following equation combining the litter input flux Fl,klitt_SOM_2DF^\text{litt\_SOM\_2D}_{l,k}, the decomposition output flux Fl,kSOM_decompF^\text{SOM\_decomp}_{l,k}, and fluxes between the pools,

ΔMl,kSOM_2DΔt=Fl,klitt_SOM_2DFl,kSOM_decomp+ikfl,i,kSOMFl,iSOM_decomp,\frac{\Delta M^\text{SOM\_2D}_{l,k}}{\Delta t} = F^\text{litt\_SOM\_2D}_{l,k} - F^\text{SOM\_decomp}_{l,k} + \sum_{i \ne k} f^\text{SOM}_{l,i,k} F^\text{SOM\_decomp}_{l,i},

where the last term is the flux from pool ii to pool kk, calculated as a fraction fl,i,kSOMf^\text{SOM}_{l,i,k} of the decompositon flux of pool ii. The default values of the fractions fl,i,kSOMf^\text{SOM}_{l,i,k} are shown in Fig. 14.

The decomposition flux for pool kk is calculated assuming linear kinetics with turnover time cksom_turnc^\text{som\_turn}_{k}, which is modified to account for soil temperature, moisture, and clay content, as well as for tillage in crop PFTs,

Fl,kSOM_decomp=cksom_turnmtempmmoistmkclaymtillageMl,kSOM_2D.F^\text{SOM\_decomp}_{l,k} = c^\text{som\_turn}_{k} m^\text{temp} m^\text{moist} m^\text{clay}_k m^\text{tillage} M^\text{SOM\_2D}_{l,k}.

The default turnover times are cactivesom_turn=7.3yrc^\text{som\_turn}_\text{active} = 7.3 \,\unit{yr}, csurfacesom_turn=6yrc^\text{som\_turn}_\text{surface} = 6 \,\unit{yr}, cslowsom_turn=0.1yrc^\text{som\_turn}_\text{slow} = 0.1 \,\unit{yr}, and cpassivesom_turn=0.0025yrc^\text{som\_turn}_\text{passive} = 0.0025 \,\unit{yr}.

The temperature and moisture modifiers parton1988,

mtemp=min(1,exp(0.069(Tdecomp303.15))),mmoist=max(0.25,min(1,1.1(θdecomp)2+2.4θdecomp+0.29)),\begin{align} m^\text{temp} &= \min\left(1,\exp\left(0.069 (T^\text{decomp}-303.15)\right)\right), \\ m^\text{moist} &= \max\left(0.25, \min\left(1, 1.1 \left(\theta^\text{decomp}\right)^2 + 2.4 \theta^\text{decomp} + 0.29\right)\right), \end{align}

depend on TdecompT^\text{decomp} and θdecomp\theta^\text{decomp} which are the temperature and volumetric water content of the current soil layer (if vertical dicretization of soil organic matter is activated) or averages over the soil profile. The averaging is done by integrating temperature or moisture over depth with a weighing factor reflecting the assumed concentration of decomposers close to the surface. This weighing factor is exponential with a characteristic depth of zdecompz^\text{decomp}, equal to 0.2 m by default. By assuming the moisture is uniform in each soil layer, the integration for soil moisture θdecomp\theta^\text{decomp} gives

θdecomp=i=1Nsoilθi[exp(zi1lb_hydro/zdecomp)exp(zilb_hydro/zdecomp)]exp(z0lb_hydro/zdecomp)exp(zNsoillb_hydro/zdecomp),\begin{align} % TWO LINES % \theta^\text{decomp} =& % \left[ % \exp{\left(z^\text{lb\_hydro}_0 / z^\text{decomp}\right)} - % \exp{\left(z^\text{lb\_hydro}_{N^\text{soil}} / z^\text{decomp}\right)} % \right]^{-1} \\ % & \cdot \sum_{i = 1}^{N^\text{soil}} \theta_i \left[ % \exp{\left(z^\text{lb\_hydro}_{i-1} / z^\text{decomp}\right)} - % \exp{\left(z^\text{lb\_hydro}_{i} / z^\text{decomp}\right)} % \right], % % ONE LINE FRAC \theta^\text{decomp} = \frac{\sum_{i = 1}^{N^\text{soil}} \theta_i \left[\exp{\left(z^\text{lb\_hydro}_{i-1} / z^\text{decomp}\right)} - \exp{\left(z^\text{lb\_hydro}_{i} / z^\text{decomp}\right)}\right] }{ \exp{\left(z^\text{lb\_hydro}_0 / z^\text{decomp}\right)} - \exp{\left(z^\text{lb\_hydro}_{N^\text{soil}} / z^\text{decomp}\right)} }, % % ONE LINE INLINE % \theta^\text{decomp} = \left[ % \exp{\left(z^\text{lb\_hydro}_0 / z^\text{decomp}\right)} - % \exp{\left(z^\text{lb\_hydro}_{N^\text{soil}} / z^\text{decomp}\right)} % \right]^{-1} % \sum_{i = 1}^{N^\text{soil}} \theta_i % \left[ % \exp{\left(z^\text{lb\_hydro}_{i-1} / z^\text{decomp}\right)} - % \exp{\left(z^\text{lb\_hydro}_{i} / z^\text{decomp}\right)} % \right], \end{align}

where θi\theta_i is the soil moisture in layer ii, zilb_hydroz^\text{lb\_hydro}_i is the depth of the lower boundary of layer ii as used in the soil hydrology calculations (with z0lb_hydroz^\text{lb\_hydro}_0 being the depth of the upper bondary of layer 1). The average temperature TdecompT^\text{decomp} is calculated analogously.

As in the original CENTURY model parton1988, the decomposition rate in Eq. (384) is decreased in proportion to the clay content of soil to represent the slowing down of decomposition due to association of organic matter with minerals. The clay modifier is equal to 1 for all but the active pool, for which it is determined by the clay content cclayc^\text{clay} (0–1),

mactiveclay=10.75cclay.m^\text{clay}_\text{active} = 1 - 0.75 \, c^\text{clay}.

Finally, the decomposition rate is increased to account for the effect of tillage in crops. This modifier is based on [ref??] and given by

mtillage={1.2for c3 crop PFT,1.4for c4 crop PFT,1otherwise.m^\text{tillage} = \begin{cases} 1.2 & \text{for c3 crop PFT}, \\ 1.4 & \text{for c4 crop PFT}, \\ 1 & \text{otherwise}. \end{cases}

1.8.3DONE: Heterotrophic respiration from soil carbon decomposition

Heterotrophic respiration from soil (Fresp,het,soil^\text{resp,het,soil}) is obtained by summing the fractions of decomposition fluxes FC,iSOM_decompF^\text{SOM\_decomp}_{\text{C},i} which do not enter any other soil organic carbon pool,

Fresp,het,soil=i(1kfC,i,kSOM)FC,iSOM_decomp.F^{resp,het,soil} = \sum_i \left(1 - \sum_k f^\text{SOM}_{\text{C},i,k} \right) F^\text{SOM\_decomp}_{\text{C},i}.

All nitrogen released during the decay of the som pools goes into the mineral nitrogen pool of the soil, where it is available for plant uptake, or other nitrogen processes (section 1.8.5). Please note that when soil organic matter is discretized the mineral N pool is not therefore all the minerazlied N is going into a single mineral N pool.

1.8.4DONE: Vertically discretized carbon and nitrogen pools

When soil organic matter discretization is activated, the active, slow, and passive pools are divided into depth layers identical to the ones used in the soil thermodynamics calculations. In each layer of pool kk, ORCHIDEE keeps track of the volumetric concentration Ml,kSOM_3DM^\text{SOM\_3D}_{l,k} (in g/m3\unit{g/m^3}) of element ll (carbon or nitrogen). When soil organic matter discretization is activated, the surface soil organic matter pool is not used.

The areal (per m2\unit{m^2}) litter input flux Fl,klitt_SOM_2DF^\text{litt\_SOM\_2D}_{l,k} of element ll to pool kk is split into volumetric (per ) fluxes Fl,k,ilitt_SOM_3DF^\text{litt\_SOM\_3D}_{l,k,i} entering layer ii following a dimensionless profile filitt_SOM_3Df^\text{litt\_SOM\_3D}_i,

Fl,k,ilitt_SOM_3D=filitt_SOM_3DFl,klitt_SOM_2Dzilb_thermozi1lb_thermo,F^\text{litt\_SOM\_3D}_{l,k,i} = f^\text{litt\_SOM\_3D}_i \frac{F^\text{litt\_SOM\_2D}_{l,k}}{z^\text{lb\_thermo}_i - z^\text{lb\_thermo}_{i-1}},

where zilb_thermoz^\text{lb\_thermo}_i is the depth of the lower boundary of layer ii of soil thermodynamics and z0lb_thermo=0z^\text{lb\_thermo}_0 = 0. The profile filitt_SOM_3Df^\text{litt\_SOM\_3D}_i is normalized to sum to 1 and extends down to a grid-cell- and PFT-dependent depth zintdepz^\text{intdep}. Above that depth, it is proportional to the integral of a piecewise constant exponential with a grid-cell- and PFT-dependent characteristic depth zlittz^\text{litt}, giving

filitt_SOM_3D{exp(zi1lb_thermo/zlitt)exp(zilb_thermo/zlitt)zilb_thermo<zintdep,0zilb_thermozintdep.f^\text{litt\_SOM\_3D}_i \propto \begin{cases} \exp{\left(-z^\text{lb\_thermo}_{i-1} / z^\text{litt}\right)} - \exp{\left(-z^\text{lb\_thermo}_i / z^\text{litt}\right)} & z^\text{lb\_thermo}_i < z^\text{intdep}, \\ 0 & z^\text{lb\_thermo}_i \geq z^\text{intdep}. \end{cases}

By default (runtime flag new_carbinput_intdepzlit set to false), zlittz^\text{litt} and zintdepz^\text{intdep} are both be set to last year’s maximum active-layer thickness or to 0.5 m0.5~\unit{m}, whichever is larger. In the new approach (new_carbinput_intdepzlit set to true), zintdepz^\text{intdep} is set to the maximum depths root occur at (zroot_depthz^\text{root\_depth}), as calculated by the soil hydrology scheme. At the same time, zlittz^\text{litt} is set to the fine rooting depth of a given PFT or to a value proportional to the last year’s maximum active-layer thickness, whichever is smaller.

Following the distribution of litter, the decomposition of soil organic matter proceeds independently in each layer using the same formulation as the bulk soil organic matter dynamics described previously. Following decomposition, vertical transport of soil organic matter by cryoturbation or bioturbation is simulated. Both processes are assumed to follow Fick’s law of diffusion and differ only in the value of the depth-dependent diffusion constant D(z)D(z). That is, for each element ll and pool kk the vertical soil organic matter flux is

Fl,kvertical(z)=D(z)Ml,kSOM_3Dz.F^\text{vertical}_{l,k}(z) = - D(z) \frac{\partial M^\text{SOM\_3D}_{l,k}}{\partial z}.

Cryoturbation takes place in grid cells and PFT tiles in which last year’s maximum active layer thickness is larger than or equal to a parameter set to 1cm1\,\unit{cm} by default. In tiles where last year’s maximum active layer thickness is larger than or equal to a parameter set to 3m3\,\unit{m} by default, bioturbation takes place instead.

There are 6 alternative parametrizations of the depth-dependent cryoturbation diffusion constant. In the default (or old) parametrization and in the new parametrizations numbered 1, 2, 4, and 5, the cryoturbation diffusion constant is equal to a parameter ccryotb_diff=0.001m2/yrc^\text{cryotb\_diff}= 0.001\,\unit{m^2/yr} down to the layer corresponding to last year’s maximum active layer thickness zaltmax_lastyearz^\text{altmax\_lastyear}. In the layers below, the diffusion constant decreases in a way that depends on the parametrization. In the old parametrization, the diffusion constant in the layers immediately below zaltmax_lastyearz^\text{altmax\_lastyear} is equal to, respectively, ccryotb_diff/10c^\text{cryotb\_diff}/10, ccryotb_diff/100c^\text{cryotb\_diff}/100, and 0 all the way down to the bottom of the soil column. In the new parametrizations numbered 1, 4, and 5, the diffusion constant decays linearly reaching zero either at 2zaltmax_lastyear2 z^\text{altmax\_lastyear} (parametrization 1), at 3zaltmax_lastyear3 z^\text{altmax\_lastyear} (parametrization 4), or at 3m3\,\unit{m} (parameterization 5). In parametrizations 2 and 3, the diffusion constant decays exponentially with a characteristic depth of zaltmax_lastyearz^\text{altmax\_lastyear}. The decay starts below zaltmax_lastyearz^\text{altmax\_lastyear} in parametrization 2 and at the soil surface in parametrzation 3.

The bioturbation diffusion constant has a unique parametrization. It is equal to a parameter cbiotb_diff=0.0001m2/yrc^\text{biotb\_diff} = 0.0001\,\unit{m^2/yr} down to a constant depth cbiotb_depthc^\text{biotb\_depth}, equal to 2m2\,\unit{m} by default, and 0 below.

The diffusion equation (392) is solved using the same (finite-difference, implicit) numerical scheme as used for the soil heat transport. The scheme is described in detail by Li (1990) and by Hourdin (1992) (Annex A).

1.8.5Nitrogen fluxes from soil dynamics

Where should we describe the impose_cn option? Here? or in allocation where it is most impactful or in phenology where it is also applied? I described impose_cn = n as "a dynamic nitrogen cycle allowing nitrogen limitation" in the description of the model configuration (section 1). I have not yet describe impose cn = y but in line with the above it would become "a dynamic nitrogen cycle preventing (or avoiding?) nitrogen limitation". Feel free to change the wording. If changed, please also change in section 1.

Mineral nitrogen is represented by five pools: ammonium (NH3_3 / NH4+^+_4), nitrate (NO3^-_3), nitrogen oxides (NOx_x), nitrous oxide (N2_2O) and dinitrogen (N2_2) soil pools. The fate of mineral N in the five pools is controlled by the internal N flows associated with nitrification (the oxidation of NH3_3 / NH4+^+_4 in NO3^-_3) and denitrification (the reduction of NO3^-_3 up to the production of N{2_2) processes and by incoming and outgoing mineral fluxes. Incoming fluxes which are accounted for in ORCHIDEE are mineralization, biological nitrogen fixation, fertilization and atmospheric nitrogen deposition. Outgoing fluxes are emissions of N2_2O, NOx_x, N2_2 and NH3_3, plant nitrogen uptake of NH4+^+_4and NO3^-_3 and leaching. Figure XXX summarizes the mineral nitrogen pools and fluxes considered in ORCHIDEE.

Incoming mineral N fluxes

Outgoing mineral N fluxes

Internal mineral N fluxes

1.9DONE: BVOC emissions

ORCHIDEE calculates the emissions of volatile organic compounds (VOCs) from vegetation, also known as biogenic VOCs (BVOCs). BVOCs are generally characterized by a strong chemical reactivity in the atmosphere, together with high natural emissions, and therefore play a key role in the atmospheric chemical composition. Implementing BVOC emission schemes into the land surface model ORCHIDEE enables studying the interactions between the terrestrial biosphere, atmospheric chemistry, and climate. The original emission scheme Lathière et al., 2006 has been extensively updated by Messina et al. (2016), based on the model developed by Guenther et al. (2012). It includes an extended list of biogenic emitted compounds, updated emission factors, and a dependency on light for almost all compounds.

A wide range of BVOCs are simulated, including isoprene, monoterpenes (as a family of compounds and also with eight speciated monoterpenes), sesquiterpenes, methanol, acetone, acetaldehyde, formaldehyde, acetic acid and formic acid. The compounds accounted for by ORCHIDEE solely consist of carbon, hydrogen, and oxygen, hence, there is no interaction between the production of BVOCs in ORCHIDEE and the nitrogen cycle. Moreover, the BVOC emission calculation is a supplementary diagnostic and is not accounted for in the carbon mass balance.

The PFT-specific emission flux (Fj,iF_{j,i}; μ\mug C m2^{-2} h1^{-1}) of the specific biogenic compound jj, at canopy layer ii is calculated as:

Fj,i=diLAIc1,jmj,iclimmjagekslaF_{j,i}=\frac{d^{LAI}_{i} \cdot c_{1,j} \cdot m^{clim}_{j,i} \cdot m^{age}_{j}}{k^{sla}}

where diLAId^{LAI}_{i} is the leaf area of canopy layer ii, kslak^{sla} is the PFT-specific leaf area (m2^{2} g1)^{-1}), c1,jc_{1,j} (μ\mug C g1^{-1} h1^{-1}) is the PFT-specific basal emission at the leaf level for an individual emitted compound jj at a reference temperature of 303.15 K and a photosynthetically active radiation of 1000 μ\mumol m2^{-2} s1^{-1}. mj,iclimm^{clim}_{j,i} (unitless) is a compound-specific modulator that reflects the deviation from the standard conditions of temperature and photosynthetically active radiation, and magem^{age} (unitless) is a modulator that accounts for the change in emission capacity depending on the age of the leaves.

The temperature and radiation modulator is calculated separately for each compound jj and canopy layer ii:

mj,iclim=(1c2,j)b1,j+c2,jb2b3,im^{clim}_{j,i} = (1-c_{2,j}) \cdot b_{1,j} + c_{2,j} \cdot b_{2} \cdot b_{3,i}

The purpose of mj,iclimm^{clim}_{j,i} is to represent the light-dependent and light-independent processes that lead to emissions. c2,j_{2,j} is the prescribed fraction of emission that is, for one particular BVOC compound, light-dependent, b2b_{2} and b1,j_{1,j} are the dependencies of emissions to temperature, for light-dependent and light-independent fractions respectively, and b3,ib_{3,i} is the radiation-dependency relationship, considered for the light-dependent fraction of emissions. With

b1,j=exp(c3,j(Tair303.15))b_{1,j} = exp \left(c_{3,j} \cdot \left(T^{air}-303.15 \right) \right)

where c3,j_{3,j} is a prescribed temperature dependency for each compound jj, and Tair^{air} is the temperature of the air.

b2=b4(un+b5)b_{2} = \frac{b_{4}} {\left(un + b_{5}\right)}

where

b4=exp(c4(Tair303.15)cR303.15Tair)b_{4} = exp \left(\frac{c_4 \cdot \left(T^{air}-303.15 \right)}{c^R \cdot 303.15 \cdot T^{air}} \right)

and

b5(ji)=exp(c5(Tair314.15)cR303.15Tair)b_{5}(ji) = exp \left(\frac{c_5 \cdot \left(T^{air}-314.15 \right)}{c^R \cdot 303.15 \cdot T^{air}} \right)

with cR^R the ideal gas constant, i.e., 8.314 J mol1^{-1} K1^{-1}.

b3,i=c6FiPAR1+c72(FiPAR)2b_{3,i} = \frac{c_6 \cdot F^{PAR\downarrow}_{i}}{ \sqrt{1+c_7^{2} \cdot \left(F^{PAR\downarrow}_{i} \right)^{2}}}

where FiPAR^{PAR\downarrow}_{i} is the incoming photosynthetic active radiation in canopy layer ii calculated following the scheme for direct and diffuse light provided by Spitters et al. (1986) and Spitters (1986). Emissions are thus calculated for each canopy layer ii considering the sunlit and shaded leaf fractions and the light extinction and light diffusion through canopy. Note that vertical discretisation of the canopy and the light transfer calculated to simulate the BVOC emissions are not necessarily consistent with the canopy discretisation (section 1.5.7) and the light transfer 1.3.2 used in the rest of the model.

The leaf age modulator is calculated for isoprene and methanol only, for which a change in the emission capacity with leaf age has been demonstrated MacDonald & Fall, 1993Guenther et al., 1999 and is equal to unity for other BVOCs. Regarding isoprene and methanol, it is calculated in all leaf age classes, based on the fraction of leaves within each class fleaf^{leaf} calculated in ORCHIDEE (Section 1.5.1, and considering a different emission activity for each class, with a 50% reduction in emissions capacity c8,j_{8,j} for leaf age classes 1 and 4 in the case of isoprene and for leaf age classes 3 and 4 in the case of methanol.

mjage=fleafc8,jm^{age}_{j} = f^{leaf} \cdot c_{8,j}

Finally, the total emission per grid cell is obtained by summing Fj,iF_{j,i} over the layer ii and adding the emission contribution of each individual PFT, weighted by PFT fractional land coverage. Every values of emission factor and light-dependent fraction for each BVOC considered in the model can be found in Messina et al. (2016).

1.10DONE: Vegetation demography

Since vegetation canopy acts as the interface between the land and the atmosphere, forest stand structure has implications beyond the carbon and nitrogen budgets of forest management and disturbances, and has been shown to influence albedo, transpiration, photosynthesis, soil temperature, roughness length, and recruitment Amiro et al., 2006Amiro et al., 2006Dore et al., 2010Luyssaert et al., 2014Alkama & Cescatti, 2016Bright et al., 2017. Three demography processes are defined in ORCHIDEE. Succession refers to the aging of vegetation and describes how stands biomass is dynamically allocated to age and circumference classes following growth, management or mortality events. Recruitment refers to cases where small-scale mortality events are compensated by the growth of saplings and happens when management is unmanaged or continuous-cover forestry or in case of a disturbance affecting less than 30% of the stand basal area. Establishment refers to the growth of saplings in an area where all biomass is dead or non-existent, for example after harvest or after a disturbance affecting more than 30% basal area.

1.10.1DONE: Succession within established vegetation

To better represent forest succession and its impacts on element, energy, and water fluxes, ORCHIDEE v4.2 distinguishes between different age classes (nagenage). Each age class also includes circumference classes to enable simulating forest management, forest disturbances, and more refined simulation of canopy structure. For each PFT, processes such as establishment, phenology, photosynthesis, maintenance respiration, allocation and growth respiration, mortality, land use, disturbances, litter decomposition, and soil decomposition are calculated as described in sections 1.10.3 to 1. Throughout these processes, the multiple circumference classes are considered, with trees in different classes experiencing preferential growth and mortality rates driven by different processes. In long enough simulations or under high mortality conditions, stand density in some circumference classes may eventually drop to zero, reducing the numerical resolution of the carbon and nitrogen allocation scheme (specifically equation 301). When only one populated circumference class remains, the scheme loses its meaning, as all the newly produced biomass is allocated to the sole remaining class. To ensure maintaining the same level of detail throughout the simulation, individuals and their biomass are redistributed across all circumference classes at the end of each day.

The daily redistribution of biomass across circumference classes largely recalculates the structural impact of thinning, disturbances, and recruitment. During the redistribution, individuals are allocated to the ncircncirc circumference classes according to the Weibull distribution, with the shape depending on the forest management strategy and the quadratic mean diameter of the stand for rotational even-aged management (equations 343 to %s). Once the number of individuals in each circumference class is known, their corresponding biomass is moved to the respective class. The new total biomass of each circumference class is then divided by its new number of individuals to obtain the mean biomass of the model tree in each class. With the wood biomass now determined, the circumference of each model tree is calculated, and the boundaries of the circumference classes are updated.

1.10.2DONE: Recruitment within established vegetation

Recruitment of saplings within an existing forest PFT compensates for the loss of individuals due to density-driven mortality (section 1.6.3) and other sources of tree mortality. By default, recruitment is calculated once per year and only applies to unmanaged or continuous-cover forestry stands. The number of recruits added each year (dind,recd^{ind,rec}; m2^{-2}) in the first age class is given by:

dind,rec=c1(log(c2dind)log(max(100fPgap,trees,season,un))d^{ind,rec} = c_1 ^{(\log{(c_2 \cdot d^{ind}) \cdot \sqrt{\log{(\max(100 \cdot f^{Pgap,trees,season},un)}}})}

where c1c_1 and c2c_2 are PFT-specific parameters, dindd^{ind} is the stand density (m2^{-2}) before recruitment, and fPgap,trees,seasonf^{Pgap,trees,season} is the fraction of light reaching the forest floor (equation 358) averaged over the growing season. Recruitment density increases with lower initial stand densities and sparser canopies.

The height of an individual sapling is determined by a PFT-specific parameter c3c_3 (m) and is used to calculate the initial diameter (m) using equation 299. Height and diameter are then used in equation 286 to calculate the sapwood mass (MsapM^{sap}; g plant1^{-1}) for an individual recruit. Subsequently, leaf mass (MleafM^{leaf}; g plant1^{-1}) and root mass (MrootM^{root}; g plant1^{-1}) are calculated using equations 287 and 292, respectively, with the allocation parameters fKFf^{KF} (equation 288) and fLFf^{LF} (equation 293) recalculated to account for the effect of light stress on allocation.

If recruitment occurs outside the growing season in a deciduous PFT, the leaf and root masses are transferred to the reserve pool (MresM^{res}; g plant1^{-1}). Finally, the newly recruited biomass and individuals are added to the first circumference class of the existing PFT as follows:

M1plant=M1plantdind+Mrecdind,recd1ind+dind,recd1ind=d1ind+dind,rec\begin{align} &M^{plant}_{1} = \frac{M^{plant}_{1} \cdot d^{ind} + M^{rec} \cdot d^{ind,rec}}{d^{ind}_{1} + d^{ind,rec}}\\ &d^{ind}_{1} = d^{ind}_{1} + d^{ind,rec} \end{align}

Recruitment is mono-specific and follows the PFT in which it occurs. In other words, ORCHIDEE v4.2 does not explicitly simulate multiple species within a single PFT. However, the PFT parameters can be set to represent a multi-species stand, as in the case of species-rich tropical forests represented by the MTC labelled as Tropical broad-leaf evergreen forest (Table 6).

1.10.3DONE: Establishment of new vegetation

In ORCHIDEE v4.2, new vegetation is established following a stand-replacing event, which can be natural mortality (section 1.6), natural disturbance (section 1), land cover change (section 1.1), forest management (section 1.4), or crop harvesting (section 1.3). In cases of land cover change (section 1.1), the newly established vegetation has a different PFT than that of the previous vegetation. Similarly, for a change in forest PFT (section

), the newly established vegetation may have a different PFT. In all other cases, the newly established vegetation retains the same PFT as the previous vegetation.

The fraction of the newly established PFT within the grid cell (fveg,maxf^{veg,max}; unitless) is read from an external annual vegetation distribution map (section 1.2) or derived from internal areal bookkeeping in the case of natural disturbances (section 1.6). For forests, the size distribution of saplings across circumferences classes in the first age class is calculated, including the diameter (dldiad^{dia}_{l}; m2^{-2}), height (dhd^{h}; m) and biomass of model individuals (MlplantM^{plant}_{l}; g plant1^{-1}) as well as the number of saplings in each circumference class. The approach formalized in ORCHIDEE v4.2 introduces a circular dependency because the density distribution across circumference classes ll depends on the quadratic mean diameter (section 1.5.5), while the quadratic mean diameter itself depends on the density distribution (section %s). This circularity is resolved through a single iteration that begins by calculating the representative diameter for each circumference class using the PFT-specific minimum diameter (c2c_2; m) and maximum diameter (c3c_3; m):

dldia,init=c2+(l1)(c3c1)ncirc1d^{dia,init}_{l} = \frac{c_2 + (l-1) \cdot (c_3-c_1)}{ncirc-1}

An initial estimate of the frequency distribution of individuals in each circumference class ll is derived from the Weibull distribution (equations 344 to %s) with distribution parameters depending on PFT and management strategy dlqmdia,initd^{qmdia,init}_{l} as the central circumference class diameter, the diameter at which the continuous Weibull distribution is truncated (c1c_1 in equation 344) depending on the forest management strategy and the shape (kshapek^{shape}; unitless) parameter of the Weibull distribution is either calculated or prescribed depending on the forest management strategy (equation 343).

The total number of individuals is determined using equation 339 with the quadratic mean diameter (dqmdia,initd^{qmdia, init}; m). The frequency distribution in each circ class and total number of individuals (dindd^{ind}; m2^{-2}) are then used to calculate the number of individuals in each circumference class ll.

The representative diameters in each circumference class derived from the Weibull distribution are also used to calculate the biomass for individual trees in each circumference class ll following the same allocation principles (section 1.4.2). The diameter of the representative sapling in each circumference class is determined using equation 403 and it is then used to calculate the corresponding tree height via the allometric equation 299. Height and diameter are subsequently used in equation 286 to calculate the sapwood mass (MsapM^{sap}; g plant1^{-1}) of an individual sapling. Then, leaf mass (MleafM^{leaf}; g plant1^{-1}) and root mass (MrootM^{root}; g plant1^{-1}) of a sapling are calculated using Equations 287 and 292, respectively, where the allocation parameters fKFf^{KF} (equation 288) and fLFf^{LF} (equation 293) are calculated assuming that there is no light stress at the time of vegetation establishment. For deciduous PFTs, if recruitment occurs outside the growing season, leaf and root masses are moved into the reserve pool (MresM^{res}; g plant1^{-1}). Since the allocation equations and the self-thinning relationship are not suited for seedlings, initial diameters (i.e., c2c_2 and c3c_3) are prescribed to exceed \sim 0.02 m. The initial forests thus better represent the sapling than the seedling stage.

For grassland and cropland PFTs, the stand density is prescribed and fixed. These PFTs are initialized by prescribing the initial height, which is converted into a leaf area using a single prescribed parameter. After calculating the allocation parameters fKFf^{KF} (equation 288), fLFf^{LF} (equation 293), and the specific leaf area (equation 1.5.2), leaf mass (MleafM^{leaf}; g plant1^{-1}) is computed as follows:

Mleaf=dLAIkslaM^{leaf} = \frac{d^{LAI}}{k^{sla}}

With the leaf mass and allocation parameters determined, root (MrootM^{root}; g plant1^{-1}) and stem mass (MsapM^{sap}; g plant1^{-1}) are calculated using Equations 287 and 292. All grassland and cropland PFTs are assumed to be deciduous, with crops established on the day of bud break. As with forest vegetation, if the grassland PFT is established outside the growing season, the leaf and root mass are transferred into the reserve pool (MresM^{res}; g plant1^{-1}) until bud break.

During vegetation establishment, the carbon necessary to build the initial biomass is taken from the atmosphere. Nitrogen needed for establishment is drawn from the soil mineral nitrogen pool, which is replenished through mineralisation (section 1.8.5), atmospheric deposition and nitrogen fertilisation (section 1.9). If the mineral nitrogen pool cannot satisfy the initial demand, nitrogen is supplied from the organic soil nitrogen pools (section 1.8.1). If the latter pools cannot meet the demand either, nitrogen is finally taken from the atmosphere.

References
  1. Lieth, H. (1974). Phenology and seasonality modeling (Vol. 8). Springer.
  2. Piao, S., Liu, Q., Chen, A., Janssens, I. A., Fu, Y., Dai, J., Liu, L., Lian, X., Shen, M., & Zhu, X. (2019). Plant phenology and global climate change: Current progresses and challenges. Global Change Biology, 25(6), 1922–1940. 10.1111/gcb.14619
  3. Botta, A., Viovy, N., Ciais, P., Friedlingstein, P., & Monfray, P. (2000). A global prognostic scheme of leaf onset using satellite data. Global Change Biology, 6(7), 709–725. 10.1046/j.1365-2486.2000.00362.x
  4. Chuine, I. (2000). A unified model for budburst of trees. Journal of Theoretical Biology, 207(3), 337–347. 10.1006/jtbi.2000.2178
  5. Hänninen, H., & Kramer, K. (2007). A framework for modelling the annual cycle of trees in boreal and temperate regions. Silva Fennica, 41(1), 167–205. 10.14214/sf.313
  6. Orlandi, F., Garcia-Mozo, H., Vazquez Ezquerra, L., Romano, B., Dominguez, E., Galan, C., & Fornaciari, M. (2004). Phenological olive chilling requirements in Umbria (Italy) and Andalusia (Spain). Plant Biosystems, 138(2), 111–116. 10.1080/11263500412331283762
  7. Cannell, M. G. R., & Smith, R. I. (1986). Climatic Warming, Spring Budburst and Forest Damage on Trees. The Journal of Applied Ecology, 23(1), 177. 10.2307/2403090
  8. Murray, M. B., Cannell, M. G. R., & Smith, R. I. (1989). Date of Budburst of Fifteen Tree Species in Britain Following Climatic Warming. The Journal of Applied Ecology, 26(2), 693. 10.2307/2404093
  9. Krinner, G., Nicolas, V., de Noblet-Ducoudre, N., Ogée, J., Polcher, J., Friedlingstein, P., Ciais, P., Sitch, S., & Prentice, I. C. (2005). A dynamic global vegetation model for studies of the coupled atmosphere-biosphere system. Global Biogeochemical Cycles, 19(1), GB1015. 10.1029/2003GB002199
  10. MacBean, N., Maignan, F., Peylin, P., Bacour, C., Bréon, F.-M., & Ciais, P. (2015). Using satellite data to improve the leaf phenology of a global terrestrial biosphere model. Biogeosciences, 12(23), 7185–7208.
  11. Yin, X., & Struik, P. C. (2009). C3 and C4 photosynthesis models: An overview from the perspective of crop modelling. NJAS - Wageningen Journal of Life Sciences, 57(1), 27–38. 10.1016/j.njas.2009.07.001
  12. Farquhar, G., & Wong, S. (1984). An empirical model of stomatal conductance. Functional Plant Biology, 11(3), 191–210.
  13. Medlyn, B. E., Dreyer, E., Ellsworth, D., Forstreuter, M., Harley, P. C., Kirschbaum, M. U. F., Le Roux, X., Montpied, P., Strassemeyer, J., Walcroft, A., Wang, K., & Loustau, D. (2002). Temperature response of parameters of a biochemically based model of photosynthesis. II. A review of experimental data. Plant, Cell and Environment, 25(9), 1167–1179. 10.1046/j.1365-3040.2002.00891.x
  14. Amthor, J. S. (1984). The role of maintenance respiration in plant growth. Plant, Cell and Environment, 7(8), 561–569. 10.1111/1365-3040.ep11591833
  15. Vicca, S., Luyssaert, S., Peñuelas, J., Campioli, M., Chapin, F. S., Ciais, P., Heinemeyer, A., Högberg, P., Kutsch, W. L., Law, B. E., Malhi, Y., Papale, D., Piao, S. L., Reichstein, M., Schulze, E. D., & Janssens, I. A. (2012). Fertile forests produce biomass more efficiently. Ecology Letters, 15(6), 520–526. 10.1111/j.1461-0248.2012.01775.x