Visualization Environment for Rich Data Interpretation (VERDI 1.3): User’s Manual

 

U.S. EPA Contract No. EP-W-05-045, “Operation of the Center for Community Air Quality Modeling and Analysis”

 

 

 

 

 

 

 


Prepared for:       William Benjey and Donna Schwede

                              U.S. EPA, ORD/NERL/AMD/APMB

                              E243-04

                              USEPA Mailroom

                              Research Triangle Park, NC 27711

 

 

Prepared by:       Liz Adams and Qun He

                              Institute for the Environment

                              The University of North Carolina at Chapel Hill

                              137 E. Franklin St., CB 6116

                              Chapel Hill, NC 27599-6116

 

 

Date:                     June 15, 2010

 


Contents

 

1     Introduction. 1

1.1     Background. 1

1.2     Where to Obtain VERDI. 2

1.3     Where to Obtain VERDI Documentation. 5

1.4     Help Desk Support for VERDI. 7

1.5     Future VERDI Development 10

2     Requirements for Using VERDI. 11

2.1     Java Runtime Environment 11

2.2     Memory and CPU Requirements. 11

2.3     Requirements to Run VERDI Remotely. 11

2.4     Graphics Requirements. 11

2.5     Display Properties. 12

3     VERDI Installation Instructions. 12

3.1     VERDI Installation. 12

3.2     Installation Instructions for Linux and Other Non-Windows JRE 6 Supported System Configurations. 12

3.3     Installation Instructions for Windows. 14

3.4     Setting VERDI Preferences. 17

4     Starting VERDI and Getting Your Data into VERDI. 18

4.1     Starting VERDI. 18

4.1.1     Windows. 18

4.1.2     Linux and Other Non-Windows JRETM 6 Supported System Configurations. 18

4.2     Main Window.. 18

4.3     Floating the Dataset and Formula Panes. 20

5     Navigating VERDI’s Main Menu Options. 20

5.1     File Menu Options. 21

5.1.1     Open Project 21

5.1.2     Save Project 21

5.1.3     View Script Editor 21

5.2     Plots Menu Options. 22

5.2.1     Undock All Plots. 22

5.2.2     Animate Tile Plots. 22

5.3     Window Menu Options. 23

5.3.1     Datasets and Formulas. 23

5.3.2     List of Plots. 23

5.4     Help Menu Options. 24

6     Working with Gridded Datasets. 24

6.1     Gridded Input File Formats. 24

6.2     Example Datasets. 24

6.3     Adding and Removing a Dataset from a Local File System.. 25

6.4     Adding and Removing a  Dataset from a Remote File System.. 27

6.4.1     Remote File Browser 27

6.4.2     Adding Additional Remote Hosts. 30

6.5     Variables List 31

6.6     Time Steps, Layers Panels. 32

6.7     Domain Panel 32

6.8     Saving Projects. 33

6.9     Configuring Default Directories. 33

7     Working with Formulas. 34

7.1     Adding and Removing a Formula. 34

7.2     Example Formulas. 35

7.3     Selecting a Formula for Plotting. 35

7.4     Saving Formulas. 35

7.5     Time Step Range, Layer Range, and Edit Domain. 36

8     Working with Area Files. 36

8.1     Area File Formats. 36

8.2     Example Area File. 36

8.3     Adding and Removing an Area File. 36

8.4     Areas List 37

8.5     Areal Interpolation. 37

9     Spatial and Temporal Data Subsetting. 42

9.1     Specify Time Step Range. 42

9.2     Specify Layer Range. 43

9.3     Specify Domain Range. 43

9.4     Rules of Precedence for Subsetting Data. 45

10   Creating Plots. 46

10.1   Tile Plot 46

10.2   Fast Tile Plot 48

10.3   Areal Interpolation Plot 49

10.3.1   Option Pull-down Menu Item.. 49

10.3.2   Areal Values for Polygon Segment 53

10.3.3   View and Export Areal Plot Data in Spreadsheet Format 54

10.3.4   Export Areal Plot Data to Shapefiles. 55

10.4   Vertical Cross Section Plot 56

10.5   Time Series Plot 58

10.6   Time Series Bar Plot 58

10.7   Scatter Plot 59

10.8   Vector Plot 61

10.9   Contour Plot 63

11   Plot Menu Bar. 63

11.1   File Menu Options. 65

11.2   Configure Menu Option. 65

11.2.1   Configuring Plots. 65

11.2.2   Loading and Saving Configuration. 68

11.3   Controls Menu Options. 68

11.3.1   Zoom Using the Left Mouse Button. 68

11.3.2   Zoom Using the Right Mouse Button. 68

11.3.2.1      Tile Plot and Vector Plot. 68

11.3.2.2      Fast Tile Plot and Areal Plot. 69

11.3.3   Probing Values at Specific Points. 71

11.3.4   Probing a Domain Region of Data. 71

11.3.5   Set Data Ranges. 72

11.3.6   Showing Latitude and Longitude. 75

11.4   Plot Menu Options. 75

11.4.1   Time Series Plots. 76

11.4.2   Animate Plots. 76

11.4.3   Add Overlays. 77

11.4.3.1      Observational Data Overlays. 77

11.4.3.1.1     Fast Tile Plot Observational Dialog. 77

11.4.3.1.2     Tile Plot Observational Dialog. 79

11.4.3.2      Vector Overlays. 80

11.5   GIS Layer Options (Fast Tile Plot) 82

11.5.1   Add Map Layers. 82

11.5.2   Configure GIS Layers (Fast Tile Plot) 84

11.5.3   Set Current Maps as Default Location. 87

12   Supported Grid and Coordinate Systems  (Map Projections) 87

12.1   IO/API-formatted Data. 87

12.2   CAMx Gridded Data. 90

13   I/O API Utilities, Data Conversion Programs,  and Libraries. 93

14   Contributing to VERDI Development 93

15   Known Bugs. 94

16   Mathematical Functions. 94

17   VERDI Script Editor. 97

18   Command Line Scripting. 104

18.1   Example Command Line Script for Linux Users. 105

18.2   Example Command Line Script for Windows Users. 105

19   Areal Interpolation Calculations. 110

20   Licenses for JAVA Libraries used by VERDI. 110

Acknowledgments. 111

Data Contributions: 112

Sample CAMx Dataset 112

Sample Mercator Projection Dataset 112

Data Reader Contributions. 112

I/O Service Provider (IOSP) Interface for CAMx: 112

Incorporating the IOSP into netCDF netcdf-java v4.1 Library: 112

 


Figures

 

Figure 1‑1. Top of Main VERDI Web Site Page. 3

Figure 1‑2. Downloading VERDI from the CMAS Web Site, Step 1. 3

Figure 1‑3. Downloading VERDI from the CMAS Web Site, Step 2. 4

Figure 1‑4. Downloading VERDI from the CMAS Web Site, Step 3. 5

Figure 1‑5. Getting Documentation on VERDI from the CMAS Web Site. 6

Figure 1‑6. VERDI Documentation on the CMAS Web Site. 7

Figure 1‑7. Top of Bugzilla Form for VERDI. 8

Figure 1‑8. Bottom of Bugzilla Form for VERDI. 9

Figure 1‑9. Add Attachment Form in Bugzilla. 10

Figure 3‑1. VERDI Setup Wizard. 14

Figure 3‑2. License Agreement 15

Figure 3‑3. Selecting an Installation Directory. 15

Figure 3‑4. Setting the Start Menu Folder 16

Figure 3‑5. File Extraction. 16

Figure 3‑6. Installation Complete. 17

Figure 4‑1. Starting VERDI in Windows. 18

Figure 4‑2. VERDI Main Window.. 20

Figure 5‑1. VERDI Main Menu Options. 21

Figure 5‑2. Animate Plots Dialog and Tile Plots. 23

Figure 6‑1. Open Dataset File Browser 25

Figure 6‑2. Datasets Pane Displaying Information about a Dataset 26

Figure 6‑3. Available Hosts in the Remote File Access Browser 27

Figure 6‑4. Select one or more variables from Remote Dataset 28

Figure 6‑5. Remote Dataset Labeled with Number at End of the Filename. 30

Figure 6‑6. Edit ui.properties file to add a remote host 31

Figure 6‑7. Right Click on Variable in Dataset Pane. 32

Figure 6‑8. Dataset Metadata Information. 33

Figure 7‑1. Adding Multiple Variables to Formula Editor 34

Figure 8‑1. Areas Pane. 37

Figure 8‑2. Open Area File Browser 38

Figure 8‑3. Open Area File: Select Name Field. 38

Figure 8‑4. Coordinate System.. 39

Figure 8‑5. Projection Information. 39

Figure 8‑6. Additional Data Fields appear depending on projection selected. 39

Figure 8‑7. Area Name Fields available for Shapefile. 41

Figure 9‑1. Specify Time Step Range. 42

Figure 9‑2. Edit Layer Range in Formula Pane. 43

Figure 9‑3. Using the Slider to View the Domain Panel 44

Figure 9‑4. Edit Domain Dialog Box. 44

Figure 9‑5. Error obtained when incompatible subset domains  are created using the Dataset pane. 46

Figure 10‑1. Tile Plot 47

Figure 10‑2. Fast Tile Plot 48

Figure 10-3. Areal Plot: Area Average. 50

Figure 10‑4. Areal Plot: Area Totals. 51

Figure 10‑5. Areal Interpolation Plot:  Show Grid (Gridded Data) 52

Figure 10‑6. Areal Interpolation Plot: Show Selected Areas. 53

Figure 10‑7. Areal Values for Polygon Segments. 54

Figure 10‑8. Right Click on Area Plot 55

Figure 10‑9. Area Information Spreadsheet 55

Figure 10‑10. Export Spreadsheet 55

Figure 10‑11. Name and save spreadsheet 55

Figure 10‑12. Export Shapefile. 56

Figure 10‑13. Name and save shapefile. 56

Figure 10‑14. Vertical Cross Section Plot 57

Figure 10‑15. Vertical Cross Section Dialog Box. 57

Figure 10‑16. Time Series Plot 58

Figure 10‑17. Time Series Bar Plot 59

Figure 10‑18. Scatter Plot 60

Figure 10‑19. Scatter Plot Dialog Box. 60

Figure 10‑20. Scatter Plot Export Data into a CSV file. 61

Figure 10‑21. Vector Plot 62

Figure 10‑22. Vector Plot Dialog Box. 62

Figure 10‑23. Contour Plot 63

Figure 10‑24. Contour Plot Menu Options. 63

Figure 11‑1. Fast Tile and Areal Plot Pull-down Menu Options. 64

Figure 11‑2. Tile and Vector Plot Pull-down Menu Options. 64

Figure 11‑3. Configure Plot, Titles Tab. 67

Figure 11‑4. Configure Plot, Color Map Tab. 67

Figure 11‑5. Configure Plot, Labels Tab. 67

Figure 11‑6. Configure Plot, Other Tab. 67

Figure 11‑7. Right Click on Tile Plot to Zoom Out 69

Figure 11‑8. Right Click on Fast Tile Plot to access Zoom Out Option. 70

Figure 11‑9. Click on Plot to Probe: Data Value Shown in Lower Left of VERDI, Grid Values Shown in Lower Right 71

Figure 11‑10. Spreadsheet Showing Probed Values for Region of Interest 72

Figure 11‑11. Select Set Row and Column Ranges. 73

Figure 11‑12. Enter Row and Column Values. 74

Figure 11‑13. Lat/Lon Values Shown in Lower Right of VERDI. 75

Figure 11‑14. Plot Menu Options. 76

Figure 11‑15. Animate Plot Dialog Box. 77

Figure 11‑16. Fast Tile Plot Observation Dialog. 78

Figure 11‑17. Fast Tile Plot with Observational Data Overlay. 79

Figure 11‑18. Tile Plot Observation Dialog. 80

Figure 11‑19. Vector Overlay Dialog Box. 81

Figure 11‑20. Wind Vector Overlay on an Ozone Tile Plot 81

Figure 11‑21. Plot Menu Options. 82

Figure 11‑22. Add Map Layers. 83

Figure 11‑23. shape2bin command usage. 84

Figure 11‑23. Manage Layers Dialog Box. 85

Figure 11‑25. Add Layer Pop-up Window.. 86

Figure 11‑26. Edit Layer Pop-up Window.. 87

Figure 12‑1. Lambert Conformal Conic Map Projection Example Plot 88

Figure 12‑2. Polar Stereographic Map Projection Example Plot 89

Figure 12‑3. Mercator Map Projection Example Plot