CMAQ Release Notes: PYTOOLS

shp2cmaq: Create CMAQ-Ready File from Shapefile

Barron Henderson, U.S. Environmental Protection Agency
Type of update: New Pre-Processing Tool
Release Version/Date: CMAQv5.5

Description: This Python Notebook converts GIS shapefiles into gridded netCDF mask files that represent spatial features such as political boundaries. This tool works on both CONUS and Northern Hemisphere domains and has the capability to represent quantitative variables such as population. The CMAQ-ready mask files can be used for defining regions and region families with DESID and using geographic source regions when running CMAQ-ISAM. The mask files can also be used to spatially subset CMAQ input and output files for analysis, for example calculating emissions totals by state or averaging modeled ambient concentrations over census tracts. The code relies on geopandas and cmaqsatproc to perform spatial operations and create IOAPI-like files for CMAQ. The overall process requires a shapefile with attributes and a GRIDDESC file. It produces variables that specify grid cell fractional coverage by each unique value of a specified attribute. It also produces total and dominant attribute variables. The total specifies the fraction coverage of any attribute. The dominant variable specifies which attribute has the largest area coverage.

Example of a gridded mask file for state boundaries in the contiguous US.

Significance and Impact: No impact on core model results. The significance of this tool is to provide a simple shapefile processor to use the DESID masking feature. Spatial mask files can also be used for ISAM simulations or as part of post-processing model output.

References:
DESID Tutorial
ISAM Tutorial

Merge Commit	Internal record
Merge for PR#904	PR#904

DMSCHLO: Augment the Standard Ocean File for Marine Chemistry

Barron Henderson, U.S. Environmental Protection Agency
Type of update: New Pre-Processing Tool
Release Version/Date: CMAQv5.4

Description: Depending on the chemical mechanism selected, the traditional "Ocean" file maybe required to contain temporal ocean dimethyl sulfide (DMS) and chlorophyll-a (CHLO) concentrations for atmospheric DMS and halogen chemistry, respectively. To create these fields for input, a new Python tool called "DMSCHLO" is released to augment standard CMAQ "Ocean" files with this data.

Significance and Impact: No impact on core model results. The significance of this tool is to provide an easy to use tool in which to augment the standard "Ocean" file for use with CCTM. See the Ocean File Tutorial for further information.

Merge Commit	Internal record
Merge for PR#903	PR#903