5.2.3. Run MOVES Model

5.2.3.1. Overview
5.2.3.2. MOVES importer script
5.2.3.3. MOVES Runspec batch script

5.2.3.1. Overview

Excute multiple MOVES runs based on automatically generated Runspec_generator.pl data importer script (import.[csh|bat]) and the MOVES script file (runspec.[csh|bat]), which specifies the characteristic of the particular scenario to be modeled.

5.2.3.2. MOVES importer script

5.2.3.2.1. Description

The MOVES importer script Importer.[csh|bat] loads the data and creates the MySQL input database containing local data for the reference county.

The output of the MOVES batch importer script includes:

  • MySQL databases (*_in).

5.2.3.2.2. Processing Order

Importer.[csh|bat] is created by Runspec_generator.pl and should be run before runspec.[csh|bat]. The Importer.[csh|bat] is written in Linux c-shell or Windows batch script format depending on which option is chosen by the user in the Runspec_generator.pl. The Importer.[csh|bat] script imports the csv files into MySQL input databases.

The Importer.[csh|bat] uses following steps:

  1. The Importer.[csh|bat] contains all of the user selections needed to import data from the csv files into a MySQL MOVES database

  2. Imports the data for each of the three different emissions processes: RPD, RPV, RPP.

  3. Review log file of the MOVES, called importlog_*.txt.

5.2.3.2.3. Files, Environment Variables, and Run Syntax
5.2.3.2.3.1. Input Files
File Name Format Description
RV_[CountyRep]_[yearID]_[monthID]_[TempBin]_imp.xml XML file specifies the zonemonthhour (*zmh.csv) files and other files that will be imported to MOVES for the Rate Per Vehicle Mode, note: TempBin varies, in 5 degree increments to cover the Temperature Range ie. [TempBin] = T10, T15,.. T105 for the temperature range [TempRange]= T10_105
RP_[CountyRep]_[yearID]_[monthID]_[MetProfID]_imp.xml XML file specifies the zonemonthhour (*zmh.csv) files that will be imported to MOVES for the Rate Per Process Mode
RD_[CountyRep]_[yearID]_[monthID]_[TempRange]_imp.xml XML importer file specifies the zonemonthhour (*zmh.csv) files that will be imported to MOVES for Rate Per Distance Mode
5.2.3.2.3.2. Run Syntax
fullpathname/importer.[csh|bat]
5.2.3.2.3.3. Output Files
File Name Format Description
RD_[CountyRep]_[yearID]_[monthID]_[TempRange]_in MySQL MOVES MySQL Database RPD Table (*_in)
RP_[CountyRep]_[yearID]_[monthID]_[MetProfID]_in MySQL MOVES MySQL Database RPP SMOKE format Table (*_in)
RV_[CountyRep]_[yearID]_[monthID]_[TempBin]_in MySQL MOVES MySQL Database RPV Table(*_in)

5.2.3.3. MOVES Runspec batch script

5.2.3.3.1. Description

The MOVES Runspec batch script file runspec.[csh|bat] is used to execute the MOVES runs for the reference county and reference fuel month.

The output directories are named according to the following naming convention: [CountyRep]_[monthID]_[YearID]_[PollutantID], ie. 13121_Apr_2009_ozone

The output files include:

  • rateperdistance.[frm|MYD|MYI]

  • ratepervehicle.[frm|MYD|MYI]

  • rateperprofile.[frm|MYD|MYI]

5.2.3.3.2. Processing Order

runspec.[csh|bat] is created by Runspec_generator.pl and should be run after Importer.[csh|bat] and before moves2smkEF.pl. The runspec.[csh|bat] is written in Linux c-shell or Windows batch script format depending on which platform is being used (this option is specified by the user in the Runspec_generator.pl) the script is used to run MOVES for the appropriate temperature bins, source types, and poluutants.

The runspec.[csh|bat] uses following steps:

  1. The runspec.[csh|bat] contains all of the user selections needed to run MOVES using the imported MySQL MOVES databases that were created by importer.[csh|bat]

  2. Creates the MOVES output in CSV format and also provides the associated XML files for the three different emissions processes: RPD, RPV, RPP.

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

5.2.3.3.3. Files, Environment Variables, and Run Syntax
5.2.3.3.3.1. Input Files
File Name Format Description
runspec.[csh|bat] ASCII runspec script to use the MySQL MOVES databases created by importer.[csh|bat] and run MOVES
RV_[SCC]_[YR]_[M]_[TempBin]_mrs.xml XML importer file specifies the zonemonthhour (*zmh.csv files that will be imported to MOVES for the Rate Per Vehicle Mode
RP_[SCC]_[YR]_[M]_[ProfMYEAR???]_mrs.xml XML importer file specifies the *.csv files that will be imported to MOVES for the Rate Per Process Mode
RD_[SCC]_[YR]_[M]_[TempBin]_[85 or 90?]_mrs.xml XML importer file specifies the *.csv files that will be imported to MOVES for Rate Per Distance Mode
5.2.3.3.3.2. Run Syntax
fullpathname/runspec.[csh|bat]
5.2.3.3.3.3. Output Files Note: these output files are placed in separate directories for each reference county, fuel month and pollutant ie. outputs/mysql/13121_Jan_2009_ozone
File Name Format Description
rateperdistance.[frm|MYD|MYI] MySQL MOVES MySQL Database RPD Table (*.frm,*.MYD,*.MYI)
ratepervehicle.[frm|MYD|MYI] MySQL MOVES MySQL Database RPV Table(*.frm,*.MYD,*.MYI)
ratepervehicle_smoke.[frm|MYD|MYI] MySQL MOVES MySQL Database RPV SMOKE format Table(*.frm,*.MYD,*.MYI)
rateperprofile.[frm|MYD|MYI] MySQL MOVES MySQL Database RPP Table (*.frm,*.MYD,*.MYI)
rateperprofile_smoke.[frm|MYD|MYI] MySQL MOVES MySQL Database RPP SMOKE format Table (*.frm,*.MYD,*.MYI)
activitytype.[frm|MYD|MYI] MySQL MOVES MySQL Database activity type Table (*.frm,*.MYD,*.MYI)
agefractotals.[frm|MYD|MYI] MySQL MOVES age fraction totals Table(*.frm,*.MYD,*.MYI)
movesactivityoutput.[frm|MYD|MYI] MySQL MOVES MySQL Database activity output Table (*.frm,*.MYD,*.MYI)
moveserror.[frm|MYD|MYI] MySQL MOVES MySQL Database error Table (*.frm,*.MYD,*.MYI)
moveseventlog.[frm|MYD|MYI] MySQL MOVES MySQL Database event log Table(*.frm,*.MYD,*.MYI)
movesoutput.[frm|MYD|MYI] MySQL MOVES MySQL Database output Table (*.frm,*.MYD,*.MYI)
movesrun.[frm|MYD|MYI] MySQL MOVES MySQL Database run Table (*.frm,*.MYD,*.MYI)
movestablesused.[frm|MYD|MYI] MySQL MOVES MySQL Database tables used Table (*.frm,*.MYD,*.MYI)
movesworkersused.[frm|MYD|MYI] MySQL MOVES MySQL Database workers used Table(*.frm,*.MYD,*.MYI)
moves.[frm|MYD|MYI] MySQL MOVES MySQL Database output Table (*.frm,*.MYD,*.MYI)
rdprex.[frm|MYD|MYI] MySQL MOVES MySQL Database RDPREX Table(*.frm,*.MYD,*.MYI)
rpprex.[frm|MYD|MYI] MySQL MOVES MySQL Database RPPREX output Table (*.frm,*.MYD,*.MYI)
rvprex.[frm|MYD|MYI] MySQL MOVES MySQL Database RVPREX Table(*.frm,*.MYD,*.MYI)
sccvtypeagedistribution.[frm|MYD|MYI] MySQL MOVES MySQL Database SCCV Type Age Distribution output Table (*.frm,*.MYD,*.MYI)
sccvtypeagedistribution_final.[frm|MYD|MYI] MySQL MOVES MySQL Database SCCV Type Age Distribution Final output Table (*.frm,*.MYD,*.MYI)
tmprdscc.[frm|MYD|MYI] MySQL MOVES MySQL Database temporary RD SCC output Table (*.frm,*.MYD,*.MYI)
tmprpscc.[frm|MYD|MYI] MySQL MOVES MySQL Database temporary RP SCC output Table (*.frm,*.MYD,*.MYI)
tmprvscc.[frm|MYD|MYI] MySQL MOVES MySQL Database temporary RV SCC output Table (*.frm,*.MYD,*.MYI)
tmp_sccroadtypedistribution.[frm|MYD|MYI] MySQL MOVES MySQL Database temporary scc road type distribution output Table (*.frm,*.MYD,*.MYI)
tmp_srcfuelagedistribution.[frm|MYD|MYI] MySQL MOVES MySQL Database temporary source fuel age distribution output Table (*.frm,*.MYD,*.MYI)
travelfrac_denominator.[frm|MYD|MYI] MySQL MOVES MySQL Database travel fraction denominator Table (*.frm,*.MYD,*.MYI)
travelfrac_numerator.[frm|MYD|MYI] MySQL MOVES MySQL Database travel fraction numerator Table (*.frm,*.MYD,*.MYI)
travelfractions.[frm|MYD|MYI] MySQL MOVES MySQL Database travel fractions Table (*.frm,*.MYD,*.MYI)