ParaView

ParaView is an open-source, multi-platform data analysis and visualization application. ParaView users can quickly build visualizations to analyze their data using qualitative and quantitative techniques. The data exploration can be done interactively in 3D or programmatically using ParaView’s batch processing capabilities.

ParaView was developed to analyze extremely large datasets using distributed memory computing resources. The OLCF provides ParaView server installs on Rhea to facilitate large scale distributed visualizations. The ParaView server running on Rhea may be used in a headless batch processing mode or be used to drive a ParaView GUI client running on your local machine.

ParaView client

A ParaView client instance is not available on Rhea. Interactive mode requires that your local machine have a version matched ParaView client installation and batch mode can benefit from a local installation as well to aid in script generation. Precompiled ParaView binaries for Windows, Macintosh, and Linux can be downloaded from Kitware.

Interactive mode

Although in a single machine setup both the ParaView client and server run on the same host, this need not be the case. It is possible to run a local ParaView client to display and interact with your data while the ParaView server runs in a Rhea batch job, allowing interactive analysis of very large data sets.

In interactive mode your local ParaView version number must match the ParaView version number available on Rhea. Please check the available ParaView versions using Rhea’s modules system.

Interactive Example

The following provides an example of launching the ParaView server on Rhea and connecting to it from a locally running ParaView client. Although several methods may be used the one described should work in most cases.

For Macintosh clients, it is necessary to install XQuartz (X11) to get a command prompt in which you will securely enter your OLCF credentials.
For Windows clients, it is necessary to install PuTTY to create an ssh connection in step 2.

Step 1: Launch ParaView on your Desktop and fetch a connection script for Rhea
Start ParaView and then select File/Connect to begin.

Next Select Fetch Servers

Next select the connection to Rhea for either windows or Mac/Linux and hit the “Import Selected” button.


You may now quit and restart ParaView in order to save connection setup in your preferences.

Step 2: Establish a connection to Rhea
Once restarted, and henceforth, simply select Rhea from the File->Connect dialog and click the “Connect” button.

A dialog box follows, in which you must enter in your username and project allocation, the number of nodes to reserve and a duration to reserve them for.


When you click OK, a windows command prompt or xterm pops up. In this window enter your credentials at the OLCF login prompt.


When your job reaches the top of the queue, the RenderView1 view window will return. At this point you are connected to Rhea and can open files that reside there and visualize them interactively.

VisIt

VisIt is a interactive, parallel analysis and visualization tool for scientific data. VisIt contains a rich set of visualization features so you can view your data in a variety of ways. It can be used to visualize scalar and vector fields defined on two- and three-dimensional (2D and 3D) structured and unstructured meshes.

Installing and Setting Up Visit

VisIt uses a client-server architecture. You will obtain the best performance by running the VisIt client on your local computer and running the server on OLCF resources. VisIt for your local computer can be obtained here: VisIt Installation.

The first time you launch VisIt (after installing), you will be prompted for a remote host preference. Make sure you select ORNL. You will then be prompted to exit and re-launch VisIt for the host preferences to become available. In order to finish setting up VisIt on your local machine:

  • Go to “Options→Host profiles” and choose “ORNL_Rhea”.
  • Make sure “Username” is set to your OLCF username.
  • Click on the “Launch Profiles” tab and then click on the “Parallel” button. Here, you can set up the parallel launch configuration. Default values will be filled in, but you will need to enter your project ID in the “Bank/Account” section. When finished, click Apply and close the “Host profiles” window.
  • To ensure these settings are saved, go to “Options→Save Settings”.

Usage

Once you have VisIt installed and set up on your local computer:

  • Open VisIt on your local computer.
  • Go to: “File→Open file” or click the “Open” button on the GUI.
  • Click the “Host” dropdown menu on the “File open” window that popped up and choose “ORNL_Rhea”.
  • This will prompt you for your OLCF password, and connect you to Rhea.
  • Navigate to the appropriate file.
  • Once you choose a file, you will be prompted for the number of nodes and processors you would like to use (remember that each node of Rhea contains 16 processors) and the Project ID, which VisIt calls a “Bank” as shown below.
  • Use the Bank field to enter your project ID

  • Once specified, the server side of VisIt will be launched, and you can interact with your data.

Please do not run VisIt’s client from an OLCF machine. You will get much better performance if you install a client on your workstation and launch locally. You can directly connect to OLCF machines from inside VisIt and access your data remotely.

For additional resources, please see the VisIt Wiki.

Troubleshooting

VisIt keeps asking for your password.

If VisIt keeps asking for your “Password” in the dialog box below, and you are entering your correct PIN + RSA token code, you might need to select “Change username” and then enter your OLCF username when prompted.

Screen Shot 2016-01-06 at 11.10.19 AM

This will give you a new opportunity to enter your PIN + token code and your username will appear in login request box as shown below. If you want you OLCF username to be filled in by default, go to “Options→Host profiles” and enter it under “Username”. See the Modifying Host Profiles section below for more details.

Screen Shot 2016-01-06 at 11.06.25 AM

VisIt will not connect when you try to draw an image.

If VisIt will not connect to Rhea when you try to draw an image, you should login to Rhea and enter “qstat” from the command line. Your VisIt job should appear in the queue. If you see it in a state marked “Q” you should wait a bit longer to see if it will start. If you do not see your job listed in the queue, check to make sure your project ID is entered in your VisIt host profile. See the Modifying Host Profiles section below for instructions.

Modifying Host Profiles

To make changes to an exiting host profile, do the following:

  • Go to “Options→Host Profiles”.
  • The window will display the known hosts on the left, with the settings for that host shown on the right in the “Host Settings” tab.
  • You can modify settings relevant to this host machine. For example, you can change the “Username” field if your OLCF username differs from your local computer username.
  • Once you have made your changes, press the “Apply” button, and then save the settings (Options/Save Settings).

Each host can have several launch profiles. A launch profile specifies VisIt can be run on a given host computer. To make changes to a host’s launch profile, do the following:

  • Go to “Options→Host Profiles”.
  • Select the host in the left side of the window.
  • Select the “Launch Profiles” tab in the right side of the window. This will display the known launch profiles for this host.
  • Select a “Launch Profile” and the settings are displayed in the tabs below.
  • You can set your Project ID in the “Default Bank/Account” field in the “Parallel” tab.
  • You can change the queue used by modifying the “Partition/Pool/Queue” field in the “Parallel” tab.
  • Once you have made your changes, press the “Apply” button, and then save the settings (Options/Save Settings).