Get documents about "New York State Department of Transportation ROADMAP Program
Document Sample
New York State
Department of Transportation
ROADMAP Program
Version 2.0
User’s Manual
Prepared by: Shengxin Jin
Environmental Analysis Bureau
September 2006
ROADMAP Program Version 2.0
Table of Contents
Disclaimer ...................................................................................................................................... 2
Acknowledgements ....................................................................................................................... 3
Introduction................................................................................................................................... 4
Installation ..................................................................................................................................... 6
File Menu ....................................................................................................................................... 7
New Submenu............................................................................................................................ 7
CAL3QHC Data Entry Form – General Information.......................................................... 7
Receptor Information Entry Form ...................................................................................... 10
Link Information Entry Form............................................................................................. 12
Save Data Form ................................................................................................................... 16
File Open Submenu................................................................................................................. 16
Exit Submenu .......................................................................................................................... 17
Run Menu .................................................................................................................................... 18
CAL3QHC Submenu.............................................................................................................. 18
View Menu................................................................................................................................... 19
Full Submenu .......................................................................................................................... 19
Zoom Submenu ....................................................................................................................... 19
Receptors in Mixing Zone Submenu ..................................................................................... 20
Printing ........................................................................................................................................ 22
1
ROADMAP Program Version 2.0
Disclaimer
ROADMAP Version 2.0 and previous versions are not part of EPA’s CAL3QHC (Version 2)
dispersion model or any other models. The use of the ROADMAP program is optional for
CAL3QHC dispersion analysis. The New York State Department of Transportation (NYSDOT)
is not responsible for the accuracy or any problems associated with the use of the program. The
mention of specific products, product or corporate names, or trademarks in no way constitutes
endorsement of same by the NYSDOT.
2
ROADMAP Program Version 2.0
Acknowledgements
I would like to thank Dr. Jane Lao, Mr. John Martin, Ms. Catherine Leslie, and Ms. Sylvia Jones
of NYSDOT for their extensive testing and comments on the current ROADMAP program and
the User’s Manual. Their comments and suggestions have made many improvements in both the
program and the manual.
If you have any questions or comments about this program and/or the User’s Manual, please
contact me. Thank you.
Sincerely,
Shengxin Jin, Ph.D.
Environmental Analysis Bureau
New York State Department of Transportation
50 Wolf Road
POD 41
Albany, NY 12232
Tel: (518) 485-1406
E-mail: sjin@dot.state.ny.us
3
ROADMAP Program Version 2.0
Introduction
ROADMAP Version 2.0 is a Windows-based computer program that is designed to assist air
quality modelers who are performing air quality modeling using US EPA’s CAL3QHC (Version
2) dispersion model (see User's Guide to CAL3QHC Version 2.0: A Modeling Methodology for
Predicting Pollutant Concentrations Near Roadway Intersections, US EPA, 1995). The Version
2.0 ROADMAP program replaces the previous version of ROADMAP that was first developed
in 1994 using DOS graphic user interface (GUI). Due to changes in computer operating systems,
users using the Windows XP operating system can no longer run the DOS version ROADMAP
program.
ROADMAP Version 2.0 has retained all of the useful features of the original ROADMAP
program. These features include the graphical display of free-flow and queue links and receptor
locations of CAL3QHC input files, the identification of any receptors within the mixing zone of
any links, and the ability to run CAL3QHC in ROADMAP. In addition to the convenience of
window functionality, the program displays the highest pollutant concentrations at each receptor
location, allows the users to zoom into any specific locations of the graphical layout, and enables
a step-by-step input file creation in Windows format with options and useful user information.
The graphic display of CAL3QHC input files is a major part of the ROADMAP program.
Before the first ROADMAP program was developed in 1994, it was a difficult and time
consuming task to adequately review the vast amount of data in the CAL3QHC input and output
files. Without checking through large amounts of data, it was difficult for the reviewer to know
if the modeling was performed properly. Past review of CAL3QHC modeling has identified
numerous errors in model input files, such as link coordinates, receptor locations, etc. The
misplacement of receptors and links is the most difficult error to identify. ROADMAP was
developed to target these problems. By displaying the receptor and link locations, the reviewer
can easily identify problems and make corrections as needed.
The ROADMAP program contains a sophisticated mathematical algorithm that calculates the
distances between receptors and any links involved in the CAL3QHC modeling. These distances
are used to determine whether a receptor is located within the mixing zone of any of the links. If
a receptor is within the mixing zone of a link or links, ROADMAP displays the receptor in red to
attract the modeler’s attention. Under the View menu, the modeler can open a second window,
which shows information regarding the receptor within the mixing zone. Based on the
information, the modeler can revise the receptor location to fall outside of the mixing zone as
required by CAL3QHC.
The Run CAL3QHC option remains in ROADMAP with additional improvements. The
modeler can run the CAL3QHC program by selecting the Run CAL3QHC option under the
Run menu. At the end of the model run, ROADMAP checks through the CAL3QHC output
files, searches for the highest concentration for each receptor, and displays the results at each
receptor location graphically. This enables the modeler to view the highest concentrations
without manually looking through the large output files.
4
ROADMAP Program Version 2.0
The zoom function is new to this Windows-based version of ROADMAP. The function allows
modelers to zoom into specific locations of the graphic layout if the entire display becomes too
crowded with too many receptors and links.
The steps for creating a new CAL3QHC file are a major improvement in this version of
ROADMAP. There are three main data entry forms for the user to enter information without
counting columns or spaces (as required with a text editor). This feature is especially useful if
the user is a new CAL3QHC modeler or lacks air quality modeling experience.
5
ROADMAP Program Version 2.0
Installation
ROADMAP is written in Lahey Fortran 95 with Winteracter Starter Kit. It runs in the Windows
operating environment and requires 1 Mb of hard disk space. To install the ROADMAP
program, users need to download the roadmap.zip file from the NYSDOT Environmental
Analysis Bureau (EAB) website or IntraDOT website along with this document to their local
machine. After downloading the zip file, unzip the file and put the ROADMAP.EXE file in a
user-desired folder.
6
ROADMAP Program Version 2.0
File Menu
ROADMAP is a menu-driven user interface program. The main menu includes File, Run, View,
and Help. There are three submenus under the File menu: New, Open, and Exit (Figure 1).
The New submenu allows users to create new CAL3QHC input files; the Open submenu allows
users to select and graphically display existing CAL3QHC input files; and the Exit submenu
allows users to quit the ROADMAP program.
Figure 1. ROADMAP Program v2.0 File submenus.
New Submenu
The New submenu allows users to create new CAL3QHC input files. Several forms (described
below) are opened in sequence to assist users in creating new input files.
CAL3QHC Data Entry Form – General Information
The CAL3QHC General Information Data Entry Form (see Figure 2) allows users to enter
information associated with CAL3QHC’s Job Title Record Line, Current Run Title Line, and
Meteorological Condition Record Line. Throughout the data entry forms, users are provided
with default values and pull-down option menus whenever possible to facilitate easy and
accurate data entry. Some of the default values are grayed-out to prevent changes as these
default values rarely need to be changed. In the event that one or more of these grayed-out
default values need to be changed, users can do so by using any text editor available after
completing the data entry.
Users should pay attention to the notes provided at the bottom of each form, such as “No single
or double quote for text field.” If the user cannot enter any more text in a text field, the
maximum number of characters allowed as defined by CAL3QHC has been reached.
ROADMAP automatically limits text input to eliminate the need for users to keep track of text
lengths. To move from field to field, users can use either the Tab key or the mouse button.
7
ROADMAP Program Version 2.0
Figure 2. CAL3QHC Data Entry Form for General Information (with sample data).
Tables 1 through 3 show the field names, data types and units, default values, and possible
values/options for the Job Title Record Line, the Current Run Title Line, and the Meteorological
Condition Record Line, respectively, on the General Information Form. After completing the
General Information Form, click the Continue button to move to the Receptor Information Entry
Form.
8
ROADMAP Program Version 2.0
Table 1. Description of data fields in the Job Title Record Line block.
Field Name Data Type Unit Default Value Value/Option
Current job title character N/A none 40 characters or less; no
single or double quote
Averaging time real minutes 60 no change allowed
Number of integer N/A none ≤ 60
receptors
Surface roughness real cm 175 Select a value from the list
height
Settling velocity real cm/s 0.0 ≥ 0.0
Deposition velocity real cm/s 0.0 ≥ 0.0
Scale conversion real N/A 0.3048 select 0.3048 for input in
factor feet or 1.0 for input in
meters
Output unit option integer N/A 0 select 0 for output in
meters or 1 for output in
feet
Debugging option integer N/A 0 no change allowed
Table 2. Description of data fields in the Current Run Title Line block.
Field Name Data Type Unit Default Value Value/Option
Current run title character N/A none 40 characters or less; no
single or double quote
Number of links integer N/A none ≤ 120
Pollutant character N/A C select C for carbon
monoxide or P for
particulate matter
Number of integer N/A 1 no change allowed
Meteorological
Condition
Output format integer N/A 1 select 0 for short format or
1 for long format
9
ROADMAP Program Version 2.0
Table 3. Description of data fields in the Meteorological Condition Record Line block.
Field Name Data Type Unit Default Value Value/Option
Wind speed real m/s 1.0 use default value
Wind direction real degree 0 use 0 for variable wind
directions; enter actual
wind direction for single
direction
Stability class integer N/A 5 (E) select a stability class
Mixing height real m 1000 use 1000 m
Background real ppm or 0.0 enter 1-hour CO or PM
concentration µg/m3 background concentration
if needed
Variable wind character N/A Y select Y for variable wind
directions directions or N for a single
wind direction
Wind direction integer degree 5 use default value or enter a
increment angle desired increment
First increment integer N/A 0 use default value or enter a
multiplier value to define the lower
boundary of the wind angle
Last increment integer N/A 71 use default value or enter a
multiplier value to define the upper
boundary of the wind angle
Receptor Information Entry Form
Figure 3 displays the Receptor Information Entry Form. Based on the number of receptors and
the receptor coordinate unit selected in the General Information Data Entry Form, the program
automatically provides the total number of receptors, the number of receptors to be entered, the
receptor number labels, and the default receptor height. If the receptor coordinate unit is set to
feet (i.e., the selected Scale Conversion Factor is 0.3048), the default receptor height is
automatically set to 6.0 feet. Otherwise, the default receptor height is set to 1.8 meters.
The grayed-out receptor number column on the left side of the form is intended to assist users in
keeping track of the receptor number. It is not part of the CAL3QHC input file. If the user
wants to have numbers associated with the receptors, the numbers should be entered in the
receptor name column. The receptor fields are defined as follows:
• Receptor name – 20 characters or less; no single or double quote
• X-coordinate – numeric number in unit consistent with the Scale Conversion Factor
• Y-coordinate – numeric number in unit consistent with the Scale Conversion Factor
• Receptor height – numeric number in meters or feet set by ROADMAP
10
ROADMAP Program Version 2.0
Figure 3. Receptor Information Entry Form (with sample data).
A maximum of 20 receptors can be entered on each form. If more than 20 receptors exist, an
additional form will be provided for the remaining receptors after clicking the Continue button
(Figure 4). Additional forms will be provided until all of the receptors have been entered. Click
the Continue button after entering all of the receptors.
11
ROADMAP Program Version 2.0
Figure 4. Additional Receptor Information Entry Form as needed (with sample data).
Link Information Entry Form
After the receptor data entry is completed, a Link Information Entry Form is opened (Figure 5).
Several notes are provided at the bottom of the form regarding data entries for free flow and
queue links. A reminder block is also provided showing the total number of links and the
remaining number of links that need to be entered on the form. Each Link Data Entry Form
allows up to 10 link entries. If more than 10 links exist, additional forms will be provided. Click
the Continue button after entering all of the links.
The fields in the Link Information Entry Form are defined as follows:
• Free or Queue – vehicle flow type indicator; select either the Free or Queue option using
the pull-down menu
• Link name – link description with no more than 20 characters; no single or double quote
• Link type – road type description; use “AG” for at-grade, “FL” for fill, “BR” for bridge,
or “DP” for depressed road
12
ROADMAP Program Version 2.0
• (X1,Y1) coordinates – numeric numbers in units consistent with the Scale Conversion
Factor; if the link is a queue link, the (X1, Y1) coordinates should be located where
queuing starts
• (X2, Y2) coordinates – numeric numbers in units consistent with the Scale Conversion
Factor
• Traffic volume – numeric number in vehicles per hour
• Emission factor – numeric number in g/veh-mi for free flow links or g/veh-hr for queue
links
• Source height – numeric number in unit consistent with the Scale Conversion Factor; use
“0” in most cases for autos and a representative nonzero value when other types of
vehicles alone are being considered
• Mixing zone (width) – numeric number in unit consistent with the Scale Conversion
Factor; for free flow links, the mixing zone width is the sum of the width of the travel
lane(s) plus 10 ft (3 m) on both sides of the travel lane(s); for queue links, the mixing
zone width is the width of the travel lane(s) only
If the link is free flow, no further data entry is necessary beyond the mixing zone column. For
queue links, the following additional information is needed:
• Number of lanes – integer number
• Signal cycle – integer number in seconds representing the average total signal cycle
length
• Red time – integer number in seconds representing the average red-light time for a given
approach
• Clearance lost time – integer number in seconds representing the portion of the yellow-
light phase that is not used by the motorist
• Saturation flow rate – integer number in veh/hr/lane; the default value is 1600 veh/hr/lane
• Signal type – integer number; select “1” for pre-timed, “2” for actuated, or “3” for semi-
actuated
• Arrival rate – integer number; select “1” for worst progression, “2” for below average
progression, “3” for average progression, “4” for above average progression, or “5” for
best progression
13
ROADMAP Program Version 2.0
Figure 5. Link Information Entry Form (with sample data).
14
ROADMAP Program Version 2.0
Figure 6. Additional Link Information Entry Form as needed (with sample data).
15
ROADMAP Program Version 2.0
Save Data Form
After entering the data, the user will be prompted to save the data to a file. Users should assign a
meaningful file name. It is recommended that the file name contain an extension of .txt,
indicating that the file is a text file. After entering the file name, click the Save button to save
the data.
After the data are saved, the information is displayed graphically.
Path and
file name
Figure 7. Save Data Form (with sample path and file name).
File Open Submenu
Depending on the release date, the CAL3QHC dispersion model requires either formatted or
unformatted model inputs. The CAL3QHC model released by EPA after September 1995 uses
“unformatted” input files, while the pre-1995 version of CAL3QHC requires formatted model
inputs. To facilitate both formatted and unformatted input files, this Windows-based version of
ROADMAP recognizes both types of input files through an internal file checking algorithm.
This functionality is transparent to the user and is a useful new feature.
To open an existing CAL3QHC input file, select Open under the File menu. The user will be
prompted with a Load Data form. Like any other Windows application, users need to navigate to
the folder where the CAL3QHC input file is located. Once the input file is selected, it is
displayed graphically (Figure 8).
The graphic display includes a general information section, which provides the file name and the
symbols associated with receptors, free flow links, queue links, and receptors within mixing
zones, if any. The main graphic display section shows the receptor numbers and locations in
either blue or red, free flow links in green, and queue links in red. The receptors are plotted with
a blue solid dot unless they are located within the mixing zone of free flow and/or queue links.
16
ROADMAP Program Version 2.0
Figure 8. Graphic display of a CAL3QHC input file (with sample receptors and links).
The ROADMAP program contains a highly sophisticated mathematical algorithm that
determines all of the receptor-link distances. ROADMAP checks the shortest distances between
the receptors and links and determines if any receptors are within the mixing zone of a link or
links. If a receptor is located within a mixing zone of a link, it will be plotted and labeled in red.
Exit Submenu
To exit the ROADMAP program, select Exit from the File menu or click in the upper right
corner. This will terminate the program.
17
ROADMAP Program Version 2.0
Run Menu
The Run menu allows users to run the CAL3QHC dispersion model. This menu contains only
one submenu, CAL3QHC. The CAL3QHC submenu is grayed-out unless an input file is
opened or a new input file is created.
CAL3QHC Submenu
To run the CAL3QHC dispersion model for a selected input file or a newly-created input file
select the CAL3QHC submenu. This will execute the CAL3QHC dispersion model. Depending
on the complexity of the input file, the model run will take a few seconds or more. Once the
model run is completed, the maximum 1-hour concentrations for all of the receptors will be
displayed at the respective receptor locations (Figure 9). These concentration values are
displayed in pink next to the receptor number label.
Maximum 1-hour
concentration at the
given receptor
Figure 9. Maximum pollutant concentration at each receptor after running CAL3QHC (with
sample concentrations).
18
ROADMAP Program Version 2.0
View Menu
The View menu contains three submenus: Full, Zoom, and Receptors in Mixing Zone (Figure
10). These three submenus are not activated until a file is created or opened. If there are no
receptors within the mixing zone, the third submenu will remain grayed-out.
Figure 10. View menu and submenus.
Full Submenu
The Full submenu allows users to return to the full extent of the graphic display. To view all of
the roadway links and receptors, click the Full submenu and the graphic display will return to the
full extent possible.
Zoom Submenu
19
ROADMAP Program Version 2.0
To zoom to an area on the plot, select the Zoom submenu under View. Move the mouse to the
starting point of the zoom area, press and hold down the left mouse button, drag the mouse to the
desired position, and release the mouse button. While dragging the mouse on the screen, a
rectangular area with colored borders will be displayed showing the zoom area (Figure 11).
Users can repeat the zoom process as many times as desired until another menu is selected. To
return to the full layout view, select the Full submenu.
Zoom area
Figure 11. Zoom to specific area (with sample receptors).
Receptors in Mixing Zone Submenu
If any receptors in the input file are within the mixing zone of a link or links, an additional
legend will appear in the upper left corner of the display, indicating “Receptor within mixing
zone.” Receptors within the mixing zone of one or more links are displayed in red. In this
situation, the Receptors in Mixing Zone option under the View menu is activated. When this
option is selected, a new window is opened, showing a list of receptors within the mixing zones
and the corresponding links. Modelers can use this feature to move the receptors outside of the
mixing zones as described in the CAL3QHC modeling guide.
20
ROADMAP Program Version 2.0
Figure 12 shows a number of sample receptors located within the mixing zones of sample links
2, 6, 9, 24, and 40. In this example, the modeler would need to relocate these receptors outside
of the mixing zones.
Figure 12. Receptors Inside Mixing Zone Window (with sample data).
21
ROADMAP Program Version 2.0
Printing
Due to the limitations of the Winteracter Starter Kit that was used in the development of this
ROADMAP program, a menu-driven print option is not available at this time. However, users
may still print graphic displays.
To print a graphic display, press the Print Screen key on the keyboard. This will transfer the
contents of the screen to a clipboard. Users can paste the contents to applications such as
Microsoft Word, PowerPoint, Paint, etc. Once the ROADMAP display is in one of these
applications, users can print the display using the print function of the application. The screen
shots throughout this document were created in this manner.
22
