LHCb Software At Nikhef: Prepare for Workshop 22-24 June 2009
The Bfys workshop will not take place at a high energy physics lab. Wireless connection is available, but for the hands-on work, we will not rely on that. Instead we provide two solutions:
1) Connect to a computer/server. (See: Running on Workshop Server )
2) Install and configure virtual machine on your laptop, "CernVM". (How to install)
(This will give the possibility to run LHCb software locally, very much as if you logon to a computer inside your laptop...)
We ask you to try to run an example job on the server using your laptop, before the workshop starts on Monday. (See Running on Workshop Server)
In addition - to familiarize with the LHCb software jargon - we ask you to read through the following pages too:
1) Python Basics
3) Gaudi Basics (twiki)
Running on Workshop Server
Linux or mac:
ssh -Y firstname.lastname@example.org (# Available usernames: u01 - u15) Password: (LHCb psswrd)
Make sure you have Exceed running ssh to 188.8.131.52 (# Available usernames: u01 - u15) Password: (LHCb psswrd)
NB: In Egmond use: 192.168.1.1
At startup, the script /opt/LHCb/LbLogin.sh is executed for all users. It sets up the LHCb environment. After this, follow the steps described in 
Run over events as described here.
Running on a Cern Virtual Machine (CernVM)
This assumes you have successfully installed a CernVM on your computer. The installation varies between Windows, Mac OS and Linux, so see section further down for instructions on how to set it up. It also assumes you have set up basic login scripts, and installed AFS, X11R6, CVS and SVN if necessary, as indicated here. Also note that you have to run an application like DaVinci, Bender or Panoramix at least once while connected to the network in order to cache the necessary software.
This could mean starting the virtual machine and CernVM, starting it and logging in "remotely" from a terminal (Linux, Mac) or Exceed (Windows).
ssh -Y -p 2222 CernVMUserName@localhost
Start exceed Start ssh Connect to vm with ssh to 192.168.204.128 (Your number might be different!) (fink tunnel x11 connections in ssh!)
Set the environment
If you have followed the instructions for setting up CernVM and added the necessary group login scripts to your own login scripts, the LHCb environment should be set. If this is not the case,
# for sh, bash, ksh, zsh . /opt/lhcb/group_login.sh # for csh, tcsh source /lhcb/group_login.csh
Then follow the steps outlined in Setting the Environment. If you can't find the required version of DaVinci or Bender, try refreshing the CernVM cache. You need an internet connection for this!
sudo /etc/init.d/cernvm restart
The main difference in setting the application environments here is that if you do not have the necessary software installed, CernVM will pull it and cache it for you. So the first time you do this you should have an interned connection.
Setting the Environment
We use the LHCb script SetupProject. We don't need to care about details, other that when invoked with --build-env it doesn't set any environment variables in the shell, and it creates a folder
where all the software should be built. We will be using the Bender v12r1 and DaVinci v23r1p1 environments, but since Bender used DaVinci, the environment necessary for the latter is provided by the former, so we will set the Bender environment.
# this line in case ~/cmtuser/Bender_v12r1 doesn't exist yet SetupProject Bender v12r1 --build-env # this exports environment variables to the shell. Some people might not like doing this SetupProject Bender v12r1
This procedure is common to working at CERN, Nikhef, CernVM and the workshop server, provided the LHCb scripts have been set up correctly, be it automatically in the login scripts, or explicitly by sourcing some script. Details are in the subsections for each platform.
Running over some events on a DST or MicroDST
After the environment has been set (either by remote login to Nikhef or CERN, or in the local CernVM on your laptop,) we can start some simple analysis:
Get Tutorial packages Tutorial/BenderTutor, Tutorial/GaudiPythonTutor if not already there
If you haven't already got the tutorial packages in your build area, get them, as you will need to perform modifications to the exercise scripts. This has to be done when you have access to the internet.
cd ~/cmtuser/Bender_v12r1 # if the package is not there, do: # cvs co -r Tutorial/GaudiPythonTutor # cvs co -r v12r1 Tutorial/BenderTutor # re-sets the $GAUDIPYTHONTUTORROOT and $BENDERTUTOR environment variables SetupProject Bender v12r1 cd $GAUDIPYTHONTUTOR/cmt/ cmt config make cd $BENDERTUTORROOT/cmt cmt config make
Run over some events and make plots using a script from the release area
Don't worry, we'll go through exercises that will gradually allow us to write such a script. For now, just run it and stare, awe-struck, at the amazing plots.
Run over events
python -i $MICRODSTEXAMPLEROOT/scripts/MicroDSTReadingExample.py --input <filename> # <filename> can take one of the following values depending on context: # Workshop Server: /data/bfys/lhcb/workshop/Bs2JpsiPhiWithMC_1.mdst # Windows CernVM: /mnt/hgfs/data/Bs2JpsiPhiWithMC_1.mdst # Mac CernVM: /data/lhcb/Bs2JpsiPhiWithMC_1.mdst
Plot some of the histograms made by the script
>>> massPlots.plot() >>> massPlots.plot() >>> massResPlots.plot() >>> propTimePlot.plot() >>> propTimeResPlot.plot() >>> refitPropTimeResPlot.plot() >>> Ctrl-D
Some more examples, using Gaudi or Bender environments and example scripts. Note we run them directly without getpacking them.
SetupProject Gaudi v21r0 python $GAUDIEXAMPLESROOT/python/HistoEx.py SetupProject Bender v12r1 cd $BENDEREXAMPLEROOT/python/BenderExample/ ./Phi.py
Introduction to Python
It is important that attendees make themselves familiar with the python programming language, at least at the level of writing simple scripts.
Extensive tutorial: Tutorial
Cheat Sheet: Cheat Sheet
Execute: python myfirst.py