Repository contains data and code for analyzing emissions, traffic, traffic-related pollution, and demographics near warehousing in the contiguous United States. 

Note there are some ancillary datasets not included in this repository that are needed to run the scripts. These datasets generally support plotting maps for the figures included in the paper and are publicly available elsewhere. As examples, the state shapefiles for Figure 1 are available at https://www.census.gov/cgi-bin/geo/shapefiles/index.php, and the Chesapeake Bay shoreline shapefiles for Figure S14 are available at https://data-chesbay.opendata.arcgis.com/datasets/ChesBay::chesapeake-bay-shoreline-high-resolution/explore. 

Code
----
- warehouse.py: script represents the main workhorse that produces statistics, tables, and figures for Kerr et al. (2024). 

- regrid_dailytropomi.py: script transforms  daily TROPOMI NO2 retrievals to gridded fields (consistent with Dan's normal grid convention) for 2019-2022 and also sample TROPOMI NO2 fields at all warehouse locations, rotating these footprints by the direction of the prevailing wind such that downwind is to the right of resultant composites (i.e. towards the east). The current version uses a search radius of +/-10 grid cells (~10 km), only considers CoStar warehouses >20,000 square feet, and excludes warehouses in HI, AK, and Key West. 

- parse_fhwa.py: script allows for state-specific AADT (total, single unit, and combination) to be regridded to a 1 km x 1 km fishnet using ICCT gridded truck activity methodology.

- harmonize_costar.py: script joins near-warehouse NO2 from regrid_dailytropomi.py with demographic, traffic, and NEMO NOx emission data. 

Data
----
- census.zip: directory contains 2017-2021 demographic data at the census tract level from the American Community Survey 5-year estimates, harmonized for use with above code. 

- footprints_tropomino2_*_v1.nc: files contain the daily unrotated and rotated TROPOMI NO2 retrievals at each warehouse in the continental United States for each day in 2021. Here, the daily retrievals have been aggregated to monthly files. 

- costar_usa_gt20k_withtraffic_v2.1.csv: harmonized file containing near-warehouse traffic at various buffers, warehouse characteristics

- costar_usa_gt20k_withGEOID_v2_OLD.csv: harmonized file containing the GEOID of the census tract in which each warehouse is located and the demographics of the tracts from the 2017-2021 5-year estimates from the American Community Survey. 

- costar_usa_gt20k_withNEMO_v1.csv: harmonized file containing total and sector-specific NOx emissions from NEMO.