Chapter 6. SMOKE Core Programs

6.1. Overview
6.2. Cntlmat
6.3. Elevpoint
6.4. Emisfac
6.5. Grdmat
6.6. Grwinven
6.7. Laypoint
6.8. Mbsetup
6.9. Mrggrid
6.10. Normbeis3
6.11. Premobl
6.12. Rawbio
6.13. Smkinven
6.14. Smkmerge
6.15. Spcmat
6.16. Temporal
6.17. Tmpbeis3
6.18. Tmpbio

6.1. Overview

Figure 6.1, “SMOKE core programs” shows the SMOKE core programs and how they relate to each other. We define the core programs as those needed for the actual emissions processing; we exclude QA and utility programs such as Smkreport (these programs are discussed in Chapter 7, SMOKE Quality Assurance and Chapter 5, SMOKE Utility Programs). The lines between the boxes represent one or more files passing between the programs, and show the dependencies among the programs. Note that we have omitted some redundant file dependencies to make the diagram easier to understand (for example, Premobl depends on the output from Grdmat; however, since Premobl also depends on the output from Mbsetup which in turn depends on Grdmat, the relationship between Grdmat and Premobl is implied). Unless otherwise noted, the SMOKE core programs are applied for the anthropogenic source categories: area-, mobile-, and point-source processing (biogenic processing follows a separate path from the other source categories). When a program that applies to multiple source categories is used, it can be run for only one source category at a time, with the exception of Smkmerge and Mrggrid.

Figure 6.1. SMOKE core programs

SMOKE core programs

The Smkinven program, at left in Figure 6.1, “SMOKE core programs”, is responsible for importing the stationary area/non-point, nonroad, on-road mobile, and point source inventory emissions data. For mobile sources, Smkinven can also import activity data in the form of VMT and vehicle speed for use in generating emission factors. For point sources, Smkinven can also import day- and hour-specific data. The output from Smkinven is used as input to nearly every other core SMOKE program.

Also at left, the Rawbio program imports the county or gridded land use data and computes normalized (time-independent) biogenic emissions.

As an alternative to BEIS2 processing using Rawbio, SMOKE is capable of using the BEIS3 model. In this type of processing, Normbeis3 creates gridded, normalized biogenic emissions from land use and biogenic emissions factors.

Grdmat creates the gridding matrix for the anthropogenic source categories. Also, for mobile sources the Grdmat program creates an ungridding matrix used by Mbsetup, Premobl, and Emisfac when emission factors are being generated.

Mbsetup groups mobile sources by road type, speed, and county in preparation for running Premobl and Emisfac.

If meteorology data are input for mobile-source processing, Premobl processes these data, creating hourly temperature and relative humidity profiles by county that are used by Emisfac to compute mobile-source emission factors.

Emisfac computes emission factors for a variety of emission processes; these factors are needed when VMT data are used as input for mobile sources. Mbsetup, Premobl, and Emisfac are skipped if only emissions data are imported for mobile sources.

The Temporal program is used to create an hourly emissions file for the anthropogenic source categories. It can read in day-specific and hour-specific data, and merge this with estimated daily and hourly data created from the annual emissions data using temporal profiles. For mobile sources, Temporal can compute hourly emissions using the daily VMT, temporal factors (monthly, day-of-week, and hourly), and the emission factors from Emisfac. If VMT are not used, then the emissions from Smkinven are combined with the temporal factors, and the emission factors are not used at all.

Elevpoint preprocesses the selected PinG and major point sources. Elevpoint is not used when no PinG or major point sources need to be defined. In this case, SMOKE can create elevated emissions for all point sources, so there is no need to specifically indicate the major point sources.

Laypoint computes the plume rise for all point sources based on the meteorology data.

Spcmat creates the speciation matrices (both mass and molar) for the anthropogenic source categories. It uses the user-selected chemical mechanism.

Cntlmat creates the growth matrices, multiplicative control matrices, and reactivity control matrices for the anthropogenic source categories. This program is not used for base-year emissions without controls.

Grwinven is used to grow the emissions to past or future years using the growth matrix created by Cntlmat and the imported inventory data from Smkinven. It writes both SMOKE inventory format (I/O API NetCDF) and IDA format. The output from Grwinven is used in place of the original output from Smkinven when processing past or future years.

Tmpbio applies meteorology adjustments to the gridded, normalized biogenic emissions from Rawbio. It also applies the speciation factors needed for the user-selected chemical mechanism to create gridded, hourly, model-species biogenic emission files for use in Smkmerge or Mrggrid. The Rawbio and Tmpbio programs taken together are the equivalent of SMOKE-BEIS2.

Tmpbeis3 applies meteorology adjustments to the normalized emissions created by Normbeis3. Tmpbeis3 also applies the speciation profiles needed for the user-selected chemical mechanism to create gridded, hourly, model-species biogenic emissions data for use in Smkmerge and Mrggrid. The Normbeis3 and Tmpbeis3 programs taken together are the equivalent of SMOKE-BEIS3.

Smkmerge is used to combine all emissions and matrices to create the gridded, hourly, model-species emissions needed for an AQM. It can merge for one source category at a time or all source categories at once, and it can read in the model-ready biogenic emissions to merge with the anthropogenic source categories. It can merge the matrices with the inventory data output from Smkinven or the hourly emissions from Temporal, and it can optionally merge the speciation, gridding, or control matrices, or any combination. It also writes state and county emissions totals.

Mrggrid is used to combine gridded emission data files, which can be speciated or non-speciated, and hourly or time-independent. It can combine a 3-D point source file with any number of 2-D files from other source categories. This program is optional and provides a convenient way to merge model-ready output files outside of Smkmerge.

In the remaining sections of this chapter, we provide detailed program descriptions, in alphabetic order.