Aerosol / particle single-scattering radiative properties

Aerosol / particle single-scattering radiative properties#

A particle radiative single-scattering property dataset provides collision coefficients and scattering phase matrix data for a given particle type. Eradiate’s built-in particle radiative property datasets are managed by the data store (see Data guide introduction for details).

Format#

Format xarray.Dataset (in-memory), NetCDF (storage)
Dimensions
- w: radiation wavelength
- mu: scattering angle cosine
- i: scattering phase matrix row index
- j: scattering phase matrix column index
Coordinates (all dimension coordinates; when relevant, units are required and specified in the units metadata field)
- w float [length]
- mu float [dimensionless]
- i, j int
Data variables (when relevant, units are required and specified in the units metadata field)
- sigma_t (w): volume extinction coefficient [length^-1]
- albedo (w): single-scattering albedo [dimensionless]
- phase (w, mu, i, j): scattering phase matrix [steradian^-1]
Conventions
- Phase matrix components use C-style indexing (from 0).

Full validation schema

dims:
  type: dict
  allow_unknown: false
  schema:
    w: integer
    mu: integer
    i: integer
    j: integer
coords:
  type: dict
  allow_unknown: true
  schema:
    w:
      required: true
      type: dict
      schema:
        dims:
          equal_list: [ w ]
        dtype:
          allowed: [ float64 ]
        attrs:
          type: dict
          schema:
            standard_name: string
            long_name: string
            units:
              units_compatible: nm
    i:
      required: true
      type: dict
      schema:
        dims:
          equal_list: [ i ]
        dtype:
          allowed: [ int64 ]
        attrs:
          type: dict
          schema:
            standard_name: string
            long_name: string
            units:
              units_compatible: dimensionless
    j:
      required: true
      type: dict
      schema:
        dims:
          equal_list: [ j ]
        dtype:
          allowed: [ int64 ]
        attrs:
          type: dict
          schema:
            standard_name: string
            long_name: string
            units:
              units_compatible: dimensionless
    mu:
      required: true
      type: dict
      schema:
        dims:
          equal_list: [ mu ]
        dtype:
          allowed: [ float64 ]
        attrs:
          type: dict
          schema:
            standard_name: string
            long_name: string
            units:
              units_compatible: dimensionless
data_vars:
  type: dict
  allow_unknown: true
  schema:
    sigma_t:
      required: true
      type: dict
      schema:
        dims:
          equal_list: [ w ]
        dtype:
          allowed: [ float64 ]
        attrs:
          type: dict
          schema:
            standard_name: string
            long_name: string
            units:
              units_compatible: dimensionless  # TODO: check (documentation mismatch)
    albedo:
      required: true
      type: dict
      schema:
        dims:
          equal_list: [ w ]
        dtype:
          allowed: [ float64 ]
        attrs:
          type: dict
          schema:
            standard_name: string
            long_name: string
            units:
              units_compatible: dimensionless
    phase:
      required: true
      type: dict
      schema:
        dims:
          equal_list: [ w, mu, i, j ]
        dtype:
          allowed: [ float64 ]
        attrs:
          type: dict
          schema:
            standard_name: string
            long_name: string
            units:
              units_compatible: dimensionless  # TODO: check (documentation mismatch)