--------------------------------------------------------------------------------
                           SHADOW 3.0 SOURCE DISTRIBUTION
--------------------------------------------------------------------------------

Contents:

1 What is SHADOW
2 Download
3 Source files
4 Building SHADOW
5 Other info
6 Contact

--------------------------------------------------------------------------------
1 What is SHADOW
----------------

SHADOW is an open source ray tracing code for modeling optical systems. 

Targeted to synchrotron radiation beamlines, it has unique features for designing X-ray optical systems. 

For more info, please read this paper (open access):

SHADOW3: a new version of the synchrotron X-ray optics modelling package
M. Sanchez del Rio, N. Canestrari, F. Jiang and F. Cerrina
Journal of Synchrotron Radiation Volume 18, Part 5 (September 2011)
http://dx.doi.org/10.1107/S0909049511026306

2 Download
----------

SHADOW3 sources are downloaded using git: 

  git clone git://git.epn-campus.eu/repositories/shadow3

Other SHADOW web resources: 

  http://forge.epn-campus.eu/projects/shadow3   (source repository)
  http://forge.epn-campus.eu/attachments/996/Shadow3Primer.pdf  (primer)
  ftp://ftp.esrf.fr/pub/scisoft/shadow3/  (binary distribution) 
  ftp://ftp.esrf.fr/pub/scisoft/shadow/  (SHADOW2 distributions - obsoleted - )
  ftp://ftp.esrf.fr/pub/scisoft/xop2.3/  (XOP and SHADOWVUI user interface)
  http://dx.doi.org/10.1107/S0909049511026306 (Official reference)


3 Source files
--------------

After using "git clone git://git.epn-campus.eu/repositories/shadow3"
a single shadow3 directory is created. It contains all sources and resources tu build shadow3. The basic files are

Tools:
  Makefile:  makefile 

Source files: 
  shadow_kernel_precpp.F90
  shadow_version_precpp.F90
  shadow_variables_precpp.F90

  gfile.f90		      
  stringio.f90
  shadow_pre_sync.f90
  shadow_beamio.f90	      
  shadow_synchrotron.f90
  shadow_bind_f.f90	      
  shadow_crl.f90		      
  shadow_globaldefinitions.f90  
  shadow_math.f90		      
  shadow_postprocessors.f90     
  shadow_preprocessors.f90      

  cdf_z.f
  wranc.c

Source file main shadow3 program:
  shadow3.f90		      

Source file optional main programs (examples):
  gen_source.f90		      
  trace3.f90
  trace3mpi.f90
  trace.f90
  example01_f95.f90	      
  example02_f95.f90	      
  fig3.f90		      

Source file API (C/C++/PYTHON/IDL)
  shadow_bind_idl.c	   
  shadow_bind_idl_loader.c  
  shadow_bind_c.c		 
  shadow_bind_python.c
  setup.py	       
  ShadowTools.py
  ShadowToolsPrivate.py  
  setpythonpath.sh

Source file examples API (C/C++/PYTHON/IDL)
  trace3_c.c
  trace3_py.py
  example01_c.c		 
  example_shadow_format.c  
  example_tolerances.py  
  shadow_bind_idl_test.pro

README files:
  README.txt
  README_API.TXT
  README_CRL.txt 
  README_MPI.txt 
  README_ShadowTools.txt

4 Building SHADOW
----------------
  Check the Makefile if you need to redefine compilers etc.

  The use of Makefile is documented in its header. Basically:
  make           : builds shadow3 the main program
  make all       : builds shadow3, libraries, examples and API


5 Other info
------------

6 Contact
---------

SHADOW is currently maintained by Manuel Sanchez del Rio (srio@esrf.eu)



