Figure 4.4, “Grdmat input and output files” shows the input and output files for the Grdmat program. The input files are the spatial surrogates file (AGPRO or MGPRO), the spatial cross-reference file (AGREF or MGREF), the inventory file output from Smkinven (AREA, MOBL, or PNTS), the surrogate description file (SRGDESC), and the grid description file (GRIDDESC).
Grdmat outputs a gridding matrix file (AGMAT, MGMAT, or PGMAT) used by other SMOKE programs, and a supplemental gridding file (AGSUP or MGSUP) that includes all of the spatial surrogate codes assigned to each source. Like all SMOKE programs, Grdmat writes a program log (LOGFILE).
| File Name | Format | Description |
|---|---|---|
SRGDESC |
ASCII | Surrogate list, description and surrogate file name used in the modeling grid. Note: we recommand to use multiple files for individual surrogate code which are available from the EPA’s New Surrogates web site. |
SRGPRO_PATH/surrogate-files |
ASCII | Gridding surrogate coefficients |
[A|M]GREF |
ASCII | Gridding surrogate cross-reference file |
[AREA|MOBL|PNTS] |
SMOKE map | Intermediate inventory file produced by Smkinven |
GRIDDESC |
ASCII | Description of the modeling grid |
GRIDMASK |
I/O API NetCDF | Geographic level code and Timezone for each grid cell |
GRID_CRO_2D |
I/O API NetCDF | Layer definitions for the CMAQ model domain |
-
FULLSCC_ONLY: See description in Section 4.2.3.2, “Input Environment Variables”. In this context, this option prevents left-7 SCC assignments using the gridding cross-reference file. -
IOAPI_GRIDNAME_1: output modeling grid that global gridded inventory data is re-gridded to. -
IOAPI_ISPH: See description in Section 4.3.3.2, “Input Environment Variables” -
IMPORT_GRDNETCDF_YN: Y to read the native netCDF annual inventory files -
REPORT_DEFAULTS: See description in Section 4.2.3.2, “Input Environment Variables” -
SRGPRO_PATH: Defines the location of the Area and Mobile spatial surrogate files. -
SMK_DEFAULT_SRGID: [default: 100 (Models-3 population surrogate code)] Mandatory, user MUST choose a fallback code. -
SMK_USE_FALLBACK: [Y/N]Defines the surrogate code number to use as a fallback surrogate when the surrogate number set by the cross-reference file would zero out the emissions for that source. This fallback surrogate is also used to define the country/state/county (FIPS) codes for use in Grdmat; therefore, a fallback surrogate code is mandatory even if the
SMK_USE_FALLBACKis set to [N]. This code should exist in theSRGDESCfile and be representative on all country/state/counties. See description in Section 6.4.1, “SRGDESC: Surrogate Designation, Description and Surrogate profile filename.”. -
SMK_SOURCE: See description in Section 4.2.3.2, “Input Environment Variables”
| File Name | Format | Description |
|---|---|---|
[A|M|P]GMAT |
I/O API NetCDF | Gridding matrix containing the factors needed to spatially allocate the input emissions to the grid cells in the modeling domain. |
[A|M]GSUP |
ASCII | Gridding supplemental file containing spatial surrogate codes for each source |
LOGFILE |
ASCII | Log generated from executing Grdmat |