Installing SGV

The environment needed to install SGV is :

• PYTHIA version 6. This Pythia version is needed, even if it is not going to be used as an event generator: SGV profits from many of pythia's utilities.
• LAPACK and BLAS (most certainly already installed on your linux-system)
• About 5 MB of free disk-space

In addition, probably you also would like to have root and stdhep installed.

If You system fulfills these requirements, get sgv by

svn co https://svnsrv.desy.de/public/sgv/trunk/ sgv/

The last argument (sgv/) can be whatever you want, and will be created, if needed. In the following, it is assumed that indeed “sgv/” was given.

The files extracted should be the sub-directories

• src (the source code)
• samples (various examples and extensions),

the scripts

• install (to install SGV)
• cresgvexe (to create an executable)
• sgvass.sh(csh) (to do standard assignments of input and output files)
• makesgvlibs (to create or recompile libraries)

the example steering files and geometry descriptions

• sgv_ex_*.steer(tit) ( sample steering files, new(old) style )
• sgv_geo*_ex.inp ( sample detector geometry files)

and tex sources for documentation

• sgv_ug.tex (this users-guide)
• sgv_refman.tex (reference manual, outdated, but still useful.)
• README
• INSTALL (instalation guide)

In addition, there are a number of utility scripts and programs, described later.

Next step is to install^2.1 : cd to sgv , and:

bash install

. ./sgvenv.sh ( or source sgvenv.csh , if your shell is a c-shell family one.)

There will be some decisions to make while installing, namely whether to install libraries, whether You want to produce the printable versions of the documentaion, and whether you want a user-directory created and filled with basic example code. Probably You want to do that, so just hit return at each question. Nevertheless, pay attention to the explanations.

You now have among other things a users-guide with the name sgv_ug.tex, and a reference manual with the name sgv_refman.tex. The pdf file are also there if You so requested. The rest You need to know is in there. The scripts sgvenv.sh/csh have been created and contains the settings of various environment variables that are needed for SGV. If makesgvlibs is run again (it was run inside install), the variable SGV_LIB will be updated in sgvenv.sh/csh, if indeed a new library was created. Other variables are not changed.

Read sgv_ug.pdf, following the reading instructions in chapter 1.1 .