United State*
Environmental
Protection
Agency
Office of Air Quality
Planning and Standards
Research Triangle Park, NC 27711
EPA-450/4-90-007F
November 1991
AIR
»E PA USER'S GUIDE FOR THE
URBAN AIRSHED MODEL
Volume VI: User's Manual for the
Postprocessing System
-------
EPA-450/4-90-007F
USER'S GUIDE FOR THE
URBAN AIRSHED MODEL
Volume VI: User's Manual for the Postprocessing System
fls
\
»7l(OI01IOIIC2ICilC' 9
It 87 8« SI i; I' 1SKOIO! 99 9! <7 9
I! 19 Si 91 9! I! 9! tt I; H 9( 91
!1 !' 9.' 95 95 94 U ii 9< 91 !9 !'
by
Art Alexander
Vincent DelGobbo
Beverly Goodrich
Christine Maxwell
U.S. Environmental Protection Agency
Region 5, Library (PL-12J)
77 West Jackson Boulevard, 12th Floor
Chicago, IL 60604-3590
Computer Sciences Corporation
Research Triangle Park, NC 27709
EPA Project Officer:
Ellen Baldridge
OFFICE OF AIR QUALITY PLANNING AND STANDARDS
U.S. ENVIRONMENTAL PROTECTION AGENCY
RESEARCH TRIANGLE PARK, NC 27711
NOVEMBER 1991
-------
NOTICE
The information in this document has been funded wholly or in part by the U.S. Environmental
Protection Agency (EPA) under contract 68-01-7365 to Computer Sciences Corporation. It has been
subjected to the Agency's review, and it has been approved for publication as an EPA document. Mention of
trade names or commercial products does not constitute endorsement or recommendation for use.
-------
PREFACE
This user's guide for the Urban Airshed Model (UAM) is divided into six volumes as follows:
Volume I«User's Manual for UAM(CB-IV)
Volume II--User's Manual for the UAM(CB-IV) Modeling System (Preprocessors)
Volume Ill-User's Manual for the Diagnostic Wind Model
Volume IV--User's Manual for the Emissions Processor System
Volume V--Description and Operation of the ROM-UAM Interface Program System
Volume VI--User's Manual for the Postprocessing System
Volume I provides historical background on the model and describes in general the scientific basis for
the model. For those users that already possess a UAM modeling database or have prepared inputs without
the use of the standard UAM preprocessors, this volume should serve as a self-sufficient guide to running the
model.
Volume II describes the file formats and software for each of the standard UAM preprocessors that
are part of the UAM modeling system. Included in this volume is an example problem that illustrates how
inputs were created from measurement data for an application of the UAM in Atlanta.
Volume III is the user's manual for the Diagnostic Wind Model (DWM). This model is a stand-alone
interpolative wind model that uses surface- and upper-level wind observations at selected sites within the
modeling domain of interest to provide hourly, gridded, three-dimensional estimates of winds using objective
techniques. It provides one means of formulating wind Melds to the UAM.
Volume IV describes in detail the Emissions Processor System (EPS). This software package is used
to process anthropogenic area and point source emissions for the UAM. An appendix to this volume
describes the Biogenic Emissions Inventory System (BEIS), which can be used to generate gridded, speciated
biogenic emissions. Software for merging the anthropogenic area, mobile, and biogenic emissions files into
UAM input format is also described in this volume.
Volume V describes the ROM-UAM interface program system, a software package that can be used
to generate UAM input files from inputs and outputs provided by the EPA Regional Oxidant Model
(ROM).
111
-------
Volume VI is the user's manual for the Postprocessing System (PPS). The UAM Postprocessing
System (UAMPPS) is a data display and analysis tool for evaluating emission control strategies. After
executing the UAM system, the results from one or more model runs may be graphically compared. The
UAMPPS creates time-series plots, tile maps, bar charts, box plots, scatter plots, and quantile plots.
Through a series of menus, the user has a wide range of flexibility in scaling and labelling the graphs.
IV
-------
ACKNOWLEDGMENTS
This manual (Volume VI) and the software it describes were written and developed for the U.S.
Environmental Protection Agency by the following individuals of Computer Sciences Corporation: Art
Alexander, Vincent DelGobbo, Beverly Goodrich, and Christine Maxwell.
Several U.S. Environmental Protection Agency employees reviewed drafts of this document and made
helpful suggestions. They include Project Officer Ellen Baldridge, Bill Cox, and Ned Meyer, all of the Office
of Air Quality Planning and Standards.
-------
CONTENTS
Preface iii
Acknowledgements v
Figures ix
Tables ix
1. INTRODUCTION 1
2. OVERVIEW 3
2.1 Data Extraction 3
2.2 Graphics Creation 4
3. NAVIGATING THROUGH THE UAMPPS 13
3.1 Starting the System 13
3.2 Extract Module 13
3.3 Graphics Module 14
3.4 Interacting with Screens 14
3.4.1 Using Menus 14
3.4.2 Colors on Input Screens 16
3.4.3 PFKeys 16
3.4.4 Error Messages 17
3.4.5 Error Correction 17
3.4.6 Selection Fields and Selection Lists 17
3.4.7 Protected Fields 18
3.4.8 Scrolling 18
3.4.9 Field Values Saved and Recalled 18
3.4.10 On-line Help 18
4. SCREEN REFERENCE 19
4.1 Data Extraction 22
4.2 Graphics Creation 31
4.2.1 Statistical Graphics 31
4.2.2 Temporal Graphics 31
4.2.3 Spatial Graphics 31
4.3 Graphics Catalog 83
5. SYSTEM INPUT 87
vii
-------
CONTENTS (concluded)
6. SYSTEM OUTPUT 89
6.1 Format 89
6.2 SAS Graphics Catalog 90
Appendix: A. UAM Output File Format A-l
B. Extracted SAS Data Set Format B-l
C. Extracted Text File Format C-l
Vlll
-------
FIGURES
Number Page
3-1 Extract module menu sequence 13
3-2 Graphics module menu sequence 15
TABLES
jumber Page
2-1 Graphics supported by the UAMPPS 4
3-1 PF-key functions for UAMPPS menus 16
4-1 Sequencing of screens 21
4-2 Definition of the UAM (CB-IV) state species 22
A-l Average concentration file header record definitions A-2
A-2 Average concentration file data record definitions A-3
A-3 Boundary file header record definitions A-4
A-4 Boundary file data record definitions A-5
B-l Fields in SAS-format species/vertical level extraction files of model
concentration data B-2
B-2 Fields in SAS-format header extraction files of model concentration data B-3
C-l Fields in extracted text-format files C-2
IX
-------
1. INTRODUCTION
SECTION 1
INTRODUCTION
The Urban Airshed Model Postprocessing System (UAMPPS) User's Guide is provided as an aid for
those interested in using the system for policy analysis and model control strategy evaluation. This user's
guide is designed to provide assistance on how to effectively navigate through the menu system and how to
respond to the menus. Although some file-format information is provided for the more sophisticated user,
there is no other programming or system-level information in this document.
The UAMPPS is an interactive screen-driven system that provides the user with a variety of visual
tools for evaluation and analysis of Urban Airshed Model (UAM) predictions. Specific UAMPPS features
are discussed in more detail in later sections of this user's guide. The UAM is a three-dimensional Eulerian
model which simulates chemical and physical processes that take place in the atmosphere and provides
information on concentrations of reactive and inert air pollutants. The model is intended for simulation of
dynamics within relatively local urban environments, compared with other models that are intended for
more regional or global extents. The model provides support for development of emission control
strategies, estimation of air quality in areas for which data are unavailable, and planning for control of air
pollution episodes.
The UAMPPS operates on the U.S. Environmental Protection Agency (EPA) National Computer
Center (NCC) IBM mainframe under MVS/XAwith Time Sharing Option (TSO). Limited CLISTs and
TSO-specific commands are used, but should be of little concern to the user. The current version of the
UAMPPS operates in a SAS Version 6.06 environment utilizing the SAS/AF software to drive base SAS and
SAS/GRAPH software.
The user's guide is organized as follows: Section 2, Overview, provides a description of the
organization and capabilities of the UAMPPS. Section 3, Navigating Through the UAMPPS, provides a
guide to using the UAMPPS. Section 4, Screen Reference, provides a description of the user-interface,
including a description of each screen. The screen descriptions are provided in the order that they are
presented. In addition to the descriptions, example responses have been provided. By presenting the screen
-------
1. INTRODUCTION
descriptions in this fashion, Section 4 also serves as a tutorial for using the system. Section 5, System Input,
provides an overview of the nature of the UAM output which serve as input to the system. Finally,
Section 6, System Output, describes the various output products from the UAMPPS.
-------
2. OVERVIEW
SECTION 2
OVERVIEW
The ability to utilize a model is only as effective as the techniques available for interpreting the model
results. Model output is commonly analyzed from one of three perspectives; change over time, comparison
between specific (or groups of) observations, or interpretation of the collective (entire domain) results. To
aid in the interpretation of model output, graphics are frequently used to visualize relationships from each
of these perspectives. In fact, it is often easier to express a relationship in terms of how it might appear on a
chart or map than it is to determine exactly the right quantitative question to be asked. For this reason, the
UAMPPS has been designed to assist the scientist or analyst in interpreting model results by providing an
interactive application for building graphics. The graphic tools provided in the UAMPPS were selected
based on the EPA Office of Air Quality Planning and Standards' (OAQPS) experience with the Regional
Oxidant Model (ROM) and informal polls of the potential user community.
The UAMPPS consists of two modules, which provide capabilities for data extraction and graphics
creation. The data extraction module provides the capability to organize UAM predicted data, based on
species and level. The graphics module provides the user with tools to create a variety of graphics from the
extracted data. Both of these modules are discussed in greater detail below.
2.1 DATA EXTRACTION
A large volume of information is generated from a single execution of the UAM. All 24 species, a
variable number of levels, hourly concentrations, and descriptive information about the model run are
contained in one file. Processing this file each time a graphic is created would result in lengthy work sessions
with large amounts of idle time spent waiting for the entire model file to be scanned for the requested data
for each graphic. Also, time-sharing and connect-time resource costs might be prohibitive to producing the
number and types of analyses required.
-------
2. OVERVIEW
The Extract module of the UAMPPS provides the capability for subsetting the model results based on
species and level. In addition, the extraction process transforms the data from a gridded binary format to
either a SAS-formatted data file used in the UAMPPS or a generic text file that can be imported into other
graphics packages. The resulting files are named according to species, level, control strategy, and date, and
thus provide a default method of organizing commonly used data.
2.2 GRAPHICS CREATION
The main goal of the UAMPPS is to provide a tool for creating graphics to assist in model analysis
and policy decision support. The Graphics module provides a variety of statistical, temporal, and spatial
graphics to achieve this goal. Table 2-1 below includes a list of graphics supported by the UAMPPS.
TABLE 2-1. GRAPHICS SUPPORTED BY THE UAMPPS
Statistical
Temporal
Spatial
Bar charts
Box plots
Scatter plots
Quantile plots
Shaded temporal plots (two-line time series)
Temporal line plots (multiline time-series)
Shaded tile maps
Gridded value maps
Statistical graphics, which usually portray information outside the context of time or location, are very
useful for immediate quantitative comparisons of observations. Temporal graphics provide a technique for
portraying change in model results over time. Spatial graphics ignore the temporal aspect of the data but
provide information on locational relationships. The following pages illustrate examples of the supported
graphics, along with the types of information that may be displayed with each type of graphic.
Graphics created by the UAMPPS may be viewed on a graphics terminal as they are created and
optionally saved in a SAS graphics library. This feature is useful for creating hard-copy output and for
composing graphics with multiple plots on a single page. Section 6.2 discusses graphics libraries in more
detail.
-------
2. OVERVIEW
Bar Charts
CELLS WITH 03 FOR LEVEL 1 OVER 1HE THRESHOLD
• 1*
57* 58;:
BASE1 CTRM CTRL2 CTRL3 CTRL4 CTRL5 CTRL6 CTRL?
Example bar chart.
Bar charts provide a quick look at how several control strategies (up to 10) compare with each other.
The height of the bars is proportional to the value of the theme.
Themes:
Number of grid cells with concentrations above given threshold between given start and stop
times
Average concentration for a given hour for the domain
Maximum concentration for a given hour for the domain
-------
2. OVERVIEW
Box Plots
CONCENTRATION PROFILES FOR 03 FOR LFVEL
BETWEEN THE HOURS OF 1 AND 24
15 16 17 18 19 20 21 22 23 24
!OUR OF DAY
Example box plot.
The box plot provides information about the spread in the concentration values at each hour for a
range of hours. The range, median, and average as well as percentile information is provided for each hour.
Themes:
Concentration percentiles for each hour between a given start and stop time across all grid cells
-------
2. OVERVIEW
Scatter Plots
MAXIMUM 03 CONCENTRAT ION FOR LEVEL
BETWEEN THE HOURS OF 1 AND 24
40 60 80 100 120
iOUROL CONCENTRATION (PPB)
40
Example scatter plot.
The scatter plot provides a comparison of two control strategies with paired data. A single point
references a given hour or grid cell for both strategies. The position of the point in relation to the two axes
compares the concentration values of each strategy at a given hour or grid cell.
Themes:
Maximum concentrations over all grid cells at each hour
Maximum concentrations over all hours at each grid cell
-------
2. OVERVIEW
Quantile Plots
MAXIMUM 03 CONCENTRATION FOR LEVEL
BETWEEN THE HOURS OE 1 AND 24
C 20 40 60 80 100 120 14
CONTROL CONCENTRATION (PPB)
Example quantile plot.
The quantile plot, which also provides a comparison of two control strategies, is a scatter plot with
deciles annotated. The data for each control strategy are independently rank ordered-from highest to
lowest values. Minimum, maximum, and decile values are annotated as filled circles; intermediate values
are plotted as empty circles.
Themes:
Maximum concentrations over all grid cells at each hour
• Maximum concentrations over all hours at each grid cell
8
-------
2. OVERVIEW
Shaded Temporal Plots
MAXIMUM 03 CONCENTRATION EOR LEVEL
BETWEEN THE HOURS OE 1 AND 24
140 -
12(H
100
2 3 4 5 f
i i i i i i i i i i i i i i i r
9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 2<
HOUR
> CNTL
BASE < CNTL
Example shaded temporal plot.
The shaded temporal plot is used to accentuate the difference between two time-series plots--
highlighting with color or pattern, the areas where the plots are different. Usually, these plots consist of one
dominant line and one subordinate line; highlighting is then used to indicated where the subordinate line is
greater or less than the dominant line.
Themes:
Domain maximum or average concentration for each hour of a given range of hours
-------
2. OVERVIEW
Temporal Line Plots
MAXIMUM 03 CONCENTRATION FOR LEVEL 1
BETWEEN THE HOURS OF 1 AND 24
200 -\
180:
60 :
I2C :
8G-J
1
E!H
L1F88
L2B88 L3B88 L4B88
Example temporal line plot.
The temporal line plot is used to accentuate the differences between time-series plots (for up to 10
time-series plots). The temporal line plot allows comparisons of a variety of control strategies
simultaneously. Lines may be displayed in different colors or in different line patterns.
Themes:
Domain maximum or average concentration for each hour of a given range of hours
10
-------
2. OVERVIEW
Shaded TileMan-
AVERAGE 03VALUESFORLEVEL1 FOR NEW YORK
11JUL88, BETWEEN THE TOURS Of 1 AND 24
10C
Example shaded tile map.
Shaded tile maps are choropleth maps; the grid cells of the model are the symbolized areas. Colors or
patterns are assigned to ranges of values (class breaks), usually corresponding to an ascending or descending
continuous scale. With the appropriate choice of color or pattern, spatial relationships in the data are
readily apparent. Actual cell values are not shown, however this type of graphic is more useful for a
qualitative interpretation of the data. Note that because the choice of class breaks is made b\ the author of
the graphic, subjectivity can be introduced.
Themes:
Concentrations for all grid cells for a given hour
Concentrations for all grid cells averaged over a range of hours
Maximum hourly concentration for a given range of hours for each grid cell
Hour of occurrence of maximum concentration for a given range of hours for each grid cell
• Concentration differences for all grid cells for a given hour for two extracted files
Concentration percent differences for all grid cells for a given hour for two extracted files
Maximum concentration differences for all grid cells for a given hour for two extracted files
11
-------
2. OVERVIEW
Gridded Value Maps
CONCENTRATION FOR LEVEL 1 AT HOUR
OMNYMAP JULY 11,1!
wr
^52 52 52 52 54
52 53 55
53 5/53 55 57
54/3 54 56 51
55 5X56 5» (1
57 57 5\i>^4_
59 59/1 64 65
5T1T64 66 19
64 64 66 6! 71
4 73"
J3 73(703
72 QjQ STT}
73 Ti,
91 91 \"i
i 65 68 7&L?1-7I 70 70 70 .Jl 74 76 ri~ft 71 79
i 70 7J 74 7^75 75 76 75 E7 10 1} {4 85 15 85
72 75 76 17 71 71 60 10 ti 14 16 17\86 8! 89
74 77 79 Ul 12 13 14 15 IR 19 90J+TS2 SI 91
75 78 81 J3 86 J7 HISJO^ i/«
77 IBU-'itJjiS SO^TTiliJriS »7 18 99
_79_8j«6 «8 «Vsil92 ti 15 tTIB » 99100
fO 84 87 89 »2 »<{9LH100lflUOtlOOIflOIOIIOO
) 83U 89 92 15 97lODmt03ID%02t01IOt|l»,
81 «\J 96 98IOI103inj03Jiy
' 90 93 /6J*WrtffIo^7o7roTl01 99 98 97
I 92 K^99tOOIOI10n01IOII0110>^(r98 97 96
'iSIOl 99 99 99 99 99 »9J4J^99
Lj899jfr^siiroi!noTim{6^«'ic6io>rf4io3io;
flTT? 96 98100103104I06J^^>^IO/106105IO:
1 91 93 95 9IIOH|14Jt^)#Wl08l08lOn06l04l02
87 9USJj»frfjimTo*5l86107l07l06l05102101 56
,92^-»f7ei 103105105105104102100 98 96 9!
94 )7IOOIOI102I02I02I01 99 97 95 9! SI 87
i »! 95 97 99160100 99 98 97 94 93 90 87 85 8'
94 96 )7 )! 98 97 96 94 92 89 86 84 81 79 76
i 95 95 96 96 95 94 92 89 87 84 82 79 77 71 73
Example gridded value map.
Gridded value maps place the actual grid cell value at the appropriate geographic location on the
graphic. This allows actual model output to be quickly referenced against a background of political or
enumeration boundaries. Because the value is shown in each grid cell, the interpretation of the model
output is left to the viewer, rather than the author.
A variation of the gridded value map is the color gridded tile map in which the values are actually
plotted in color as they are displayed on the screen or plotted to a hard-copy device. In addition to retaining
the information of the value, class breaks and colors may be chosen to help illustrate general trends. This
type of graphic might be especially appropriate for audiences of mixed technical expertise.
Themes:
• Concentrations for all grid cells for a given hour
• Concentrations for all grid cells averaged over a range of hours
Maximum hourly concentration for a given range of hours for each grid cell
Hour of occurrence of maximum concentration for a given range of hours for each grid cell
• Concentration differences for all grid cells for a given hour for two extracted files
• Concentration percent differences for all grid cells for a given hour for two extracted files
Maximum concentration differences for all grid cells for a given hour for two extracted files
12
-------
3. NAVIGATING
SECTION 3
NAVIGATING THROUGH THE UAMPPS
This section provides an overview of how to use the UAMPPS. Basic information on starting the
system and on the menu sequence is covered. In addition, a discussion of common screen features is
presented.
3.1 STARTING THE SYSTEM
The system is started by executing the UAMPPS CLIST from the TSO prompt. Type "UAMPPS" at
the TSO prompt and press [Enter ). There will be a short pause while the UAMPPS main menu is loaded.
From the main menu, you can enter the Extract module, enter the Graphics module, go directly to the
graphics catalog, access on-line help, or exit to TSO. Simply tab the cursor to the desired position option
and press f Enter ).
3.2 EXTRACT MODULE
Figure 3-1 illustrates the order in which the screens of the Extract module will be presented to you.
These screens are always presented in the same order and are accessed sequentially. At any time within the
Extract module, you may press
the main menu.
to move to the previous screen or press [ PF4/PF16 ) to jump to
UAMPPS EXTRACT MODULE STARTUP
TERMINATION SELECTION
EXTRACT DATA RLE
SPECIES/LEVEL DATA EXTRACTION
FILE SELECTION
(LEFT)
SPATIAL DESCRIPTION OF DOMAIN
<«GHT)
Figure 3-1. Extract module menu sequence.
13
-------
3. NAVIGATING
After an extraction has been completed, you will be presented with the Termination Selection Screen,
where you can choose to exit the Extract module or perform another extraction. Exiting the Extract module
will return you to the UAMPPS main menu.
3.3 GRAPHICS MODULE
The sequence in which the screens of the Graphics module are presented is shown in Figure 3-2. The
screens that you will see are based on your selection of graphic type on the Graphic Selection Screen.
Choosing "1" will display the screens associated with the generation of statistical graphics; selecting
"2" or "3" causes the temporal and spatial graphics generation screens to be presented, respectively. At any
time within the Graphics module, you may press rpra/PFis") to move to the previous screen or press
(PF4/PF16 ] to jump to the main menu.
After a graphic has been generated, you will be presented with the Termination Selection Screen,
where you can choose to return to the main menu, save the graphic, or generate another graphic. From the
main menu, you may exit the system and return to the TSO prompt by placing the cursor on the exit block
and pressing [Enter! If at any time you wish to exit the Graphics module, press (PF4/PFi6~| to return to the
main menu.
If you choose to save the graphic that you generated, the Graphics Catalog Generation Screen will be
displayed. The only time this screen will be displayed is when you select the option on the Termination
Selection Screen to save the graphic. After filling out the requested information, the graphic is saved and
the Termination Selection Screen is redisplayed.
3.4 INTERACTING WITH SCREENS
The information presented in this subsection is generic across all or most screens. There may be
some departures from this description depending on the type of terminal available.
3,4.1 Using Menus
Each menu that appears on your terminal screen prompts you for certain information. Press [Tat>] to
move the cursor to the data entry fields. After you have supplied the requested information, press [Enter ] to
process the panel. If a screen consists of more than one page, you can use HPFZO] and [prig] to move
forward and backward between the screens. The menu program checks the information that you have
entered for errors and inconsistencies and reports any problems it finds. Correct any problems and again
press [Enter] and the next menu will appear.
To override any defaults, type over the field and eliminate any extraneous characters by using either
the ( Space bar ] or the [Erase EO?"lor [PEL]
14
-------
3. NAVIGATING
GRAPHIC SELECTION
GRAPHICS CATALOG GENERATION
(OPTIONAL)
TEfMNATKM SELECTION
VALUE CALCULATION MESSAGE
GRAPHIC THLE/OESCWTON SPECIFICATION
SPATIAL PLOT PATTERN SELECTION
CITIES LOCATED WITHIN DOMAIN
DATA SET SELECTION
(SINGLE OR TWO)
SPATIAL GRAPHIC SELECTION
JLEFT)
STATISTICAL COMPOSITION OF DATA
(RIGHT)
GRAPHICS CATALOG GENERATION
(OPTIONAL)
TERM NATION SELECTION
AXIS SCALING
VALUE CALCULATION MESSAGE
GRAPHIC TrrLE/OESCRIPTION SPECIFICATION
DATA SET SELECTION
TEMPORAL GRAPHIC SELECTION
GRAPHICS CATALOG GENERATION
(OPTIONAL)
TERMINATION SELECTION
AXIS SCALING
VALUE CALCULATION MESSAGE
GRAPHIC TrrLE/DESCRIPTION SPECIFICATION
DATA SET SELECTION
(SINGLE OR MULTIPLE)
STATISTICAL GRAPHIC SELECTION
Figure 3-2. Graphics module menu sequence.
15
-------
3. NAVIGATING
3.4.2 Colors on Input Screens
If you are using a terminal that supports IBM color graphics, you may notice that different types of
information are displayed on the screens in different colors.
The text describing a given field is displayed in cyan.
If the field is protected (i.e., it is not intended to be updated but is merely designed to supply
information to you), the color of the field will be pink.
• Fields that require a response from you are displayed in green.
System error or informational messages are displayed in red.
• If invalid data is input to a field and the program detects the error, the field will be displayed in
red and reverse video.
If a monochrome terminal is used, no colors will be observed. However, if an error is detected, the
terminal will most likely display the field in reverse video.
3.4.3 PFKe\s
Table 3-1 lists the standard PF-key functions. The CANCEL function-Si} or [PFIS] , denoted
herein as [ PFS/PFIS )-js available on every menu. It lets you return to a previous menu or exit from the
UAMPPS without producing a graph. The ABORT function-(HI) or (MH), denoted as rpF4/pFi6]..js
available on every menu except the main menu. It is a quick way to abandon a graphics request and return to
the UAMPPS main menu. The scroll functions (BACKWARD, FORWARD) are meaningful only on
menus displaying an item list that does not completely fit on one screen.
TABLE 3-1. PF-KEY FUNCTIONS FOR UAMPPS MENUS
PFKey
Command
Assigned Function
PF1 orPF13a
PF3 or PFlfa
PF4 or PFl6a
PF7 or PF19b
PF8 or PF20b
HELP
CANCEL
ABORT
BACKWARD
FORWARD
Provides context-sensitive information on how to proceed or
indicates what information is required.
Terminates the current menu without taking any action and
return to the previous menu.
Terminates the current menu without taking any action and
returns to the UAMPPS main menu.
Scrolls toward the beginning of a list of items.
Scrolls toward the end of a list of items.
a These PF Keys are available on all menus except the main menu.
b These PF Keys are available on menus that contain a list that is too long to fit on one screen.
16
-------
3. NAVIGATING
3.4.4 Error Messages
All UAMPPS menus have error windows that will notify you if something is wrong. After a menu
program detects a field error, a window will open with a message after you press [Enter). In addition to the
error message relating to a particular screen field, the message window will instruct you to press IPFIS] to
continue. After you have read the message and have pressed fPfis], the window will close and the field that
is in error will be highlighted (red on color terminals) to make it stand out. The cursor will be placed on the
appropriate field for easy data correction.
3.4.5 Error Correction
Fill-in-the-blank fields associated with an error are highlighted (red on color terminals). If there are
multiple errors, the error message describes only the first one and the cursor is positioned on that field. You
should change that field to eliminate the error. If you determine that there are other fields in error, it is
most efficient to change them also, before you press i En tea-1. If you are not sure whether or not more fields
are in error, correct the field for which the error message applies and press [Enter). If there is an additional
error, an error message applicable to the next highlighted field will then appear, and you can correct it. In
some instances, an error condition involves two or more fields and you may need to decide which of them is
the "culprit" (i.e., the one causing the error).
3.4.6 Selection Fields and Selection Lists
Some menus display a table of values for you to choose from. Press LTato] to move the cursor from
one selection field to the next. Enter an "S" in any field that you want to select. The list of values may be
more than one screen long. If so, scroll down the list by pressing [PFZO] or up the list by pressing [PFIQ] .
you wish to change a selection, simply press f space bar ] or [pel] to remove the "S" from a field. After you
are finished selecting items from the list, press [ PFS/PFIS! to move to the next menu.
Some menus contain fields that are linked to a list of valid values from which one value may be
chosen for that field. Whenever these "Selection Lists" are available for a field, the menu will inform you of
the list's existence and instruct you to enter a"?" in the field and press (Enter] to display the list. A list
window will open on top of the current menu and the cursor will be placed on the first item in the list. Press
[Tab] to move down the visible list; press [PFigJor [PFao] to scroll up or down a list that is longer than one
window. Press [Enter] to close the list window and transfer the list value that is under the cursor to the
related screen field. Once the list value is transferred to the related screen field, it may be necessary to press
[Enter] once more to process the menu selections and move on to the next menu in the sequence.
If
17
-------
3. NAVIGATING
3.4.7 Protected Fields
Sections of tfee screen (skipped over when you press fTat>]) are protected; you cannot alter them. If
you move the cursor with cursor-movement keys to a protected area on the screen and attempt to enter data,
the terminal keyboard locks and you must press (React! to regain use of it. Menu titles, instructions, and
"white space" are examples of protected areas. Sometimes an area of a menu that looks like a fill-in-the-
blank field with an initial value is instead a protected field. If the menu program determines that only one
value is valid for the field, the computer "fills in" that value for you and makes the field protected. If you can
tab the cursor to a field, it has an initial value that can be changed. If you cannot tab to it, the field is
protected.
3.4.8 Scrolling
Some menus have a list of items to choose from. If the entire list does not fit on the screen, you can
scroll to see more items. Imagine that part of the menu is a window through which you see the list of items.
Scrolling forward is like sliding the window down, toward the end of the list. Scrolling backward is like
sliding the window rap, toward the beginning of the list. The window scrolls by the number of lines visible,
until it reaches the end or beginning of the list. If the beginning of a list is displayed, scrolling backward has
no effect; if the end of the list is displayed, scrolling forward has no effect. The message "end of file" or "at
bottom" or "at top" may appear in the message area, however.
3.4.9 Field Values Saved and Recalled
The first time you use a menu, the fields in which you can enter values are blank or they have default
values chosen by the menu program. Underlines indicate the locations and sizes of blank fields. When you
leave a particular menu, the UAMPPS saves the values of all fill-in-the-blank fields, but not the selections
you make from a scrollable list. The next time you use the same menu, the values you entered (or the
defaults you accepted) are displayed as the initial values. If you want to use the same values again, you do
not have to reenter them. To override any defaults, type over the field and eliminate any extraneous
characters by using either the f space bar ] or the {Erase EOF lor (DEL) keys.
3.4.10 On-line Help
On-line help is available from most screen fields. To access on-line help, simply place the cursor on
the field for which lielp is desired and press { PFI/PFIS I A window with an explanation and additional
information on the field will open on top of the menu. The help window may be one screen or multiple
screens, depending on the field and the complexity of the related information. From the help window, press
\ to return to the application screen and continue your data entry.
18
-------
4. SCREEN
SECTION 4
SCREEN REFERENCE
This section provides an in depth explanation of all fields displayed on each screen of the UAMPPS.
Presented below is the main menu screen:
URBAN AIRSHED MODEL
EXTRACT
HELP
MAIN MENU
GRAPHICS
GRAPHICS CATLG
EXIT
Place cursor on your selection and press the enter key.
From the main menu screen, you can enter the Extract module, enter the Graphics module, go
directly to a previously defined graphics catalog, access on-line help, or exit the UAMPPS system to TSO.
Simply tab the cursor to the desired position and press [Enter].
You can return to this menu from any other UAMPPS menu by pressing ft*F4) or (PFi6l
19
-------
4. SCREEN
Table 4-1 provides an overview of the sequence in which the screens are displayed for the Extract and
Graphics modules. To preserve continuity, all screens pertaining to an extraction or a given type of graphic
are presented consecutively, just as you would view them if you were running the actual system.
For example, if you are creating a temporal line plot, you would see the following screens:
• Temporal Graphic Selection,
Temporal Line Chart Data Selection,
Graphic Title/Description Specification,
Value Calculation Message,
Axis Scaling, and
• Termination Selection.
Because the Graphic Title/Description Specification, the Value Calculation Message, and the
Termination Selection screens appear in the Statistical, Temporal, and Spatial graphics subprograms, they
have been included in each subsection. Although this may appear to be redundant, it serves the purpose of
preserving continuity.
In addition, responses are provided on the sample screens to step you through a session using the
Extract and Graphics modules to create statistical, temporal, and spatial graphics. Thus, you can use this
section as a brief tutorial as you execute the UAMPPS Extract and Graphics modules.
Each individual screen description has four components: a screen image, purpose, instructions, and
error messages. At the top of the page, a sample screen image is presented which resembles what you would
see if you were actually running the UAMPPS modules. Below the screen image is a brief summary of the
purpose of the screen, followed by a detailed set of instructions designed to assist you in properly filling in all
fields on the screen. Following the instructions is a list of error messages that you may encounter, along with
instructions on how to fix each error.
20
-------
4. SCREEN
TABLE 4-1. SEQUENCING OF SCREENS
Section
Module
Screen
4.1
Extract
Extract Module Startup Screen
UAM File Selection Screen
Species/Level Data Extraction Screen
Extraction Process Message Screen
Termination Selection Screen
4.2
Graphics
Graphic Selection Screen
4.2.1
Statistical Graphics
Statistical Graphic Selection Screen
Single and Multiple Observation Data Set
Selection Screens
Graphic Title/Description Specification Screen
Value Calculation Message Screen
Axis Scaling Screen
Termination Selection Screen
Graphics Catalog Generation Screen
4.2.2
Temporal Graphics
Temporal Graphic Selection Screen
Shaded Temporal Chart Data Set Selection
Screen
Temporal Line Chart Data Set Selection Screen
Graphic Title/Description Specification Screen
Value Calculation Message Screen
Axis Scaling Screen
Termination Selection Screen
Graphics Catalog Generation Screen
4.2.3
Spatial Graphics
Spatial Graphic Selection Screen
Single Observation Data Set Selection Screen
and Spatial Differences Data Set Selection
Screen
Cities Subset Screen
Spatial Plot Pattern Selection Screen
and Statistical Composition of Data Screen
Graphic Title/Description Specification Screen
Value Calculation Message Screen
Termination Selection Screen
Graphics Catalog Generation Screen
4.3
Graphics Catalog
Graphics Catalog Management Menu Screen
21
-------
4. SCREEN
4.1 DATA EXTRACTION
The results of a UAM execution contain a large volume of information. All 24 species (see Table 4-2),
a variable number of levels, hourly concentration, and descriptive information about the model run are
contained in one file. The Extract module of the UAMPPS provides the data extraction capability for
subsetting the model results based on species and level. In addition, the extraction process transforms the
data from a gridded binary format to either a SAS-formatted data file used in the UAMPPS or a generic text
file that can be imported into other graphics packages. The resulting files are named according to species,
level, control strategy, and date, and thus provide a default method of organizing commonly used data.
TABLE 4-2. DEFINITION OF THE UAM (CB-IV) STATE SPECIES
UAM species
Species name
NO
N02
03
OLE
PAR
TOL
XYL
FORM
ALD2
ETH
CRES
MGLY
OPEN
PNA
NXOY
PAN
CO
MONO
H2O2
HNO3
MEOH
ETOH
ISOP
CLBR
Nitric oxide
Nitrogen dioxide
Ozone
Olefinic carbon bond (C=C)
Paraffinic carbon bond (C-C)
Toluene (QHs-CHs)
Xylene (C6H6-(CH3)2)
Formaldehyde (CH2=O)
High molecular weight aldehydes (RCHO, R > H)
Ethane (CH2=CH2)
Cresol and higher molecular weight phenols
Methyl glyoxal (CH3C(O)C(O)H)
Aromatic ring fragment acid
Peroxynitric acid (HO2NO2)
Total of nitrogen compounds (NO + NO2 + N2O5 + NO3)
Peroxyacyl nitrate (CH3C(O)O2NO2)
Carbon monoxide
Nitrous acid
Hydrogen peroxide
Nitric acid
Methanol (optional)
Ethanol (optional)
Isoprene (optional)
Calibration
22
-------
4. SCREEN
Extract: Extract Module Startup Screen
1.0
URBAN AIRSHED MODEL POSTPROCESSING SYSTEM {UAMPPS)
Extract Module
NOTE:
THE EXTRACT MODULE IS CAPABLE OF OUTPUTTING EITHER A SAS FORMAT DATA
FILE FOR PROCESSING BY THE UAMPPS/UAMPES GRAPHICS SYSTEMS OR A GENERIC
TEXT FILE FOR USE WITH OTHER SOFTWARE PROGRAMS,
IF YOU WANT TO PRODUCE THE GENERIC TEXT FILE, YOU MUST ENTER A 'Y'
IN THE FIELD BELOW. NOTE THAT SUCH A FILE MAY BE DOWNLOADED AND
MANIPULATED AS WOULD ANY TEXT FILE FOR INPUT INTO OTHER SYSTEMS.
IT MAY NOT, HOWEVER, BE USED AS INPUT FOR UAMPPS OR UAMPES GRAPHICS.
IF YOU DO NOT ENTER A 'Y' THE SYSTEM WILL DEFAULT TO THE SAS FORMAT.
DO YOU WANT TO OUTPUT A GENERIC TEXT FILE (Y/N)? N_
PF1/PF13-HELP PF3/PF15-PREV MENU PF4/PF16-MAIN MENU
The Extract Module Startup Screen gives you an opportunity to specify what type of output file will be
produced by the extract. The default output file is an extracted SAS-formatted data set, which is used as
input for the UAMPPS and UAMPES graphics modules. You may choose to output a generic text file by
entering a ® at the prompt. If you enter anything other than the © or nothing at all, the SAS-formatted
data set will be produced.
The naming convention for the extracted output file is as follows:
uidacct.UAM.ftyp.EXT.spec.Xddmmmyy.Lnss
where: uid = your User ID supplied by the NCC
acct = your account number supplied by the NCC
ftyp = SASD for SAS-formatted data sets; or TEXT for generic text files
spec = the species you are extracting in this run
dd = the starting day of the UAM run
mmm = the starting month of the UAM run (JAN, FEE, MAR, etc.)
yy = the starting year of the UAM run
n = the number of the level you are extracting in this run
23
-------
4. SCREEN
Extract: Extract Module Startup Screen
(concluded)
Note that, if you are attempting to perform an extraction for a given species, level, start date combination,
and base/control strategy that has previously been performed, the existing file will be deleted and the results
of the present run will be contained in a data set with the same name.
Instructions:
Press [Enter) to continue. Press fPF«) or [ffi^l to abort the extract and return to the main menu.
Error Messages:
None.
24
-------
4. SCREEN
Extract: File Selection Screen
1.1
UAMPPS: Extract File Selection
Please enter the Fully Qualified Data Set Name for the UAM file from
which you wish to extract a Species and Level subset of information.
Also, supply the name of the Boundary FiXe.
Do not enclose the Data Set Name in quotes,
UAM Output Data Set: uidacct.UAM.MODEL.GR8ff8.BS88.JUL1188.AVGCNC
Boundary File Data Set: uidacct.AIRSHED.GR6X8.BS88.JUL1188.BCBIN
Please supply Study Description and Scenario Information
Study: New York Base or Control (B or C):_B_ Year or Control #: M
Please enter the User Id and the Account that will be used to create
the data set name containing the extracted UAM data.
User Id: uid Account Number: acct
PFl/PF13=Help PF3/PF15-Prev Menu PF4/PF16=Main Menu
The information requested on this panel is used to determine the name of the extracted data set and to
provide some information on its name and location.
Instructions:
You must supply fully qualified names of both the UAM output file from which you wish to extract data and
the UAM boundary file. Do NOT enclose the data set name in quotes. Please note that the input file should
be binary and not ASCII or EBCDIC and must be a cataloged disk file residing on the NCC IBM mainframe.
Generally, the name of the domain is placed in the "Study" field, although you may choose any type of
identifier. You must also indicate the Base/Control and the Year/Control indicators in the appropriate
fields.
For example, if the file you are performing the extraction on is a base file for the year 1988, then enter "B" in
the "Base or Control" field and "88" in the "Year or Control" field. Otherwise, enter "C" and the control
strategy number in the corresponding fields. Both fields are required. The information you supply is stored
as descriptive information and is used to generate the name of the output data set.
25
-------
4. SCREEN
Extract: File Selection Screen
(concluded)
Finally, you must supply User ID and account information in order to determine the prefix of the output data
set being created. These two pieces of information were supplied to you by the NCC when you received your
IBM account authorization.
When you are finished specifying all of the necessary information, press [Enter] to process your selections.
Error Messages:
Entering an invalid file name on either the "UAM Input Data Set" field or the "Boundary File Data Set" field
will result in the following message displayed in the center of the screen:
-Press PF15 to continue-
DATA SET DOES NOT EXIST. PLEASE REENTER DATA SET NAME.
If the geographical boundaries in the boundary file do not fall within the geographical domain of the data
file, the following message will appear:
-Press PF15 to continue'
FILE DOMAINS ARE INCOMPATIBLE... REENTER ONE OR BOTH.
Press [PFIS] to continue and reenter file names.
All other fields are required. If you leave any of the these fields blank, the following message will result:
-Press PF15 to continue'
VALUE REQUIRED AT CURSOR LOCATION.
For the "Base or Control" field, any value other than B or C will result in:
•Press PF15 to continue'
PLEASE ENTER B OR C TO CONTINUE.
For the "Year or Control" field, the response must be a numeric value between 0 and 99. Any other response
will result in:
•Press PF15 to continue'
VALID RANGE 0-99...PLEASE REENTER.
When you press [PFIS] to continue, the cursor will be placed on the appropriate field for data entry.
26
-------
4. SCREEN
Extract: Species/Level Data Screen
1.2
UAMPPS: Extract Species/Level Data
Model Run
Start Day: 11JUL88 Hour: 1 End Day; 11JUL88 Hour: 24
Number of Species: 24 Swnfoer of Segments: _1
Domain '--
Columns(x): 31 Rows(y): 25
Vertical Levels(z): 5 ( Upper 3 , Lower 2 )
Enter a ? and Press Enter to Select from a List of Available Species
Select Species: 03 Select Level: 1
Press PF20 for a Spatial Description of the Domain.
PFl/PF13=Help PF3/PF15~Prev Menu PF4/PF16-Main Menu
1.2
UAMPPS: Extract Spatial Description of the Domain
UTM Zone: 18
Reference Origin(x): 0 Reference Origin(y): 0
Origin of Grid(x): 520000 Origin of Grid(y): 4460000
Columns(x): 31 Rows(y): 25
Grid Interval(x): 8000 Grid Interval(y): 8000
Vertical Levels(z): 5 < Upper 3 , Lower 2 )
Height to Base of Surface Level: 0
Minimum Height to Lower Level: 50
Minimum Height to Upper Level: 150
Press PF19 to return to the Species/Level Data Extraction Menu.
PFl/PF13-Help PF3/PF15-Prev Menu ?F4/PF16-Main Menu
27
-------
4. SCREEN
Extract: Species/Level Data Screen
(concluded)
This screen is a 2-page screen. Page 1 of this screen lists the starting and ending periods of the UAM run and
the species present, along with some spatial information. Page 2 is purely informational, showing the spatial
description of the domain. The number of columns, rows, and vertical levels are repeated from page 1 so that
you will not have to page back and forth to see a complete spatial description of the domain.
Instructions:
On Page 1 of this screen, you are asked to supply the name of the species and the number of the level from
which you would like data extracted. The name of the species must match one of the names supplied in the
list of available species. If you enter a "?" in the "Select Species" field and press {Enter], a list of available
species will be displayed. You may select a species by placing the cursor on a member of the list and pressing
[Enter]. The level you select must be less than or equal to the total number of vertical levels.
When you are finished specifying all the necessary information, press [Enter] to process your selections.
Error Messages:
If the "Select Species" field is left blank or the species entered is not a valid species, the following message is
displayed:
-Press PF15 to continue-
INVALID SPECIES...PLEASE REENTER.
The "Select Level" field must be less than or equal to the number of vertical levels in the domain. If this is
not the case, the following message will be displayed:
•Press PF15 to continue1
SELECT LEVEL FIELD OUTSIDE VALID RANGE...REENTER.
When you press [wis] t0 continue, the cursor will be placed on the appropriate field for data entry.
28
-------
4. SCREEN
Extract* Extraction Process Message Screen
1.3
UAMPPS: EXTRACT DATA FILE
PRESS ENTER TO BEGIN EXTRACTION OF DATA FROM THE UAM FILE
FOR SPECIES 03 AND T-BVEL 1
THIS PROCESS MAY TAKE FOUR MINUTES OR LONGER.
THE OUTPUT DATA SET WILL BE CALLED:
'uidacct.UAM.SASD.EXT.03.X11JUL88.L1B88'
THE PREVIOUS COPY OF THIS DATA SET WILL BE DELETED IF IT EXISTS.
*** BE SURE TO MAKE NOTE OF THIS DATA SET NAME FOR LATER USE ***
PFl/PF13=Help PF3/PF15=Prev Menu PF4/PF16-Main Menu
After the Species/Level Data Selection Screen is completed, the extraction process begins. The message
screen is displayed indicating the species and level being extracted along with the name of the extracted data
set. At this time, you should make note of the name of the data set that is being created. When you enter the
Graphics module, you will need to supply this or another extracted data set name. Therefore, it is
recommended that you keep a list containing the names of all data sets you extract along with a brief
description of their contents. After the extraction is complete, you are, of course, free to rename any or all
files, if you so desire.
Instructions:
Make note of the name of the extracted data set and be sure to write it down for later use. This data set name
is required by the UAMPPS Graphics module.
Because large data files are involved, the extraction process may take 4 minutes or longer.
Error Messages:
None.
29
-------
4. SCREEN
Extract: Termination Selection Screen
1.4
Termination Selection
Select the action you would like to take,
1) Extract Another File
2) Exit the Extraction Module
Selection: 2
The Termination Selection Screen allows you to perform another extraction or to exit the Extract module. If
another extraction is chosen, control is returned to the Extract Module Startup Screen described earlier.
Instructions:
To perform another extraction, enter "1" in the "Selection" field, otherwise, enter "2" to exit the Extract
module. If you choose to exit the Extract module, you will be returned to the UAMPPS main menu.
Error Messages:
The values "1" or "2" are the only valid values for the "Selection" field. Any other entry will result in the
following error message:
•Press PF15 to continue'
YOU MUST ENTER 1 OR 2 TO CONTINUE.
Press [PFIS] to remove the message from the screen. Then, enter a "1" or "2" and press Center.].
30
-------
4. SCREEN
4.2 GRAPHICS CREATION
The Graphics module provides a variety of statistical, temporal, and spatial graphics to assist in model
analysis and policy decision support.
4.2.1 Statistical Graphics
Statistical graphics, which usually portray information outside the context of time or location, are very
useful for immediate quantitative comparisons of observations. The UAMPPS provides four types of
statistical graphics: the bar chart, the box plot, the scatter plot, and the quantile plot.
• For a quick comparison of multiple control strategies, use a bar chart. A bar chart compares up to
10 data sets, with a dominant data set used as the basis for comparison. Percentage differences
between each control strategy and the base are annotated on each bar.
If you want detailed information on specific concentrations contained in a data set, use the box
plot. The box plot provides the range, median, and average, as well as percentile information for
each hour for a single data set.
For a comparison of concentration information of two control strategies over a time or grid cells,
use the scatter and quantile plots.
4.2.2 Temporal Graphics
Temporal graphics provide a technique for portraying change in model results over time. The
UAMPPS provides two types of temporal graphics: the shaded temporal plot and the temporal line plot.
For a comparison of two control strategies over a specified time span, use the shaded temporal
plot. The shaded temporal plot highlights areas of difference between the two strategies occurring
within the time span.
For a comparison of multiple control strategies over time, use the temporal line plot. Like its
statistical counterpart, the bar chart, the temporal line plot compares up to 10 data sets, but the
comparison here is more specific for a given range of hours.
4.2.3 Spatial Graphics
Spatial graphics ignore the temporal aspect of the data but provide information on locational
relationships. The UAMPPS provides two types of spatial graphics: the shaded tile map and the gridded
value map. Either map can provide an overview of the concentrations of a single control strategy over a
geographical region or of the differences between two strategies for the region.
For a general overview of the concentration pattern over the area, select the shaded tile map.
For more specific concentration values of the area, select the gridded value map.
31
-------
4. SCREEN
Graphics: Graphic Selection Screen
2.0
URBAN AIRSHED MODEL POSTPROCESSING SYSTEM (UAMPPS)
Graphic Selection
1) STATISTICAL GRAPHICS
Bar Charts
Box Plots
Scatter Plots
Quatitile Plots
2) TEMPORAL GRAPHICS
Time Series Line Graph
3) SPATIAL GRAPHICS
Shaded Tile Maps
Gridded Value Maps
Selection: 1 Device: IBM3179
Type ? on the device field and press ENTER for a list of supported devices
PFl/PF13-Help PF3/PF15-Prev Menu PF4/PFl6«Main Menu
The Graphic Selection Screen is the first panel you will see upon invoking the Graphics module. From this
screen, you can select the type of graphic to display and the type of terminal on which you would like to
display it. The hard-copy devices are not supported directly. After displaying the graphic on your terminal,
you may save it to a SAS graphics library and then plot it at a later date on the desired hard-copy device. SAS
Graphics Catalogs are discussed separately in this document.
Instructions:
In the "Device" field, enter the name of the terminal that you are using/emulating, or you may enter a "?" on
the device field and press [Enter] for a list of supported devices. Be sure to consult the user's manual
supplied by the terminal manufacturer if you are not certain what type of graphics device you are using or
emulating. Failure to enter the proper device name on this screen may result in unrecoverable errors when
you attempt to display a plot.
If you are using a Tektronix 4207, 4211, or 4224 connected via a coaxial adapter, use the device "TCX4207".
If you are using one of the above named devices but NOT with a coaxial connection, use the device
TEK4207". The devices "IBM3179" and "GDDMPCG" can be entered if you are using or emulating an IBM
3179G terminal; the device "IBM3279" should be selected if you are using or emulating an IBM 3279G
terminal.
32
-------
4. SCREEN
Graphics: Graphic Selection Screen
(concluded)
Anytime you select a device from the list, you will also be asked to choose "display" or "no display" mode. If
you are generating graphics to view during the current session, choose "display". If you are generating
graphics to store in the catalog for later viewing or you are using a device that does not display graphics,
choose "no display". The display mode that you select will remain in effect until you re-enter the list and
change devices and display modes.
A value of "1", "2" or "3" should be entered in the "Selection" field in order to display a specific type of
graphic. Samples of the types of graphics available can be found in Section 2 of this document.
When you are done specifying all the necessary information, press [laiter] to process your selections.
Error Messages:
If any value other than "1", "2" or "3" is entered in the "Selection" field, the following message will be
displayed in the center of the screen:
-Press PF15 to continue-
ENTER EITHER 1, 2, OR 3 -OR- PRESS PF13 FOR HELP.
When you press [PFISI, the message will be removed from the screen and the cursor will be placed on the
"Selection" field to allow you to enter either "1", "2" or "3", or press GEoDfor related help.
Finally, if you specify a value in the "Device" field that is not in the list of supported terminal devices, the
system will display a list of supported devices from which you may choose one.
33
-------
4. SCREEN
Statistical Graphics: Graphic Selection Screen
2.1
UAMPPS: Statistical Graphic Selection
Plot Type: 1 1) Bar Chart 2) Box Plot 3) Scatter Plot 4) Quantile Plot
Period of Interest: Start Day 11JUL88 Hour _1
End Day .HjULfrfr Hour 24
Analysis: 1 BAR CHARTS 1) Number of Cells above Threshold
2) Average Concentration
3) Maximum Concentration
BOX PLOTS 4) Hourly Concentration Percentiles
SCATTER PLOTS 5) Hourly Concentration Maximum
6) Grid Cell Concentration Maximum
•QUANTILE PLOTS 7) Hourly Concentration Maximum
8) Grid Cell Concentration Maximum
Threshold Value (ppb) : 120 (Used for Analysis 1 or 4)
PFl/PFL3=Help PF3/PF15=Prev Menu PF4/PF16=Main Menu
This screen allows you 10 select the type of statistical graphic you would like to create. You can choose to
display a bar chart, a box plot, a scatter plot, or a quantile plot, with various statistics applied to create each
of them.
Instructions:
Choose either a bar chart or box plot by specifying either "1" or "2" in the "Plot Type" field, respectively.
You must then determine the period of interest for the particular type of graphic that you selected. This
consists of starting sad ending dates and times; the values you specify must correspond to the extracted data
you are going to use as input.
For example, if you have an extracted data set containing data for hours 1 to 24 on July 11,1988, then you
must enter "HJULgSS" in the "Start Day" and "End Day" fields and may choose any range of hours between 1
and 24 for the "Start Hour" and "End Hour" fields. The only restriction is that the starting hour is less than
the ending hour. Because there is limited input validation applied to these fields, you must be careful to
supply accurate valises. Failure to do so can result in unpredictable errors.
34
-------
4. SCREEN
Statistical Graphics: Graphic Selection Screen
(continued)
By filling out the "Analysis" field, you determine the type of statistic that is displayed in the graphic. As
indicated, types "1", "2" and "3" correspond to bar charts, type "4" to box plots, types "5" and "6" to scatter
plots, and types "7" and "8" to quantile plots.
If you are creating a bar chart, you can determine the number of cells over a given concentration threshold
for the period of interest by selecting "1" for "Analysis". Note that the "Threshold Value" field at the bottom
of the screen must be filled in. By selecting "2" or "3" for "Analysis", you will create a bar chart showing the
average or maximum concentration over the period of interest, respectively.
When a plot type "2" (box plot) is selected, analysis type "4" is the only acceptable choice. You must also
supply a value for the concentration threshold for box plots. If you do not want a reference line drawn at the
value of the concentration threshold, simply enter a value of zero for threshold and no reference line will be
drawn.
Two "Analysis" types are available for both scatter plots and quantile plots. They are: maximum
concentrations over all grid cells at each hour and maximum concentrations over all hours at each grid cell.
These selections are "5" and "6", respectively, for scatter plots and "7" and "8", respectively, for quantile plots.
When you are done specifying all the necessary information, press (Enter] to process your selections.
Error Messages:
If the "Plot Type" field is left blank or if it contains a value outside the valid range, the following message will
be displayed in the center of the screen:
•Press PF15 to continue'
ENTER EITHER 1, 2, 3, OR 4 -OR- PRESS PF13 FOR HELP.
Press [PFisj to continue and the cursor will be placed on the appropriate field to allow you to enter a valid
value.
Blank or improper "Date" fields can result in the following error:
— Press PF15 to continue —
START DAY MUST PRECEDE END DAY. PLEASE REENTER.
35
-------
4. SCREEN
Statistical Graphics: Graphic Selection Screen
(concluded)
If a "Start Hour" or "End Hour" field is blank, <1, or >24, then the following message will appear:
— Press PF15 to continue
TIME VALUE RANGE IS 1-24 INCLUSIVE. PLEASE REENTER.
If the "Start Hour" field is greater than the "End Hour" field, the following message will appear:
— Press PF15 to continue
START TIME MUST PRECEDE END TIME. PLEASE REENTER.
Values of the "Analysis" field are valid only in certain combinations with the "Plot Type" field. An improper
combination will result in an error message similar to the following:
•Press PF15 to continue'
VALID ANALYSIS VALUES ARE 5 AND 6. PLEASE REENTER.
A blank "Threshold Value" field, if one is required, will result in the following message:
— Press PF15 to continue
PLEASE ENTER A THRESHOLD VALUE OR A ZERO FOR NO THRESHOLD.
36
-------
4. SCREEN
Statistical Graphics: Data Set Selection Screens
2.1.1
UAMPPS: Single Observation Data Set Selection
Please enter the Fully Qualified Data Set Name for the
extracted (Species and Level) tJAM data set to be used
in this graphic.
Do not enclose the Data Set Name in quotes.
Extracted Data Set: uidacct.UAM.SASD.EXT.03.X11JUL88.L1B88
PFl/PF13-Help PF3/PF15-Prev Menu PF4/PF16-Main Menu
2.1.1
UAMPPS: Multiple Observation Data Set Selection
Enter up to ten Fully Qualified Data Set Names for the extracted
(Species and Level) UAM data sets to be used in this graphic.
Order is important; the dominant data set should be entered first.
Do not enclose the Data Set Names in quotes. Do tiot skip lines.
Extracted Data Sets Bar Labels
uidacct.UAM.SASD.EXT.03.X05JUL88.LlB88 BASE1
uidacct.UAM.SASD.EXT.O3.X05JUL88.L^GOl CNTL1
uidacct.UAM. SASD. EXT.03.XQ5JOL88.1.1C02 CNTL2
uidacct.UAM.SASD.EXT.03.X05JOLg8 .^.1C03 CNTL3
uidacct. UAM. SASD. EXT .03. X05JUL88. L1C04 CNTL4
PFl/PF13=Help PF3/PF15-Prev Menu PF4/PF16-Main Menu
37
-------
4. SCREEN
Statistical Graphics: Data Set Selection Screens
(continued)
2.1.1
UAMPPS: Statistical Two Observation Data Set Selection
Please enter the Fully Qualified Data Set Name for the
extracted (Species and Level) tlAM data sets to be used
in this graphic.
Order is important; the data set to be plotted on the
vertical axis should be entered first.
Do not enclose the Data Set Name in quotes.
Vertical Axis Data Set:
Horizontal Axis Data Set:
Please enter the color and the size of the symbols
that will be used on the plot.
Color: Size:
PFl/PF13=Help PF3/PF15=Prev Menu PF4/PF16~Main Menu
The Single Observation Data Set Selection Screen is displayed for box plots; the Multiple Observation Data
Set Selection Screen is displayed for bar charts; and the Statistical Two Observation Data Set Selection
Screen is displayed for scatter plots and quantile plots. All screens are similar in appearance and have the
same function: to determine the name(s) of the data set(s) to be used to generate the graphic.
Regardless of the type of graphic generated, the input data sets must be extracted SAS-formatted data sets
created by the Extract module. They must be currently cataloged disk files on the NCC IBM mainframe
containing data corresponding to the period of interest specified on the previous screen.
38
-------
4. SCREEN
Statistical Graphics: Data Set Selection Screens
(continued)
Instructions:
Enter the fully qualified name of the data set(s) you wish to process in the space(s) provided. Be sure NOT
to enclose the data set name(s) in quotes. If you are creating a bar chart, the order in which you enter the
files is important; the dominant data set should be entered first. If you are creating scatter plots or quantile
plots, the first data set will be plotted on the vertical axis and the second data set will be plotted on the
horizontal axis.
On the Multiple Observation Data Set Selection Screen, be sure to enter data set names on consecutive lines.
When the system encounters a blank data set name (after the first and second data set names, which are
required), it assumes that data set entry is complete. Any data after the blank data set name is ignored.
When you are done specifying all the necessary information, press tEnter) to process your selections.
Error Messages:
The "Extracted Data Set" field is required for the Single Observation Data Set Selection Screen. Leaving this
field blank, entering an invalid file, or using quotes in the file name will result in the following message:
•Press PF15 to continue'
DATA SET DOES NOT EXIST. PLEASE REENTER DATA SET NAME.
When you press [PFIS], the cursor will be placed on the field to allow you to enter a valid data set name.
The first and second "Extracted Data Sets" fields are required for the Multiple Observation Data Set
Selection Screen and leaving either field blank will result in the message:
-Press PF15 to continue'
THIS DATA SET FIELD MAY NOT BE LEFT BLANK.
As before, entering an invalid data set name will result in the following:
— Press PF15 to continue
THIS DATA SET DOES NOT EXIST. PLEASE REENTER DATA SET NAME.
39
-------
4. SCREEN
Statistical Graphics: Data Set Selection Screens
(concluded)
All data sets must have a data set label and each label must be unique. If a label is left blank or the label
duplicates another, the following message is displayed:
•Press PF15 to continue-
PLEASE ENTER A UNIQUE DATA SET LABEL.
For scatter plots and quantile plots, you need to specify a color and a size for the plot symbol. If either is left
blank, the following message will appear:
•Press PF15 to continue-
VALUE REQUIRED AT CURSOR LOCATION.
Press
to continue and the cursor will be placed on the appropriate field for data entry.
If the time period entered as "Stan DayTEnd Day" and "Hour" fields on the previous screen (i.e., the
Statistical Graphic Selection Screen) do not fall within the time period of data contained in the selected file,
the following message will appear:
•Press PF15 to continue-
DATE/TIME RANGE ENTERED:
Start Day: 11JUL88 Hour: 1 End Day: 11JUL88 Hour: 24
OUTSIDE RANGE OF FILE DATE/TIME:
Start Day: 11JUL88 Hour: 13 End Day: 11JUL88 Hour: 24
PLEASE ENTER A NEW FILE NAME -OR- RETURN TO PREVIOUS SCREEN
BY PRESSING PF3/PF15 AND ENTER A NEW DATE/TIME RANGE.
When you press [pFIsl, the cursor will be placed on the "Extracted Data Set" field. At this point you must
choose between entering another file name or returning to the Statistical Graphic Selection Screen (by
pressing [ PFS/PFIS ]) to change the period of interest.
40
-------
4. SCREEN
Statistical Graphics: Graphic Title/Description Specification Screen
UAMPPS: Graphic Title/Description
Enter requested information. Skip any fields not
TEXT
Title #1
CELLS WITH 03 FOR LEVEL 1 OVER THE THRESHOLD
Title #2
Footnote #1
Footnote #2
Vertical Axis
# OF CELLS ABOVE 120 PPB
Horizontal Axis
PFl/PF13=Help PF3/PF15=Prev Menu
Specification
desired.
COLOR
WHITE
^HITE
WHJTE
WHITE
WHITE
WHITE
Do not use quote
FONT
NONE
NONE
NONE
NONE
NONE
NONE
PF4/PF16-Main
SIZE
1.0
1.0
1.0
1 .0
1.0
1 .0
Menu
In this screen, you specify titles, footnotes, and axes labels along with their respective color, font, or text size.
Instructions:
You can specify up to two titles and two footnotes for any given graphic. Simply type the text of the title or
footnote in the fields called "TEXT and then choose the corresponding color, font and size. You should be
sure that the color you specify is supported by the device you are using. Generally, it is a good idea to use
"WHITE" for display on a terminal and "BLACK" for printing on a hard-copy device. You may select a color
from the basic color list by typing a "?" in the color field and then pressing f Enter 1. Otherwise, you may enter
any valid color supported by your graphics device. A complete discussion of SAS/Graph colors may be found
in SAS/Graph Software Reference, Volume 1, Chapter 7.
Next, you will want to choose a font to print the text of your title or footnote. A font value of "NONE" tells
the system to use the hardware characters of the device to compose the text. This is a very simple font, but
suitable for most applications. The "NONE" font is also drawn faster than any other font, so it should be
used if saving time is important or for previewing graphics.
Finally, you will need to specify the size of the characters printed in the title or footnote. We recommend
that you try using the value "1.0" in the "Size" field first, and then change it if you find that the result is not
acceptable. Using a large value of "SIZE" can cause awkward looking titles.
41
-------
4. SCREEN
Statistical Graphics: Graphic Title/Description Specification Screen
(concluded)
Keep in mind that titles and footnotes take up space which can be used for the displaying of the graphic.
Thus, if you specify two titles and two footnotes, the actual graphic will be smaller than if you specified one
title and one footnote. Similarly, the size (specified in the "SIZE" field) of the title or the footnote affects the
size of the display area for the graphic. For this reason, you should judiciously choose the number and size of
the titles and footnotes.
Axes labels are specified in the same way as titles and footnotes. Generally it is a good idea to use the same
color and font for the labels as you used for the titles, but this is completely up to you.
When you are done specifying all the necessary information, press [Enter] to process your selections.
Error Messages:
The "Title #1" field is required for all graphics. If the title line is left blank or if its "Color", "Font", or "Size"
fields are left blank, the following message is displayed:
•Press PF15 to continue'
A VALUE IS REQUIRED AT THE CURSOR LOCATION.
The "Vertical Axis" and "Horizontal Axis" fields are required for certain graph types. If these fields are
required and are left blank, the following message is displayed:
-Press PF15 to continue-
A VALUE IS REQUIRED IN THIS FIELD FOR THIS GRAPH TYPE.
When the "Vertical Axis" and "Horizontal Axis" fields are required, the corresponding "Color", "Font", and
"Size" fields are also required. Leaving any of these blank at these times will result in the following message:
•Press PF15 to continue'
A VALUE IS REQUIRED AT THE CURSOR LOCATION.
If any of the above error messages is encountered, press rgFis] and enter the required data at the cursor
location.
42
-------
4. SCREEN
Statistical Graphics: Value Calculation Message Screen
UAMPPS: Value Calculation Message
Press ENTER to Calculate Values and DISPLAY Graph
Process could take several minutes
PFl/PF13-Help PF3/PFl5-Prev Menu PF4/PFl6-Main Menu
CALCULATING VALUES AND PLOTTING GRAPH
AFTER SCREEN GRAPHIC HAS BEEN CREATED, PRESS ENTER FOR DISPOSITION OPTIONS
The Value Calculation Message Screen provides status information.
Instructions:
The upper screen frame will appear after you have entered the necessary title and label information in the
Graphic Title/Description Specification Screen. The screen informs you that there will be a perceptible
delay, while the intensive calculations required to construct the graph are performed. Press [Enter] to
continue.
After you press [Enter], the lower screen frame will appear and remain on until the next screen in the
sequence is displayed. On some devices, the "Calculating Values and Plotting Graph" message will blink.
Error Messages:
None.
43
-------
4. SCREEN
Statistical Graphics: Axis Scaling Screen
UAMPPS: Box Plot Axis Scaling
Default Axis Values Data Values Selected Axis Values
Maximum
Minimum
Step
120
0
24
111.2
6.483
115
Do you want box plot legend displayed (Y/N)? S
PFl/PFl3-Help PF3/PF15=Prev Menu PF4/PF16=Main Menu
The Axis Scaling Screen allows you the option of altering the scale on the vertical chart axis.
Instructions:
The "Default Axis Values" column and the "Data Values" column are informational. The "Default Axis
Values" column gives you suggested values for the vertical axis based on the actual maximum and minimum
data values displayed the "Data Values" column. The actual values used in drawing the chart will be the
values you enter in the "Selected Axis Values" column.
For box plots, you may choose to display the "box plot legend" (see example below) before the chart is
displayed. Here, the default is always "N". Type a "Y" if you want the "box plot legend" displayed.
BOX PLOT LEGEND
95th Percentile
90th Percentile
75th Percentile
Average
Median
25th Percentile
10th Percentile
5th Percentile
44
-------
4. SCREEN
Statistical Graphics: Axis Scaling Screen
(concluded)
Keep in mind that the "Selected Axis Values" column defaults to your previously entered values. If you
change data sets, the "Selected Axis Values" column may need to be changed.
Error Messages:
Three errors are possible from the Axis Scaling Screen.
(1) If the maximum "Selected Axis Value" is less than the maximum "Data Value", the following error
message is displayed:
•Press PF15 to continue-
DATA VALUES GREATER THAN MAXIMUM AXIS VALUE...REENTER.
(2) If the minimum "Selected Axis Value" is greater than the minimum "Data Value", the following error
message is displayed:
•Press PF15 to continue-
DATA VALUES LESS THAN MINIMUM AXIS VALUE...REENTER.
(3) If the difference between the maximum and minimum "Selected Axis Value" is not equally divisible by
the selected axis step value, then the following message is displayed:
•Press PF15 to continue-
RANGE NOT EQUALLY DIVISIBLE BY STEP VALUE...REENTER.
In each case, press (fzisjand the cursor will be placed on the appropriate field. Refer to the "Data Values"
column, reenter valid values, and press [Enter] when done.
At this point, your graphic will be displayed on the screen and, when you are through viewing it, press
(Enterl to continue.
45
-------
4. SCREEN
Statistical Graphics: Termination Selection Screen
2.2
UAMPPS: Termination Selection
Choose the Action you would like to take.
1) Change Device, Plot Type, or Starting/Ending Conditions
2) Change Input Data Sets
3) Change Cutoff Ranges or Titles
A) Redisplay the Graphic
5) Save the Graphic
6) Exit UAMPPS Graphic Module (Without Saving Graphic)
Selection:
The Termination Selection Screen provides a number of options for saving, redisplaying, modifying, or
recreating graphics as well as exiting the UAMPPS Graphics module. Depending on your response, you will
be transferred to the appropriate screen, where you can make any changes. The screens always execute in the
same order as previously specified.
Instructions:
A value between "1" and "6" must be entered in the "Selection" field at the bottom of this screen. A
description of the six possible options follows. If you would like more information regarding any screen
discussed below, please refer to the detailed screen descriptions presented earlier in this section.
Option 1 - Change Device, Plot Type or Starting/Ending Conditions
Selecting this option returns you to the Graphic Selection Screen, where you can change the device type or
the type of graphic being generated. After making any changes and processing the selections, the Statistical
Graphic Selection Screen will be displayed, allowing you to change the starting and/or ending conditions.
Option 2 - Change Input Data Sets
When this option is selected, either the Single or Multiple Observation Data Set Selection Screen is
displayed, depending on the type of graphic that you originally chose. It is assumed that you would like to
generate the same type of graphic with the same starting and ending conditions, but with different data
displayed. Simply supply the new name(s) of the data set(s) on this screen.
46
-------
4. SCREEN
Statistical Graphics: Termination Selection Screen
(concluded)
Option 3 - Change Cutoff Ranges or Titles
The Graphic Title/Description Specification Screen is displayed when this option is chosen, and you can
change the titles, footnotes, and/or axis labels along with their respective colors, fonts, and sizes.
Option 4 -- Redisplay the Graphic
Selecting this option will cause the graphic that was just viewed to be redisplayed on your terminal screen.
This option is mostly for your convenience, to allow you a quick method of reviewing the last graphic without
going through all the steps to recreate it.
Option 5 -- Save the Graphic
The Graphics Catalog Generation Screen (discussed later in this section) is displayed when you choose this
option. This screen allows you to specify the name of the data set that will contain the SAS Graphics Catalog
as well as descriptive fields that will later aid in the identifying the graphic.
Option 6 -- Exit UAMPPS Graphic Module (Without Saving Graphic)
As the title indicates, selecting this option will cause you to leave the UAMPPS Graphics module without
saving the graphic that was just created. All open files will be closed and you will be returned to the main
menu.
When you are done specifying the value for "Selection", press [ Enter 1 to process your selection.
Error Messages:
If any value other than "1" through "6" is entered in the "Selection" field, the following message will be
displayed in the center of the screen:
•Press PF15 to continue-
YOU MUST ENTER A VALUE FROM 1-6 INCLUSIVE TO CONTINUE.
After you press [PFIS], the cursor will be placed on the "Selection" field to allow you to enter a value between
"1" and "6".
47
-------
4. SCREEN
Statistical Graphics: Graphics Catalog Generation Screen
UAMPPS: Graphics Catalog Generation
Please enter below the Fully Qualified Data Set Name
of the Graphics Catalog to be created or modified.
Do not enclose the Data Set Name in Quotes
Graphics Catalog DSN: uidacct.UAM.SAMPLE.GCATLG
Enter the NAME and Description of this graphic. This
information will be stored in the Graphics Catalog and
will aid in identifying the plot.
Name: BAR
Description: NEW YORK 11JUL88 03 LI B88 GT THRESH
PFl/PF13=Help PF3/PF15-Prev Menu PF4/PF16=Main Menu
This screen provides you a way to permanently save any or all graphics you generate in a device independent
SAS Graphics Catalog. Because this is a device independent file, you can replay these graphics later on any
graphics device and change as many colors you desire.
You will be asked for the name of the data set that will contain the graphics catalog as well as some
descriptive information that will aid in later identification of the plot. If the data set name you supply already
exists, the file will be kept and the current graphic will be added to any existing graphics. No default data set
name is supplied, but suggested descriptive information is furnished.
Instructions:
Enter the fully qualified name of the data set you wish use for the SAS Graphics Catalog in the space
provided. Be sure not to enclose the data set name in quotes.
The "Name" and "Description" fields are required and are used to aid in identifying the type of graphic in the
catalog without displaying it on the terminal screen.
-------
4. SCREEN
Statistical Graphics: Graphics Catalog Generation Screen
(concluded)
If meaningful values of "Name" and "Description" were supplied when the graphic was generated, you should
be able to easily identify the graphic. For this reason, we recommend that you use the default values
supplied.
Default values for the "Name" field are either "BAR", "BOX", "SCAT", or "QUANT depending on whether a
bar chart, box plot, scatter plot, or quantile plot was generated, respectively. The default value of the
"Description" field is always of the form:
study start-day species Ln scenario stat
where:
study = the "STUDY" variable supplied in the Extract module
start-day = the Start date for this graphic
species = the species for which the graphic is being generated
n = the number of the level for which the graphic is being generated
scenario = the "SCENARIO" variable supplied in the Extract module
stat = the statistic chosen for this graphic, which will be "GT THRESH", "AVG CONC"
or "MAX CONC" for bar charts and "HRLY CONC" for box plots.
Thus the default description for a bar chart showing the number of cells in the New York domain with base
year 1988 ozone concentration for level 1 over a given threshold on July 11,1988 would be:
NEW YORK 11JUL88 O3 LI B88 GT THRESH
and the default name would be "BAR".
When you are done specifying all the necessary information, press (Enter] to process your selections.
If the data set you specified already exists, it will be kept and the current graphic will be added to it. If the
data set does not exist, you will be asked if you want to create it. If you do not wish to create the data set,
enter a "N" and press (Enter]. If you enter a "Y", you will be asked if you want to catalog or delete the data
set upon deallocation. If you want the catalog and its contents to be saved for use in future SAS sessions,
enter a "C" and press [Enter].
The screen will clear and the next screen displayed will be the PROC GREPLAY screen. For complete
information on using PROC GREPLAY, see Chapter 36 of the Version 6 edition of the SAS/GRAPH
User's Guide. When you are finished using the Graphics Catalog, press [PFisj to return to UAMPPS.
Error Messages:
None.
49
-------
4. SCREEN
Temporal Graphics: Graphic Selection Screen
2.2
UAMPPS: Temporal Graphic Selection
Plot Type:
1) Shaded 2) Line
Period of Interest: Start pay J.1JUL88 Hour _1
End Day IIJUL88 Hour 2A
Analysis: 1
1) Hourly Maximum Concentration
2) Hourly Average Concentration
Threshold Value (ppb): 120
PFl/PF13»Help PF3/PF15-Prev Menu PF4/PF16=Main Menu
This screen allows you to select the type of temporal graphic that you would like to create. You can choose
to display either a shaded or multiple line plot, with various statistics applied to create each of them.
Instructions:
Choose a shaded or multiple line plot by specifying either "1" or "2" in the "Plot Type" field.
You must then determine the period of interest for the particular type of graphic that you selected. This
consists of starting and ending dates and times, corresponding to the extracted data you are going to use as
input.
For example, if you have an extracted data set containing data for hours 1 to 24 on July 11, 1988, then you
must enter "11JUL88" in the "Start Day" and "End Day" fields and may choose any range of hours between 1
and 24 for the "Start Hour" and "End Hour" fields. The only restriction is that the starting hour needs to be
less than the ending hour. Because there is no input validation applied to these fields, you must be careful to
supply accurate values. Failure to do so can result in unpredictable fatal errors.
By filling in the "Analysis" field, you determine the type of statistic that is displayed in the graphic. You can
choose to either display the hourly maximum or hourly average concentration over the period of interest by
selecting "1" or "2" for "Analysis", respectively.
50
-------
4. SCREEN
Temporal Graphics: Graphic Selection Screen
(continued)
Note that the "Threshold Value" field at the bottom of the screen must be filled in. You must specify the
concentration at which you would like a reference line drawn the graphic. If you do not want a reference line
drawn, enter a value of "0".
When you are done specifying all the necessary information, press [Inter] to process your selections.
Error Messages:
Leaving the "Plot Type" field blank or entering a value other than "1" or *2" will result in the following
message being displayed in the center of the screen:
-Press PF15 to continue-
ENTER 1 OR 2 -OR- PRESS PF13 FOR HELP.
Press [FTIS] to continue and the cursor will be placed on the "Plot Type" field to allow you to enter a valid
value.
Blank or improper "Date" fields can result in the following error:
— Press PF15 to continue
START DAY MUST PRECEDE END DAY. PLEASE REENTER.
If a "Start Hour" of "End Hour" field is blank, < 1 or >24, then the following message will appear:
— Press PF15 to continue
TIME VALUES MUST BE BETWEEN 1 AND 24. PLEASE REENTER.
If the "Start Hour" field is greater than the "End Hour" field, then the following message will appear:
— Press PF15 to continue
START TIME MUST PRECEDE END TIME. PLEASE REENTER.
51
-------
4. SCREEN
Temporal Graphics: Graphic Selection Screen
(concluded)
The "Analysis" field has only two valid values. A blank or values other than "1" or "2" will result in an error
identical to that of the "Plot Type" field above.
A blank Threshold Value" field will result in the following message:
— Press PF15 to continue
PLEASE ENTER A THRESHOLD VALUE OR A ZERO FOR NO THRESHOLD.
52
-------
4. SCREEN
Temporal Graphics: Shaded Temporal Plot Data Set Selection Screen
2.2.1
UAMPPS: Shaded Temporal Plot Data Set Selection
Please enter the Fully Qualified Data Set Names for the
extracted (Species and Level) HAM data sets to be used
for this graphic.
Order is important; the dominant data set should be
entered first.
Do not enclose the Data Set Name in quotes.
Extracted Data Sets: Graphic Legend Labels
uidacct.UAM.SASD.EXT.03.X11JUL88.L1B88 BASE
uidacct.UAM.SASD.EXT.03.X11JUL88.L1C01 CNTL
PFl/PF13=Help PF3/PF15=Prev Menu PF4/PF16=Main Menu
This screen allows you to enter the names of the data sets to be used to generate the shaded line plot. Two
data sets are required because the graphic illustrates the difference between two values of concentration at a
given point in time.
The input data sets must be extracted SAS format data sets created by the Extraction module. The data sets
must be currently cataloged disk files on the NCC IBM mainframe containing data corresponding to the
period of interest specified on the Temporal Graphic Selection Screen.
Instructions:
Enter the fully qualified name of the data sets that you wish to process in the spaces provided. Be sure NOT
to enclose the data set names in quotes. Note that the order in which you enter the files is important; the
dominant data set should be entered first.
When you are done specifying all the necessary information, press t Enter] to process your selections.
53
-------
4. SCREEN
Temporal Graphics: Shaded Temporal Plot Data Set Selection Screen
(concluded)
Error Messages:
Both "Data Set" fields are required. Leaving either field blank, entering invalid data set names, or using
quotes in the file name will result in the following message:
•Press PF15 to continue-
DATA SET DOES NOT EXIST. PLEASE REENTER DATA SET NAME.
Both data sets must be designated with unique labels. If a label is left blank or the labels are the same, the
following error message will result:
•Press PF15 to continue-
DUPLICATE LABELS ARE NOT ALLOWED. REENTER ONE OR BOTH.
If the time period entered as "Start DayTEnd Day" and "Hour" fields on the previous screen (i.e., the
Statistical Graphic Selection Screen) do not fall within the time period of data contained in the selected file,
the following message will appear:
-Press PF15 to continue-
DATE/TIME RANGE ENTERED:
Start Day: 11JUL88 Hour: 1 End Day: 11JUL88 Hour: 24
OUTSIDE RANGE OF FILE DATE/TIME:
Start Day: 11JUL88 Hour: 13 End Day: 11JUL88 Hour: 24
PLEASE ENTER A NEW FILE NAME -OR- RETURN TO PREVIOUS SCREEN
BY PRESSING PF3/PF15 AND ENTER A NEW DATE/TIME RANGE
When you press [PFIS], the cursor will be placed on the "Extracted Data Set" field. At this point you must
choose between entering another file name or returning to the Statistical Graphic Selection Screen (by
pressing [ PFS/PFIS")) to change the period of interest.
54
-------
4. SCREEN
Temporal Graphics: Temporal Lane Plot Data Set Selection Screen
2.2.1
UAMPPS: Temporal Line Plot Data Set Selection
Enter up to ten Fully Qualified Data Set Names for the extracted
(Species and Level) XJAM data sets to be us«d in this graphic.
Do not enclose the Data Set Name in quotes. Do not skip lines.
Line Line Line
Extracted Data Set Name Legend Type Color
uidacct .UAM.SASD. EXT.03.X05JUL88.L1B88 BASEl 1 RED
uidacct.UAM.SASD.EXT.03.X05JUL88.L1C01 CSTL1 _i YELLOW
uidacct.UAM.SASD. EXT.03.X05JtJL88.LlC02 CJSIL2. -L BLUE
uidacct .UAM. SASD. EXT .03 .X05JUL88 .L^COS CNTL3 _1 GREEN
uidacct. UAM.SASD. EXT. O3 . X05 JUL88. L1C04 CNTL4 _1 CYAN
PFl/PF13-Help PF3/PF15-Prev Menu PF4/TF16-Main Menu
This screen allows you to enter the names of the data sets to be used to generate the multiple line plot as well
as the type of line to be drawn and the color of the line. A minimum of two data sets are required and up to
ten can be specified.
The input data sets must be extracted SAS format data sets created by the Extraction module. They must be
currently cataloged disk files on the NCC IBM mainframe containing data corresponding to the period of
interest specified on the Temporal Graphic Selection Screen.
Instructions:
Enter the fully qualified name of the data sets you wish to process in the spaces provided. Be sure not to
enclose the data set names in quotes. Because no concentration differences are being displayed, the order in
which you specify the data sets is not important. Be sure to enter data set names on consecutive lines. When
the system encounters a blank data set name (after the first and second data set names, which are required), it
assumes that data set entry is complete. Any data after the blank data set name is ignored.
Next to each data set name, you must enter the line legend label, the type of line, and the corresponding color
that you would like to be used in plotting the data. Valid line types can be found in the Version 6 edition of
the SAS/GRAPH User's Guide. As on previous screens, colors may be selected by typing a "?" in the "Line
Color" field and pressing [.Enter.], or by typing in a color.
When you are done specifying all the necessary information, press [Enter] to process your selections.
55
-------
4. SCREEN
Temporal Graphics: Temporal Line Plot Data Set Selection Screen
(concluded)
Error Messages:
"Extracted Data Set" fields 1 and 2 are required and leaving either field blank will result in a message similar
to the following:
-Press PF15 to continue-
DATA SET CANNOT BE LEFT BLANK.
Entering an invalid data set name in any of the 10 fields will result in the following:
— Press PF15 to continue
DATA SET DOES NOT EXIST. PLEASE REENTER DATA SET NAME.
All data sets must have a "Line Legend" label and each label must be unique. If a label is left blank or the
label duplicates another, then the following message is displayed:
-Press PF15 to continue-
PLEASE ENTER A UNIQUE DATA SET LABEL.
All nonblank data sets must have a "Line Type" and a "Line Color". Leaving any of these fields blank will
result in the following error message:
•Press PF15 to continue-
VALUE REQUIRED AT CURSOR POSITION.
If the time period entered as "Start DayTEnd Day" and "Hour" fields on the previous screen (i.e., the
Statistical Graphic Selection Screen) do not fall within the time period of data contained in the selected file,
the following message will appear:
•Press PF15 to continue-
DATE/TIME RANGE ENTERED
Start Day: 11JUL88 Hour: 1 End Day: 11JUL88 Hour: 24
OUTSIDE RANGE OF FILE DATE/TIME:
Start Day: 11JUL88 Hour: 13 End Day: 11JUL88 Hour: 24
PLEASE ENTER A NEW FILE NAME -OR- RETURN TO PREVIOUS SCREEN
BY PRESSING PF3/PF15 AND ENTER A NEW DATE/TIME RANGE
When you press [PFIS], the cursor will be placed on the "Extracted Data Set" field. At this point you must
choose between entering another file name or returning to the Statistical Graphic Selection Screen (by
pressing f PFS/PFIS!) to change the period of interest.
56
-------
4. SCREEN
Temporal Graphics: Graphic Title/Description Specification Screen
UAMPPS: Graphic Title/Description
Enter requested Information, Skip any fields not
TEXT
Title #1
MAXIMUM 03 CONCENTRATION FOR LEVEL 1
Title #2
BETWEEN THE HOURS OF 1 AND 24
Footnote #1
Footnote #2
Vertical Axis
CONCENTRATION (PPB}
Horizontal Axis
HOUR
PFl/PF13-Help PF3/PF15=Prev Menu
Specification
desired.
COLOR
WHITE
WHITE
WHITE
WHITE
WHITE
WHJTE
Do not use quote
FONT
NONE
NONE
NONE
NONE
NONE
NONE
PF4/PF16-Main
SIZE
1.0
1.0
1.0
1 .0
1.0
1.0
Menu
In this screen you specify titles, footnotes, and axes labels along with their respective color, font, and text size.
Instructions:
You can specify up to two titles and two footnotes for any given graphic. Simply type the text of the title or
footnote in the fields called "TEXT and then choose the corresponding color, font and size. You should be
sure that the color you specify is supported by the device you are using. Generally, it is a good idea to use
"WHITE" for display on a terminal and "BLACK" for printing on a hard-copy device. As before, limited
color selection is available by typing a"?" on the color field and pressing tEritcr 1.
Next, you will want to choose a font to print the text of your title or footnote. A value of "NONE" tells the
system to use the hardware characters of the device to compose the text. This is usually a very simple font,
but suitable for most applications. The "NONE" font is also drawn faster than any other font, so it should be
used if saving time is important or for previewing graphics.
Finally, you will need to specify the size of the characters printed in the title or footnote. We recommend
that you use a "1.0" in the size field, and then change it if you find that the result is not acceptable. Using a
large value of "SIZE" can cause awkward looking titles.
57
-------
4. SCREEN
Temporal Graphics: Graphic Title/Description Specification Screen
(concluded)
Keep in mind that titles and footnotes take up space which can be used for the displaying of the graphic.
Thus, if you specify two titles and two footnotes, the actual graphic will be smaller than if you specified one
title and one footnote. Similarly, the size (specified in the "SIZE" field) of the title or the footnote affects the
size of the display area for the graphic. For this reason, you should judiciously choose the number and size of
the titles and footnotes that you use.
Axes labels are specified in the same way as titles and footnotes. Generally it is a good idea to use the same
color and font for the labels as you used for the titles, but this is completely up to you.
When you are done specifying all the necessary information, press I
Error Messages:
I to process your selections.
The "Title #1" field is required for all graphics. If the title line is left blank or if its "Color", "Font", or "Size"
fields are left blank, the following message is displayed:
•Press PF15 to continue-
A VALUE IS REQUIRED AT THE CURSOR LOCATION.
The "Vertical Axis" and "Horizontal Axis" fields are required for certain graph types. If these fields are
required and are left blank, the following message is displayed:
-Press PF15 to continue-
A VALUE IS REQUIRED IN THIS FIELD FOR THIS GRAPH TYPE.
If the "Vertical Axis" and "Horizontal Axis" fields are required, the corresponding "Color", "Font", and "Size"
fields are also required. Leaving any of these fields blank at these times will result in the following message:
•Press PF15 to continue-
A VALUE IS REQUIRED AT THE CURSOR LOCATION.
If any of the above error messages is encountered, press fPFis.] and enter the required data at the cursor
location.
58
-------
4. SCREEN
Temporal Graphics: Value Calculation Message Screen
UAMPPS: Value Calculation Message
Press ENTER to Calculate Values and DISPLAY Graph
Process could several minutes
PFl/PF13-Help PF3/PFl5-Prev Menu PF4/PFl6-Main Menu
CALCULATING VALUES AND PLOTTING GRAPH
AFTER SCREEN GRAPHIC HAS BEEN CREATED, PRESS ENTER FOR DISPOSITION OPTIONS
The Value Calculation Message Screen provides status information.
Instructions:
The upper screen frame will appear after you have entered the necessary title and label information in the
Graphic Title/Description Specification Screen. The screen informs you that there will be a perceptible
delay, while the intensive calculations required to construct the graph are performed. Press [Enter] to
continue.
After you press [Enter], the lower screen frame will appear and remain on until the next screen in the
sequence is displayed. On some devices, the "Calculating Values and Plotting Graph" message will blink.
Error Messages:
None.
59
-------
4. SCREEN
Temporal Graphics: Axis Scaling Screen
UAMPPS: Temporal Shaded Chart Axis Scaling
Default Axis Values Data Values Selected Axis Values
Maximum 120 111,2 115
Minimum 0 6.483 £ „„ .
Step 24
PFl/PF13-Help PF3/PF15-Prev Menu PF4/TF16-Main Menu
The Axis Scaling Screen allows you the option of altering the scale on the vertical chart axis.
Instructions:
The "Default Axis Values" column and the "Data Values" column are informational. The "Default Axis
Values" column gives you suggested values for the vertical axis based on the actual maximum and minimum
data values displayed in the "Data Values" column. The actual values used in drawing the chart will be the
values you enter in the "Selected Axis Values" column.
Keep in mind here that the "Selected Axis Values" column defaults to your previously entered values. If you
change data sets, the "Selected Axis Values" column may need to be changed.
Error Messages:
Three errors are possible from the Axis Scaling Screen.
(1) If the maximum "Selected Axis Value" is less than the maximum "Data Value", the following error
message is displayed:
-Press PF15 to continue-
DATA VALUES GREATER THAN MAXIMUM AXIS VALUE...REENTER.
60
-------
4. SCREEN
Temporal Graphics: Axis Scaling Screen
(concluded)
(2) If the minimum "Selected Axis Value" is greater than the minimum "Data Value", the following error
message is displayed:
•Press PF15 to continue-
DATA VALUES LESS THAN MINIMUM AXIS VALUE...REENTER.
(3) If the difference between the maximum and minimum "Selected Axis Value" is not equally divisible by
the selected axis step value, then the following message is displayed:
•Press PF15 to continue1
RANGE NOT EQUALLY DIVISIBLE BY STEP VALUE...REENTER.
In each case, press [PFIS] and the cursor will be placed on the appropriate field. Refer to the "Data Values"
column, reenter valid values, and press [Enterl when done.
At this point, your graphic will be displayed on the screen and, when you are through viewing it, press
[Enter] tO Continue.
61
-------
4. SCREEN
Temporal Graphics: Termination Selection Screen
UAMPPS: Termination Selection
Choose the Action you would lik« to take.
1) Change Device, Plot Type, or Starting/Ending Conditions
2) Change Input Data Sets
3) Change Cutoff Ranges or Titles
4) Redisplay the Graphic
5) Save the Graphic
6) Exit UAMPPS Graphic Module (Without Saving Graphic)
Selection:
The Termination Selection Screen provides you with a number of options for saving, redisplaying, modifying,
or recreating graphics as well as exiting the UAMPPS Graphics module. Depending on your response, you
will be transferred to the appropriate screen, where you can make any changes. The screens always execute in
the same order as previously specified.
Instructions:
A value between "1" and "6" must be entered in the "Selection" field at ihe bottom of this screen. A
description of the six possible options follows. If you would like more information regarding any screen
discussed below, please refer to the detailed screen descriptions presented earlier in this section.
Option 1 -- Change Device, Plot Type or Starting/Ending Conditions
Selecting this option returns you to the Graphic Selection Screen, where you can change the device type or
the type of graphic being generated. After making any changes and processing the selections, the Temporal
Graphic Selection Screen will be displayed, allowing you to change the starting and/or ending conditions.
Option 2 -- Change Input Data Sets
When this option is selected, either the Shaded Temporal Chart Data Set Selection Screen or the Temporal
Line Chart Data Set Selection Screen is displayed, depending on the type of plot that you originally chose. It
is assumed that you would like to generate the same type of graphic with the same starting and ending
conditions, but with different data displayed. Simply supply the new name(s) of the data set(s) on this screen.
62
-------
4. SCREEN
Temporal Graphics: Termination Selection Screen
(concluded)
Option 3 -- Change Cutoff Ranges or Titles
The Graphic Title /Description Specification Screen is displayed when this option is chosen, and you can
change the titles, footnotes, and/or axis labels along with their respective colors, fonts, and sizes.
Option 4 -- Redisplay the Graphic
Selecting this option will cause the graphic that was just viewed to be redisplayed on your terminal screen.
This option is mostly for your convenience, to allow you a quick method of reviewing the last graphic without
going through all the steps to recreate it.
Option 5 - Save the Graphic
The Graphics Catalog Generation Screen (discussed later in this section) is displayed when you choose this
option. This screen allows you to specify the name of the data set that will contain the SAS Graphics Catalog
as well as descriptive fields that will later aid in the identification of the graphic.
Option 6 -- Exit UAMPPS Graphic Module (Without Saving Graphic)
As the title indicates, selecting this option will cause you to leave the UAMPPS graphics module without
saving the graphic that was just created. All open files will be closed and you will be returned to the main
menu.
When you are done specifying the value for "Selection", press [Enter] to process your selection.
Error Messages:
If any value other than "1" through "6" is entered in the "Selection" field, the following message will be
displayed in the center of the screen:
— Press PF15 to continue
YOU MUST ENTER A VALUE FROM 1-6 INCLUSIVE TO CONTINUE.
After you press CEoI} the cursor will be placed on the "Selection" field to allow you to enter a value between
"1" and "6".
63
-------
4. SCREEN
Temporal Graphics: Graphics Catalog Generation Screen
UAMPPS: Graphics Catalog Generation Menu
Please enter "below the Fully Qualified Data Set Name
of the Graphics Catalog to be created or modified.
Do not enclose the Data Set Haine in Quotes
Graphics Catalog DSN: uidacct.UAM.SAMPLE.GCATLG
Enter the NAME and Description of this graphic. This
information will be stored in the Graphics Catalog and
will aid in identifying the plot.
Name: SLINE
Description: NEW YORK 11JUL88 03 LI B88 HRLY MAXC
PFl/PF13-Help PF3/PF15-Prev Menu PF4/PF16-Marn Menu
This screen provides you a way to permanently save any or all graphics you generate in a device independent
SAS Graphics Catalog. Because this is a device independent file, you can replay these graphics later on any
graphics device and change as many colors you desire.
You will be asked for the name of the data set that will contain the graphics catalog as well as some
descriptive information that will aid in later identification of the plot. If the data set name you supply already
exists, the file will be kept and the current graphic will be added to any existing graphics. No default data set
name is supplied, but suggested descriptive information is furnished.
Instructions:
Enter the fully qualified name of the data set you wish use for the SAS Graphics Catalog in the space
provided. Be sure NOT to enclose the data set name in quotes. If the data set already exists, it will be kept
and the current graphic will be added to it. No default is supplied for this field.
The "Name" and "Description" fields are required and are used to aid in identifying the type of graphic in the
catalog without displaying it on the terminal screen.
64
-------
4. SCREEN
Temporal Graphics: Graphics Catalog Generation Screen
(concluded)
If meaningful values of "Name" and "Description" were supplied when the graphic was generated, you should
be able to easily identify the graphic. For this reason, we recommend that you use the default values that are
supplied, which are explained below.
Default values for the "Name" field are either "SLINE" or "MLINE", depending on whether a shaded or
multiple line plot was generated, respectively. The default value of the "Description" field is always of the
form:
study start-day species Ln scenario stat
where:
study = the "STUDY" variable supplied in the Extract module
start-day = the Start date for this graphic
species = the species for which the graphic is being generated
n = the number of the level for which the graphic is being generated
scenario = the "SCENARIO" variable supplied in the Extract module
stat = the statistic chosen for this graphic, which will be "HRLY MAXC" or "HRLY
AVGC" to indicate hourly maximum or average concentrations, respectively.
Thus, the default description for a shaded line plot showing the 1988 base year hourly maximum ozone
concentration in the New York domain for level 1 on July 11,1988 would be:
NEW YORK 11JUL88 O3 LI B88 HRLY MAXC
and the default name would be "SLINE".
When you are done specifying all the necessary information, press [Enter] to process your selections.
If the data set you specified already exists, it will be kept and the current graphic will be added to it. If the
data set does not exist, you will be asked if you want to create it. If you do not wish to create the data set,
enter a "N" and press [Enter]. If you enter a "Y", you will be asked if you want to catalog or delete the data
set upon deallocation. If you want the catalog and its contents to be saved for use in future SAS sessions,
enter a "C" and press [Enter].
The screen will clear and the next screen displayed will be the PROC GREPLAY screen. For complete
information on using PROC GREPLAY, see Chapter 36 of the Version 6 edition of the SAS/GRAPH
User's Guide. When you are finished using the Graphics Catalog, press [ppislto return to UAMPPS.
Error Messages:
None.
65
-------
4. SCREEN
Spatial Graphics: Graphic Selection Screen
2.3
UAMPPS: Spatial Graphic Selection
Map Type: 1 1) Shaded Tile 2) <3iri4ded Value
Pattern Type: 1 1) Color 2) Monochrome
Grid Annotation; 1 1) None 2) Col/Row 4) Lat/Lon
City Annotation: 3 1) None 2) All 3) Subset Cities 4) Prev Subset
Period of Interest: Start Day 11JUL88 Hour 1
End Day 11JUL88 Hour 24
Analysis: 1 1) Average Concentration
2) Maximum Concentration
3) Hour of Maximum Concentration
4) Concentration at a Given Hour
5) Percent Difference
6) Difference
7) Maximum Concentration Difference
PFl/PF13-Help PF3/PF15-Prev Menu PF4/PF16-Main Menu
This screen allows you to select the type of spatial graphic that you would like to create. You can choose to
display either color or monochrome versions of a shaded tile or gridded value map, with various statistics
being applied to create each of them.
Instructions:
Choose either a shaded tile or gridded value map by specifying either "1" or "2" in the "Map Type" field,
respectively.
After selecting the type of graphic that you would like to display, you may then choose to display either a
color or monochrome plot. Inserting a "1" in the "Pattern Type" field will yield a color plot; a value of "2" will
generate a monochrome plot.
Next, you must decide the type of grid annotation that you want displayed on the chart. A "1" in the "Grid
Annotation" field will display no annotation, a "2" will annotate rows and columns, and a "3" will display lati-
tude/longitude annotation.
66
-------
4. SCREEN
Spatial Graphics: Graphic Selection Screen
(continued)
The "City Annotation" field allows you to determine what cities, if any, will be displayed on the map.
Selection "1" displays no cities. Selection "2" displays all major cities within the domain; you may find that
displaying all cities within the domain produces cluttered output. Selection "3" allows you to select the cities
that you would like to display from the complete list. After you have decided on a subset of cities to display,
you may repeat that subset on subsequent runs by selecting "4".
It is important to note here that the "City Annotation" selection "3" must be run before selection "4" can be
used. The subset is not retained at the end of a session.
Also, if you choose to change domains within a session, you must run selection "3" to produce a valid subset
for the new domain. For example, a previous subset (selection "4") for New York would not overlay on a
domain for Atlanta.
You must then determine the "Period of Interest" for the particular type of graphic that you selected. This
consists of starting and ending dates and times, with the values you specify corresponding to the extracted
data you are going to use as input.
For example, if you have an extracted data set containing data for hours 1 to 24 on July 11,1988, then you
must enter "11JUL88" in the "Start Day" and "End Day" fields and may choose any range of hours between 1
and 24 for the "Start Hour" and "End Hour" fields. The only restriction is that the starting hour is less than
the ending hour.
By filling out the "Analysis" field, you determine the type of statistic that is displayed in the graphic. The
types of statistics corresponding to the various options are explained below.
Option 1 -- Average Concentration
Computes the average concentration for each cell in the domain over the period of interest and displays the
result in the graphic.
Option 2 -- Maximum Concentration
Computes the maximum concentration for each cell in the domain over the period of interest and displays
the result in the graphic.
Option 3 -- Hour of Maximum Concentration
Determines the hour at which the maximum concentration for each grid cell in the domain occurs over the
period of interest, and displays the result in the graphic.
Option 4 - Concentration at a Given Hour
Determines the concentration at the hour specified in the "Start Hour" field of this screen and displays the
result on the graphic.
67
-------
4. SCREEN
Spatial Graphics: Graphic Selection Screen
(continued)
Option 5 -- Percent Difference
Computes the percent difference in concentration for two different input files for each cell in the domain
over the period of interest, and displays the result in the graphic. Note that two Extract SAS-format data sets
are needed to produce this graphic.
Option 6 -- Difference
Computes the straight difference in concentration for two different files for each cell in the domain over the
period of interest, and displays the result in the graphic. Note that two Extract SAS-format data sets are
needed to produce this graphic.
Option 7 - Maximum Difference
Calculates the maximum concentration for each cell for each of the two input files; then displays the
difference of the grid cell maximums. Note that two Extract SAS-format data sets are needed to produce this
graphic.
When you are done specifying all the necessary information, press [Enter] to process your selections.
Error Messages:
All fields on this screen are required. Leaving the "Map Type" field blank or entering a value other than "1"
or "2" will result in the following message:
-Press PF15 to continue'
ENTER 1 OR 2 -OR- PRESS PF13 FOR HELP.
Also, the "Pattern Type", "Grid Annotation" and "City Annotation" fields must also contain values within
their respective allowable ranges or a similar error will be displayed.
For the "City Annotation" field, selection "4" is only valid after the subset of cities has been created. Thus,
choosing selection "4" before selection "3" will result in the following message:
•Press PF15 to continue'
SELECTION 4 ONLY VALID AFTER SELECTION 3 HAS BEEN RUN.
68
-------
4. SCREEN
Spatial Graphics: Graphic Selection Screen
(concluded)
As with statistical graphics and temporal graphics (Sections 4.2.1 and 4.2.2), the spatial graphics "Date" fields
require that the start date and hour precede the end date and hour. The "Date" fields must be valid SAS
dates and the "Hour" fields must be between 1 and 24. Failure to follow these rules will result in the same
error messages detailed in previous graphics selections.
For the "Analysis" field, any value other than "1" through "7" will result in the following message:
— Press PF15 to continue
ANALYSIS VALUES MUST BE FROM 1-7 INCLUSIVE. PLEASE REENTER.
For all of the above error messages, press fpfi's'l to continue and the cursor will be positioned for data entry.
69
-------
4. SCREEN
Spatial Graphics: Single Observation Data Set Selection Screen
and
Spatial Differences Data Set Selection Screen
UAMPPS: Data Set Selection
Please enter the Fully Qualified Data Set Name for the
extracted (species and level) UAM data set to be used
for this graphic.
Do not enclose the Data Set Name in quotes.
Extracted Data Set: uidacct.UAM.SASD.EXT.03.X11JUL88.L1B88
PFl/PF13-Help PF3/PF15-Prev Menu PF4/PFl6-Main Menu
2.3.1
UAMPPS: Spatial Differences Data Set Selection
Please enter the Fully Qualified Data Set Names for the
extracted (Species and Level) UAM data sets to be used
for this graphic.
Order is important; the dominant data set should be
entered first.
Do not enclose the Data Set Names in quotes.
Extracted Data Set: uidacct.UAM.SASD.EXT.03.X1UUL88.L1B88
Extracted Data Set: uidacct.UAM.SASD.EXT.O3>XllJUL88.L2C01
PFl/PF13=Help PF3/PF15=Prev Menu PF4/PFl6=Main Menu
70
-------
4. SCREEN
Spatial Graphics: Single Observation Data Set Selection Screen
and
Spatial Differences Data Set Selection Screen
(concluded)
When difference or percent difference plots are created, the Spatial Differences Data Set Selection Screen is
displayed; the Single Observation Data Set Selection Screen is displayed for all other statistic types. Both
screens are similar in appearance and have the same function: to determine the name(s) of the data set(s) to
be used to generate the graphic.
Regardless of the type of graphic generated, the input data sets must be Extract SAS-format data sets created
by the Extraction module. They must be currently cataloged disk files on the NCC IBM mainframe
containing data corresponding to the period of interest specified on the previous screen.
Instructions:
Enter the fully qualified name of the data set(s) you wish to process in the space(s) provided. Be sure not to
enclose the data set name(s) in quotes. If you are creating a difference or percent difference plot, the order
in which you enter the file names is important; the dominant data set should be entered first.
When you are done specifying all the necessary information, press [Enter] to process your selections.
Error Messages:
Because the "Extracted Data Set" field in all cases, leaving one (or both) data set names blank or entering
data set names that do not exist will result in the following message:
•Press PF15 to continue-
DATA SET DOES NOT EXIST. PLEASE REENTER DATA SET NAME.
When you press CPFIS], the message will disappear and the cursor will be placed at the appropriate field for
data entry.
If the time period entered as "Start DayTEnd Day" and "Hour" fields on the previous screen (i.e., the
Statistical Graphic Selection Screen) do not fall within the time period of data contained in the selected file,
the following message will appear:
— Press PF15 to continue
DATE/TIME RANGE ENTERED:
Start Day: 11JUL88 Hour: 1 End Day: 11JUL88 Hour: 24
OUTSIDE RANGE OF FILE DATE/TIME:
Start Day: 11JUL88 Hour: 13 End Day: 11JUL88 Hour: 24
PLEASE ENTER A NEW FILE NAME -OR- RETURN TO PREVIOUS SCREEN
BY PRESSING PF3/PF15 AND ENTER A NEW DATE/TIME RANGE.
When you press tPFisl, the cursor will be placed on the "Extracted Data Set" field. At this point you must
choose between entering another file name or returning to the Statistical Graphic Selection Screen (by
pressing f PFS/PFIS)) to change the period of interest.
71
-------
4. SCREEN
Spatial Graphics: Cities Subset Screen
2.3.1.1
UAMPPS: Cities Located Within Domain
Place an S in the selection column for all cities to be displayed on map.
Press PF20 to scroll down the list, P3F19 to scroll up.
After all selections have been made, press PF15 to save selections.
Selection City
S *BRIDGEPORT
*BRISTOL
*DANBURY
*FAIRFIELD
^GREENWICH
*HAMDEN
s *HARTFORD
S *MANCHESTER
*MERIDEN
*M1LFORD
PFl/PF13-Help PF3/PF15-Prev Menu PF4/PF16-Main Menu
If "City Annotation" field selection "3" was chosen on the Spatial Graphics Selection Screen, this screen will
be displayed. It allows you to subset the cities within the domain covered by the Extract SAS-format data set.
Instructions:
All cities included in the SAS "Cities" data set that fall within the current domain will be present in the list of
cities. The list may be several screens long. Scroll down the list by pressing HPFZO]; scroll up by pressing
(PF191
Place an "S" in the "Selection" column next to each city that you want in the cities subset. When you have
completed the selection process, press [PFIS] to save the subset. The screen will close and the next screen
will be displayed.
Error Messages:
None.
72
-------
4. SCREEN
Spatial Graphics:
Spatial Plot Pattern Selection Screen
and
Statistical Composition of Data Screen
2.3.2
UAMPPS: Spatial PI
Press PF20 to see the Stati
Select the appropriate class break
The available colors and patterns
Default
Class Cutoff Value
1 < 82
2 < 96
3 < 110
4 < 124
5 < 138
6 >,- _JJ1
Available Colors (for Color plots)
BLUE CYAN GREEN YELLOW
Available Patterns
E M1N45
PFl/PF13=Help
(for Monochrome
M3N45 M4N45
PF3/PF15
ot Pattern Selection
stical Composition of the Data.
s and corresponding colors or patterns
for your device are specified below.
Assigned Assigned
Cutoff Value Color/Pattern
< $9 BW£
< 95 CYAN
< 110 GREEN
< 125 XELLPJL.
< 140 PINK
>.- 140 RED
PINK RED WHITE
Tile plots)
M5N45 S
=Prev Menu PF4/PFl6=Main Menu
2.3.2
UAMPPS :
Press PF19 to
Percentile
5
10
15
20
25
30
35
40
45
50
Minimum Value
Number of Records
PFl/PF13-Help
Statistical Composition of
return to
Value
81.4
89.9
94.1
97,1
.99.1
105.1
110.6
115.5
119.4
122.2
: 68.4
: 667
PF3/PF15
Data
the Pattern Selection Menu.
Percentile
55
60
65
70
75
80
85
90
95
Maximum Value:
•=Prev Menu
Value
126.3
129.6
132.3
134.8
138.4
140.7
143.5
|45 . 5
148.8
154.5
PF4/PF16~Main Menu
73
-------
4. SCREEN
Spatial Graphics: Spatial Plot Pattern Selection Screen
and
Statistical Composition of Data Screen
(continued)
The Statistical Composition of Data Screen is really the second page of the Spatial Plot Pattern Selection
Screen, and is accessed by pressing [PFZO] when the Spatial Plot Pattern Selection Screen is displayed.
The purpose of the Statistical Composition of Data Screen is to provide you the information necessary to
enter the cutoff values on the Spatial Plot Pattern Selection Screen. Based on the statistic chosen on the
Spatial Graphic Selection Screen, you will be presented with the values of the data to be plotted broken
down into several percentiles. Thus, you can determine the approximate percent of the data that will be
contained in the cutoff ranges you select.
The Spatial Plot Pattern Selection Screen allows you to select cutoff values for the class breaks and a
corresponding color or monochrome fill pattern to be displayed on the graphic.
NOTE: Neither of these screens will be displayed if you are generating a monochrome gridded value map.
Instructions:
The column labeled "Default Cutoff Value" offers a suggestion of six cutoff values derived from the data
range detailed on the Statistical Composition of Data Screen. You may enter these values in the "Assigned
Cutoff Value" fields or select your own values. The only restriction is that all six fields must have a value, and
the values must be in ascending magnitude from top to bottom. Note that the logical operator preceding the
"Assigned Cutoff Value" field will be used to subset the data for this class.
For example, in the sample screen listed above, the following class breaks are defined.
Class 1-- All data values less than 80 will be colored blue.
Class 2-- All data values greater than or equal to 80 but less than 95 will be colored cyan.
Class 3— All data values greater than or equal to 95 but less than 110 will be colored green.
Class 4-- All data values greater than or equal to 110 but less than 125 will be colored yellow.
Class 5-- All data values greater than or equal to 125 but less than 140 will be colored pink.
Class 6- All data values greater than or equal to 140 will be colored red.
You must also enter a color or monochrome fill pattern in the corresponding "Assigned Color/Pattern" field.
We recommend that you choose from the colors listed at the bottom of this screen, because these colors are
supported by the device you specified on the Graphic Selection Screen. Also, the available monochrome
patterns that are listed have proved to yield good results, so they should be used when pattern fills are
needed.
74
-------
4. SCREEN
Spatial Graphics: Spatial Plot Pattern Selection Screen
and
Statistical Composition of Data Screen
(concluded)
Note that values for "Assigned Cutoff Value" and "Assigned Color/Pattern" fields are retained from the
previous run. If you change species, levels, or analysis types, the cutoff values may not adequately represent
the range of values present. Always refer to the "Default Cutoff Value" column or the Spatial Composition
of Data Screen before selecting cutoff values.
Error Messages:
If the Class 1 "Cutoff Value" field is left blank or if any "Color/Pattern" field is left blank, then the following
message is displayed:
•Press PF15 to continue'
VALUE REQUIRED AT CURSOR LOCATION.
Each succeeding "Cutoff Value" field must be greater than the preceding one. If this is not true or if one of
the value fields is left blank, then a message similar to the following is displayed:
-Press PF15 to continue-
CUTOFF VALUE 3 MUST BE GREATER THAN CUTOFF VALUE 2.
Press [PFis]and enter a corrected value at the cursor location.
75
-------
4. SCREEN
Spatial Graphics: Graphic Title/Description Specification Screen
UAMPPS: Graphic Title/Description
Specification
Enter requested information. Skip fields not desired. Do not use quotes.
TEXT
Title #1
AVERAGE 03 CONCENTRATION FOR LEVEL 1
Title #2
BETWEEN THE HOURS OF 1 AND 24
Footnote #1
Footnote #2
Vertical Axis
Horizontal Axis
CONCENTRATION (PPB1
PFl/PF13=Help PF3/PF15-Prev Menu
CQtOR FONT
WHITE NONE
WH|TE NONE
WHITE NONE
WHITE NONE
WHITE NONE
WHITE NONE
PF4/PF16-Main
SIZE
1.0
1.0
1.0
1.0
1.0
1.0
Menu
In this screen, you specify default titles, footnotes, and axes labels along with their respective color, font, or
text size.
Instructions:
You can specify up to two titles and two footnotes for any given graphic. Simply type the text of the title or
footnote in the fields called "TEXT and then choose the corresponding color, font, and size. You should be
sure that the color you specify is supported by the device you are using. Generally, it is a good idea to use
"WHITE" for display on a terminal and "BLACK" for printing on a hard-copy device.
Next you will want to choose a font to print the text of your title or footnote. A value of "NONE" tells the
system to use the hardware characters of the device to compose the text. This is usually a very simple font,
but suitable for most applications. The "NONE" font is also drawn faster than any other font, so it should be
used if saving time is important and also for previewing graphics.
Finally, you will need to specify the size of the characters printed in the title or footnote. We recommend
that you use "1.0" in the "SIZE" field first, and then change it if you find that the result is not acceptable.
Using a large value of "SIZE" can cause awkward looking titles.
76
-------
4. SCREEN
Spatial Graphics: Graphic Title/Description Specification Screen
(concluded)
Keep in mind that titles and footnotes take up space which can be used for the displaying of the graphic.
Thus, if you specify two titles and two footnotes, the actual graphic will be smaller than if you specified one
title and one footnote. Similarly, the size (specified in the "SIZE" field) of the title or the footnote affects the
size of the display area for the graphic. For this reason, you should judiciously choose the number and size of
the titles and footnotes that you use.
The "Vertical Axis" label is not used in spatial plots. The "Horizontal Axis" label field is used as the "Legend"
label and its "COLOR", "FONT", and "SIZE" fields determine the color, font, and size of the text used in the
legend.
When you are done specifying all the necessary information, press [Enter] to process your selections.
Error Messages:
The "Title #1" field is required for all graphics. If the title line is left blank or if its "COLOR", "FONT', or
"SIZE" fields are left blank, the following message is displayed:
•Press PF15 to continue'
A VALUE IS REQUIRED AT THE CURSOR LOCATION.
The "Horizontal Axis" field is required for this graph type. If it is left blank, the following message is
displayed:
-Press PF15 to continue-
A VALUE IS REQUIRED IN THIS FIELD FOR THIS GRAPH TYPE.
If the corresponding "COLOR", "FONT", and "SIZE" fields are left blank, the following message will occur:
— Press PF15 to continue
A VALUE IS REQUIRED AT THE CURSOR LOCATION.
If any of the above error messages is encountered, press fPFis] and enter the required data at the cursor
location.
77
-------
4. SCREEN
Spatial Graphics: Value Calculation Message Screen
UAMPPS: Value Calculation Message
Press ENTER to Calculate Values and DISPIAY Graph
Process could take several minutes.
PFl/PFl3-Help PF3/PFl5-Prev Menu PF4/PF16-Main Menu
CALCULATING VALUES AND PLOTTING GRAPH
AFTER SCREEN GRAPHIC HAS BEEN CREATED, PRESS ENTER FOR DISPOSITION OPTIONS
The Value Calculation Message Screen provides status information.
Instructions:
The upper screen frame will appear after you have entered the necessary title and label information in the
Graphic Title/Description Specification Screen. The screen informs you that there will be a perceptible
delay, while the intensive calculations required to construct the graph are performed. Press [Enter] to
continue.
After you press [Enter], the lower screen frame will appear and remain on until the next screen in the
sequence is displayed. On some devices, the "Calculating Values and Plotting Graph" message will blink.
Error Messages:
None.
78
-------
4. SCREEN
Spatial Graphics: Termination Selection Screen
UAMPPS: Termination Selection
Choose the Action you would like to take.
1) Change Device, Plot Type, or Starting/Ending Conditions
2) Change Input Data Sets
3) Change Cutoff Ranges or Titles
4) Redisplay the Graphic
5) Save the Graphic
6) Exit UAMPPS Graphic Module (Without Saving Graphic)
Selection: .5
The Termination Selection Screen provides you with a number of options for saving, redisplaying, modifying,
or recreating graphics as well as exiting the UAMPPS Graphics module. Depending on your response, you
will be transferred to the appropriate screen, where you can make any changes. The screens always execute in
the same order as previously specified.
Instructions:
A value between "1" and "6" must be entered in the "Selection" field at the bottom of this screen. A
description of the six possible options follows. If you would like more information regarding any screen
discussed below, please refer to the detailed screen descriptions presented earlier in this section.
Option 1 -- Change Device, Plot Type or Starting/Ending Conditions
Selecting this option returns you to the Graphic Selection Screen, where you can change the device type or
the type of graphic being generated. After making any changes and processing the selections, the Spatial
Graphic Selection Screen will be displayed, allowing you to change the starting and/or ending conditions.
Option 2 -- Change Input Data Sets
When this option is selected, either the Single Observation Data Set Selection Screen or the Spatial
Differences Data Set Selection Screen is displayed, depending on the type of plot that you originally chose. It
is assumed that you would like to generate the same type of graphic with the same starting and ending
conditions, but with different data displayed. Simply supply the new name(s) of the data set(s) on this screen.
79
-------
4. SCREEN
Spatial Graphics: Termination Selection Screen
(concluded)
Option 3 -- Change Cutoff Ranges or Titles
The Spatial Plot Pattern Selection Screen is displayed when this option is chosen, which allows you to change
the class breaks and colors or patterns. Recall that the Statistical Composition of the Data Screen, which
gives a statistical breakdown of the data by percentile, can be accessed by pressing [PFzol.
Option 4 -- Redisplay the Graphic
Selecting this option will cause the graphic that was just viewed to be redisplayed on your terminal screen.
This option is mostly for your convenience, to allow you a quick method of reviewing the last graphic without
going through all the steps to recreate it.
Option 5 - Save the Graphic
The Graphics Catalog Generation Screen (discussed later in this section) is displayed when you choose this
option. This screen allows you to specify the name of the data set that will contain the SAS Graphics Catalog
as well as descriptive fields that will later aid in the identification of the graphic.
Option 6 -- Exit UAMPPS Graphic Module (Without Saving Graphic)
As the title indicates, selecting this option will cause you to leave the UAMPPS graphics module without
saving the graphic that was just created. All open files will be closed and you will be returned to the main
menu.
When you are done specifying the value for "Selection", press [Enter] to process your selection.
Error Messages:
If any value other than "1" through "6" is entered in the "Selection" field, the following message will be
displayed in the center of the screen:
•Press PF15 to continue-
YOU MUST ENTER A VALUE FROM 1-6 INCLUSIVE TO CONTINUE.
After you press fmsl, the cursor will be placed on the "Selection" field to allow you to enter a value between
"1" and "6".
80
-------
4. SCREEN
Spatial Graphics: Graphics Catalog Generation Screen
UAMPPS Graphics Catalog Generation
Please enter below the Fully Qualified Data Set Name
of the Graphics Catalog to be created or nodified.
Do not enclose the Data Set Name in Quotes
Graphics Catalog DSN: uidacct.UAM.SAMPLE -
Enter the NAME and Description of this graphic. This
information will be stored in the Graphics Catalog and
will aid in identifying the plot.
Name: CTILE
Description: NEW YORK 11JUL88 03 LI B88 AVG CONG
PFl/PF13=Help PF3/PF15-Prev Menu PF4/PFl6=Main Menu
This screen allows you to permanently save any or all graphics that you generate in a device independent SAS
Graphics Catalog. Because this is a device independent file, you can replay these graphics later on any
graphics device and change as many colors you desire.
You will be asked for the name of the data set that will contain the graphics catalog as well as some
descriptive information that will aid in later identification of the plot. If the data set name you supply already
exists, the file will be kept and the current graphic will be added to any existing graphics. No default data set
name is supplied, but suggested descriptive information is furnished.
Instructions:
Enter the fully qualified name of the data set you wish use for the SAS Graphics Catalog in the space
provided. Be sure not to enclose the data set name in quotes. If the data set already exists, it will be kept and
the current graphic will be added to it.
The "Name" and "Description" fields are required and are used to aid in identifying the type of graphic in the
catalog without displaying it on the terminal screen.
81
-------
4. SCREEN
Spatial Graphics: Graphics Catalog Generation Screen
(concluded)
If meaningful values of "Name" and "Description" were supplied when the graphic was generated, you should
be able to easily identify the graphic. For this reason, we recommend that you use the default values that are
supplied, which are explained below.
Default values for the "Name" field are either "CTILE" or "CVALUE" for color tile and gridded value maps,
respectively and "MTILE" or MVALUE" for monochrome tile and gridded value maps, respectively. The
default value of the "Description" field is always of the form:
study start-day species Ln scenario stat
where:
study = the "STUDY" variable supplied in the Extract module
start-day = the Start date for this graphic
species = the species for which the graphic is being generated
n = the number of the level for which the graphic is being generated
scenario = the "SCENARIO" variable supplied in the Extract module
stal = the statistic chosen for this graphic, which will be one of the following: "AVG
CONC" or "MAX CONC" for average and maximum concentrations, respectively,
"HR OF MAX" for hour of maximum concentration, "CONC AT HR start-time"
for concentration at a given hour, where start-time is the value of the starting hour
specified on the Spatial Graphic Selection Screen, "PCT DIFP or "DIFF" for
percent difference and difference, respectively.
Thus, the default description for a color shaded tile map for the New York domain showing the average base
year 1988 ozone concentration for level 1 on July 11,1988 would be:
NEW YORK 11JUL88 O3 LI B88 AVG CONC
and the default name would be "CTILE".
Whes you are done specifying all the necessary information, press fEnter] to process your selections.
If the data set you specified already exists, it will be kept and the current graphic will be added to it. If the
data set does not exist, you will be asked if you want to create it. If you do not wish to create the data set,
enter a "N" and press (Enter), if you enter a "Y", you will be asked if you want to catalog or delete the data
set upon deallocation. If you want the catalog and its contents to be saved for use in future SAS sessions,
enter a "C"and press {Enter).
The screen will clear and the next screen displayed will be the PROC GREPLAY screen. For complete
information on using PROC GREPLAY, see Chapter 36 of the Version 6 edition of the SAS/GRAPH
User's Guide. When you are finished using the Graphics Catalog, press [PFislto return to UAMPPS.
Error Messages:
None.
82
-------
4. SCREEN
4.3 GRAPHICS CATALOG
Within the SAS data management system, the Graphics Catalog is the storage area for the graphics
command string that produces graphic output from the processed data. The resulting graphic data can be
"replayed" to redisplay the graphic much more rapidly than repeating the graphic generation process. A
temporary graphics catalog is always produced when SAS graphics procedures are run, but this temporary
catalog and its contents are lost when the SAS session is concluded.
To save graphics output between SAS sessions, you must specify a permanent graphics catalog. The
"Save the Graphic" option on the Termination Selection Screen of the graphics creation module allows you
to create a permanent SAS graphics catalog and to store graphics output in it. To redisplay, merge graphics,
remap colors, or otherwise manipulate the stored graphics, you must run the SAS GREPLAY procedure.
GREPLAY may be run from the TSO Ready prompt by executing the SAS CLIST and subsequently
submitting PROC GREPLAY to the system with the proper parameters. The Graphics Catalog
management section of the UAMPPS allows you a "shortcut" to access PROC GREPLAY from the
UAMPPS menu system.
83
-------
4. SCREEN
Graphics Catalog: Catalog Management Menu Screen
UAMPPS 3.0
Graphic Catalog Management Menu
Please enter below the Fully Qualified Data Set Same
of the Graphics Catalog to be created or modified.
Do not enclose the Data Set Name in Quotes*
Graphics Catalog DSN: uidacct.UAM.OAOPS.GCATLG
Graphics Device : JBM317^
PFl/PFl3=Help PF3/PFl5=Prev Menu PF4/PFl6=Main Menu
If you choose the "Graphics Catalog" block on the main menu, you will find yourself in the above screen.
This screen is intended to be a quick way for you to access PROC GREPLAY from within the UAMPPS.
You may create a graphics catalog from this screen or access any existing one.
Instructions:
Enter the fully qualified data set name for the Graphics Catalog. (Do not confuse this data set name with the
extracted UAM data sets.)
Also, enter your graphics device.
When you press [Enter], the screen will clear and the next screen displayed will be the PROC GREPLAY
screen.
When you have finished using PROC GREPLAY, press Kyis] to return to the main menu.
Error Messages:
None.
84
-------
4. SCREEN
Graphics Catalog: GREPLAY Screen
PROG GREPLAY
Command •» «>
IGOUT: GOUT.PLOTS
TC:
CC:
Sel Name
^AR
BOX
SLINE
CVALUE
CTILE
GOUT:
Template:
Cmap:
Device;
Scroll:
Type Description
I
1
I
I
I
NEW
03
NEW YORK 11JUL88 03 11 B88 HRLY COKC
YORK 11JUL88 O3 t.1 B88 HRLY HAXC
NEW YORK 11JTJL88 03 U. B88 HR OF MAX
NEW YORK 11JUL88 O3 Ll B88 PCT DIFF
IBM3179
PAGE
Updated
09/30/91
09/30/91
09/30/91
09/30/91
09/30/91
Field: Description:
"IGOUT" The name of the input catalog (the catalog currently displayed).
"GOUT" The name of the output catalog (the catalog to which the graphic will be replayed or
copied).
"Device* The graphics device on which the graphic will be displayed (generally the current graphics
device).
"TC" The template catalog containing the template to be used when displaying the graphic (leave
blank if no template is used).
"Template" The name of the template to be used to display the graphic (leave blank if no template is
used).
"Scroll" The current scroll value for an entry list greater than one screen in length.
"CC" The color map catalog from which the color map is drawn.
"Cmap" The name of the color map used to display the graphic (leave blank if no color map is
used).
"Sel" The selection field; used to enter commands that apply to the corresponding catalog entry.
85
-------
4. SCREEN
Graphics Catalog: GREPLAY Screen
(concluded)
Field: Description:
"Name" The name that was assigned to the graphic by the "Name" field on the Graphics Catalog
Generation screen.
"Type" The type of graphics output. See Chapter 3 of SAS/GRAPH Reference for more
information.
"Description" The description that was assigned to the graphic by the "Description" field on the Graphics
Catalog Generation screen.
"Updated" The date that the catalog entry was generated.
Instructions:
Display a graphic:
Place an S in the "Sel" field and press [Enter].
Delete a graphic:
Enter DEL in the "Sel" field and press [Enter].
Copy a graphic:
Place a C in the "Sel" field and press [Enter]. The graphic entry will be copied to the catalog specified
in the "GOUT field.
Display a graphic (or graphics) in a template:
Enter a template catalog name in the "TC" field and the name of the template in the "Template" field.
Next select the graphic (or graphics) from the catalog list by placing an S and a number (or numbers,
i.e. SI, S2, etc.) in the "Sel" field(s) indicating the order in which to display the graphics in the
template. Press [Enter].
Change the colors in a graphic:
Enter a color map catalog name in the "CC" field and the name of the color map in the "Cmap" field.
Next select the graphic from the catalog list by placing an S in the selection field. Press [Enter 1.
Create or edit a template:
Enter a template catalog name in the "TC" field.
On the command line type: edit templatename-TEMPLATE, then press [Enter ]. The TEMPLATE
DESIGN window will be displayed for editing of the template. See SAS/GRAPH Reference (pages
1241-1244) for additional information on the TEMPLATE DESIGN window.
Create or edit a color map:
Enter a color map catalog name in the "CC" field.
On the command line type: edit colormapname.CMAP, then press fEnter]. The COLOR MAPPING
window will be displayed for editing of the color map. See SAS/GRAPH Reference (pages
1244-1245) for additional information on the COLOR MAPPING window.
Change the current catalog:
Enter the new catalog name in the "IGOUT field and press [Enter]. The new catalog list will be
displayed.
86
-------
5. SYSTEM INPUT
SECTION 5
SYSTEM INPUT
Input for the UAMPPS Extract module consists of two UAM files:
(1) the UAM "average" prediction file-- an output file from the UAM.
(2) the UAM "boundary" file--a UAM input file.
The boundary file is used in the UAMPPS to establish geographical limits for processing data
contained in the prediction file. The prediction file contains concentration values (one value for each hour)
based on an average of the values for the preceding hour. For example, the first concentration is the average
of the values that were calculated between hour 0 and the end of the first hour. The UAM Average
Prediction file contains data for 24 species and a variable number of vertical levels and hours.
The UAM average prediction file is divided into two types of records: header records and time
varying records.
There are four header records. These records contain information on the domain, species, time
frame, and control strategy for the data contained in the file. The first header record describes the chemical
and temporal nature of the file. The second record describes the spatial characteristics of the domain. The
third record describes the layout of the concentration data records in records that follow. The last header
record contains the names of the species contained in the UAM file.
Following the header records, the prediction file contains time varying data consisting of three types
of data records. The first record provides temporal information for the next two data record types. The
segment record indicates which segment the following data represents. Current UAM implementations
support only one segment. The basic data record contains a grid of concentration values for each species
and vertical level.
The header record for the boundary file is identical to that of the prediction file. Following the
header record, the boundary file contains both time invariant and time varying data. The time invariant data
87
-------
5. SYSTEM INPUT
defines the boundaries of the region, both the external boundaries defined in the data preparation and the
internal segment interfaces created when the region is segmented. For each segment there are four
Boundary Definition Records, one record for each edge (Left, Right, Bottom and Top). Each Boundary
Definition Record defines the location of the boundary cells at an edge of a segment. The time varying data
consists of two record types, one set for each time interval. The first record provides temporal information
for the data records. The boundary concentration records are in groups of four records (one for each edge)
for each species and contain boundary concentration information on the vertical plane along the edge.
Appendix A provides a detailed description of the UAM file formats.
88
-------
6. SYSTEM OUTPUT
SECTION 6
SYSTEM OUTPUT
6.1 FORMAT
Output from the UAMPPS Extract module may take one of two forms depending on the user's
response on the Extract Module Startup Screen.
(1) A response of "N" produces a SAS-formatted data set, which can be used for input to the
UAMPPS or UAMPES Graphics modules.
(2) A response of "Y" produces a generic text file for export to other systems.
The SAS-formatted data set consists of two members: a concentration file and a descriptive file.
The concentration file contains a record for each grid cell--i.e., 24 hourly concentration values along
with the identifying information for the type of species, vertical level, scenario, data, and row and column
location in the domain. Files containing more than 24 hours will have more than one record for each grid
cell. This method of storing the data allows for variability in the domain size without the limitations on
record length that might arise from a gridded format.
The descriptive file contains the information from the UAM output file header. This information is
especially important for the graphics procedures that create spatial plots requiring geometric information
about the domain. It is also very important for interfacing with Geographic Information System (GIS)
applications and utilities.
If you are familiar with SAS system software, this SAS data set can be exported and used to generate
other types of graphics, reports, or statistical analyses.
The generic text file format consists of straight EBCDIC (or ASCII) text fields separated by one blank
space. The first four records contain the file descriptive information. The remaining records contain the file
concentration data.
More detailed descriptions of the extracted file formats are presented in Appendix B and Appendix C.
89
-------
6. SYSTEM OUTPUT
6.2 SAS GRAPHICS CATALOG
The graphics images that you generate with the UAMPPS can be saved to a SAS Graphics Catalog for
later use. A discussion of generating and saving graphics is covered in Sections 4.2.1 (Statistical Graphics),
4.2.2 (Temporal Graphics), and 4.2.3 (Spatial Graphics).
Once a graphic is saved in the catalog, it can be replayed using PROC GREPLAY and the image can
be displayed on any of the SAS-supported devices, regardless of the device on which it was generated. For
example, if you created a graphic using an IBM 3179G terminal and saved it to a graphics catalog, you can
use PROC GREPLAY to display this graphic on a Tektronix 4211 terminal or any other device supported by
SAS. A discussion of hardware devices supported by SAS can be found in Chapter 4 of the Version 6 edition
of the SAS/GRAPH User's Guide.
By using a color map, you can change any or all of the colors of a graphic when replaying it from a
graphics catalog. For example, if all of the titles of a particular graphic were white when you saved the
graphic, you may use a color map to change white to red. Note that, not only the titles, but anything that was
printed in white will be printed in red. Explanations and examples of color mapping with PROC
GREPLAY can be found in Chapter 36 of the Version 6 edition of the SAS/GRAPH User's Guide pp. 1198,
1224,1244,1254,1255.
For further information about graphics catalogs and replaying the graphics, you should consult
Chapters 3 and 36 of the SAS/GRAPH User's Guide.
90
-------
APPENDIX A
UAM OUTPUT FILE FORMAT
The UAM files contain several types of logical records broadly defined in two categories: header
records and data records. The header records serve to define the temporal and spatial characteristics of the
model run (Tables A-l and A-3). The data records contain the actual concentration data as well as indicators
for species and hour (Tables A-2 and A-4).
-------
TABLE A-l. AVERAGE CONCENTRATION FILE HEADER RECORD DEFINITIONS
Each UAM output file contains four header records containing information on the domain,
species, time frame, and control strategy for the data contained in the file. The file produced by the UAM
is a binary file.
Variable
Type
Length
Field length
Description
Header Record 1 (model description)
describes the chemical and temporal nature of the data in the file.
FILNAM
FILEID
NOSEG
NOSPEC
IDATB
TIMBEG
JDATET
TIMEND
Character
Character
Integer
Integer
Integer
Float
Integer
Float
10
60
4
4
4
4
4
4
10
60
2
2
6
6
6
6
Heading information
Heading information
Number of segments
Number of species
Starting date for model run
Starting time for model run
Ending date for model run
Ending time for model run
Header Record 2 (domain description)
describes the geometry of the domain.
XREF
YREF
IUTM
XORG
YORG
DELTAX
DELTAY
NOXG
NOYG
NOZG
NCELL1
NCELL2
SURFHT
HTMIN1
HTMIN2
Float
Float
Integer
Float
Roat
Float
Float
Integer
Integer
Integer
Integer
Integer
Float
Roat
Roat
4
4
4
4
4
4
4
4
4
4
4
4
4
4
4
10
10
3
10
10
6
6
4
4
4
4
4
7
7
7
Reference origin (.r-direction)
Reference origin (y-direction)
UTM zone
Origin of grid (.r-direction)
Origin of grid (y-direction)
Grid interval (r-direction)
Grid interval (y-direction)
Number of columns in grid (x)
Number of rows in grid (v)
Number of vertical levels in grid (2)
Number of vertical levels in lower layer
Number of vertical levels in upper layer
Height to base of surface level, m
Minimum height of lower level, m
Minimum height of upper level, m
Header Record 3 (data description)
describes the layout of the concentration data records.
ILOCX
ILOCY
NOX
NOY
Integer
Integer
Integer
Integer
4
4
4
4
5
5
5
5
Dummy
Dummy
Number of data values in x-direction
Number of data values in y-direction
Header Record 4 (file contents)
contains the names of the species contained in the file.
MSPEC
Character
10
10
Species name
A-2
-------
TABLE A-2. AVERAGE CONCENTRATION FILE DATA RECORD DEFINITIONS
Variable
Type
Length
Field length
Description
Data Record 1 (temporal information)
provides the start and end time for the following data block.
IBGDAT
GETTIM
IENDAT
ENDTIM
Integer
Integer
Float
Float
4
4
4
4
10
10
10
10
Starting date for data block
Starting time for data block
Ending date for data block
Ending time for data block
Data Record 2 (segment record)
indicates the segment (always one segment) and the species name of the following data block.
ISEG
FILNAM
Integer
Character
4
10
4
10
Segment indicator
Species name
Data Record 3 (concentration record)
contains the actual data for the model run.
(This record repeats with nine values per physical record
until all data in all logical rows and columns are complete.)
CONC
Float
Concentrations, in units of ppm
A-3
-------
TABLE A-3. BOUNDARY FILE HEADER RECORD DEFINITIONS
All UAM input and output files have a similar overall file structure. The header record
information for the UAM Boundary input file is identical to that of the Average concentration output file.
Following the header records are two categories of data records: regional boundary data and time-interval
concentration data.
Variable
Type
Length
Field length
Description
Header Record 1 (model description)
describes the chemical and temporal nature of the data in the file.
FILNAM
FILEID
NOSEG
NOSPEC
IDATB
TIMBEG
JDATET
TIMEND
Character
Character
Integer
Integer
Integer
Float
Integer
Float
10
60
4
4
4
4
4
4
10
60
2
2
6
6
6
6
Heading information
Heading information
Number of segments
Number of species
Starting date for model run
Starting time for model run
Ending date for model run
Ending time for model run
Header Record 2 (domain description)
describes the geometry of the domain.
XREF
YREF
IUTM
XORG
YORG
DELTAX
DELTAY
NOXG
NOYG
NOZG
NCELL1
NCELL2
SURFHT
HTMIN1
HTMIN2
Float
Float
Integer
Roat
Float
Float
Float
Integer
Integer
Integer
Integer
Integer
Float
Float
Float
4
4
4
4
4
4
4
4
4
4
4
4
4
4
4
10
10
3
10
10
6
6
4
4
4
4
4
7
7
7
Reference origin (x-direction)
Reference origin (y-direction)
UTM zone
Origin of grid (x-direction)
Origin of grid (y-direction)
Grid interval (r-direction)
Grid interval (y-direction)
Number of columns in grid (r)
Number of rows in grid (y)
Number of vertical levels in grid (z)
Number of vertical levels in lower layer
Number of vertical levels in upper layer
Height to base of surface level, m
Minimum height of lower level, m
Minimum height of upper level, m
Header Record 3 (data description)
describes the layout of the concentration data records.
ILOCX
ILOCY
NOX
NOY
Integer
Integer
Integer
Integer
4
4
4
4
5
5
5
5
Dummy
Dummy
Number of data values in .r-direction
Number of data values in _y-direction
Header Record 4 (file contents)
contains the names of the species contained in the file.
MSPEC
Character
10
10
Species name
A-4
-------
TABLE A-4. BOUNDARY FILE DATA RECORD DEFINITIONS
Variable
Type
Length
Field length
Description
Data Records 1-4 (regional boundary data)
Four Boundary Definition Records, one record for each edge. The edges are defined as follows:
1 Left West Lower limit column index for each row
2 Right East Upper limit column index for each row
3 Bottom South Lower limit row index for each column
4 Top North Upper limit row index for each column
Each Boundary Definition Record defines the location of the boundary cells at an edge of a segment. The
first three fields identify the edge and its dimensions:
SEGNUM
EDGNUM
CELNUM
Integer
Integer
Float
4
4
4
4
4
4
Segment number (must be 1).
Edge number.
Number of cells on edge (i.e., number of
rows and columns).
The next four fields define the boundary location for the grid index (row or column) along each edge:
INDEX
SEGADJ
XINDEX
YINDEX
Integer
Integer
Integer
Integer
4
4
4
4
4
4
4
4
Index, within the segment, of the cell at the
edge of the region modeled. If 0, row or
column is omitted from the simulation
and the next three numbers are ignored.
Segment number in which adjacent cell is
located. If 0, boundary is external and
next two numbers are ignored.
x-index of adjacent cell within segment
defined by SEGADJ.
y-index of adjacent cell within segment
defined by SEGADJ.
Data Records 5+ (time-interval concentration data)
contains one set of the following records for each time interval.
Time Interval Record contains four fields:
BEGDATE
BEGTIME
ENDDATE
ENDTIME
Integer
Float
Integer
Float
4
4
4
4
4
4
4
4
Beginning date (Julian).
Beginning time (hours).
Ending date (Julian).
Ending time (hours).
For each segment in the region, there is a set of Boundary Concentration Records, grouped by species,
with four records (one for each edge) for each species.
SEGNO Integer
SPECIES Character
EDGENO Integer
BDRYCONC Float
4
10
4
4
10
4
Segment number (must be 1).
Species name.
Edge number.
Boundary concentrations at each vertical
level for each cell along the edge.
For rows or columns that are not to be
simulated and for edges that represent
internal segment boundaries, these num-
bers must be present but will be ignored.
A-5
-------
APPENDIX B
EXTRACTED SAS DATA SET FORMAT
-------
TABLE B-l. FIELDS IN SAS-FORMAT SPECIES/VERTICAL LEVEL EXTRACTION FILES
OF MODEL CONCENTRATION DATA
Variable
Type
Length
Description
DATATYPE
STUDY
SCENARIO
SPECIES
LEVEL
SP
LV
CONCDATE
ROW
COL
CONC(24)
Character
Character
Character
Character
Character
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
8
8
8
8
8*24
Type of model concentration data
Name of study selected for retrieval
Name of modeling scenario selected
Code for a species selected-
e.g., "O3" for ozone
Code for a vertical level selected-
e.g., "1" for level 1
Ordinal number of SPECIES for the model-
e.g., "3" for ozone.
Ordinal number of LEVEL for the model-
e.g., "2" for level 2.
Date of the data in this record, in SAS date format
Row number of the model grid cell to which data in this
record pertain
Column number of the model grid cell to which data in
this record pertain
Concentration of SPECIES at each hour of the day
specified by CONCDATE. These values may be
referenced as separate fields (CONC1, ...,
CONC24) or as an array (CONC{1>, ...,
CONC{24}).
B-2
-------
TABLE B-2. FIELDS IN SAS-FORMAT HEADER EXTRACTION FILES
OF MODEL CONCENTRATION DATA
Variable
DELTA_X
DELTA_Y
E_DAY
E_TIME
EN_DATE
FILEID
FILENAME
MINHT_L
MINHT_U
NUM_COL
NUM_HRS
NUM_LEV
NUM_ROW
NUM_SEG
NUM_SPEC
NUMLEV_L
NUMLEV_U
NUMVAL_X
NUMVAL_Y
Type
Numeric
Numeric
Numeric
Numeric
Character
Character
Character
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Length
8
8
8
8
n
t
60
10
8
8
8
8
8
8
8
8
8
8
8
8
Description
Grid interval in ^-direction, meters
Grid interval in ^-direction, meters
Ending day, Julian
Ending time, hour
Ending date, DDMMMYY
File identifier comment
File name, e.g. 'AVERAGE'
Minimum height to lower level, meters
Minimum height to upper level, meters
Number of columns
Time interval covered by file, hours
Number of vertical levels
Number of rows
Number of segments
Number of species
Number of levels in lower layer
Number of levels in upper layer
Number of values in .it-direction
Number of values in y-direction
(continued)
B-3
-------
TABLE B-2 (concluded).
Variable
S_DAY
S_TIME
ST_DATE
SURF_HT
UTM_ZONE
X_ORG
Y_ORG
X_REF
Y_REF
SPEC(24)
Type
Numeric
Numeric
Character
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Character
Length
8
8
7
8
8
8
8
8
8
40
Description
Starting day, Julian
Starting time, hour
Starting date, DDMMMYY
Height to base of surface level, meters
UTMzone
x-coordinate of grid origin (UTM Easting), meters
y-coordinate of grid origin (UTM Northing), meters
^-coordinate of reference origin, meters
y-coordinate of reference origin, meters
Available species in the base UAM file. These values may
be referenced as separate fields (SPEC1, ...,
SPEC24) or as an array (SPEC{1>, ..., SPEC{24}).
B-4
-------
APPENDIX C
EXTRACTED TEXT FILE FORMAT
-------
TABLE C-l. FIELDS IN EXTRACTED TEXT-FORMAT FILES
(A) The following fields occur in sequence (each separated by a single space), once at the beginning of
the file.
Variable
FILENAME
FILEID
NUM_SEG
NUM_SPEC
S_DAY
E_DAY
SJTIME
E_TIME
NOURS
NUM_HOURS
X_REF
Y_REF
UTM_ZONE
X_ORG
Y_ORG
DELTA_X
DELTA_Y
NUM_COL
Type
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Description
File name, e.g. 'AVERAGE'
File identifier comment
Number of segments
Number of species
Starting day, Julian
Ending day, Julian
Starting time, hour
Ending time, hour
Number of hours
Total time span covered in data (in hours)
jc-coordinate of reference origin, meters
y-coordinate of reference origin, meters
UTM zone
.r-coordinate of grid origin (UTM Easting), meters
y-coordinate of grid origin (UTM Northing), meters
Grid interval in x-direction, meters
Grid interval in y-direction, meters
Number of columns
(continued)
C-2
-------
Variable
Description
NUM ROW
NUM LEV
NUMLEV L
NUMLEV U
SURF HT
MINHT L
MINHT U
NUMVAL X
NUMVAL Y
SPEC1-24
ST DATE
EN DATE
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Number of rows
Number of vertical levels
Number of levels in lower layer
Number of levels in upper layer
Height to base of surface level, meters
Minimum height to lower level, meters
Minimum height to upper level, meters
Number of values in ^-direction
Number of values in y-direction
Available species in the base UAM file. These values may be
referenced as separate fields (SPEC1,..., SPEC24) or as an array
(SPEC{1},...,SPEC{24}).
Starting date, DDMMMYY
Ending date, DDMMMYY
(B) The following fields occur in sequence (each separated by a single space) and repeat for all
remaining data in the file.
CON CD ATE
SP
LV
Character
Character
Character
Date of the data in this record, DDMMMYY
Ordinal number of SPECIES for the model-
e.g., "20" for ozone in ROM 2.1
Ordinal number of LEVEL for the model-
e.g., "2" for level 2 in ROM 2.1
(concluded)
C-3
-------
Variable
Type
Description
COL
ROW
STUDY
SCENARIO
SPECIES
LEVEL
CONC1-24
Character
Character
Character
Character
Character
Character
Character
Column number of the model grid cell to which data in this record
pertain
Row number of the model grid cell to which data in this record
pertain
Name of study selected for retrieval
Name of modeling scenario selected
Code for a species selected--
e.g., "O3" for ozone
Code for a vertical level selected--
e.g., "1" for level 1
Concentration of SPECIES (in ppm) at each hour of the day
specified by CONCDATE. These values may be referenced as
separate fields (CONC1,..., CONC24) or as an array (CONC{1},
...,CONC{24}).
C-4
-------
TECHNICAL REPORT DATA
(Please read Instructions on the reverse before completing)
3. RECIPIENT'S ACCESSION NO
4. TITLE ANDSUBJITLE
User's Guide for the Urban Airshed Model
Volume VI: User's Manual for the
Postprocessing System
5. REPORT DATE
November
19, 1991
6. PERFORMING ORGANIZATION CODE
7. AUTHOR(S)
Art Alexander (CSC)
8. PERFORMING ORGANIZATION REPORT NO
9. PERFORMING ORGANIZATION NAME AND ADDRESS
Computer Sciences Corporation (CSC)
Applied Technology Division
P.O. Box 12767
Research Triangle Park, NC 27709
10. PROGRAM ELEMENT NO.
11. CONTRACT/GRANT NO
12. SPONSORING. AGENCY NAME AND ADDRESS
U.S. Environmental Protection Agency (EPA)
Technical Support Division (MD-14)
Office of Air Quality Planning and Standards
Research Triangle Park, NC 27711
13. TYPE OF REPORT AND PERIOD COVERED
14. SPONSORING AGENCY CODE
15 SUPPLEMENTARY NOTES
16 ABSTRACT
The UAM Postprocessing System (UAMPPS) is a data display and
analysis tool for evaluating emission control strategies. After
executing the UAM system the results from one or more model runs
may be graphically compared. The UAMPPS creates time series plots,
tile maps, bar charts, boxplots, scatter plots and quantile plots.
Through a series of menus the user has a wide range of flexibility
in scaling ,and labeling the graphs.
17.
KEY WORDS AND DOCUMENT ANALYSIS
DESCRIPTORS
b.lDENTIFIERS/OPEN ENDED TERMS C. COSATI Field/Group
Urban Airshed Model (UAM)
species, scenario, guantile, tiles,
boxplots, SAS graphics catalog
18. DISTRIBUTION STATEMENT
Release Unlimited
19. SECURITY CLASS (Tins Report}
21. NO. OF PAGES
20 SECURITY CLASS (Tins page)
22 PRICE
93
EPA Form 2220-1 (Rev. 4-77) PREVIOUS EDI TION i s OBSOLET E
-------
U.S. Environmental Protection Agency
Region 5, Library (PL-12J)
77 West Jackson Boulevard, 12th Floor
Chicago, IL 60604-3590
------- |