eradiate.data.convert.libradtran_to_aer_core_v2

eradiate.data.convert.libradtran_to_aer_core_v2(ds, attrs=None, fallback_units=None, normalize=False, check='full')

Convert a dataset in the libRadtran scattering particle property format to the Aer-Core v2 format.

Parameters:

  • ds (Dataset) – A dataset in the libRadtran format. No additional dimensions such as the effective radius or humidity are considered.

  • attrs (dict, optional) – Additional metadata applied to the converted dataset.

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

  • normalize (bool, default: False) – If True, rescale the phase matrix so that p₁₁ integrates to 2 over μ ∈ [-1, 1]. Passed to make_aer_core_v2(); see that function for details.

  • check ({"none", "fast", "full"}, default: "full") – Apply validation checks to the output.

Returns:

xr.Dataset

Notes

  • The Aer-Core v2 format has a single angular discretization common to all phase matrix coefficients, while libRadtran’s data aerosol format allows for a different one for each coefficient. The angular grid of the output dataset is constructed as the union of the libRadtran grids for all coefficients; all coefficients are then interpolated linearly in μ space on the angular points that were missing for them.