UNIX Extensions for XOP 2.11 (Installation notes)
               =================================================

IMPORTANT: The installation of XOP extensions requires a previous 
	   installation of the main XOP

XAID [XAFS toolbox]
-------------------
  1) Download the file xaid1.2.tar.gz to your main XOP directory
  2) Execute:
     gunzip xaid2.1.tar.gz
     tar xvf xaid1.2.tar
  3) Start xaid by entering at the unix prompt:
      xop xaid

      Note: The XAID installation package does not contain the DABAX
      files containing the EXAFS and XANES experimental database.
      If you want to install them, just copy into your
      $XOP_HOME/data/dabax directory the (big) files:

      ../../DabaxFiles/XAFS_DATA_EXAFS_CHI.dat
      ../../DabaxFiles/XAFS_DATA_EXAFS_CHI.HIdl
      ../../DabaxFiles/XAFS_DATA_XANES.dat
      ../../DabaxFiles/XAFS_DATA_XANES.HIdl


INES [Nuclear INElastic Scattering]
-----------------------------------
  1) Download the file ines1.0.tar.gz to your main XOP directory
  2) Execute:
     gunzip ines1.1.tar.gz
     tar xvf ines1.1.tar
  3) Start xaid by entering at the unix prompt:
      xop ines

TOPO [analysis on profiles and surfaces by Windt]
-------------------------------------------------
  1) Download the file topo2.05.tar.gz to your main XOP directory
  2) Execute:
     gunzip topo2.05.tar.gz
     tar xvf topo2.05.tar
  3) Start topo by entering at the unix prompt:
      xop topo4xop

  See also:
  http://cletus.phys.columbia.edu/~windt/idl/


IMD [Multilayers by Windt]
--------------------------
  1) Download the file imd4.1.1.tar.gz to your main XOP directory
  2) Execute:
     gunzip imd4.1.1.tar.gz
     tar xvf imd4.1.1.tar
  3) Start imd by entering at the unix prompt:
      xop imd4xop

  See also:
  http://cletus.phys.columbia.edu/~windt/idl/
 

NOP [Neutron OPtics]
--------------------
  1) Download the file nop1.0Beta1.tar.gz to your main XOP directory
  2) Execute:
     gunzip nop1.0Beta1.tar.gz
     tar xvf nop1.0Beta1.tar
  3) Start nop by entering at the unix prompt:
      xop nop

  Notes: 
  i) NOP includes imd (D. Windt) with optical constants for neutrons
      replacing the original optical constants for x-rays. 
      See also:
      http://cletus.phys.columbia.edu/~windt/idl/
 

SHADOWVUI [Visual user interface to the x-ray tracing program SHADOW)
---------------------------------------------------------------------
                ** Note: NOT AVAILABLE FOR MAC OSX **
  1) Download the file shadowvui1.0Beta4.1.tar.gz to your main 
     XOP directory
  2) Execute:
     gunzip shadowvui1.0beta4.1.tar.gz
     tar xvf shadowvui1.0beta4.1.tar
  3) Install SHADOW for your computer platform. 
     SHADOW can be installed in any directory. If you are going to use
     SHADOW only via XOP/SHADOWVUI, you can install it in 
     $XOP_HOME/extensions/shadowvui/

     SHADOW can be downloaded from: 
         http://www.nanotech.wisc.edu/shadow
    (alternatively see http://www.esrf.fr/computing/scientific/raytracing/)
  4) Edit the files .shadowrc and .shadowrc.sh in the directory where
     you installed SHADOW.
	4.1) Set the SHADOW_ROOT to your particular installation directory
	4.2) VERY IMPORTANT: Set a new environment variable (add new line(s)):
	 	<> in file .shadowrc:
	     	setenv SHADOW_ENV_FILE  "/tmp/shadow-env-${USER}" 
	 	<> in file .shadowrc.sh:
	     	SHADOW_ENV_FILE="/tmp/shadow-env-${USER}"
		export SHADOW_ENV_FILE
  5) Edit the file 
	$XOP_HOME/extensions/shadowvui/data/shadowvui_preferences.pro
	and customize the variables in the UNIX block (see instructions
	therein).
 
  6) Start shadowvui by entering
      xop shadowvui

  NOTE: The SHADOW version 2.3.2 contains a bug in the wiggler source and
      crashes the program. Older versions may work.