HOW TO INSTALL AND RUN
ESPACE
Steps 3-5 are installation notes. Step 6 explains the
files you need. For more details, see the ESPACE manual
from Feb 28, 1997 (the latest version from E.A. Offermann),
espace.ps.
2) Add the following lines to your
login file : Additions to .login file
setenv HALLA_DIR 'your_directory'
setenv LOC_HALLA_BIN $HALLA_DIR/bin//$OSNAME
setenv PATH $LOC_HALLA_BIN/:$PATH
Sometimes better than above:
set path = ($LOC_HALLA_BIN $path)
Additions to .login file on SunOs
setenv LD_LIBRARY_PATH /usr/dt/lib
1)
First decide whether you want to install and compile
your own version of the analysis software
(follow steps 2-5, and
give in step 2 the directory where you want to install it as
'your_directory') -- or whether
you want to run the preinstalled version on the
work disk (skip steps 3-5;
give in step 2 the directory '/work/halla/software' as
'your_directory')
Execute the login file by giving the command 'source .login' or
logging out and in again. Now the necessary logicals have been
defined.
3) Download, via ftp the
distribution file
for the 12 June 1998 version 2.6.1 of ESPACE, which is
distribution-2.6.1-src.tar.gz,
to your machine.
You will need about 50 Mbytes to work productively.
For description of changes in this version, as well as
earlier versions, see the
version history.
4) After downloading the
tar file, type 'cd $HALLA_DIR' and
then type
gunzip -c distribution-2.6.1-src.tar.gz | tar xvf -
5) Now you're ready to compile. Go to $HALLA_DIR/src/r2-6 and type 'make install-all'. This will take anywhere from 10 to 30 minutes and print lots of information on your screen. If it worked, you will have an executible 'espace' in the directory pointed to by the environment variable $LOC_HALLA_BIN
6) Here is a list of files you need to
get started and do a minimal
analysis. For FPP, the list is much longer.
- Analysis kumac. This is the kumac file which controls ESPACE execution. An example is in /util_notsource of the tar file distribution, see ana_start.kumac. Once you start-up espace (by typing 'espace') and have the espace> prompt, you type 'exec ana_start'.
- Database. These are the geometry, time-offsets, magnet matrix elements, and other constants. Good examples are in /db in the tar file. The notation is db_eA_hB, where "e" and "h" mean electron and hadron arm, and A, B are the momentum where the calibration was done.
- Header file. This has some run-dependent constants, like magnet settings, reaction type, etc. You might get a copy from the adaq account, a file like hdr_5080 for run 5080, and modify it.
- detmap.config -- the detector map. If your kumac has the line set/file/detmap in it, you must have the corresponding detector map in your directory. If the line is absent, ESPACE should find this file from inside the data file.