Standard

class abcmodel.land.standard.StandardLandState(biosphere, soil, surface)

Bases: AbstractLandState, Generic[BiosphereT, SoilT, SurfaceT]

Standard land surface model state aggregating biosphere, soil, and surface.

Parameters:

• biosphere (TypeVar(BiosphereT, bound= AbstractBiosphereState)) – The biosphere component state.

• soil (TypeVar(SoilT, bound= AbstractSoilState)) – The soil component state.

• surface (TypeVar(SurfaceT, bound= AbstractSurfaceState)) – The surface component state.

biosphere: BiosphereT

soil: SoilT

surface: SurfaceT

property alpha: Array

Surface albedo [-], range 0 to 1.

property surf_temp: Array

Surface temperature [K].

property rs: Array

Surface resistance [s m-1].

property wg: Array

Ground water storage [m].

property wl: Array

Land water storage [m].

property esat: Array

Saturation vapor pressure [Pa].

property qsat: Array

Saturation specific humidity [kg kg-1].

property dqsatdT: Array

Derivative of saturation specific humidity with respect to temperature [kg kg-1 K-1].

property e: Array

Vapor pressure [Pa].

property qsatsurf: Array

Saturation specific humidity at the surface [kg kg-1].

property wtheta: Array

Kinematic heat flux [K m/s].

property wq: Array

Kinematic moisture flux [kg kg-1 m/s].

property wCO2: Array

Kinematic CO2 flux [kg m/s].

class abcmodel.land.standard.StandardLandModel(biosphere, soil, surface)

Bases: AbstractLandModel[StandardLandState]

Standard land model coordinating biosphere, soil, and surface models.

Parameters:

• biosphere (AbstractBiosphereModel) – Biosphere model instance (e.g., AgsModel or JarvisStewartModel).

• soil (AbstractSoilModel) – Soil model instance (e.g., StandardSoilModel).

• surface (AbstractSurfaceModel) – Surface model instance (e.g., StandardSurfaceModel).

init_state(biosphere_state, soil_state, surface_state)

Initialize standard land state.

Parameters:

• biosphere_state (TypeVar(BiosphereT, bound= AbstractBiosphereState)) – Initialized biosphere state.

• soil_state (TypeVar(SoilT, bound= AbstractSoilState)) – Initialized soil state.

• surface_state (TypeVar(SurfaceT, bound= AbstractSurfaceState)) – Initialized surface state.

Returns:

The aggregated StandardLandState.

run(state)

Run the full land surface model for one time step.

Execution order:

1. biosphere diagnostics (stomatal resistance, CO2 fluxes, wet fraction)

2. soil diagnostics (soil resistance)

3. surface fluxes and skin temperature (energy balance, latent/sensible/ground heat)

4. biosphere tendencies (canopy water)

5. soil tendencies (moisture and temperature)

Parameters:

state (AbstractCoupledState) – CoupledState carrying atmos, land, and radiation state.

Returns:

The updated land state object with all computed fluxes and diagnostics.

integrate(state, dt)

Integrate biosphere, soil, and surface states forward in time.

Parameters:

• state (StandardLandState) – the land state object carrying all variables.

• dt (float) – the time step [s].

Returns:

The updated land state object.