A common difficulty for new users is determining where to put the input files for their case. In SMOKE v2.0 and later, we have reduced the number of places in which you need to keep your raw input files. Section 8.1.4, “Input files for SMOKE nctox case” lists the all of the input directories for the files used in the example “nctox” case. In that section, we also define the path names relative to the SMK_HOME directory, which is the directory in which you install SMOKE (and is different for every installation). In Chapter 3, SMOKE Directories and Example Data, we provide diagrams of the SMOKE directory structures, which help in visualizing the tree of directories that SMOKE uses. Additionally, Section 4.5, “How to use SMOKE” contains instructions for getting set up for new runs, including the files that need to be created and where they should go.

In summary, SMOKE input files must go into a handful of directories (see Section 8.1.4, “Input files for SMOKE nctox case”). Multiple directories are needed because in some cases (such as speciation profiles and meteorology data), the data are to be shared across multiple runs. In other cases (such as inventory data), the data are specific to a case and should be stored independently to prevent corrupting other modeling runs. To change the directories used for input (or any other) files in SMOKE, you must modify the Assigns file as described in Section 3.3, “How to change the default directory structure”.

In this section, we list all of the raw input files to SMOKE. The files are grouped into tables by functional type:

Within each table, the files are listed in alphabetical order. When a file is optional, this is noted in the description column of the table.

In this section, we summarize the SMOKE input files for the nctox example case provided with SMOKE for processing ozone, PM, and toxics pollutants. You can adapt these tables to keep track of the raw input files needed for your cases, and to help you understand all the files that need to be prepared for input to SMOKE. Section 4.2.1, “nctox case” is a description of the nctox case in more detail. The documentation in Section 4.5, “How to use SMOKE” describes which input files need to be changed for adapting the test case scripts to a particular case.

We list the raw SMOKE input files by program, with the programs listed in alphabetical order:

Intermediate files (those output by one program and input to another) are not included in the list, but can be found with the program-specific documentation in Chapter 6, SMOKE Core Programs and in the intermediate file documentation in Chapter 9, SMOKE Intermediate Files. The files that are shared among several programs are listed with each program for which they are used (i.e. listed multiple times), and noted with an asterisk adjacent to the logical file name. The file paths are listed using the path logical names, the definitions for which are available below the tables.

There are several directories that contain the raw SMOKE inputs. These are:

All of these directories are based on the $SMKDAT directory, which is set by the Assigns file as $SMK_HOME/data. The SMK_HOME environment variable should be set as part of the SMOKE installation process, as described in Section 12.3, “Installing SMOKE”.

For the nctox case, these directories (based on your SMK_HOME setting) are as follows: