6.9.3. Files and Environment Variables

6.9.3.1. Input Files
6.9.3.2. Input Environment Variables
6.9.3.3. Output Files

Figure 6.9. Mrggrid input and output files

Mrggrid input and output files

Figure 6.9, “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).

6.9.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 FILELIST are defined prior to running Mrggrid.

6.9.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.

6.9.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