| QMUL SuperB analysis FAQ Page
| |
You will need to obtain accounts locally, and may also need to obtain accounts at CNAF and on the SuperB LDAP system. Once you have the necessary accounts set up you can start working with the code.
The SuperB Fast Simulation programme is installed on the students machine, and also at CNAF. This programme is used to generate simulated Monte Carlo samples with which to study detector design and physics issues for the SuperB project. First you will need to log into a computer that has FastSim installed. Having done that you can check out a release, and follow the necessary instructions for compiling the programme you need to use (if this is not already compiled in the release). The third step is to then run the simulation. You will find detailed instructions on how to start using FastSim at the following locations:
For the FastSim release V0.2.3 (and above) you need to run the following commands to set up a release:
setenv ROOTVER 5.26 [using a bash shell, type 'export ROOTVER=5.26' instead] sbnewrel -d V0.2.3_test -r FastSim/V0.2.3 sbsrtpath [return][return] cd V0.2.3_test/ReleaseFiles svn update cd ../ SvnTools/addpkg -f ReleaseFiles/Patches_devel gmake clean gmake lib PacMC.binOn completion of this step, you should have successfully recompiled the release, and can then follow instructions below for compiling tau->3mu, B->hh, Generating single particles.
In order to start using the FastSim programme, just as in the case of CNAF, one has to set the environment up in order to specify where your shell will find the appropraite start up scripts. The following will do this for you:
export ROOTVER=5.26
export SBROOT=/opt/exp_software/superb/
source $SBROOT/bin/superb-env.sh
export SVNROOT=https://sbrepo.pd.infn.it:8910
mkdir FastSim
cd FastSim
sbnewrel -d V0.2.4_test -r FastSim/V0.2.4
cd V0.2.4_test
sbsrtpath
gmake installdirs
gmake workdir.setup
Having done that, one should be able to add packages as normal, e.g.
sbaddpkg PacUser
The binaries will work out of the box, so as long as you don't need to modify code, and are content
to simply modify any tcl configuration files, then this minimal set up should be sufficient for your
requirements.
The PacTauUser package contains a reconstruction sequence for the decay tau->3mu. In order to use this sequence to generate events you will need to run the following commands from a FastSim release to compile the PacTauUserApp programme.
gmake PacTauUser.lib
gmake PacTauUser.bin
[note that if you have checked out a number of packages and modified their code, you may need to replace
the first line with gmake lib].
If the programme has been compiled correctly you will see the following files:
lib/*/libPacTauUser.a
bin/*/PacTauUserApp
If these do not appear, please fix the compile problem and re-compile. From the workdir in your release you
will be able to run the following command and generate tau->3mu signal MC.
PacTauUserApp ../PacTauUser/example_tau3mu.tcl
If this programme has worked correctly, you will see a new file in the workdirectory called pacTau3Mu_10K_INMAPS.root.
The file should be renamed to something appropriate, for example: tau3mu.root.
There is a background MC tcl setup for ue with the SuperB production code. This is PacTauTo3MuSequence.tcl.
The package PacTwoBodyUser instructions has been prepared in order to study different types of B->hh final states (h=pi+/-, K+/-, pi0, K0). In order to compile this package one must
gmake PacTwobodyUser.lib
gmake PacTwobodyUser.bin
[note that if you have checked out a number of packages and modified their code, you may need to replace
the first line with gmake lib].
and if this is successful you will find the following files exist:
lib/*/libPacTwoBodyUser.a
bin/*/PacTwoBodyUserApp
Having successfully compiled the programme, you can generate events by running the following command from your workdir
PacTwoBodyUserApp ../PacTwoBodyUser/example_PiPi.tcl
for B0 -> pi+ pi-, or change the example tcl file to generate any of the other modes of
interest (See PacTwoBodyUser instructions for details.
Please take a look at the following URL for information on how to do this: Generating events using a particle gun.
There are a number of useful tcl parameters (or FwkCfgVars [Framework Configuration Variables]) that can be modified in order to change the number of events generated, filename etc. These will be found in the example_XYZ.tcl files. The most useful ones are:
In order to change configuration between the SuperB baseline and BaBar configurations for simulation, there are two steps to take (assuming that you have a working FastSim release having followed steps in Starting with FastSim:
Change the line
FwkCfgVar BeamConfig PacMC/SuperB_Beams.tcl
in PacMC/PacMC.tcl to read
FwkCfgVar BeamConfig PacMC/BaBar_Beams.tcl
Change the line
FwkCfgVar DetectorConfig PacDetector/pacrat_SuperB.xml
in PacMC/PacMC.tcl to read
FwkCfgVar DetectorConfig PacDetector/pacrat_BaBar.xml
include file="PacTrk/Si_SuperB_Geom.xml"
in PacTrk/Si_SuperB.xml so that this refers to the geometry that you would like to use. For example, the Si_SuperB_Geom_inmap_long_barrel.xml for a
long barrel pixel detector, or Si_SuperB_Geom_inmap_lampshade.xml for a lampshade pixel detector.
There are a number of other useful documents available online for SuperB. The following wiki pages may be of use to you:
In addition to the above wiki pages, past meetings are documented here, and documents on the project and physics can be found at the following section of the wiki: Physics Documentation.
This webpage is maintained by Adrian Bevan.
The QMUL SuperB web page also has a number of useful links.