This is the README of the XOP extension "shadowvui"

Definitions:
============

"XOP" : A multiplatform graphical user interface  for synchrotron 
        radiation spectral, optics and data analysis calculations. 
	For more info, see:
        http://www.esrf.fr/computing/expg/subgroups/theory/idl/xop/xop.html

"XOP extension" is a software package which is not part of the XOP 
                installation, but it can be installed optionally and run 
                under the XOP interface.


ShadowVUI:
==========
SHADOW VUI is a Visual User Interface for the SHADOW ray-tracing code.
It is written completely in IDL and can be run either using an IDL license or
using XOP. 
More info on SHADOW can be obtained from:
  http://www.xraylith.wisc.edu/shadow/shadow.html 
More info on SHADOW VUI can be obtained from:
  http://www.esrf.fr/computing/expg/subgroups/theory/shadow/vui/shadowvui.html

Requirements:
=============
  1) A Unix (HP, Solaris, Linux) or PC (Windows95.NT) machine
  2) XOP installed on it.
  3) Unix: SHADOW installed on it
     Windows: SHADOW is packed in SHADOWVUI distribution. You do not need 
	      to install SHADOW before SHADOWVUI.
  4) installation and customization of SHADOWVUI for XOP-EMBEDDED (see next).

installation and customization of SHADOWVUI for XOP-EMBEDDED
============================================================
  1) Download file:
     Unix: ftp://ftp.esrf.fr/expg/idl/xop/extensions/shadowvui/shadowvui.tar.Z
     Windows: ftp://ftp.esrf.fr/expg/idl/xop/extensions/shadowvui/shadowvui.zip

  2) Unix:
       i)  Copy (or move) shadowvui.tar.Z to your .../xop/extensions directory
       ii) Change directory to .../xop/extensions
       iii) Unpack shadowvui.tar.Z with the unix command:
            cat rodgui.tar.Z | tar xvf -
           As a result you should one file and one directory
            shadowvui.sav (file)
            shadowvui (directory)
	   
     Windows:
       i) Use the (32-bit) WinZip shareware program to unpack the
            shadowvui.zip file in the c:\xop\extensions directory.
          As a result you should obtain a directory "shadowvui"
	    under c:\xop\extensions
       ii) Copy shadowvui.sav to  c:\xop\extensions directory 
	   DOS COMMAND: 
	   cp c:\xop\extensions\shadowvui\shadowvui.sav c:\xop\extensions\shadowvui.sav

  3) Customization (not needed for Windows if you want to use the 
     SHADOW 2.3.0 version shipped with SHADOWVUI.
     Always needed for Unix):

     Edit the .../xop/extensions/shadowvui/data/shadowvui_preferences.pro
     file and enter the calling command for your local SHADOW installation:
     Under Unix: 
     ...
     shadow_start='.  /your_local_path_here/.shadowrc.sh'
     setenv,'SHELL=/bin/sh'
     ...
     Under Windows (it is very important NOT to split the command lines!): 
     ....
     shadow_start = ['set SHADOW_ROOT=c:/SHADOW2.3.1','set PATH=c:/SHADOW2.3.1/bin;c:\windows\command.com','SET SHADOW_ENV_FILE=xsh_env_file.inp']
     ;setenv,'SHELL=/bin/sh'
     ....
  4) Start shadowvui:
     Unix:
         i) At the  Unix prompt, type:
            xop shadowvui
         ii) From the main XOP window:
            a) Select Tools -> IDL Macro
	    b) Clear the window and type shadowvui
	    c) Select File -> Quit and accept changes
     Windows:
	 i) Double-click on c:\xop\extensions\shadowvui\shadowvui\shadowvui.bat
         ii) From the main XOP window:
            a) Select Tools -> IDL Macro
	    b) Clear the window and type shadowvui
	    c) Select File -> Quit and accept changes

  5) Problems, bug reports, suggestions etc should be addressed to: 
     srio@esrf.fr