6.8.3. Files and Environment Variables

6.8.3.1. Input Files
6.8.3.2. Input Environment Variables
6.8.3.3. Output Files

Figure 6.8. Movesmrg input and output files

Movesmrg input and output files

Figure 6.8, “Movesmrg input and output files” shows the input and output files for the Movesmrg program. The input files are the country, state, and county codes file (COSTCY), the grid description file (GRIDDESC), the inventory data table (INVTABLE), the reference county fuel month file (MFMREF), the list of emission process and associated pollutants file (MEPROC), the reference county cross-reference file (MCXREF), the list of emission factors files by reference county file (MRCLIST), the meteorology files (MET_CRO_2D), the gridding matrix from Grdmat (MGMAT), the inventory file output from Smkinven (MOBL), the speciation matrix from Spcmat (MSMAT_L or MSMAT_S), the Met4moves output file for SMOKE (METMOVES =SMOKE_OUTFILE), the MOVES-based lookup tables (RPD, RPV, and RPP), and the daily hour VMT files from Temporal (MTMP_(day)). Note that MET_CRO_2D, METMOVES, and MTMP_(day) are optional files that are included only in certain situations.

Movesmrg outputs a model-ready emissions file MGTS_L or MGTS_S, a report file REPMGTS_S, and a log file LOGFILE.

6.8.3.1. Input Files

File Name Format Description
COSTCY ASCII Country, state and county codes file
GRIDDESC ASCII Grid Description File
INVTABLE ASCII Inventory data table
MFMREF ASCII Reference county fuel month file
MEPROC ASCII List of emission process and associated pollutants file
MCXREF ASCII Reference county cross-reference file
MRCLIST ASCII List of emission factors files by reference county file
MET_CRO_2D(optional) ASCII MCIP meteorology files
MGMAT ASCII Gridding matrix from Grdmat
MOBL ASCII Inventory file output from Smkinven
MSMAT_[L|S] ASCII Speciation matrix from Spcmat
(METMOVES =SMOKE_OUTFILE) (optional) ASCII Meteorology file from Met4moves
MOVES Lookup Tables(RPD, RPV, and RPP) ASCII MOVES Lookup Tables (RPD, RPV, and RPP)
MTMP_{day}(optional) ASCII Daily hour VMT files from Temporal
SPDPRO(optional) ASCII Weekday and weekend hourly speed profiles

6.8.3.2. Input Environment Variables

  • MRG_BYDAY: [default: blank]

    String code that specifies which source category is to use a by-day approach for the hourly input files. It must be set to "M" for a Movesmrg to create an output file for each day.

  • MRG_GRDOUT_YN: [default: N]

    Determines whether Movesmrg produces a gridded output file.

    • Y: Read the gridding matrix produced by the Grdmat

    • N: Do not read the gridding matrix.

  • MRG_SPCOUT_YN:: [default: N]

    Determines whether Movesmrg produces a speciated output file.

    • Y: Read the gridding matrix produced by the Spcmat

    • N: Do not read the gridding matrix.

  • MRG_REPCNY_YN:: [default: N]

    Determines whether Movesmrg produces a report of emission totals by county

    • Y: Produce the report by Movesmrg

    • N: Do not produce the report

  • MRG_REPSTA_YN:: [default: N]

    Determines whether Movesmrg produces a report of emission totals by state

    • Y: Produce the report by Movesmrg

    • N: Do not produce the report

  • MRG_REPSCC_YN:: [default: N]

    Determines whether Movesmrg produces a report of emission totals by SCC

    • Y: Produce the report by Movesmrg

    • N: Do not produce the report

  • MRG_REPSRC_YN:: [default: N]

    Determines whether Movesmrg produces a report of emission totals by source.

    • Y: Produce the report by Movesmrg. It will reset MRG_REPCNY_YN and MRG_REPSCC_YN to N to avoid to outputing duplicate information into the report.

    • N: Do not produce the report

  • If MRG_GRDOUT_UNIT [default: units]

    String code that permits user to change the unit of the gridded output file.

  • If MRG_TOTOUT_UNIT [default: units]

    String code that permits user to change the unit of the state/county total report file.

  • RPD_MODE:: [default: N]

    Determines whether Movesmrg processes rate-per-distance emissions.

    • Y: Process rate-per-distance emissions

    • N: Do not process rate-per-distance emissions

  • RPV_MODE:: [default: N]

    Determines whether Movesmrg processes rate-per-vehicle emissions.

    • Y: Process rate-per-vehicle emissions

    • N: Do not process rate-per-vehicle emissions

  • RPP_MODE:: [default: N]

    Determines whether Movesmrg processes rate-per-profile emissions.

    • Y: Process rate-per-profile emissions

    • N: Do not process rate-per-profile emissions

  • SMK_MVSPATH: [default: blank]

    Defines the temperature increment (in deg. F) for RPD lookup table to create combinations of min/max temperature bins

  • SMK_SOURCE: [default: blank]

    Sets the types of source category. It must be set to "M" for Movesmrg.

  • TMPVNAME: [default: TEMP2]

    Name of temperature variable to read from the meteorology files for Movesmrg.

  • USE_HOURLY_SPEEDS: [default: N]

    Determine whether processes weekday/weekend hourly speed profiles or not.

    • Y: Process weekday/weekend hourly speed profiles

    • N: Do not process hourly speed profiles

6.8.3.3. Output Files

File Name Format Description
MGTS_L or MGTS_S I/O API NetCDF Model Ready Emissions File
REPMGTS_S ASCII Report File
LOGFILE ASCII Logfile