Shadow3PreBeta5
===============

This is the prerelease of SHADOW THREE! 
New in PreBeta3: Working with ShadowVUI!! - Some bugs fixed. Works on Mac
New in PreBeta4: Updated Primer, and fix some bugs. All examples in the 
                 Primer work well. 
New in PreBeta5: Fix some bugs. Faster

Fully compatible with shadow2. 

Source and Trace working. 

Only binaries are distributed by now...

Major improvements: 
  - reorganised source, common blocks removed, full f90 code
  - unlimited number of rays
  - presurface works for Nx=201 Ny=Unlimited
  - Some bugs fixed (included for spherical LVG)
  - ShadowVui upgraded
  - shadow primer updated

Soon: 
  - cleaned and more organized source code made publically available
  - C, python and IDL bindings
  - upgraded optical library, physical constants, etc.

LINUX Files:
------------

gen_source     :  identical to the old gen_source
trace          :  identical to the old trace
trace3         :  trace that runs using file systemfile.dat
shadow3        :  main program for running Shadow3 in command mode
                  it also gives access to pre and post processors,
                  and graphics (plotxy,histo1) [gnuplot output]

WINDOWS Files   
-------------
Same as for linux, but with the .exe extension

MAC Files   
-------------
Same as for linux, but with the .mac extension. If wanted, rename the files
to  remove the extension.


INSTALLATION
------------
Just download the files to a new directory and run them
If Unix, you may require to "chmod +x *"

RUN
---
run shadow3 from the command window  (Unix, Mac or DOS) and enter help. 
(note that it has never been tested in MacOS and lightly tested in Windows,
most of the development has been done in Linux). 

SHADOWVUI
---------
Install ShadowVUI under xop2.3, as you probably already have, and then: 
  -Update it,by replacing the some files by the ones found here: 
        .../xop2.3/extensions/shadowvui/data/shadowvui_vui.sav
        .../xop2.3/extensions/shadowvui/shadowvui_preferences.pro
  -Drop the file shadow3 for linux (shadow3.exe for windows, 
         in Mac rename shadow3.mac to shadow3 and use it) in: 
         .../xop2.3/extensions/shadowvui/shadow-2.3<version>/bin
  -Start ShadowVUI, and in ShadowVUI->Preferences select 
        Shadow3 mode: Shadow3
        (you must do this any time you restart xop. It cannot be 
         permanently defined by now).
        (you can swich at any time from Shadow3 to Shadow2, and viceversa)

KNOWN PROBLEMS
--------------
  -Shadow3 seems to be much slower than Shadow2 
  -In Windows, running an bending magnet with ShadowVUI, it gives an error:
   Out of interpolation range. 
   The problem is that files SRANG, SRDISTR, SRSPEC are read from the ShadowVUI
   old distribution
   Solution: Run manually (command mode)  shadow3 and files SRANG,SRDISTR and
   SRSPEC will be created. Put them in your ShadowVUI working directory.

FEEDBACK
--------
Please give feedback to srio@esrf.eu
srio@esrf.eu    2011-01-06