Figure 4.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 representative county fuel month file (MFMREF
), the list of emission process and associated pollutants file (MEPROC
), the representative county cross-reference file (MCXREF
), the list of emission factors files by representative 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, RPS, RPH, RPHO 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
.
When using source apportionment, Movesmrg will also read the source grouping file (SOURCE_GROUPS
) and output the source group information SRCGROUPS_OUT
, the emissions for each source group SGINLNTS_L
or SGINLNTS_S
, and a source group report file SRCGRP_REPORT
.
File Name | Format | Description |
---|---|---|
COSTCY |
ASCII | Country, state and county codes file |
GEOCODE_LEVEL[1-4] |
ASCII | Geographical level codes and descriptions for gridded inventories, only when USE_EXP_GEO_CODES is set to Y, (COSTCY is ignored
when GEOCODE_LEVEL[1-4] files are used)
|
CFPRO (optional)
|
ASCII | Control factor file |
GRIDDESC |
ASCII | Grid description file |
INVTABLE |
ASCII | Inventory data table |
MFMREF |
ASCII | Representative county fuel month file |
MEPROC |
ASCII | List of emission process and associated pollutants file |
MCXREF |
ASCII | Representative county cross-reference file |
MRCLIST |
ASCII | List of emission factors files (i.e., RPD, RPV, RPS, RPH, RPHO and RPP Lookup tables) by representative county file |
METLIST |
ASCII | List of 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 |
MTMP_{day} |
ASCII | Daily hour VMT files from Temporal |
SOURCE_GROUPS (optional)
|
ASCII | Source apportionment groups |
SPDIST (optional)
|
ASCII | Weekday and weekend hour-specific 16-bins average speed distribution profiles |
SPDPRO (optional)
|
ASCII | Weekday and weekend hourly speed profiles |
APPLY_NOX_HUMIDITY_ADJ:
: [default: N]
Allows Movesmrg to apply NOx humidity correction to gridded hourly NOx emissions for RPD, RPS, RPH, and RPHO runs. If there is a header "HUMIDITY_ADJUSTED_NOX Y" listed in the MOVES lookup tables, it means that NOx emissions in those MOVES lookup tables are already adjusted and this flag will be overwritten to N. No NOx humidity correction will be applied.
Y: Apply NOx humidity correction to non-NOx humidity correction applied MOVES lookup tables from RPD, RPH, RPS, and RPHO runs.
N: Do not apply NOx humidity correction.
MEMORY_OPTIMIZE_YN:
: [default: Y]
Allows Movesmrg to use less RAM memory. However, it will increase computational time of RPD_MODE and RPV_MODE runs.
Y: Runs Movesmrg in memory optimization mode.
N: Runs Movesmrg faster mode using high capacity of RAM memory.
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.
MTMP_OUTPUT_YN
: [default: N]
Defines whether Temporal outputs the Temporal intermediate output file from Section 7.15, “Temporal” for Smkreport to create hourly emissions summary report based on hourly gridded emissions estimated by Movesmrg.
Y: Output Temporal intermediate output file
N: Do not output Temporal intermediate output file
OUTPUT_EMIS_TABLE_YN
: [default: N]
Determines whether Movesmrg outputs temperature-bin precomputed gridded hourly emissions tables or not (Not applicable for RPP mode). Find the details on how the temperature-bin-specific pregridded hourly emissions approach can work for your modeling run “ CMAQ-MetEmis Dynamic Coupler Development”
Y: Output temperature-bin precomputed gridded hourly emissions table.
N: Do not output temperature-bin precomputed gridded hourly emissions table
MIN_TEMP_EMIS_TABLE
: [default: 0.0]
Define the lowest temperature for precomputed emissions table output file when OUTPUT_EMIS_TABLE_YN is set to Y.
MAX_TEMP_EMIS_TABLE
: [default: 120.0]
Define the highest temperature for precomputed emissions table output file when OUTPUT_EMIS_TABLE_YN is set to Y.
TEMP_INCREMENT_EMIS_TABLE
: [default: 5.0]
Define the temperature bin increment for precomputed emissions table output file when OUTPUT_EMIS_TABLE_YN is set to Y.
ONI_MODE
: [default: N]
Determines whether Movesmrg processes off-network idling emissions for RPHO sector.
Y: Process off-network idling emissions
N: Do not process off-network idling emissions
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
RPH_MODE:
[default: N]
Determines whether Movesmrg processes rate-per-hour emissions.
Y: Process rate-per-hour emissions
N: Do not process rate-per-hour emissions
RPV_MODE
: [default: N]
Determines whether Movesmrg processes rate-per-vehicle and rate-per-start 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
RPS_MODE
: [default: N]
Determines whether Movesmrg processes rate-per-start emissions.
Y: Process rate-per-start emissions
N: Do not process rate-per-start emissions
SMK_MVSPATH
: [default: blank]
Defines the location of MOVES emission factors lookup tables.
SMK_SOURCE
: [default: blank]
Sets the types of source category. It must be set to "M" for Movesmrg.
SMK_SRCGROUP_OUTPUT_YN
: [default: N]
Indicates if source apportionment emissions should be output
Y: Group sources and output source apportionment files
N: Do not perform any source apportionment processing
SMK_SUB_SECTOR_OUTPUT_YN
: [default: N]
Indicates if sub-sector source group emissions should be output
Y: Group sources and output sub-sector source group files
N: Do not perform sub-sector source group processing
TEMP_BUFFER_BIN
: [default: 0.0]
Defines the temperature buffer value (°F). This value allows Movesmrg to cover the outside of min/max temperature range in SMOKE_OUTFILE
from Met4moves for Movesmrg RPP processing. If TEMP_BUFFER_BIN
is set to 10.0, the original max temperature which is 90.0°F will be treated as 100.0°F, and minimum temperaure (=30°F) will
be treated as 20.0°F internally in Movesmrg. Emission rates for those temperatures outside of original temperature range will share the ones from original max/min temperatures.
TVARNAME
: [default: TEMP2]
Name of temperature variable to read from the meteorology files for Movesmrg.
USE_AVG_SPD_DIST
: [default: N]
Allows the user to apply 16-speed bin average speed distribution profiles by region, SCC, day of week, and hour of day.
Y: Apply 16-speed bin average speed distribution profiles.
N: Do not apply average speed distribution profiles.
USE_CONTROL_FACTORS
: [default: N]
Allows the user to apply control factor by region, SCC, pollutant, and month.
Y: Apply control factors to MOVES emission rates from MOVES lookup tables.
N: Do not apply control factor.
USE_EXP_CONTROL_FAC_YN
: [default: N]
Allows the user to optionally apply pollutant/species-specific explict control factor by region, SCC, and month when USE_CONTROL_FACTORS
is set to Y.
Y: Apply pollutant/species-specific explicit control factors to MOVES emission rates from MOVES lookup tables.
N: Do not apply control factor.
USE_EXP_GEO_CODES
: [default: N]
If set to Y then use GEOCODE_LEVEL[1-4] files instead of the COSTCY file to define expanded geographical detail such as country-level(GEOCODE_LEVEL1), country/state-level (GEOCODE_LEVEL2), country/state/county-level (GEOCODE_LEVEL3) or country/state/county/tribal-level (GEOCODE_LEVEL4).
USE_REF_CONTROL_FAC_YN
: [default: N]
Allows the user to optionally apply reference-county-level control factor by SCC, and month when USE_CONTROL_FACTORS
is set to Y.
Y: Apply reference-county-level control factors to MOVES emission rates from MOVES lookup tables.
N: Do not apply control factor.
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
USE_SPCMAT_SPC_YN
: [default: N]
Determine whether estimate air quality model species using chemical speciation profiles or not.
Y: Estimate model species emissions using GSPRO input file
N: Estimate model species emissions directly from MOVES emission rates lookup tables
File Name | Format | Description |
---|---|---|
MGTS[_S|_L] |
I/O API NetCDF | Model Ready Emissions File |
MTMP_INV |
I/O API NetCDF | Hourly emissions by source |
REPMGTS[_S|_L] |
ASCII | Report File |
LOGFILE |
ASCII | Logfile |
SGINLNTS[_S|_L] |
I/O API NetCDF | Emissions by source group, formatted as CMAQ in-line emissions data, produced if SMK_SRCGROUP_OUTPUT_YN is set to Y
|
SRCGROUPS_OUT |
I/O API NetCDF | Source group information, produced if SMK_SRCGROUP_OUTPUT_YN is set to Y
|
SRCGRP_REPORT |
ASCII | Source group report file, produced if SMK_SRCGROUP_OUTPUT_YN or SMK_SUB_SECTOR_OUTPUT_YN is set to Y
|
SUBOUT##GTS[_S|_L] |
I/O API NetCDF | Emissions by sub-sector source group ID (##) produced if SMK_SUB_SECTOR_OUTPUT_YN is set to Y
|