On this page you can find the OLD instructions for running the BGV SW using the LHCb Gaudi projects installed in /afs/cern.ch/work/p/phopchev/public/LHCbSW/. These instructions are not maintained since June 2015 , but still provide useful examples. The latest instructions for can be found here.

Overview

A public installation is available on lxplus, at /afs/cern.ch/work/p/phopchev/public/LHCbSW
The following projects are installed:

For running on SLC5 (lxplus5), platform x86_64-slc5-gcc46-opt

• Environment setup script: source /afs/cern.ch/work/p/phopchev/public/LHCbSW/BGVLoginScript.sh
• Gauss: v46r2p1
• Boole: v26r5
• Panoramix: v22r0

For running on SLC6 (lxplus6), platform x86_64-slc6-gcc48-opt

• Environment setup script: source /afs/cern.ch/work/p/phopchev/public/LHCbSW/BGVLoginScript_slc6.sh
• Gauss: v46r8
• Boole: v29r1p1
• Panoramix: v23r0

Note about the various CPU platforms

• In 2013 the lxplus services and the LHCb software started transition from SLC5 to SLC6
• Since the end of 2013 there is only one official platform for the LHCb SW: x86_64-slc6-gcc48-opt
• The LHCb SW projects listed above provide the framework for running the BGV SW. The actual BGV code is stored in independent packages which are available in the BGV SVN repository. This means that we don't need to have the latest versions of the LHCb projects, and that in total only a few project versions will be installed in the BGV release area.

To run any application/job:

• Setup the BGV environment: see the possible "Environment setup script" above
• Setup the project environment: SetupProject <project> <version>
  • <project> is e.g. Gauss or Panoramix
  • If <version> is omitted, the latest available version is used
• Run your gaudirun.py or GaudiPython job
  • Job options and GaudiPython scripts (examples) can be found:
    • In /afs/cern.ch/work/p/phopchev/public/BGVExamples
    • In the options directory of the BGV SW packages

Simulation examples

• An example GaudiPython script is provided
  • Reads a .sim file located on castor
  • Creates a root ntuple (aka TTree) with some info (just an example). The ntuple creation and filling is not mandatory (it is not so useful for simple checks)
• To run it:
  • source /afs/cern.ch/work/p/phopchev/public/LHCbSW/BGVLoginScript.sh
  • SetupProject Panoramix v22r0
  • python -i /afs/cern.ch/work/p/phopchev/public/BGVExamples/pano_read_sim_make_ntuple.py

Read the root ntuple produced by the script above

• An example PyRoot script is provided
  • Lists the ntuple branches and draws a histogram
  • Two plotting approaches are demonstrated: PyRoot and matplotlib. In both cases the root TTree::Draw method is used to obtain (and possibly apply a cut on) the values of interest
• To run it:
  • source /afs/cern.ch/work/p/phopchev/public/LHCbSW/BGVLoginScript.sh
  • SetupProject Panoramix v22r0
  • python -i /afs/cern.ch/work/p/phopchev/public/BGVExamples/read_ntuple.py

Visualize the BGV geometry and events with Panoramix

• A shell script is provided that encapsulates the command to be executed
  • The input event and geometry files are specified as arguments
  • It is the user's responsibility to provide consistent event and geometry files
  • Don't mind the FATAL and ERROR messages from VeloClusterPosition and MeasurementProvider (looks like we need to fix hard-coded statements in the LHCb code)
• To run it:
  • source /afs/cern.ch/work/p/phopchev/public/LHCbSW/BGVLoginScript.sh
  • SetupProject Panoramix v22r0
  • . /afs/cern.ch/work/p/phopchev/public/BGVExamples/pano_run_vis.sh
  • If you wish to visualize events (particles, vertices, etc.) you need to read at least 1 event from the input file
    • Use the "arrow" button in the panoramix menu, or type appMgr.run(1) in the python prompt

Generate and simulate beam-gas events with Gauss

• To be completed