4.10.3. Files and Environment Variables

4.10.3.1. Input Files
4.10.3.2. Input Environment Variables
4.10.3.3. Output Files

Figure 4.10. Mrggrid input and output files

Mrggrid input and output files

Figure 4.10, “Mrggrid input and output files” shows the input and output files for the Mrggrid program. The input file is simply a list of the logical file names for the files to be merged (FILELIST). The program outputs a log file (LOGFILE), a gridded, optionally layered, optionally hourly emissions file (OUTFILE), and if merging different days, a report file (REPMRGGRID).

4.10.3.1. Input Files

File Name Format Description
FILELIST ASCII

List of logical file name for 2-D and 3-D gridded I/O API NetCDF files; this file cannot contain the full paths and file names. Users should make sure that the logical file names that appear in the column A of FILELIST are defined prior to running Mrggrid. The column B can be filled with "METEMIS" to enable the MOVES onroad mobile emissions except for RPP mode using METCRO2D and/or METCRO3D input files. Optionally, the column C can enable the NOx humidity correction by fuel types ("GASOLINE" or "DIESEL").

RPD_DIESEL, METEMIS, DIESEL
RPD_GASOLINE, METEMIS, GASOLINE
RPV, METEMIS
RPP
ADJ_FACS

(optional)

ASCII

File that lists the species name, the logical file name, and the factor to be applied to all grid cells. The species name must be in columns A, the logical file name in column B, and the factor in columns C. SMOKE will ignore the case of the text, treating lower- and uppercase characters as if they were the same. For example, the following ADJ_FACS file sample would multiply NO emissions from the MGTS_L file by 1.3 (30% increase) and multiply PAR from the PGTS_L file by 0.6 (40% decrease).

NO, MGTS_L, 1.3
PAR, PGTS_L, 0.6
TAG_SPECIES

(optional)

ASCII

File that lists the logical file name, the species name, and the tag name to be appended. The logical file name in column B, the species name must be in columns B, and the factor in columns C. SMOKE will ignore the case of the text, treating lower- and uppercase characters as if they were the same. For example, the following TAG_SPECIES file sample would append a tag (t1) to the NO species from the MGTS_L file and append a tag (t3) to the PAR from the PGTS_L file.

MGTS_L, NO,  t1
PGTS_L, PAR, t3

4.10.3.2. Input Environment Variables

  • MRG_DIFF_DAYS: [default: N]

    This environment variable allows Mrggrid to merge files with data from different days.

    • Y: Allow data from different dates to be merged together

      Mrggrid will use the environment variables G_STDATE, G_STTIME, G_RUNLEN, and G_TSTEP to set the start date, start time, length, and time step of the output file. All input files must have the same starting time as G_STTIME, the same time step as G_TSTEP, and must contain more than G_RUNLEN steps of data. For each input file, if it contains data to cover the actual episode requested by G_STDATE, G_STTIME, and G_RUNLEN, then the data for the actual episode will be used; otherwise, data starting at the first time step of the file will be used.

    • N: Require all merged data to be from the same date

      Mrggrid will determine the output file time period based on the latest starting input file and the earliest ending input file.

4.10.3.3. Output Files

File Name Format Description
LOGFILE ASCII Log generated from executing Mrggrid
OUTFILE I/O API NetCDF Gridded, optionally layered, optionally hourly emission file
REPMRGGRID ASCII Report file generated when MRG_DIFF_DAYS is set to Y; the report lists the date and time for each output time step along with the actual date and time of the data read from each file
REPMERG_ADJ ASCII Report file generated when ADJ_FACS is set; the report lists the date, the logical file name, the species name, the factor applied, a daily total of species before and after applying adjustment factor, and the ratio (after/ratio). The report only lists when the ratio is not equal to 1.0
REPMERGE_SUM ASCII Report file generated when ADJ_FACS is set; the report lists the date, the species name, a daily total of species over all the logical files before and after applying adjustment factors, and the ratio (after/ratio). The report only lists when the ratio is not equal to 1.0
REPMERGE_TAG ASCII Report file generated when TAG_SPECIES is set; the report lists the logical files name, species name before and after appending the tag