Figure 6.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 |
-
FULLSCC_ONLY: See description in Section 6.2.3.2, “Input Environment Variables”. In this context, this option prevents left-7 SCC assignments using the gridding cross-reference file. -
IOAPI_ISPH: See description in Section 6.3.3.2, “Input Environment Variables” -
REPORT_DEFAULTS: See description in Section 6.2.3.2, “Input Environment Variables” -
SRGPRO_PATH: Defines the location of the Area and Mobile spatial surrogate files. This should be a sub-directory in the$GE_DATdirectory. -
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 county/state/country (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 county/state/countries. See description in Section 8.4.1, “SRGDESC: Surrogate Designation, Description and Surrogate profile filename.”. -
SMK_SOURCE: See description in Section 6.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 |