5.11.3. Files and Environment Variables

5.11.3.1. Input Files
5.11.3.2. Input Environment Variables
5.11.3.3. Output Files

5.11.3.1. Input Files

File Name Format Description
MET_CRO_3D I/O API NetCDF

Meteorology file that can be a 2-D or 3-D file (though the logical file name is the same in both cases) and needs to include all dates in the modeling period. For example, for an annual SMOKE run this file would need to have all hours of the year. The file can be created by extracting one or more temperature variables (at a minimum, the one you intend to use) out of the MET_CRO_2D or MET_CRO_3D files output by the MCIP or MCPL programs using the m3xtract I/O API utility and appending all days of data into the same file.

The m3xtract utility documentation is provided with the I/O API, but we provide some information here. The utility expects input logical file name INFILE and creates output logical file name OUTFILE. It prompts for the start date, start time, duration, and variables that you want to extract from the INFILE. If OUTFILE already exists, m3xtract appends additional data to the file (assuming that the grid is the same and the time period is sequential).

5.11.3.2. Input Environment Variables

  • TMPR_VAR: [default: TA]

    Sets the name of the temperature variable that will be read from the MET_CRO_3D input file. Acceptable values for MCIP and MPCL outputs available at the time of this writing are TA (ambient layer-1 temperature from the MET_CRO_3D file), TEMP10 (10-meter temperature from the MET_CRO_2D file), TGD (ground temperature), TGRND (ground temperature), and TEMP15 (1.5-meter temperature). Current guidance from EPA suggests that a 10- to 20-meter temperature is the best choice for the temperature input to BEIS2 or BEIS3, to account for the fact that these models do not include a canopy model.

  • N_S_HEMI: [default: NORTH]

    Sets the program to run for the Northern or Southern Hemisphere. Acceptable values for this setting are:

    • NORTH: Northern Hemisphere. Program starts July 1 and scans data in reverse chronological order to find the last freeze date and in chronological order to find the first freeze date.

    • SOUTH: Southern Hemisphere. Program starts January 1 and scans data in chronological order to find the first freeze date. It also starts December 31 and scans the data in reverse chronological order to find the last freeze date.

5.11.3.3. Output Files

File Name Format Description
BIOSEASON I/O API NetCDF For each grid cell, contains 0 for winter dates and 1 for summer (nonwinter) dates. The file’s duration will be as long as that of the input meteorology file you provide.
LOGFILE ASCII Log generated from executing Metscan