6.10.3. Files and Environment Variables

6.10.3. Files and Environment Variables
Prev	6.10. Mrggrid	Next

6.10.3.1. Input Files
6.10.3.2. Input Environment Variables
6.10.3.3. Output Files

Figure 6.10. Mrggrid input and output files

Figure 6.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).

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

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

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

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

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

Prev	Up	Next
6.10.2. Processing Order	Home	6.11. Mrgpt