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 $EDSS_ROOT/data. In this section, we provide the structure of these input directories.
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 $SMKDAT/inventory/nei99. Another example of this in the figure is the SMK_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 $SMKDAT/inventory 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 set_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. You will be able to use the default files provided with SMOKE for many of these files. The file that is most likely to require changes is the spatial surrogates file, to customize it for the grid you wish to model. 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.
-
AGPRO, BGPRO, MGPRO: The spatial surrogates file for nonpoint (stationary area)/nonroad, biogenics (for using county-total land use in Rawbio and/or computing county-total emissions with Smkmerge), and on-road mobile sources. These three logical file names can all reference the same physical file.
-
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.
-
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).
-
PSTK: The point-source replacement stack parameters.
-
SCCDESC, SRGDESC, ORISDESC, SICDESC: The descriptions of each known SCC, surrogate code, ORIS ID, and SIC 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.
-
beld2 ($BBASE): Contains the gridded BELD2 land use data for as many grids as are available and necessary. These files are listed in the Assigns files as BGUSE.
-
beld3 ($BBASE): Contains the gridded BELD3 land use data for as many grids as are available and necessary. These files are listed in the Assigns files as BELD3_A, BELD3_B, and BELD3_TOT.
-
$INVID: 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 here are the most likely files for you to change, because these files need to be changed to be specific to your inventory files and modeling case. This directory contains subdirectories for each of the major source categories by default:
-
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.
-
-
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_$EF_YEAR subdirectory of this directory. Contains a list of the MOBILE6 inputs files for each reference county.
-
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_$EF_YEAR: 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 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:
-
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_$METSCEN: 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.
-
run_$MSCEN/static/m6: 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.