HOW  TO  INSTALL  AND  RUN   ESPACE

This page is presently maintained by Bob Michaels rom@cebaf.gov.

1) First decide whether you want to install and compile your own version of the analysis software (follow steps 2 through 5; 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')

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. Offerman), 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

(Bob) Sometimes better than above: set path = ($LOC_HALLA_BIN $path)

Additions to .login file on SunOs

setenv LD_LIBRARY_PATH /usr/dt/lib

Execute the login file by giving the command 'source .login' or logging out and in again. Now the necessary logicals have been defined.

3) ftp the distribution file for the Sept 21, 1997 version 2.4.0 of ESPACE, which is distribution-2.4.0-src.tar, to your machine and type 'cd $HALLA_DIR'. For description of changes in this version, as well as earlier versions, see the version history.

If you want the linux version see http://studbolt.physast.uga.edu/templon/espace_cernlib.html

4) type 'tar xvf ~/distribution-2.4.0-src.tar'.

5) 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.