Using VAPOR in the Yellowstone environment

Preparing data | Starting VAPOR | Visualization example

The VAPOR user interface enables scientists to visualize both large- and small-scale features of time-varying data sets.

Running VAPOR in the Yellowstone environment provides the ability to analyze and visualize these data sets on the Yellowstone, Geyser (recommended), and Caldera clusters without the need to move the data between systems. You can visualize data sets from your own model runs, for example, without moving them from your /glade/scratch space.

Complete documentation of the application's extensive capabilities is on the VAPOR web site.

At a glance

As described below, to use VAPOR you will:

  • Start an interactive job,
  • Start the TurboVNC software for remote visualization,
  • Launch the VAPOR application.

Getting help

Help is available a number of ways:

  • Tool tips, which appear when you hold your mouse over a button or input field.
  • Context-sensitive help within VAPOR. Select Explain This from the Help menu (Figure 1), then click the feature you would like to have explained.
  • Detailed documentation on the VAPOR web site.
VAPOR help
Figure 1 - Click to see an image of the VAPOR screen.

Preparing data

Have your data in place before you start—in your /glade/scratch/username directory or a GLADE project space, for example.

Many data sets that are specific to the WRF and Ocean models can be imported directly into VAPOR. You may need to convert other types of data sets before importing them. (See VAPOR Data Preparation.)

Starting VAPOR

To visualize data with VAPOR in the Yellowstone environment, first launch a job by following the procedures at Running visualization programs.

Briefly, those procedures describe how to:

After you start the VNC client and authenticate, open a terminal within your TurboVNC client window. (Select Applications, then System Tools, then Terminal.)

Then, in that window, run this command to load the VAPOR module:

module load vapor

Use the vglrun command and the executable name as in this example to start the VAPOR interface:

vglrun vaporgui
VAPOR user interface
Figure 2 - Click to enlarge.


With the VAPOR interface open (Figure 2), you can load your data set and proceed. See the detailed documentation for visualizing data on the VAPOR web site.

The following example demonstrates some basic functions.

Visualization example using WRF-ARW

This documentation will be most helpful if you refer to it after starting VAPOR as described above, then work through the example to create a basic visualization.


  1. Load your data set
  2. Stretch the scene
  3. Display an image
  4. Define a variable
  5. Edit the transfer function
  6. Capture an animation

Loading a data set

This example assumes that you have copied the sample WRF-ARW data files from /glade/u/sampledata/vapor/WRF/Katrina to your /glade/scratch/username/wrf_sample directory or similar location.

Substitute your own directory name and data set as appropriate.

Load data
Figure 3 - Click to enlarge.



  1. From the Data menu at the top of the VAPOR window, click Import data into current session, then WRF-ARW.
  2. Use the Look in dropdown to locate your file. (Figure 3)
  3. Select all of the files you will be visualizing and click Open.
  4. A flat rectangle will appear on the screen to indicate the bounds of the current region. Stretch the scene.

Once the scene is established, you can manipulate it as follows.

  • Rotate the scene by clicking and dragging with your left mouse button.
  • Zoom in and out by dragging your right mouse button up and down.
  • Move it horizontally or vertically by dragging with your middle mouse button.

Stretching a scene

You may need to adjust the “scene stretch” to visualize 3D data effectively. For example, if the box is 1,000 km long and 1,000 km wide but only 20 km high, the scene will be quite flat in the Z dimension.

Stretch scene
Figure 4 - Click to see the whole panel.



  1. From the Edit menu at the top of your VAPOR window, click Edit Visualizer Features. The editor will open in a new window. (Figure 4)
  2. Enter 50 for scene stretch factor Z.
  3. Click OK at the top of the panel.

The box in the scene will be taller, as will the portion of the terrain in the scene.

Displaying images

Display a background image to help you see the geographic area associated with the data you are visualizing.

Stretch scene
Figure 5 - Click to enlarge.



  1. Select the Image tab.
  2. Click Select Installed Image, then choose the background image you want to use – BigBlueMarble.tiff, for example. (If you retrieved a different terrain image, choose Select Image File instead and locate that image.)
  3. Check Apply to terrain.
  4. Check the View box next to Instance: 1. A small portion of the image will be visible.
  5. Select Image from the Modes dropdown menu.
  6. Right click the red image handles (Figure 5) and drag them to expand the portion of the image that will be visible.
  7. Uncheck and then recheck the View box next to Instance: 1.

Defining and selecting a variable to visualize

You can either select a variable to visualize from the Variable dropdown list or define a new variable.

For this demonstration, define a variable and add it to the dropdown list as follows.

Define variable
Figure 6 - Click to see the whole panel.



  1. From the Edit menu, click Edit Python program defining a new variable.
  2. Click the checkboxes for variables U, V, and W in the Input 3D Variables box. (Figure 6)
  3. Click Add 3D variable.
  4. Name the new variable "wind" and click OK.
  5. In the input field, type: wind = sqrt(U*U+V*V+W*W)
  6. Click Test to confirm that you did that correctly. (If the result is not "Successful Test," double-check the previous steps.)
  7. Click Apply after conducting a successful test.

See Using Python with VAPOR for related information.

After defining the new variable, take these additional steps:

  1. Click the DVR tab.
  2. Select the wind variable from the Variable dropdown list.
  3. Check the View box next to Instance: 1.

Editing the transfer function

The Transfer Function Editor controls colors and opacity in the volume rendering of your data.

Edit transfer function
Figure 7 - Click to enlarge.



  1. Select the DVR tab. (Figure 7)
  2. Choose your new wind variable from the Variable menu. 
  3. Click Fit Data, then Fit to View, then Histo.
  4. Click Load Installed TF button (near the bottom of the control panel) and select pre-installed transfer function reversed.vtf. This reverses the color map so larger values (greater wind speeds, for example) are red and smaller values are violet. 
  5. Select the variable interval to be mapped to color and opacity. For example, drag the left end of the arrow at the top of the Transfer Function Editor (Figure 8) to the right about one-third (1/3) of the way to exclude low wind values.
  6. Reduce the opacity at the two middle control points by dragging them downward to help you see the higher wind values inside the hurricane.
  7. Move the opacity slider down until you can see the most useful representation of your data.  
  8. Click Fit to View and Histo.
Adjusting variable interval
Figure 8 - Click for another view of the Transfer Function Editor.


Capturing an animation sequence

Before animating and capturing the visualization, you may want to further define or restrict the region you’re observing by rotating the scene, zooming in or out, or changing the size of the region box.

Then, use the VAPOR animation toolbar or “player” to animate and capture a sequence of the visualization. (Figure 9)

Adjusting variable interval
Figure 9 - Click to enlarge.



To capture the animation sequence, proceed as follows.

  1. From the Mode menu near the top of your VAPOR window, select Navigation.
  2. Set the current time step to 1.
  3. Zoom in to get a close look at the hurricane
  4. From the Capture menu at the top of your VAPOR window, select Begin image capture sequence.
  5. Choose a name for the jpeg files to be captured — "KatrinaEye.jpg,” for example.
  6. Click the Play Forward button on the animation toolbar, and watch the animation proceed to its completion.
  7. From the Capture menu, select End image capture sequence.

VAPOR saves a series of jpeg files to disk. You can convert them into a movie file using any of various utilities such as QuickTime Pro and FFmpeg.