7.3. REPCONFIG Input File

7.3.1. One-time section
7.3.2. Define-group section
7.3.3. Create-report Section
7.3.4. The /DELIMITER/ packet
7.3.5. The /SET LABEL/ packet
7.3.6. The /REPORT TIME/ packet
7.3.7. The /AVEDAY/ packet
7.3.8. The /NEWFILE/ packet

The REPCONFIG file is used to control the Smkreport program. As noted earlier, each run of Smkreport is constrained to a single source category (area, mobile, or point), at most one speciation scenario, at most one grid, and at most one hourly emissions file. All of these component datasets are optional, however, and their use is controlled by the settings in REPCONFIG. This file also controls the number and types of reports created by Smkreport, which can create an unlimited number of reports in each program run.

The file works on the principles of “packets” and “instructions”. Packets are groups of instructions or a single action that have been predefined by the REPCONFIG file format to control the Smkreport outputs; instructions are settings that tell Smkreport what to do. Some types of packets must appear in one of three sections, while other packets can appear anywhere in the REPCONFIG file. The three sections are: “One-time” (see Section 7.3.1, “One-time section”), “Define-group” (see Section 7.3.2, “Define-group section”), and “Create-report” (see Section 7.3.3, “Create-report Section”); each file section has a large number of options. In this section of the chapter, we first provide details on these three file sections and their packets, and then we describe four additional packets that can appear between other packets at any point in the REPCONFIG file.

The full list of packets that one can use in the REPCONFIG input file are as follows:

One-time section (Section 7.3.1, “One-time section”)

Define-group section (Section 7.3.2, “Define-group section”)

Create-report section (Section 7.3.3, “Create-report Section”)

Packets that can appear anywhere in the file

Comments can be put in the file using a pound sign (#) at the first column of a line, or a double pound sign (##) anywhere else on a line. The double pound can appear after packet labels or instructions in the file.

Finally, note that the maximum number of characters that can be read on any line in this file is 300. This can be important in particular for the SELECT DATA instruction.

7.3.1. One-time section

The first section of the file is the One-time section, and it is a required section. This section is used for setting the environment variables that control Smkreport for all reports in a given run. The variables are set by listing the environment variable as an instruction, followed by its value. No setenv command (used in the C shell) is needed, because SMOKE is interpreting these values directly. At this time, the one instruction available in the One-time section is the SMK_SOURCE variable:

SMK_SOURCE: Set as “A”, “M”, or “P”, for area-source reporting, mobile-source reporting, and point-source reporting, respectively.

An example of the way this setting would appear in the REPCONFIG file is the following: