Shadow3 (2011-10-02)
====================

This is binary distribution of Shadow3 


Reference: 
SHADOW3: a new version of the synchrotron X-ray optics modelling package
M. Sanchez del Rio, N. Canestrari, F. Jiang and F. Cerrina
J. Synchrotron Rad. (2011). 18, 708-716    
http://dx.doi.org/10.1107/S0909049511026306 

Shadow3 Sources can be obtained using: 
    git clone git://git.epn-campus.eu/repositories/shadow3/


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

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. 


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/shadowvui.sav
        .../xop2.3/extensions/shadowvui/data/shadowvui_vui.sav
        .../xop2.3/extensions/shadowvui/shadowvui_preferences.pro
        .../xop2.3/o_modules/xoplibfull.sav
  -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)

A NOTE ON SHADOW3 DATA FILES
----------------------------

For some particular calculations (synchrotron sources, optical element 
reflectivity etc. Shadow needs these data files:
    BSKM         F12LIB.INDEX  G0UNF  SRDISTR  
    F12LIB.FULL  G0FUNC        SRANG  SRSPEC   

These data files are searched in the following path: 
.:$SHADOW3_HOME:$XOP_HOME/extensions/shadowvui/shadow3:$SHADOW_DATA_DIR:$SHADOW_ROOT/data

If the file searched does not exist, shadow3 creates it in the current
directory. 

However, for creating the  F12LIB.INDEX shadow3 needs the files PRELIB1.DAT
and PRELIB2.DAT available in the path. These files can be copied from this
repository.


KNOWN PROBLEMS
--------------
  -In Windows, running an bending magnet with ShadowVUI, it may give 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-10-02