# Data used in AQA on a Unified Grid.

All the data in the US/CAN AQA was from multipled modeling projects. The projects
include modeling for the Revised CSAPR Update (RCU), the Regional Haze Rule (RHR)
and the Policy Assessment (PA). The RCU and RHR used the CAMx model and the PA
used CMAQ. Each used a different subset of photochemical modeling projected grids.
The projected grids include:

* 12US2    : 12km Lambert Conic Conformal covering the continental US (RCU, RHR, PA)
* 36US3    : 36km Lambert Conic Conformal covering most of North America (RHR, PA)
* 108NHEMI2: 108km Polar Stereographic covering the northern hemisphere (PA)

All of this data has been sampled on a common 2.5 minute domain that allows for
comparison with the Gridded World Population version 4 (GPWv4).

## Annotated Directory Structure

Each file in this directory is listed below and followed by a description.
The file name itelf is descriptive. The file name includes simulation
attributes:

* model: CMAQ or CAMx,
* simulation year: 2016, 2023, or 2028
* emission iteration: fe, ff, fg, fh1
* the target species or technology
    * o3 or O3: ozone
    * pm or PM: fine particulate matter
    * apca: ozone source apportionment technology with anthropogenic culpability
    * psat: partical source apportionmetn technology
    * depn: deposition of nitrogen
    * depredn: deposition of reduced nitrogen
    * depoxn: deposition of oxidized nitrogen
    * deps: deposition of sulfur
* temporal resolution: aggregated daily or monthly analysis

The project can be diagnosed from these descriptors:

* RCU: CAMx with apca and 2016fh1, 2023fh1, and 2028fh1
* RHR: CAMx with psat and 2016fg and 2028fg
* PA:  CMAQ with 2016fe

Each file name is also followed by a textual description of the file contents.

```
.
|-- README.md
|   # This file
|-- CAMx_2016fh1_ussa_apca_16j.tagged.camx.O3_8hrmax_LST.5-9.mean_2pt5_min.nc
|   # RCU16 daily MDA8 ozone and contributions
|   # Variables (all ozone MDA8 ppb):
|   #   O38HRMX: Base total prediction
|   #   BIOG: In-domain biogenic contribution
|   #   OFFSHORE: In-domain shipping contribution
|   #   CNMX_ANTH: In-domain Canada anthropogenic contribution
|   #   USA_ANTH: USA anthropogenic contribution
|-- CAMx_2023fh1_ussa_apca_16j.tagged.camx.O3_8hrmax_LST.5-9.mean_2pt5_min.nc
|   # RCU23 daily MDA8 ozone and contributions
|   # Variables: same as RCU16
|-- CAMx_2028fh1_ussa_apca_16j.tagged.camx.O3_8hrmax_LST.5-9.mean_2pt5_min.nc
|   # RCU28 daily MDA8 ozone and contributions
|   # Variables: same as RCU16
|-- monthlyavg.LST.Y_24.2016fg_camx7b3_dms_psat_all_16j_allmrgu_tagged_2pt5_min.nc
|   # RHR16 monthly pm and tags
|   # Variables:
|   #   PM25_TOT: Total PM25 concentration (micrograms/m3)
|-- monthlyavg.LST.Y_24.2028fg_camx7b3_dms_psat_all_16j_allmrgu_tagged_2pt5_min.nc
|   # RHR28 monthly pm and tags
|   # Variables (all micrograms/m3):
|   #   PM25_bulk: total prediction
|   #   USA_ANTH: USA anthropogenic contributions
|   #   CN_ANTH: In-domain Canada anthropogenic contribution
|   #   MX_ANTH: In-domain Mexico anthropogenic contribution
|   #   ROW_ANTH: Out of domain international anthropogenic contribution
|   #   NATURAL: Natural contribution
|-- CMAQv5.2.1_2016fe_cb6r3_ae6nvpoa_16j_base_and_contributions_no_mask_depnmonthly_2pt5_min.nc
|   # PA16 total Nitrogen (N) deposition and tags
|   # Variables:
|   #   TD_N_TOT: total nitrogen deposition
|   #   TD_N_NAT_LI: natural contribution by zero out of all anthropogenic
|   #   TD_N_CANMEX_ZO: Canada and Mexico contribution by zero out
|   #   TD_N_USA_ZO: USA contribution by zero out
|-- CMAQv5.2.1_2016fe_cb6r3_ae6nvpoa_16j_base_and_contributions_no_mask_depoxnmonthly_2pt5_min.nc
|   # PA16 oxidized Nitrogen (N) deposition and tags
|   # Variables:
|   #   TD_OXN_TOT: oxidized nitrogen deposition
|   #   TD_OXN_NAT_LI: natural contribution by zero out of all anthropogenic
|   #   TD_OXN_CANMEX_ZO: Canada and Mexico contribution by zero out
|   #   TD_OXN_USA_ZO: USA contribution by zero out
|-- CMAQv5.2.1_2016fe_cb6r3_ae6nvpoa_16j_base_and_contributions_no_mask_deprednmonthly_2pt5_min.nc
|   # PA16 reduced Nitrogen (N) deposition and tags
|   # Variables:
|   #   TD_REDN_TOT: oxidized nitrogen deposition
|   #   TD_REDN_NAT_LI: natural contribution by zero out of all anthropogenic
|   #   TD_REDN_CANMEX_ZO: Canada and Mexico contribution by zero out
|   #   TD_REDN_USA_ZO: USA contribution by zero out
|-- CMAQv5.2.1_2016fe_cb6r3_ae6nvpoa_16j_base_and_contributions_no_mask_depsmonthly_2pt5_min.nc
|   # PA16 Sulfur (S) deposition and tags
|   # Variables:
|   #   TD_S_TOT: total sulfur deposition
|   #   TD_S_NAT_LI: natural contribution by zero out of all anthropogenic
|   #   TD_S_CANMEX_ZO: Canada and Mexico contribution by zero out
|   #   TD_S_USA_ZO: USA contribution by zero out
|-- CMAQv5.2.1_2016fe_cb6r3_ae6nvpoa_16j_base_and_contributions_no_mask_o3daily_2pt5_min.nc
|   # PA16 daily MDA8 ozone and tags
|   # Variables:
|   #   O3_8HRMAX: daily total prediction in ppb
|   #   NATURAL: natural estimate by zero-out of all anthropogenic
|   #   USA_ZO: USA estimate by zero out of USA anthropogenic
|   #   ROW_ZO: Rest-of-World (i.e., not USA) estimate by zero out of ROW anthropogenic
|   #   CANMEX_ZO: Canada and Mexico estimate by zero out of CANMEX anthropogenic
|   #   CHN_ZO: China estimate by zero out of CHN anthropogenic
|   #   IND_ZO: India estimate by zero out of IND anthropogenic
|   #   FIRE_ZO: Fire estimate by zero out of FIRE anthropogenic
|   #   SHIP_ZO: Ocean shipping estimate by zero out of SHIP anthropogenic
|   #   MIX: Nonlinear attribution (O3_8HRMAX - NATURAL + USA_ZO + ROW_ZO)
|-- CMAQv5.2.1_2016fe_cb6r3_ae6nvpoa_16j_base_and_contributions_no_mask_pmmonthly_2pt5_min.nc
|   # PA16 monthly PM and tags
|   # Variables: Same as PA16 for ozone, but for each PM species in micrograms/m3
|   # Species:
|   #   ATOTIJ: Total fine modes (I: aitken; J: accumulation)
|   #   ANO3IJ: nitrate
|   #   ASO4IJ: Sulfate
|   #   AOMIJ: Total Organic Matter
|   #   APOMIJ: Primary Organic Matter
|   #   AORGAJ: Components of secondary organic matter
|   #   AORGBJ: Components of secondary organic matter
|   #   AORGCJ: Components of secondary organic matter
|-- CAMx_2016ff2_apca.O3NV.CATEGORIES.contrib8hrmax_LST.yr.ioapi.5-9.mean_2pt5_min.nc
|   # Not used in report
|-- CAMx_v65_2016mean.12US2.35.2016ff2_secsa_psat_16j.epa.camx.sa.grd01.cat.2pt5_min.nc
|   # Not used in the report
|
|# below this line is additional data that might be useful
|
|-- Baseline_Incidence.nc
|   # Gridded baseline incidence from Global Burden of Disease health tool.
|-- gpw_natid_masks_with_zones.nc
|   # Nations and zones identified on the GWP grid
|-- gpw_v4_une_atotpopbt_2pt5_min.nc
|   # Populations on the GWP grid
|-- ne_10m_admin_1_states_provinces_distance_to_US_States_2pt5_min.nc
|   # NaturalEarth ADMIN_1 state and province codes on GPW grid from 10e6:1 shapefile.
`-- ne_50m_admin_1_states_provinces.US_PEMA.2pt5_min.nc
    # NaturalEarth ADMIN_1 state and province codes on GPW grid from 50e6:1 shapefile.
```