ILC Software Releases

The ILC software is not going to be the final framework of the Belle2 collaboration (see rooBASF). It is, however, our current play ground for optimization studies.

The following parts are implemented and ready to use:

Geometry GeometryModels:

  • PXD
  • SVD
  • CDC

Reconstruction:

  • PXD Digitizer
  • SVD Digitizer
  • CDC Digitizer (extremely simplyfied)
  • Sillicon Tracking (Pattern recognition & Kalman)
  • CDC Tracking (TPC assumption)
  • Full Tracking (Combination of Silicon and CDC Tracking)

Analysis:

  • Track combination & Candidate preparation
  • Vertex fitting (Sophisticated using Rave library)

Administration

To get access to the common MYSQL Database which holds the Geometry description please contact me Kolja Prothmann. Our IT will open the firewall for you and you will be able to login to the mysql database with the standard password from the tutorials.

You are free to setup your own mysql server and modify the geometry. To do this you can use the program 'mysqldump -hpcbelle01 -u belle2 -p --all-databases > dump.sql' . Then log in your new mysql server and load the dump. 'mysql -hMYSERVER -u MYNAME -p < dump.sql'

Installation

Some general comment

The Package is divided into two parts, CoreILC and Barcelona. The first provides some general libraries and classes, which can be used, and rarely have to be modified. The latter contains Mokka and the Marlin processors, that will be more often used and modified.

Mokka is a Geant4 wrapper. Marlin processes data similar as BASF.

There is no complete installation manual. If you encounter any problems please email Kolja Prothmann.

Requirements

The following libraries and programs are required to be installed on you computer:

  1. gcc - version 4.x is recommended but it can be compiled on 3.4 as well
  2. gfortran
  3. JDK - Java development kit
  4. CLHEP 2.0.4.x
  5. geant4 9.x
  6. cernlib 2006
  7. gsl development package
  8. boost
  9. cmake > 2.6
  10. mysql connector or development package
  11. ROOT

Downloading the software

There is a Ringberg release available, which is the most current version of the silicion tracking. Instructions can be found in RingbergILC .

the Barcelona Release is splitted into two pieces the CoreILC which contains unmodified ILC software packages and the Barcelona part which contains software that is modified to better suit the Belle II detector.

Please download these packages from the SVN repository. In the tags subfolder you will currently find to tagged versions. The Barcelona_1.0/ folder contains the first version of the framework. The Guofu_1.0/ folder contains a modified version, where the CDC simulation, which is in the Barcelona package only a modified TPC, is modified to a real CDC with the CDCHits saved as wire positions plus drift time.

Installation procedure

Download source code

wget http://belle2.mpp.mpg.de/ilcframe/CoreILC.tar.gz
tar -xzf CoreILC.tar.gz

hg clone static-http://belle2.mpp.mpg.de/ilcframe/gear
hg clone static-http://belle2.mpp.mpg.de/ilcframe/Mokka
hg clone static-http://belle2.mpp.mpg.de/ilcframe/MarlinReco
hg clone static-http://belle2.mpp.mpg.de/ilcframe/MarlinBelle
hg clone static-http://belle2.mpp.mpg.de/ilcframe/SiPxlDigi
hg clone static-http://belle2.mpp.mpg.de/ilcframe/SiStripDigi

"MarlinRave - optional"
wget 'http://stop.itp.tuwien.ac.at/websvn/dl.php?repname=marlinrave&path=%2Ftrunk%2F&rev=0&isdir=1'


wget http://belle2.mpp.mpg.de/ilcframe/config-scripts/setup-ilc.sh

Compile packages


"Change the pathes according to your system
ILCSOFT should point to your just downloaded CoreILC folder
WORKSPACE points to a folder where all the other packages go in.

cd $ILCSOFT/lcio/v01-11
mkdir build
cd build
cmake -C ../BuildSetup.cmake ..
make install

cd $ILCSOFT/RAIDA/v01-04-03
mkdir build
cd build
cmake -C ../BuildSetup.cmake ..
make install

cd $WORKSPACE/gear
mkdir build
cd build
cmake -C ../config/BuildSetup.cmake ..
make install

cd $ILCSOFT/Marlin/v00-10-04
"edit QT4 path if you want to have MarlinGUI in BuildSetup.cmake"
mkdir build
cd build
cmake -C ../BuildSetup.cmake ..
make install

cd $ILCSOFT/CED/v00-06
mkdir build
cd build
cmake -C ..
make install

cd $ILCSOFT/MarlinUtil/v00-13
mkdir build
cd build
cmake -C ../BuildSetup.cmake ..
make install

cd $MOKKA/source
make

cd $MARLINRECO
mkdir build
cd build
cmake -C ../config/BuildSetup.cmake ..
make install

cd $WORKSPACE/SiPxlDigi
mkdir build
cd build
cmake -C ../config/BuildSetup.cmake ..
"you can include the following options to get different debug outputs
-DCAIRO_OUTPUT 'Graphics output'
-DROOT_OUTPUT 'cluster size information'
-DASCII_OUTPUT 'raw data for hardware people'
"
make install

cd $WORKSPACE/SiStripDigi
mkdir build
cd build
cmake -C ../config/BuildSetup.cmake ..
make install

cd $MARLINBELLE
mkdir build
cd build
cmake -C ../config/BuildSetup.cmake
make install

"MarlinRave - optional"
cd $MARLINRAVE
"edit BuildSetup.cmake to fit to our environment"
mkdir build
cd build
cmake -C ../BuildSetup.cmake ..
make install

"No MarlinRave"
"edit setup-ilc.sh comment out the two marlin rave lines"

Excursion: compile dependencies

CLHEP (do not use 2.1)
wget http://proj-clhep.web.cern.ch/proj-clhep/DISTRIBUTION/tarFiles/clhep-2.0.4.5.tgz
tar -xzf clhep-2.0.4.5.tgz
cd 2.0.4.5/CLHEP
./configure --prefix="INSTALLLOCATION"
make -j
make check
make install

GEANT4 9.3
"important: do not source setup-ilc.sh before compiling geant4"
./Configure -build
./Configure
"source the generated env.sh inside your setup-ilc.sh"

Tutorial

There are some outdated tutorials around. If you do not know anything about BelleILC please contact somebody who will explain. There are alot of options to steer the software and it is not trivial to get everything right.

Anyway please contact the development team about the latest changes and a recent steering file for Mokka and Marlin

YOUR HELP IS NEEDED TO FILL THIS PARAGRAPH!

-- KoljaProthmann - 03 Sep 2010

Edit | Attach | Watch | Print version | History: r4 < r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r3 - 2010-09-06 - KoljaProthmann
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2019 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback