4.11.3. Files and Environment Variables

4.11.3.1. Input Files
4.11.3.2. Input Environment Variables
4.11.3.3. Output Files

Figure 4.11. Mrgpt input and output files

Mrgpt input and output files

Figure 4.11, “Mrgpt input and output files” shows the input and output files for the Mrgpt program. The input files are a list of the logical file names for the speciated hourly emissions files from Smkmerge to be merged (FILELIST_INLN) and a list of the logical file names for the ASCII elevated output files from Elevpoint to be merged (FILELIST_STACK). The program outputs a log file (LOGFILE), a merged specated hourly emissions file (OUTFILE_INLN), a merged ASCII elevated output file (OUTFILE_STACK), and if merging different days, a report file (REPMRGGRID).

4.11.3.1. Input Files

File Name Format Description
FILELIST_INLN ASCII List of logical file name for hourly speciated 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 FILELIST_INLN are defined prior to running Mrgpt.
FILELIST_STACK ASCII List of logical file name for ASCII elevated output files; this file cannot contain the full paths and file names. Users should make sure that the logical file names that appear in FILELIST_STACK are defined prior to running Mrgpt.
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 PTIPMTS_L_INLN file by 1.3 (30% increase) and multiply PAR from the PTNONIPMTS_L_INLN file by 0.6 (40% decrease).

NO, PTNONIPMTS_L_INLN, 1.3
PAR, PTIPMTS_L_INLN, 0.6

4.11.3.2. Input Environment Variables

  • MRG_DIFF_DAYS: [default: N]

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

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

      Mrgpt 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

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

4.11.3.3. Output Files

File Name Format Description
LOGFILE ASCII Log generated from executing Mrgpt
OUTFILE_INLN I/O API NetCDF Merged inline-mode hourly speciated emission file
OUTFILE_STACK ASCII Merged inline-mode ASCII point elevated 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