CAMP: Modal/Binned Mass Aerosol Representation

The modal/binned mass aerosol representation includes a set of sections/bins that are made up of one or more aerosol phases. The json object for this aerosol representation has the following format:

{ "camp-data" : [
  {
    "name" : "my modal/binned aero rep",
    "type" : "AERO_REP_MODAL_BINNED_MASS",
    "modes/bins" :
    {
      "dust" :
      {
        "type" : "BINNED",
        "phases" : [ "insoluble", "organic", "aqueous" ],
        "bins" : 8,
        "minimum diameter [m]" : 0.8e-9,
        "maximum diameter [m]" : 1.0e-6,
        "scale" : "LOG"
      },
      "depeche" :
      {
        "type" : "MODAL",
        "phases" : [ "moody", "listless" ],
        "shape" : "LOG_NORMAL",
      }
    }
  },
  ...
]}

The key-value pair type is required and must be AERO_REP_MODAL_BINNED_MASS. The key-value pair modes/bins is also required and must contain a set of at least one uniquely named mode or bin-set key-value pair whose value(s) specify a type that must be either MODAL or BINNED and an array of phases that correspond to existing aerosol phase objects. Each phase will be present once within a mode or once within each bin in a bin-set.

Modes must also specify a distribution shape which must be LOG_NORMAL (the available shapes may be expanded in the future). Log-normal sections have geometric mean diameter (m) and a geometric standard deviation (unitless) properties that must be set using an aero_rep_update_data_modal_binned_mass_GMD_t or and aero_rep_update_data_modal_binned_mass_GSD_t object and will be used along with the mass concentration of species in each phase and their densities to calculate a lognormal distribution for each mode at runtime.

Bin sets must specify the number of bins, a minimum diameter (m), a maximum diameter (m) and a scale, which must be LOG or LINEAR. The number concentration will be calculated at run-time based on the total mass of each bin, the species densities and the diameter of particles in that bin.

The GMD and GSD for each mode must be set from an external model using camp_aero_rep_modal_binned_mass::aero_rep_update_data_modal_binned_mass_GMD_t and camp_aero_rep_modal_binned_mass::aero_rep_update_data_modal_binned_mass_GSD_t objects.