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). For mobile sources, the mobile codes file (MCODES) is also needed.
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 |
MCODES (optional)
|
ASCII | Mobile codes for converting inventory road classes and vehicle type names to SMOKE’s road types and vehicle type numbers |
-
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” -
USE_MCODES_SCC_YN: [defual:Y]Define whether or not the program use
MCODESinput file to build internal SCC based on vehicle type and road type numbers. See detail information in Section 8.9.2.1.2, “MCODES: Mobile source codes file”-
Y: Construct internal SCC using vehicle type and road type numbers
-
N: Do not construct internal SCC
-
| 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 |