1.  Running RPLOT from ElVis
The TRANSP RPLOT program is integrated with ElVis.  RPLOT's basic function consists of an xterm command line window and an xterm display window.  RPLOT has been extended to send its graphs to ElVis for enhanced display:
1.  Multiple, simultaneous graphs.
2.  Color plots.
3.  Interactive data exploration:  pan, zoom, dynamic numerical readout, interactive log plots.
4.  Variety of presentation styles for f(x,t) data.
5.  Publication quality output to PostScript or PDF files.
6.  Animation of multi-dimensional data.

1.1 ElVis on Linux or Mac
To start an RPLOT session, run ElVis and go to:  Desktop --> RPLOT.  If you are running ElVis on Linux or a Mac then select the menu item for ssh portal...  This brings up a dialog box where you can specify RPLOT's working directory on the PPL file system.  When you click OK, ElVis will start an ssh to portal, cd to the working directory, start RPLOT in an xterm, and connect it to ElVis.  You will see the legacy RLOT command window and display window in addition to ElVis, as shown:

elvisrplot
 
The working directory specified in ElVis will be saved as a preference when you exit.  It will be the default directory when you run ElVis again.

1.2 ElVis on Windows
If you are running ElVis on Windows then you must also have software, such as Cygwin/X, that will make an ssh connection and support an xterm coming from the cluster.  Install and run ElVis from a Cygwin xterm.  This will put the Cygwin ssh program in ElVis's executable path.   Go to:  Desktop --> RLOT --> local command...  This brings up a dialog box for entering a Windows command such as: 

    c:\cygwin\bin\ssh -X fusiongrid /p/fgweb/bin/elvisrplot.csh localName portNumber workDir. 

The portNumber is shown in the ElVis titlebar.  It is usually 7654.  The localName of your computer is also shown in the titlebar following the port number.  The workDir is your desired working directory on the PPL file system.

Running RPLOT from ElVis assumes that your computer can make a socket connection to the PPL portal cluster.  You must be logged in to your computer with your PPL account name.  Here is a screenshot of a Windows computer running Cygwin/X.  ElVis has been started from the xterm command line.  A local command was entered to run rplot via ssh and connect to ElVis running on Windows:

windowsrplot


1.3 ElVis in nx
Another approach is to run the nx client on your local computer and connect to the nx server on cportal.pppl.gov.  This provides a graphical desktop on the PPL cluster.  Now you can run ElVis on the cluster although the user interface will be slower than running ElVis directly on your local computer.  Here is a screenshot of ElVis running within the nx client:

elvis_nx
2.  Running RPLOT Within ElVis -- A Web Service

If you are running on a computer outside the PPL firewall then you must authenticate with the PPL firewall to run RPLOT.
You must also have a valid FusionGrid credential because rplot is run through GLOBUS on the PPL cluster.

On the toolbar, go to Desktop --> RPLOT --> Web Service ...
    This brings up a dialog window for a FusionGrid Credential.  Enter your FusionGrid user name and passphrase.  Click Sign On.  This will check your credential on the Credential Server to determine if you can run RPLOT at PPL.  If it succeeds then the text areas will get a green background and information about your credential and proxy will be shown. If it fails then the background will turn red.  If you are running ElVis as an application then it will fill in the User Name with your log in account.  If this is different than your FusionGrid user name then enter your FusionGrid user name.

Credential Dialog Window
  

    After you sign on the rplot window will be displayed:

RPLOT window

This window is the client side of an rplot session running on the PPL cluster.  Text output from rplot is shown in the panel on the left.  Graphs are drawn in the panel on the right.  Enter commands in the command line at the bottom left.  A copy of rplot is running with your pshare user ID, such as pshr0003.  The current working directory is /u/pshrNNNN/rplot.  You can enter rplot commands to access runs stored in files or in MDSplus.  You can run rplot scripts stored in command files.

Be sure to exit rplot before quiting ElVis.  Quit out of all menu levels or enter *A or *A! for immediate exit.  A message will be displayed in the command line area when rplot exits.  Be sure to exit rplot to avoid leaving copies of the program running on the cluster.

rplot graphs

Each command  you enter is sent to the rplot program.  It returns lines of text and draws graphs when they are complete.  You can explore the graphs using the interactive features in ElVis.  Each graph is added to the window which will scroll.  Initially one column of graphs is displayed.  The Layout page in the Graph Editor has controls for changing the number of rows and columns of graphs.

Click in the command line or the text area above it to regain typing focus for entering commands.