Facilitate porting of rate constants to MICM

[mattldawson]

MUSICA should make it easy to inject photolysis rate constants from TUV-x or another calculator into MICM. Some time of mapping.

Acceptance Criteria

• A test that demonstrates the calculation of photolysis rate constants in TUV-x, copying into MICM rate constant data structure, and solving with MICM is included in the test suite
• Mapping is automated when the "MUSICA name" in a MICM photolysis reaction matches the name given to a TUV-x photolysis reaction
• Users can configure custom mapping when the names in MICM and TUV-x don't match, and can include scaling factors that will be applied to rate constants before copying into MICM

Ideas

• A JSON/YAML file that specifies the mapping configuration could be used:

  "map" : {
  "auto-match" : true,
  "custom mapping" : [
  {
    "source name" : "foo",
    "destination name": "jfoo"
  },
  {
    "source name" : "bar",
    "destination name" : "jbaz",
    "scaling factor" : 0.75
  }
  ]
  }

• Users could do something like:

  // create MICM, TUV-x
  Error error;
  MICM* micm = CreateMicm(config_path, &error);
  TUVX* tuvx = CreateTuvx(config_path, &error);
  
  size_t n_micm_rxns;
  Mapping* micm_rxns = GetUserDefinedReactionRatesOrdering(micm, &n_micm_rxns, &error);
  double custom_rate_constants = new double[n_micm_rxns];
  
  size_t n_tuvx_rxns;
  Mapping* tuvx_rxns = GetPhotolysisReactionLabels(tuvx, &n_tuvx_rxns, &error);
  double tuvx_photo_rates = new double[n_tuvx_rxns];
  
  IndexMapping* tuvx_to_micm = CreateIndexMap(map_config_path, tuvx_rxns, n_tuvx_rxns, micm_rxns, n_micm_rxns);
  
  TuvxCalculate(tuvx, tuvx_photo_rates);
  ApplyIndexMap(tuvx_to_micm, tuvx_photo_rates, custom_rate_constants);
  MicmSolve(micm, ..., custom_rate_constants, ...);