From Documentation
Revision as of 01:42, 5 April 2012 by Isaac (Talk | contribs) (Created page with "{{Software |package_name=PARAVIEW |package_description=Application designed to visualize data sets of size varying from small to very large |package_idnumber=67 }} h1. Visualiza...")

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
PARAVIEW
Description: Application designed to visualize data sets of size varying from small to very large
SHARCNET Package information: see PARAVIEW software page in web portal
Full list of SHARCNET supported software



h1. Visualization Stations

ParaView can be started from the _applications_ menu (the one in the upper-left hand corner) under the _graphics_ sub-menu after logging into any of the visualization stations. It can also be launched from the command prompt on any of the visualization stations by typing

$ paraview

Adding a @--stereo@ option will enable stereo rendering when supported by the hardware.

h1. Rainbow and Visualization Stations

The supported way to run ParaView on rainbow is through the visualization stations.

Once ParaView has started up, choose the _connect_ option from the _file_ menu. Click on _rainbow_ and then _connect_. Select the desired number of processors (note that more is not necessarily faster due to the overhead of moving data around) and then press _connect_ again. ParaView will then (depending on your ssh setup) request your password (on the command prompt if you started ParaView that way), login to rainbow, and submit an appropriate job to the vis queue.

Be aware that ParaView will expect your data files to be on rainbow and your state files to be on the local machine. As well, the use of the vis queue implies individual sessions will only last up to eight hours, and stereo rendering does not work in conjunction with rainbow.

h1. Rainbow and your PC

You can also download ParaView for your PC (Linux, MacOS, and Windows version exist) from the "ParaView Website"[1] (or install it using your package manager under Linux) and use it in client server mode to perform your rendering on rainbow. Note that you must use the same version of ParaView as on rainbow, you must setup ssh for passwordless login, and you must open tcp port 11111 for incoming connections on any firewalls.

h2. Linux and MacOS

Place the following in _servers.pvsc_ under _.config/ParaView_ in your home directory (this must be done while ParaView is not running)

<Servers>
  <Server name="builtin" resource="builtin:">
    <ManualStartup/>
  </Server>
  <Server name="rainbow" resource="csrc://rainbow.sharcnet.ca:11111">
    <CommandStartup>
      <Options>
        <Option name="PV_NODES" label="Number of Nodes">
          <Range type="int" min="1" max="16" step="1" default="4"/>
        </Option>
        <Option name="PV_CLIENT_HOST" label="Client Host" save="true">
        </Option>
        <Option name="PV_LOGIN" label="Login Name" save="true">
        </Option>
      </Options>
      <Command exec="ssh" timeout="0" delay="5" Arguments="24">
        <Arguments>
          <Argument value="-x"/>
          <Argument value="-l"/>
          <Argument value="$PV_LOGIN$"/>
          <Argument value="rainbow.sharcnet.ca"/>
          <Argument value="sh"/>
          <Argument value="-l"/>
          <Argument value="-c"/>
          <Argument value="'"/>
          <Argument value="sqsub"/>
          <Argument value="-q"/>
          <Argument value="vis"/>
          <Argument value="-n"/>
          <Argument value="$PV_NODES$"/>
          <Argument value="-N"/>
          <Argument value="$PV_NODES$"/>
          <Argument value="-o"/>
          <Argument value="/tmp/pvsharcnet-mpi.%J.out"/>
          <Argument value="-r"/>
          <Argument value="480"/>
          <Argument value="-f"/>
          <Argument value="mpi"/>
          <Argument value="/opt/sharcnet/paraview/3.4.0/bin/pvsharcnet-mpi"/>
          <Argument value="--reverse-connection"/>
          <Argument value="--client-host=$PV_CLIENT_HOST$"/>
          <Argument value="--connect-id=$PV_CONNECT_ID$"/>
          <Argument value="'"/>
        </Arguments>
      </Command>
    </CommandStartup>
  </Server>
</Servers>

The directions above on connecting from the Visualization Stations will now apply to your PC as well. Enter your "external IP address"[2] in the _Client Host_ field.

h2. Windows

A similar file, customized for your ssh setup, must be placed under your applications settings directory, and then the above directions will apply as well.

h1. Other Options

It is also possible to run ParaView directly on rainbow. While this option is not supported, advanced users may find it useful. ParaView is installed into _/opt/sharcnet/paraview/$version_, where _$version_ is the version number, and can be add to your path by doing

$ export PATH=/opt/sharcnet/paraview/$version/bin:$PATH

This will directly allow you to directly run the various ParaView programs (the ones compiled with MPI are postfixed with _-mpi_). Most of the programs, however, won't actually work because they require a running X server in order to access the graphics card for rendering.

The _pvsharcnet_/_pvsharcnet-mpi_ scripts are wrappers around the _pvserver_/_pvserver-mpi_ commands that handle starting and stopping of an X server. The following is an example of manually starting a four node render server and telling it to connect back to the client running on $myhost

 $ sqsub -q vis -n 4 -N 4 -r 480 -f mpi -o /tmp/pvsharcnet-mpi.%J.out \
       /opt/sharcnet/paraview/3.4.0/bin/pvsharcnet-mpi               \
       --reverse-connection --client-host=$myhost