**************************************************************
How to compile and install SIMRES   :
**************************************************************

Requirements:
---------------

 - SIMRES distribution with source files
   (check for upgrades at http://omega.ujf.cas.cz/restrax)   

 - A Fortran 77/90 compiler. Number or Fotran90 extensions are required, therefore g77 is not enough. Scripts for compiling with Absoft Fortran on Linux/i386 and with Digital Fortran on OSF1/Alpha are already available. In other cases, you will need to invent appropriate command line options.

 - PGPLOT library (http://astro.caltech.edu/~tjp/pgplot) installed on your system

 - Access rigths to write into installation directory
 
**************************************************************
COMPILING
**************************************************************
   
1) Unpack files
----------------------------------
The program comes in a single *.tar.gz package. Unpack the archive into a subdirectory 
(replace <archive_name> with actual distribution filename),

% gunzip < archive_name.tar.gz | tar -xf -

and enter the distribution directory:

% cd archive_name 

2) Compile
----------------------------------
SIMRES can be compiled with a single command, using the script Build:

% Build <system>

where <system> is the extension of the "config.<system>" file in the ./config subdirectory. These files contain appropriate options for compiling and linking, depending on the system and compiler vendor:

config.Absoft ... Absoft Fortran on Linux/i386 systems
config.DEC    ... Digital Fortran on OSF1/Alpha systems

For other compilers/systems, you would need to create appropriate config.<system> file. Use one of those available as a template.

You should be able to start SIMRES now:

% start


**************************************************************
INSTALLATION
**************************************************************

1) Create a target directory
------------------------------
You may need superuser rights to install SIMRES into a system directory like /usr/local/simres. However, you can also install and run SIMRES under you acount:

% mkdir $HOME/simres

Call the script "Install" with the target directory as an argument:

% Install $HOME/simres

The "Install" script copies files into the target directory and creates scripts for starting SIMRES ("start" and "simres_run"). A link is made to $HOME/bin/simres, so that you should be able to call the program from any directory under your account just by typing "simres" in a terminal window.

2) Run the demo simulations
----------------------------------
Call SIMRES from a terminal, at least one of the following should work now:

% simres
or
% $HOME/bin/simres
or
% $HOME/simres/start

Select a configuration from the menu. As a default, configuration is taken from the $HOME/simres/demo directory. You can modify the menu in the "start" script to call SIMRES with other options and/or project directories. 

------------------------------------------------------------------------
See the RESTRAX webpage for other information and guides:
http://omega.ujf.cas.cz/restrax