eradiate.data.io.load_aerosol_libradtran

eradiate.data.io.load_aerosol_libradtran(data, tolerance=None, wbounds=(None, None), fallback_units=None, **kwargs)

Convert a libRadtran NetCDF aerosol file to the Eradiate aerosol data format. Both effective radius and humidity-indexed data are supported.

Parameters:

• data (Dataset or path-like) – A libRadtran NetCDF aerosol dataset. If a path is passed, it will be resolved by the file resolver and tentatively loaded into memory.

• reff, hum (float or quantity) – For datasets with a humidity or effective radius dimension, the coordinate point to select. By default, the nearest data point is selected; tolerance can be adjusted using the tolerance parameter. Quantities are accepted (see Notes for expected dimensions and defaults). These parameters are optional if the dataset has only one point on these dimensions.

• wbounds (tuple, optional) – Bounds to restrict the spectral domain where conversion is performed. This parameter accepts a tuple with the minimum and maximum values (use None to leave a bound open). Examples: (300, 3000), (None, 3000), (0.3, 3) * ureg.micron, (None, 3 * ureg.micron).

• tolerance (dict) – A mapping that allows to specify a tolerance for nearest neighbour lookup for relevant parameters. Units are applied with the same rules as for the reff and hum parameters.

• fallback_units (dict, optional) – A mapping that specifies units to apply to variables that are missing them.

Returns:

Dataset

See also

libradtran_to_aer_core_v2()

Notes

Parameter	Dimension	Default units
reff	Length	μm
hum	Dimensionless (fraction)	percent
wbounds	Wavelength	ucc.get("wavelength") (usually, nm)

• All conversion is done in memory: very large datasets might result in massive converted data. In such cases, an easy way to split the conversion is to chunk it on the spectral dimension.