The MOVES Runspec script Runspec_generator.pl is written in Perl, generates the scripts and inputs needed to run MOVES for each reference county. The MOVES Model can be run at any of the three domains/scales: national, county or project. The Runspec_generator.pl uses the county domain/scale 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 run scripts so that the fewest number of runs will produce all of the necessary emissions factors. The user specifies one or more groups of pollutants to model in the run control file. In MOVES, four types of modeling groups may be used: ozone precursors, toxics, PM, and greenhouse gases (GHG). The choice of pollutant group(s) determines what pollutants are included in the three emission rate lookup tables output by MOVES (RPD, RPV, and RPP).
Runspec_generator.pl is a MOVES pre-processor utility script that is run after Met4moves. Runspec_generator.pl assembles the instructions for MOVES to create MySQL input databases from XML files and creates the importer.[csh|bat] 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 runspec.[csh|bat].
The Runspec_generator.pl uses following steps:
Reads the output file from Met4moves
Reads the run control file (control.in) and reference county file (countyrep.in).
Assembles instructions for MOVES to create MySQL input databases from XML files (data importer).
Assembles runspec XML files to run MOVES for a wide range of conditions.
Generates the run-specific temperature and humidity comma-separated-values (CSV) file.
Assembles a batch list of data importer files, runspec files, and also a list of the MySQL output database names to be postprocessed.
Importer.[csh|bat] and Runspec.[csh|bat] 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).
Review log file of the MOVES, called runlog_*.txt.
Table 5.1. Input Files
| File Name | Format | Description |
|---|---|---|
| countyrep.in | ascii | Reference county file containing the county/state/country FIPS codes and the full path and file names for the csv files containing MOVES data for AGE, FUELSUPPLY, FUELFORM(optional), IM, POP, SourceType, HPMSVMT, VMT for each reference 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 |
| input files specified by the user in the control.in file | ||
| Met4moves output | txt | Met4moves output for each fuel month for the MOVES driver script (minimum and maximum temperatures, Average daytime relative humidity, multiple sets of 24-hour temperature profiles, Temperature increments) |
| input files specified by the user in the countyrep.in file | ||
| sourceTypeAgeDistribution | csv | Age distribution by source type over 30 vehicle model years |
| fuelSupply | csv | list directed file used to define the fuel properties, their market shares and the months that the fuels are used for each reference county |
| fuelformulation (optional) | csv | list directed file used to define the fuel supply and the months that the fuels are used for each reference counties |
| IMCoverage | csv | list directed file used to define the inspection and maintanance data available for each reference counties |
| sourcetypeyear | csv | Vehicle population by MOVES source type |
| HPMSVTypeYear | csv | list directed file used to define the annual VMT by Highway Performance Monitoring System (HPMS) vehicle type |
| dummy_avgspeeddistribution | csv | Speed distribution by roadway type and vehicle class. MOVES dummy inputs files provided with tool package in OUTDIR directory |
| dummy_monthvmtfraction | csv | list directed file that allocates annual VMT to the individual months |
| dummy_dayvmtfraction | csv | 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 | csv | list directed file that allocates the day-type VMT to individual hours of the day |
| dummy_roadtypedistribution | csv | list directed file that allocates annual VMT to five MOVES roadway types |
| File Name | Format | Description |
|---|---|---|
| runspec.[csh|bat] | ASCII | Batch or c-shell script to run required MOVES runs. Fine more information from Section 5.2.3.3, “MOVES Runspec batch script” |
| importer.[csh|bat] | ASCII | Batch or c-shell Script to create MySQL MOVES databases and import the data. Fine more information from Section 5.2.3.2, “MOVES importer script” |
| zonemonthhour files | csv | 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 reference county. |
| data importer files | xml | data importer files (*_imp.xml) |
| runspec files | xml | runspec files (*_mrs.xml) |