model.environment.surface_exchange¶

Atmospheric thermodynamics and aerodynamic surface exchange for ADELM.

This module diagnoses thermodynamic quantities and aerodynamic conductances shared by evapotranspiration and photosynthesis. The routines are called once per timestep so their outputs can be reused by downstream processes.

Module Contents¶

Functions¶

calculate_timestep_and_thermodynamics

Diagnose atmospheric thermodynamic quantities from air temperature and vapour pressure deficit.

calculate_aerodynamic_exchange

Diagnose canopy and soil aerodynamic conductances using a neutral-stability wind-profile model.

Data¶

API¶

model.environment.surface_exchange.calculate_timestep_and_thermodynamics(drivers, states, fluxes, diagnos, params, consts, errors, structure, debugs)¶

Diagnose atmospheric thermodynamic quantities from air temperature and vapour pressure deficit.

See also

Process notes: Atmospheric Thermodynamics

Parameters:
  • drivers (dict) – Required variables: ta_degC and vpd_kPa.

  • consts (dict) – Required variables: absolute_zero_offset, standard_air_pressure, universal_gas_constant, and specific_heat_capacity_air.

Returns:

diagnos – Updated variables: air_density, air_molar_density, latent_heat_of_vaporization, psychrometric_constant, saturation_vapour_pressure_slope, water_vapour_diffusivity, and kinematic_viscosity_of_air.

Return type:

dict

model.environment.surface_exchange.calculate_aerodynamic_exchange(drivers, states, fluxes, diagnos, params, consts, errors, structure, debugs)¶

Diagnose canopy and soil aerodynamic conductances using a neutral-stability wind-profile model.

See also

Process notes: Aerodynamic Exchange

Parameters:
  • drivers (dict) – Required variables: lai and wind_ms.

  • diagnos (dict) – Required variables: water_vapour_diffusivity and kinematic_viscosity_of_air.

  • params (dict) – Required variables: canopy_height, soil_roughness_length, and canopy_leaf_width.

  • consts (dict) – Required variable: von_karman_constant.

Returns:

diagnos – Updated variables: soil_aerodynamic_conductance, leaf_boundary_layer_conductance, above_canopy_aerodynamic_conductance, and canopy_aerodynamic_conductance.

Return type:

dict

model.environment.surface_exchange.__all__¶

[‘calculate_timestep_and_thermodynamics’, ‘calculate_aerodynamic_exchange’]