Subsections
calchep_2.4.#.tgz
where # - denotes the number of release
Unpack this file by
tar -xzf calchep_2.4.#.tgz
or
mv calchep_2.4.#.tgz calchep_2.4.#.tar.gz
gunzip calchep_2.4.#.tar.gz
tar -xvf calchep_2.3.#.tar
As a result a directory 'calchep_2.4.#' should be created.This directory contains source codes of the CalcHEP package for UNIX platforms.
gmake or make
command started from the CalcHEP root directory. Indeed gmake options are needed. But if gmake is absence, it as rule means that your make works like gmake.
If the C compiler and X11 files are detected and the sources are compiled successfully you will see the message:
"CalcHEP can be started."
Otherwise the corresponding error message comes out. See below a discussion of possible problems.
The files in the CalcHEP root directory will be used only for reading and execution during the user session. It provides one with a possibility to have one CalcHEP root directory for several users.
Each user has to create his own directory to work with CalcHEP. See an instruction for the user installation in the next section.
The CalcHEP root directory is not intended to start a session. For this purpose the user has to prepare a special working directory. A few working directories may be created for various tasks and by different users.
The user working directory is prepared by the command
./mkWORKdir dir_Name
launched from the CalcHEP root directory. For example
./mkWORKdir ~/WORK
As a result the following sub-directories and files
should appear in your WORK directory:
models/ tmp/ results/
bin/
calchep calchep.ini
The directory models is used for files which describe models of particle interactions. The directory tmp is created for temporal files. The directory results is assigned for a CalcHEP output. bin is a symbolic link to CalcHEP executables.
To start a CalcHEP session you should issue a command
./calchep
The calchep.ini file allows to choose an appropriate text font for the CalcHEP window, select the color or colorless mode for the window and also switch on/off the sound signal. The syntax of this file is self-explanatory.
At first step make_all lauches getflags. The target of this program is generation of files FlagsForSh and FlagsForMake which contains names of C and Fortran compilers and compiler flags. If FlagsForSh is absent, it is generated autmatically depending on Unix platform. Otherwise getflags checks the flags written in FlagsForSh. Thus in case of problem user has to correct FlagsForSh and start make_all or getflags again. FlagsForMake contains the same flags but for usage in Makefiles. It is corrected automatically.
To use CalcHEP in graphic interface mode one should have installed
libX11-devel for Fedora/Scientific, Darwin(MAC)
libX11-dev for Ubuntu/Debian
xorg-x11-devel for SUSE
If the package is installed, one should see X11 header files in directory /usr/include/X11
CalcHEP contains only SM. Other models should be installed
indepedently.
To install new model the user has to
a) download the corresponding MODEL.tgz file.
b) unpack it; In result directory MODEL with CalcHEP model files and
codes for external functions will be generated.
c) If you don't dispose MODEL in CalcHEP directory, improve
definition of CALCHEP variable in MODEL/Makefile. It has to
show the path to CalcHEP directory which is used to dowload the file
with compiler flags.
d) read README file attached to the model and make the corresponding changes
in Makefile if it needs.
e) launch 'gmake' inside MODEL. If 'gmake' is absent try 'make'.
The Makefile is written for 'gmake', but in modern platforms sometimes
'make' presents the 'gmake' command. In results of compilation you
should get the mLib.a library.
f) To add a new model to the list of models for your working sessions use
the
"IMPORT OF MODELS" menu function. It asks you to define the directory
where model is disposed:
Dir= 'path to MODEL'/models
For expample, in case of MSSM disposed directly inside CalcHEP
Dir= $CALCHEP/MSSM/models