3.2.2. MOVES Driver Scripts

3.2.2.1. Processing Order
3.2.2.2. How-To-Run
3.2.2.3. Files and Environment Variables

The MOVES Runspec script Runspec_generator.pl is written in Perl, generates the scripts and inputs needed to run MOVES for each representative county. The MOVES Model can be run at any of the three domains/scales: national, county or project. The Runspec_generator.pl is only applicable to the county-level because this level of model detail is required by EPA for SIP and conformity analyses. For this scale, MOVES requires a MySQL input database containing local data for a single county. The Runspec_generator.pl is designed to prepare the MOVES importer and MOVES run scripts so that the fewest number of runs will produce all of the necessary emissions factors. In this approach, user can specify one or more groups of pollutants to model in the run control fil.

There are a total of four types of modeling pollutant groups: 1) Ozone precursors, 2) Toxics, 3) Particulate Matters, and 4) GreenHouse Gases (GHG) based on Table 2.8, “MOVES Pollutant Groups”. The choice of pollutant group(s) determines what pollutants are included in the three emission rate lookup tables (RPD, RPV, and RPP) by MOVES.

3.2.2.1. Processing Order

Runspec_generator.pl run after Met4moves. It assembles the instructions for MOVES to create MySQL input databases from XML files and creates the importer.csh scripts and assembles run specification XML files to run MOVES for a necessary range of conditions (for each emissions process: rate-per-distance, rate-per-vehicle, and rate-per-profile) based on the Met4moves output temperature list by county-specific runspec.csh.

The Runspec_generator.pl uses following steps:

  1. Reads the representative county min/max temperature and 24-hours temperature profiles output file from Met4moves for RPP mode. Find detail information from Section 7.8.1, “MOVES_OUTFILE

  2. Reads the representative county specific min/max temperatures and average RH output file from Met4moves for RPD, RPV and RPH modes. Find detail information from Section 7.8.2, “MOVES_RH_OUTFILE

  3. Import the name of pollutant group to model from the run control file (contorl.in) based on Table 2.8, “MOVES Pollutant Groups”

  4. Reads the run control file (control.in) and representative county file (countyrep.in) created by user.

  5. Assembles instructions for MOVES to create MySQL input databases from XML files (data importer).

  6. Assembles runspec XML files to run MOVES for a wide range of conditions.

  7. Generates the run-specific temperature and humidity comma-separated-values (CSV) format file.

  8. Assembles a batch list of data importer files, runspec files, and also a list of the MySQL output database names to be postprocessed.

  9. importer.csh and runspec.csh scripts are used to create the on-road operating rateperdistance table (RPD), off-network processes ratepervehicle table (RPV), and vapor venting off-network rateperprofile table (RPP).

  10. Review log file of the MOVES, called runlog_*.txt.

3.2.2.2. How-To-Run

Check out the most latest processing scripts and the “How to run” instructions are available from the SMOKE-MOVES Github repository.

3.2.2.3. Files and Environment Variables

3.2.2.3.1. Input Files

Table 3.1. Input Files

File Name Format Description
countyrep.in ASCII Representative county file containing the country/state/county FIPS codes and the full path and file names for the files containing MOVES data for AGE, FUELSUPPLY, FUELFORM(optional), IM, POP, SourceType, HPMSVMT, VMT for each representative county
control.in ASCII Run control file that user specifies fields for the Database Host, Project Name, Model year, day type (weekday or weekend), pollutant and the met4moves MET output file for the batch run of MOVES
MOVES_OUTFILE ASCII Met4moves output for each fuel month for the MOVES Driver script (minimum and maximum temperatures, and 24-hour temperature profiles for all representative counties by temperature bin)
MOVES_RH_OUTFILE ASCII Met4moves outputs fuel month-specific averaged, min, and max temperatures and averaged RH values in local time for all representative counties by temperature bin
sourceTypeAgeDistribution ASCII Age distribution by source type over 30 vehicle model years
fuelSupply ASCII list directed file used to define the fuel properties, their market shares and the months that the fuels are used for each representative county
fuelformulation (optional) ASCII list directed file used to define the fuel supply and the months that the fuels are used for each representative counties
IMCoverage ASCII list directed file used to define the inspection and maintanance data available for each representative counties
sourcetypeyear ASCII Vehicle population by MOVES source type
HPMSVTypeYear ASCII list directed file used to define the annual VMT by Highway Performance Monitoring System (HPMS) vehicle type
dummy_avgspeeddistribution ASCII Speed distribution by roadway type and vehicle class. MOVES dummy inputs files provided with tool package in OUTDIR directory
dummy_monthvmtfraction ASCII list directed file that allocates annual VMT to the individual months
dummy_dayvmtfraction ASCII file that allocates month VMT day type, weekday or weekend and the decimal fraction of the proportion of vehicle miles travelled for the weekday or weekend day type
dummy_hourvmtfraction ASCII list directed file that allocates the day-type VMT to individual hours of the day
dummy_roadtypedistribution ASCII list directed file that allocates annual VMT to five MOVES roadway types
3.2.2.3.2. Output Files
File Name Format Description
runspec.csh ASCII Batch or c-shell script to run required MOVES runs. Fine more information from Section 3.2.3.3, “MOVES Runspec batch script”
importer.csh ASCII Batch or c-shell Script to create MySQL MOVES databases and import the data. Fine more information from Section 3.2.3.2, “MOVES importer script”
InputDBlist ASCII

List of MySQL database names to process. It will be used as an input to MOVES Post-processing script. See example below:

localhost
/work/MOVES_Processing_Scripts/post_process
13121_2008_1
Data importer files ASCII data importer files (*_imp.xml)
Runspec files ASCII runspec files (*_mrs.xml)
zonemonthhour files ASCII MOVES-formatted zonemonthhour (*_zmh.csv) contains temperature and RH data from the Met4Moves Meteorological processor. Relative Humidity is a single value averaged over the time period selected by the user in Met4Moves and averaged over the entire group of inventory counties that map to a representative county.