model.processes.radiative_transfer

Canopy radiative transfer module for ADELM.

This module calculates shortwave and longwave radiation exchange between atmosphere, vegetation canopy, and soil surface. The scheme provides absorbed radiation fluxes required by canopy energy balance, photosynthesis, and soil energy processes.

Module Contents

Functions

calculate_shortwave_balance	Partition incoming shortwave radiation between canopy and ground using the two-stream scheme.
calculate_longwave_balance	Compute net longwave exchange between atmosphere, canopy, and ground.

API

model.processes.radiative_transfer.calculate_shortwave_balance(drivers, states, fluxes, diagnos, params, consts, errors, structure, debugs)

Partition incoming shortwave radiation between canopy and ground using the two-stream scheme.

See also

Physics: Shortwave Radiation

Parameters:

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

• diagnos (dict) – Required variables: vegetation_area_index, canopy_direct_beam_extinction_coefficient, canopy_diffuse_optical_depth_scale, canopy_single_scattering_albedo_{vis,nir}, canopy_direct_beam_upscatter_parameter_{vis,nir}, canopy_diffuse_upscatter_parameter_{vis,nir}, ground_direct_beam_albedo_{vis,nir}, and ground_diffuse_albedo_{vis,nir}.

• params (dict) – Required variables: vis_fraction_of_shortwave and direct_beam_fraction.

Returns:

• fluxes (dict) – Updated variables: incoming_par_Wm2, leaf_apar_Wm2, canopy_net_swrad_Wm2, soil_net_swrad_Wm2, and net_swrad_Wm2.

• errors (dict) – Updated variable: shortwave_balance_error.

model.processes.radiative_transfer.calculate_longwave_balance(drivers, states, fluxes, diagnos, params, consts, errors, structure, debugs)

Compute net longwave exchange between atmosphere, canopy, and ground.

See also

Physics: Longwave Radiation

Parameters:

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

• diagnos (dict) – Required variable: vegetation_area_index.

• params (dict) – Required variable: surface_emissivity.

• consts (dict) – Required variables: stefan_boltzmann_constant and absolute_zero_offset.

Returns:

• fluxes (dict) – Updated variables: canopy_net_lwrad_Wm2, soil_net_lwrad_Wm2, net_lwrad_Wm2, lwdown_below_canopy_Wm2, lwup_below_canopy_Wm2, and lwup_above_canopy_Wm2.

• errors (dict) – Updated variable: longwave_balance_error.

• debugs (dict) – Updated variables: canopy_emit_lwrad_Wm2 and soil_emit_lwrad_Wm2.