# # E391a library # # Revised: Tue Mar 5 17:17:01 JST 2002 # Wed Oct 10 14:58:38 JST 2001 # Fri Sep 28 10:59:58 JST 2001 # Draft : Fri Sep 14 13:56:56 JST 2001 # # Mitsuhiro YAMAGA (yamaga@post.kek.jp) # 1. Introduction This library contains the software kits for the E391a experiment. Currently only GEANT3 full-simulation, MIDAS DAQ system and some utilities are included. 2. Supported platform o Linux on PC o IBM AIX on ps.cc.kek.jp o Solaris8 on Sun (ultra)sparc 3. Requirements o CERN library o CLHEP library o GNU-make(gmake) 4. Installation on PC Linux 1) Obtain the source package and required libraries. Source packages are kept under ps.cc.kek.jp:/dfs/g/ps/klea/e391/tar/src/e391-exxxx_xxxx.tar.gz CLHEP is under ps.cc.kek.jp:/dfs/g/ps/klea/e391/tar/clhep/clhep-x.x.x.x.tar.gz 2) Install CERN library and CLHEP library. (Follow the instruction documents of each distribution. ) 3) Create a directory for e391a library, then untar the source package there. % mkdir -p somewhere/e391/exxxx_xxxx % cd somewhere/e391/exxxx_xxxx % tar xvzf e391-exxxx_xxxx.tar.gz % cd somewhere/e391 % ln -s exxxx_xxxx pro 4) Set the enviroment variables properly. E391_HOME = 'somewhere'; E391_LEVEL = 'exxxx_xxxx'; 'pro' will be convenient. E391_TOP_DIR = ${E391_HOME}/e391/${E391_LEVEL} E391_LIB_DIR = ${E391_TOP_DIR}/lib E391_CONFIG_DIR = ${E391_TOP_DIR}/src/config CERN = 'cern' directory of your computer (e.g. /cern ). CERN_LEVEL = release number (e.g. 2000). CERN_ROOT = ${CERN}/${CERN_LEVEL} CLHEP_BASE_DIR = top directory you installed CLHEP (e.g. /usr/local). CLHEP_LIB = CLHEP-g++.1.7.0.0 LD_LIBRARY_PATH = list of the directory name where shared libraries are stored. e.g. '.:${E391_TOP_DIR}/lib/so' You can use an example script to set them. somewhere/e391/exxxx_xxxx/examples/script/cshrc_e391 Copy it to your directory, modify it if you need, then source it. % cp somewhere/e391/exxxx_xxxx/examples/script/cshrc_e391 yourdirectory/. % vi yourdirectory/cshrc_e391 % source yourdirectory/cshrc_e391 5) Build the library. % cd somewhere/e391/exxxx_xxxx/src % gmake 5. Setup on IBM AIX on ps.cc.kek.jp E391a libraries are kept under /dfs/g/ps/klea/e391/e391 Only you have to do is to set the enviroment variables. Use the script below. /dfs/g/ps/klea/e391/local/etc/cshrc_e391 % source /dfs/g/ps/klea/e391/local/etc/cshrc_e391 6. Play with gsim You can find the example scripts and configuration files for gsim; ${E391_TOP_DIR}/examples/gsim/gsim-e391a Copy and use them to play with gsim. % cp -r ${E391_TOP_DIR}/examples/gsim/gsim-e391a your_work_area/. % cd your_work_area/gsim-e391a % ./lnk.csh % ./gxsim .... GEANT > exe disp GEANT > trig 1 GEANT > quit % ./gsim -display -psfile test.ps -gen 10 'gsim' has many command-line options. Type './gsim' then you will see all the options. If you are a code developper, look at the source code under ${E391_TOP_DIR}/src/sim/gsim/e391a/src/ . Manual will be ready soon. 7. Modify or develop the code in the E391 library The useful command 'get_packages' is available for you to modify the official source code. Please read README.get_packages in the examples/doc/ directory. This command provide you the directory-tree and Makefiles into your local directory, then copies the package file there. % ${E391_HOME}/local/bin/get_packages package_name You can simply type 'make' to rebuild the package in your local directory. You can apply any modification to the source code there. 8. More about library The details about e391a library will be described in another manual. 9. Contact Questions, comments, suggestions or requests are welcome. Please contact Mitsuhiro YAMAGA (yamaga@post.kek.jp) . (Tue Mar 5 17:17:01 JST 2002) (Wed Oct 10 14:58:38 JST 2001) (Fri Sep 14 20:06:19 JST 2001) (Fri Sep 28 10:59:58 JST 2001)