Edited: 03-Jun-2010

                 Using jScope on the PPPL Linux cluster

jScope, distributed with MDSplus, is a powerful extension to the original
dwscope program. jScope does overlays in color, shows images and video 
(in sync with times from other frames), displays error bars, etc.
See http://nstx.pppl.gov/nstx/Software/jScope/jScope.htm for more detail.

To make a regular scope file work in jScope on the PPPL Linux Cluster
for NSTX data (assuming you have done a "module load nstx"):

1)  IDL> cp2jScopeFile, 'myscope.dat', outfile='myscope.jscp'

2)  (cp2ScopeFile should allow you to skip this step)
t the Linux command line:

        jScope myscope.jscp 
	   (ignore the initial complaint about LocalDataProvider)

   a) go into "File...Properties..." and make sure any of the lines 
      at the top (down to "jScope.reversed=false") have site-specific 
      values, such as:
   
      jScope.directory= ~/Wherever
      jScope.default_server = 1

      jScope.data_server_1.name = NSTX
      jScope.data_server_1.argument = skylark.pppl.gov:8501
      jScope.data_server_1.class = MdsDataProvider

      jScope.cache_directory=~/
      jScope.cache_size=1024
      
   b) Click on "Save" and then "Close" at the bottom of this window
      and then restart jScope. 
      You can find useful instructions under the "Help...About jScope" menu.

3) all the files (changed within 1000 days before 3-Nov-2009) in
   $NSTXUSR/util/scopes/ were copied & converted to jScope input files in
   $NSTXUSR/util/jscp/. jScope input files can now be used in 
   http://nstx.pppl.gov/nstx/Software/WebTools/mdsscopeadj.html. 
   
4) If you get an error "Configuration file syntax error: missing columns keyword"
   recopy the .scope file and change the font line to something like:
   
      Scope.font: java.awt.Font[family=Dialog,name=Times,style=plain,size=14]

5) you might want to change (with an editor)
 
      Scope.print_file: sys$login:dwscope.ps
   to 
      Scope.print_file: $HOME/jscope.ps

6) With an editor, you may wish to insert the following before the Scope.title 
   line:
   
      Scope.color_0: Black,java.awt.Color[r=0,g=0,b=0]
      Scope.color_1: Red,java.awt.Color[r=255,g=0,b=0]
      Scope.color_2: Blue,java.awt.Color[r=0,g=0,b=255]
      Scope.color_3: Green,java.awt.Color[r=0,g=255,b=0]
      Scope.color_4: Magenta,java.awt.Color[r=255,g=0,b=255]
      Scope.color_5: Cyan,java.awt.Color[r=0,g=255,b=255]
      Scope.color_6: Orange,java.awt.Color[r=255,g=200,b=0]
      Scope.color_7: Pink,java.awt.Color[r=255,g=175,b=175]
      Scope.color_8: Yellow,java.awt.Color[r=255,g=255,b=0]