EXCI
Shared libraries with scattering models for RESTRAX 
-----------------------------------------------------------
THIS FILE CAN BE OBSOLETE. READ doc/howtoEXCI.html INSTEAD.
------------------------------------------------------------

1) Getting source files
------------------------
Source files for EXCI libraries is distributed with RESTRAX sources or separately at
http://omega.ujf.cas.cz/restrax

Models distributed with version 4.8.0:
res_exci_osc.f      ... Damped oscillators"
res_exci_osc1.f     ... Damped oscillators with free dispersion gradient"
res_exci_bcm.f      ... BC model (phonons in Si, Ge, ...)"
res_exci_incom.f    ... incommensurate satellites"


2) Compiling
-------------
Make the distribution root your current directory and use following commands to compile EXCI

$ configure.EXCI <sys>
$ make -f exci/makefile

<sys> defines the configuration file './config/config.<sys>' with system
dependent linker and compiler options. There should be config.<sys>
files available for following systems/compilers:
 - Linux/Absoft Fortran 95 (Absoft)
 - Linux/GNU fortran g77 (g77)
 - OSF1/Digital Fortran 90 (DEC) 
Use one of these files as a template for porting to other systems. 

The makefile creates a set of *.so libraries in the ./lib directory. 
These files represent different scattering models. You can add your own source file 
to the list in configure.EXCI or directly in  exci/makefile (variable EXCIFILES).

Requirements:
 - header files in ./includes directory
 - src/reclat.f, src/exci/*.f 
 (link with these files to ensure correct interfacing with RESTRAX)

3) Installation
----------------
Make sure that your libraries can be found when called by system loader. 
Define the environment variables LD_LIBRARY_PATH or SHLIB_PATH 
(depending on UNIX system), e.g.

export LD_LIBRARY_PATH=.:./lib:/usr/local/restrax/lib

The library will be searched in the specified directories in given order.

When starting RESTRAX from scripts comming with the distribution, the
environment setting is done automatically. Installation then
means just to copy *.so files to the installation directory under lib directory: 

$ cp -fp lib/*.so <installation directory>/lib

and/or modify menu in the 'start' script to make links to the newly installed models. 


4) Usage
----------------
NOTE: 
RESTRAX links with the library dynamically at runtime. The default library filename 
can be passed to RESTRAX as a command line option, e.g. -exci=res_exci_osc.
Use command EXCI to exchange the library during session.

To create own model, use one of the provided source files as a template. 
Read comments in the source code for instructions.

Input file format is specific to each model type. Default filenames are defined
inside the source code. There are three input files in ./exci directory for 
the models included in this package:

exc.par (res_exci_osc, libres_exci_osc1)
sat.par (res_exci_incom)
bcm.par (res_exci_bcm)







