ROADMAP Program Version 2.0 User’s ManualROADMAP Program Version 2.0 1 Table of Contents Disclaimer ... real cm 175 Select a value from the list Settling velocity real cm/s 0.0 ≥

New York State

Department of Transportation

ROADMAP Program Version 2.0

User’s Manual

Prepared by: Shengxin Jin Environmental Analysis Bureau September 2006


1

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


2

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.


3

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: [email protected]


4

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.


5

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.


6

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.


7

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.


8

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.


9

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 receptors

integer N/A none ≤ 60

Surface roughness height

real cm 175 Select a value from the list

Settling velocity real cm/s 0.0 ≥ 0.0 Deposition velocity real cm/s 0.0 ≥ 0.0 Scale conversion factor

real N/A 0.3048 select 0.3048 for input in 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 Meteorological Condition

integer N/A 1 no change allowed

Output format integer N/A 1 select 0 for short format or 1 for long format


10

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 concentration

real ppm or µg/m3

0.0 enter 1-hour CO or PM background concentration if needed

Variable wind directions

character N/A Y select Y for variable wind directions or N for a single wind direction

Wind direction increment angle

integer degree 5 use default value or enter a desired increment

First increment multiplier

integer N/A 0 use default value or enter a value to define the lower boundary of the wind angle

Last increment multiplier

integer N/A 71 use default value or enter a 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


11

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.


12

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


13

• (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


14

Figure 5. Link Information Entry Form (with sample data).


15

Figure 6. Additional Link Information Entry Form as needed (with sample data).


16

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.

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.

Path and file name


17

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.


18

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.

Figure 9. Maximum pollutant concentration at each receptor after running CAL3QHC (with sample concentrations).

Maximum 1-hour concentration at the given receptor


19

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


20

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.

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.

Zoom area


21

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).


22

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.

Documents

ROADMAP Program Version 2.0 User’s ManualROADMAP Program Version 2.0 1 Table of Contents Disclaimer ... real cm 175 Select a value from the list Settling velocity real cm/s 0.0 ≥