Ags#

class abcmodel.land.biosphere.ags.AgsState(rs, wl, cliq, wCO2, cveg, rsCO2=<factory>, gcco2=<factory>, ci=<factory>, co2abs=<factory>, wCO2A=<factory>, wCO2R=<factory>, wltend=<factory>)[source]#

Bases: AbstractBiosphereState

A-gs biosphere state.

rs: Array#

Surface resistance [s m-1].

wl: Array#

Canopy water content [m].

cliq: Array#

Wet fraction of canopy [-].

wCO2: Array#

Total CO2 flux [mol m-2 s-1].

cveg: Array#

Vegetation fraction [-].

rsCO2: Array#

Stomatal resistance to CO2.

gcco2: Array#

Conductance to CO2.

ci: Array#

Intercellular CO2 concentration.

co2abs: Array#

CO2 assimilation rate / concentration.

wCO2A: Array#

Net assimilation flux [mol m-2 s-1].

wCO2R: Array#

Respiration flux [mol m-2 s-1].

wltend: Array#

Canopy water content tendency [m].

class abcmodel.land.biosphere.ags.AgsModel(c3c4='c3', lai=2.0, cveg=0.85, wmax=0.0002, wwilt=0.171, wfc=0.323, w2=0.21)[source]#

Bases: AbstractBiosphereModel[AgsState]

Ags land surface biosphere model with coupled photosynthesis and stomatal conductance.

Parameters:
  • c3c4 (str) – string indicating whether the model should use C3 or C4 photosynthesis. Default is “c3”.

  • lai (float) – leaf area index [m2 m-2]. Default is 2.0.

  • cveg (float) – vegetation fraction [-]. Default is 0.85.

  • wmax (float) – maximum water storage capacity of the canopy [m]. Default is 0.0002.

  • wwilt (float) – soil moisture content at wilting point [m3 m-3]. Default is 0.171.

  • wfc (float) – soil moisture content at field capacity [m3 m-3]. Default is 0.323.

  • w2 (float) – soil moisture content at the second layer [m3 m-3]. Default is 0.21.

init_state(rs=1000000.0, wl=0.0, cliq=0.0, wCO2=0.0)[source]#

Initialize the Ags state.

Parameters:
  • rs (float) – Surface resistance [s m-1]. Default is 1.0e6.

  • wl (float) – Canopy water content [m]. Default is 0.0.

  • cliq (float) – Wet fraction of canopy [-]. Default is 0.0.

  • wCO2 (float) – Total CO2 flux [mol m-2 s-1]. Default is 0.0.

Returns:

The initialized AgsState.

run(state)[source]#

Compute stomatal resistance and CO2 fluxes.

compute_co2comp(thetasurf)[source]#

Compute the CO₂ compensation concentration.

compute_gm(thetasurf)[source]#

Compute the mesophyll conductance.

compute_fmin(gm)[source]#

Compute minimum stomatal conductance factor.

compute_ds(surf_temp, e)[source]#

Compute vapor pressure deficit (ds) in kPa.

compute_d0(fmin)[source]#

Compute reference vapor pressure deficit.

compute_internal_co2(ds, d0, fmin, co2, co2comp)[source]#

Compute cfrac, co2abs, and ci (internal CO2 concentration).

compute_max_gross_primary_production(thetasurf)[source]#

Compute maximal gross primary production.

compute_soil_moisture_stress_factor(w2)[source]#

Compute effect of soil moisture stress.

compute_gross_assimilation(ammax, gm, ci, co2comp)[source]#

Compute gross assimilation rate.

compute_dark_respiration(am)[source]#

Compute dark respiration.

compute_absorbed_par(in_srad)[source]#

Compute absorbed photosynthetically active rad.

compute_canopy_co2_conductance(alphac, par, am, rdark, fstr, co2abs, co2comp, ds, d0, fmin)[source]#

Compute CO2 conductance at canopy level.

compute_rs(gcco2)[source]#

Compute surface resistance.

compute_light_use_efficiency(co2abs, co2comp)[source]#

Compute light use efficiency.

compute_surface_co2_resistance(gcco2)[source]#

Compute surface resistance to CO₂.

compute_net_assimilation(co2abs, ci, ra, rsCO2)[source]#

Compute net CO₂ assimilation rate.

compute_soil_water_fraction(wg)[source]#

Compute soil water fraction.

compute_respiration(temp_soil, fw)[source]#

Compute soil respiration.

scale_flux_to_mol(flux)[source]#

Scale a flux to mol m⁻² s⁻¹.

compute_cliq(wl)[source]#

Compute wet fraction of canopy.

compute_wltend(le_liq)[source]#

Compute canopy water storage tendency.

run_tends(state, surf_state)[source]#

Compute biosphere tendencies that depend on surface fluxes.

integrate(state, dt)[source]#

Integrate canopy water content forward in time.