model.environment.optical_properties

Canopy optical properties for ADELM.

This module derives canopy optical properties, two-stream geometry, and ground albedo required by the shortwave radiative transfer scheme.

Module Contents

Functions

calculate_optical_properties

Derive canopy two-stream optical parameters and snow-blended ground albedo.

API

model.environment.optical_properties.calculate_optical_properties(drivers, states, fluxes, diagnos, params, consts, errors, structure, debugs)

Derive canopy two-stream optical parameters and snow-blended ground albedo.

See also

Process notes: Optical Properties

Parameters:

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

• states (dict) – Required variable: snow_water_storage.

• params (dict) – Required variables: stem_area_index, leaf_angle_dist_index, leaf_{vis,nir}_reflectance, leaf_{vis,nir}_transmittance, stem_{vis,nir}_reflectance, stem_{vis,nir}_transmittance, soil_{vis,nir}_albedo, snow_{vis,nir}_albedo, snow_{vis,nir}_omega, and snow_cover_scale.

• consts (dict) – Required variable: numerical_epsilon.

Returns:

diagnos – Updated variables: vegetation_area_index, snow_cover_fraction, canopy_single_scattering_albedo_{vis,nir}, canopy_direct_beam_extinction_coefficient, canopy_diffuse_optical_depth_scale, 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}.

Return type:

dict