Input directories, which contain SMOKE input files, are one of the subdirectory types that make up the $SMKDAT
directory shown in Figure 3.1, “Basic SMOKE directories: the first three levels of the directory structure” as
. In this section, we provide the structure of these input directories.
$SMK_HOME
/data
Figure 3.3, “SMOKE input files directory structure” shows all of the input directories that stem from $SMKDAT
. In the diagram, note how some paths depend on environment variables set in the Assigns file. For example, the INVID
environment variable listed in Section 3.2.1, “Example Assigns file” is defined by the user (as we will describe in Chapter 4, Using SMOKE Scripts) to label the inventory name. This variable is used to build the name of the INVDIR
directory as follows:
INVDIR
= $SMKDAT
/inventory/$INVID
So, if a user decided to label the inventory “nei99”, then the Assigns file would have INVID
= nei99 and the INVDIR
directory would be
. Another example of this in the figure is the $SMKDAT
/inventory/nei99SMK_M6PATH
directory. The full path depends upon the setting of the MSCEN
variable; if MSCEN
is set to “case1”, then SMK_M6PATH
would be
.
$SMKDAT
/run_case1/static/m6
In some cases, we do not have environment variables associated with a directory name. One example is the
directory. In these cases, we did not assign variables simply because they were not very useful and we have to limit the
number of SMOKE environment variables. Most operating systems have a limit on the number of environment variables (usually
256), so when the variables were not really useful we did not assign them. If desired, you can add environment variables to
the Assigns file and/or the $SMKDAT
/inventoryset_dirs.scr
helper script.
In the list below, we describe the purpose of each of these directories, along with the file names and in some cases file descriptions for those files that you may need to change. You can refer to Chapter 8, SMOKE Input Files for more information about each of these files (look under the logical file names). Chapter 4, Using SMOKE Scripts provides step-by-step instructions on how to create and install each of the files listed.
ge_dat
: This directory contains the cross-reference files, profile files, spatial surrogates, and other files that are likely to
be shared among multiple cases of processing inventories with SMOKE. The logical file names for files included in this directory
are listed here; many physical files could be available in the ge_dat
directory for each file type. For example, you may have dozens of surrogate files for different modeling grids and several
speciation profiles for different model-mechanism combinations. More detailed descriptions of these files are in Chapter 8, SMOKE Input Files; descriptions of the example files provide with SMOKE are in Section 3.4, “Test case data files”.
BGPRO
: The spatial surrogates file biogenics (for using county-total land use in Rawbio and/or computing county-total emissions with Smkmerge).
SRGPRO_PATH
: The location of the spatial surrogates file for nonpoint (stationary area)/nonroad and on-road mobile sources.
AGREF
, MGREF
: The spatial cross-reference files for nonpoint (stationary area)/nonroad and on-road mobile sources. These two logical file
names can all reference the same physical file.
ATPRO
, MTPRO
, PTPRO
: The temporal profiles files for nonpoint (stationary area)/nonroad, on-road mobile, and point sources. These three logical
file names can all reference the same physical file.
ATREF
, MTREF
, PTREF
: The temporal cross-reference files for nonpoint (stationary area)/nonroad, on-road mobile, and point sources. These three
logical file names can all reference the same physical file.
B3FAC
: The BEIS3 normalized emission factors.
B3XRF
: The BELD3-to-BELD2 land use cross-reference.
BCUSE
: The BEIS2 county-total land use for all U.S. counties.
BFAC
, S_BFAC
, W_BFAC
: The default, summer, and winter BEIS2 normalized emission factors.
BIOSEASON
: I/O API file indicating which grid cells in a domain are winter and which are summer for biogenics modeling purposes, for
each day of the year or episode.
COSTCY
: The country, state, and county information file.
GRIDDESC
: The grid definitions file.
SRGDESC
: The surrogate definitions/description file.
GSREF
, GSPRO
, GSCNV
: The chemical speciation cross-reference file, speciation profiles file, and pollutant-to-pollutant conversion file (e.g.,
VOC-to-TOG factors), respectively.
HOLIDAYS
: The dates that SMOKE should process as holidays and the day of the week to use for each date instead of its actual day of
the week (the substitute is usually a Saturday or Sunday).
PROCDATES
: The sequential/non-sequential user-specified dates that SMOKE should process.
PSTK
: The point-source replacement stack parameters.
SCCDESC
, SRGDESC
, ORISDESC
, SICDESC
, MACTDESC
, NAICSDESC
: The descriptions of each known SCC, surrogate code, ORIS ID, SIC code, MACT code, and NAICS code.
VNAMMAP
: The name-mapping file for transforming the I/O API file model-species names to the names used by the model (e.g., renaming
CD for REMSAD to CD-1).
inventory
: The location of all inventory files for each inventory case (as defined by the $INVID
environment variable in an Assigns file), land use data, and other data.
: This directory name depends on the name given to the inventory in the Assigns file. (This is the case for any directory
name in the figure that is preceded with “$” to indicate that it is an environment variable.) The files in the subdirectories are specific to your inventory files and
modeling case. This directory contains subdirectories for each of the major source categories by default:
$INVID
area
: Contains the nonpoint or stationary area inventories. Optionally, it may contain nonroad mobile inventories. Can include
any inventory that will be processed as a SMOKE area source (e.g. criteria, particulates, and/or toxics inventories). Files should
include:
ARINV
(raw area-source inventory file). If this is a list file, the files listed within it should also be included in this directory.
GCNTL
(control packet file). The growth and control packet files for each growth or control scenario. The default naming scheme
for these files is described in the default SMOKE scripts.
biog
: Contains the gridded BELD3 land use data. These files are listed in the Assigns files as BELD3_A
, BELD3_B
, and BELD3_TOT
. This directory could optionally contain the gridded BELD2 land use data (if processing using BEIS2); this file is listed
in the Assigns file as BGUSE
.
nonroad
: Optional directory for the nonroad mobile inventory, if it is not included with the other SMOKE area sources in the area
directory. Files should include:
GCNTL
(control packet file). The growth and control packet files for each growth or control scenario. The default naming scheme
for these files is described in the default SMOKE scripts.
NRINV
(raw nonroad-mobile-source inventory file). If this is a list file, the files listed within it should also be included in
this directory.
mobile
: Contains the on-road mobile inventory and other on-road mobile-specific input files. Files should include:
GCNTL
(control packet file). The growth and control packet files for each growth or control scenario. The default naming scheme
for these files is described in the default SMOKE scripts.
M6LIST
(MOBILE6 input files list). With the default SMOKE scripts, this file is generated automatically based on the MCREF
file and the files listed in the m6_
subdirectory of this directory. Contains a list of the MOBILE6 inputs files for each reference county.
$EF_YEAR
M6MAP
: (vehicle mapping file). For MOBILE6 modeling only, contains information on how to map the 28 MOBILE6 vehicle types to the
vehicle types used in the mobile inventory.
MBINV
(raw on-road mobile-source inventory file). If this is a list file, the files listed within it should also be included in
this directory.
MCODES
(mobile-source codes file). Contains list of valid on-road SCCs, vehicle types, and road class codes.
MCREF
(mobile-source county cross-reference). For MOBILE6 modeling only, contains the reference county assignments (see Section 2.8.4.7, “Reference counties” for an explanation of reference counties).
MEPROC
(mobile-source processing file). For MOBILE6 modeling only, contains the pollutants to be modeled by MOBILE6 and the emission
processes (e.g., exhaust running) associated with each.
METLIST
(meteorology input files list). With the default SMOKE scripts, this file is generated automatically based on the meteorology
files in the $METDAT
directory.
MVREF
(mobile-source county settings). For MOBILE6 modeling only, contains the reference county and its temporal averaging, spatial
averaging, and local-road approach settings.
SPDPRO
(speed profiles file). For MOBILE6 modeling only, contains the optional hour-specific speed profiles.
SPDREF
(speed profiles cross-reference file). For MOBILE6 modeling only with optional hour-specific speed profiles, contains the
cross-reference assignments for the speed profiles in the SPDPRO
file to the inventory sources.
VMTMIX
(VMT mix file). For EMS-95 input only, contains the VMT mix (fractions used to disaggregate VMT by vehicle type).
mobile/m6_
: This subdirectory is used only when MOBILE6 will be used with SMOKE, and must contain the MOBILE6 input scenario files in
standard MOBILE6 input format for each of the reference counties in the domain. The $EF_YEAR
$EF_YEAR
variable is set by the $YEAR
variable in the Assigns file for base-case runs or by the $FYEAR
variable from the run script for future-year runs (see Section 3.2.4.3, “Configuration for growth and/or control case” for more information on the FYEAR
setting).
point
: Contains the point-source inventory and other point-specific input files. Files should include:
CEMSUM
(CEM summary file). When processing CEM data, this file contains a summary of a year’s worth of CEM data and is produced
by CEMScan.
GCNTL
(control packet file). The growth and control packet files for each growth or control scenario. The default naming scheme
for these files is described in the default SMOKE scripts.
PELVCONFIG
(elevated-source selection configuration file). When using the Elevpoint program to select elevated and PinG sources, this file is required to specify the selection criteria.
PTDAY
(raw day-specific point-source inventory file). If this optional file is a list file, which is typically the case, the files
listed within it should also be included in this directory.
PTHOUR
(raw hour-specific point-source inventory file). If this optional file is a list file, which is typically the case, the files
listed within it should also be included in this directory.
PTINV
(raw point-source inventory file). If this is a list file (required for EMS-95 inputs), the files listed within it should
also be included in this directory.
other
: Contains files that are associated with the various inventories, but which may be shared by more than one source category.
These files are:
ARTOPNT
(area-to-point file). Contains the area-to-point assignments by SCC with the point locations for each county in which a SMOKE
area source will be assigned to point locations.
INVTABLE
(inventory table file). Contains a list of the valid inventory pollutants and whether or not emissions associated with each
pollutant should be kept when reading the inventory files, among other purposes.
NHAPEXCLUDE
(non-HAP exclusions file). Contains the SCCs that will be excluded from a NONHAPVOC or NONHAPTOG calculation when integrating
toxics and criteria inventories.
REPCONFIG
(report configuration file). Contains instructions used by Smkreport to configure reports. The SMOKE installation includes only the REPCONFIG
files for the default reports included with the SMOKE default scripts.
met/run_
: This directory contains the meteorology files that are needed for running (1) biogenic emissions; (2) on-road mobile sources
with MOBILE6 using gridded, hourly meteorology data; or (3) point sources for the CMAQ or MAQSIP models. Meteorology data
are required in all of these cases. SMOKE can use output files from CMAQ’s MCIP and MCIP2 meteorology processors or from the
Meteorology Coupler (MCPL) processor. SMOKE automatically checks for the different variable names that may be used for the
same meteorology data in the different file formats. See Section 8.8, “Meteorology Files” for more information about the meteorology data needed by SMOKE.
$METSCEN
run_
: For MOBILE6 modeling only, this directory must contain the ancillary MOBILE6 inputs needed for running MOBILE6. Section 4.5.12, “Use MOBILE6 for on-road mobile sources” contains a description of the files that are required and their dependencies on MOBILE6 commands. Some files are needed only
when certain MOBILE6 input commands are used.
$MSCEN
/static/m6