README for data files accompanying Hancock et al. (2023)

This file is organized by directory names. Each directory contains
the code associated with a given figure in the manuscript.

==================================================================
fig_1

AOD_chennai.nc, AOD_kolkata.nc, AOD_mumbai.nc, AOD_new_delhi.nc
These files contain aqua and terra 2013-2015 average seasonal 
cycles of AOD from aqua and terra satellites, as well as 
CESM2-WACCM6. Each file contains:
Variable 1, "CESM2-WACCM6" (ensemble member, month) = monthly 550 nm
AOD from the model
Variable 2, "Terra" (month, year) = monthly 550 nm AOD from Terra 
for 2013-2015
Variable 3, "Aqua" (month, year) = monthly 550 nm AOD from Aqua 
for 2013-2015

2003_2014_AOD_map_aqua.nc, 2003_2014_AOD_map_terra.nc 
These files contain average AOD from 2003 to 2014 across India. 
Downloaded from NASA Giovanni:
(https://giovanni.gsfc.nasa.gov/giovanni/).

chennai_PM_obs_seasonal_cycle.nc, kolkata_PM_obs_seasonal_cycle.nc,
mumbai_PM_obs_seasonal_cycle.nc, new_delhi_PM_obs_seasonal_cycle.nc
These files contain seasonal cycles of:
Variable 1, 'PM25_SRF' (ensemble member, month) = modeled surface 
PM2.5 from the model diagnostic in μg/m3, 2012-2014 average
Variable 2, 'COMP_SUM' (ensemble member, month) = modeled PM2.5 
component sum in μg/m3, 2012-2014 average
Variable 3, 'OBS' (year, month) = surface PM2.5 observations from 
the U.S. Embassy and Consulates in each city, available from 
2013-2015.

==================================================================
fig_2

Annual_PM25_CPCB_2012-2017.txt contains measurements of PM2.5 from
India's CPCB, averaged from 2012 to 2017. 
Column 1 = city name
Column 2 = PM2.5 concentration (μg/m3)

ChemicalSpecies_literature_AS.xlsx contains measurements of PM2.5
and its components in different cities obtained from a literature
review.
Column 1, ‘lat’ = city latitude
Column 2, ‘lon’ = city longitude
Column 3, ‘BC’ = black carbon concentration (μg/m3)
Column 4, ‘OC’ = organic carbon concentration (μg/m3)
Column 5, ‘SO4’ = SO4 concentration (μg/m3)
Column 6, ‘NH4' = NH4 concentration (μg/m3)
Column 7, ‘NO3’ = NO3 concentration (μg/m3)
Column 8, ‘PM2.5’ = PM2.5 concentration (μg/m3)
Column 9, ‘Reference’ = Paper from which measurement was obtained

==================================================================
fig_3

primary_emissions.nc, secondary_emissions.nc
These files contain average annual primary and secondary emissions
for every grid cell globally from 1950 to 2014. Both files have 
only one variable, "map", which is of dimension (year, lat, lon).

==================================================================
fig_4

map_data.nc
This file contains model data from 1950 to 2014 for every grid 
cell over India averaged from 1950 to 2014 for surface PM2.5, 
inversion strength, boundary layer height, relative humidity, and 
average surface wind speed. All variables are of dimension 
(year, ensemble member, lat, lon). 
Variable 1: 'RHREFHT' = reference height relative humidity (fraction)
Variable 2: 'PM' = surface PM2.5 concentration (μg/m3)
Variable 3: 'PBLH' = planetary boundary layer height (m)
Variable 4: 'WSPDSRFAV' = average surface wind speed (m/s)
Variable 5: 'INV' = temperature inversion strength (m)

==================================================================
fig_5

Contains only a text file directing the user to use map_data.nc
found in the fig_4 directory to get the data used in fig_5.

==================================================================
fig_6

bc.nc, dst.nc, ncl.nc, pom.nc, soa.nc
Each file contains annual averages of each component listed in the
file name bc (black carbon), dst (dust), ncl (sea salt), 
pom (particulate organic matter), so4 (SO4), and soa (secondary 
organic aerosol. Each variable (mumbai, new_delhi, chennai, kolkata)
contains the concentrations in each city in μg/m3 for each year and 
ensemble member.

PM_ann_avg.nc contains annual average PM2.5 concentrations in 
Chennai, Kolkata, Mumbai, and New Delhi where each variable is the 
concentrations for each city and has dimensions (ensemble member, 
year). 

==================================================================
fig_7

PM_seasonal_cycle_Chennai.nc, PM_seasonal_cycle_Kolkata.nc, 
PM_seasonal_cycle_Mumbai.nc, PM_seasonal_cycle_New Delhi.nc
These files contain seasonal cycles for surface PM2.5 in each city
as indicated by the filename. 

Each file has only one variable, PM, which has dimensions
(ensemble member, decade, month) to store the city's
seasonal cycle of PM2.5 concentration in μg/m3 for each ensemble 
in each decade of the model simulation. 

==================================================================
fig_8

INV_seasonal_cycle.nc, PBLH_seasonal_cycle.nc, 
PRECT_seasonal_cycle.nc, RHREFHT_seasonal_cycle.nc, 
WSPDSRFAV_seasonal_cycle.nc
These files contain seasonal cycles for each meteorological 
variable as indicated by the filename. 
'RHREFHT' = reference height relative humidity (fraction)
'PM' = surface PM2.5 concentration (μg/m3)
'PRECT' = precipitation (mm/day)
'WSPDSRFAV' = average surface wind speed (m/s)
'INV' = temperature inversion strength (m)

Each file has four variables labeled by city name. Each variable
has dimensions (ensemble member, decade, month) to store the 
seasonal cycle for each ensemble in each decade of the model 
simulation. 

==================================================================
supplement

====== fig_s1

Chennai.nc, Kolkata.nc, Mumbai.nc, New_Delhi.nc
These files contain seasonal cycles of components included in the 
modeledPM2.5 component sum averaged from 2012-2014 in Chennai, 
Kolkata, Mumbai, and New Delhi. Variables include bc (black carbon), 
dst (dust), ncl (sea salt), pom (particulate organic matter), and 
so4 (SO4). All concentrations are in μg/m3.

====== fig_s2

GPCP_india.nc contains monthly data from the Global Precipitation 
Climatology Project over India. Downloaded from:
https://www.ncei.noaa.gov/data/global-precipitation-climatology-project-gpcp-monthly

PRECT_monthly_CESM2WACCM6 contains monthly precipitation data from
the model for each grid cell over India. There is only one variable,
"PRECT", which has dimensions (year, ensemble member, month, lat, lon)

====== fig_s3

BC_Average_Emissions_1950-2014.nc, POM_Average_Emissions_1950-2014.nc,
SO4_Average_Emissions_1950-2014.nc, SO$_{2}$_(Secondary)_Emissions_Map.nc
These files contain emissions data for each component listed in the file
name for every grid cell globally. Each file has only one variable, "map",
which has dimensions of (latitude, longitude).

BC_Emissions(1950-1959_to_2005-2014).nc, 
POM_Emissions(1950-1959_to_2005-2014).nc,
SO4_Emissions_(1950-1959_to_2005-2014).nc,
These files are the same as the above but instead contain data for the 
difference in emissions between the first and last decade of the model
simulation (2005-2014 average - 1950-1959 average).

Other emissions data can be found in the fig_3 folder.

====== fig_s4

Each file contains a time series of annual average emissions of the 
constituent (BC, POM, SO4, and SO2) and city (Chennai, Kolkata, 
Mumbai, and New Delhi) in the filename from 1950 to 2014. In CESM2,
SO4 is carried as NH4HSO4, and POM and BC are both carried as carbon.

====== fig_s5

Contains only a text file directing the user to use map_data.nc
found in the fig_4 directory to get the data used in fig_s5.
