LHCb Software At Nikhef: Prepare for Workshop 22-24 June 2009
Introduction
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
2) Bender Tutorial (twiki) Tutorial (pdf)
3) Gaudi Basics (twiki)
Running at Nikhef
Login
ssh user@ribble.nikhef.nl ssh stbc-16 (on stoomboot)
Environment
Before setting the application environment as explained in section [1] it is necessary to set the LHCb login environment:
mkdir cmtuser cd cmtuser . /project/bfys/lhcb/sw/LbLogin.sh # for sh, bash, ksh, zsh source /project/bfys/lhcb/sw/LbLogin.csh # for csh, tcsh
(NB: zsh-users should add 'setopt SH_WORD_SPLIT' to their .zshrc )
Run
Simply follow the steps outlined in [2]
Running on Workshop Server
Login
Linux or mac:
ssh -Y u01@192.16.186.110 (# Available usernames: u01 - u15) Password: (LHCb psswrd)
Windows:
Make sure you have Exceed running ssh to 192.16.186.110 (# Available usernames: u01 - u15) Password: (LHCb psswrd)
Environment
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 [3]
Run
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.
Login
This could mean starting the virtual machine and CernVM, starting it and logging in "remotely" from a terminal (Linux, Mac) or Exceed (Windows).
Linux/Mac
ssh -Y -p 2222 CernVMUserName@localhost
Windows
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
~/cmtuser/ProjectName_vXrY
where all the software should be built. In our case, we will be using DaVinci v23r1p1 or Bender v12r1. In the examples that follow, we use DaVinci.
# this line in case ~/cmtuser/DaVinci_v23r1p1 doesn't exist yet SetupProject DaVinci v23r1p1 --build-env # this exports environment variables to the shell. Some people might not like doing this SetupProject DaVinci v23r1p1
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 a nice package full of example scripts (new Bender Examples package exists too...)
If you haven't already got an examples package, get it, as you might need to perform modifications to some of the scripts. This has to be done when you have access to the internet.
cd ~/cmtuser/DaVinci_v23r1p1 getpack -p anonymous Ex/MicroDSTExample v2r5 # re-sets the $MICRODSTEXAMPLEROOT environment variable SetupProject DaVinci_v23r1p1 cd Ex/MicroDSTExample/cmt/ make
# Run over events: python -i $MICRODSTEXMAPLEROOT/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[443].plot() >>> massPlots[531].plot() >>> massResPlots[531].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.
Python Basics
Extensive tutorial: Tutorial
Cheat Sheet: Cheat Sheet
Example: myfirst.py
Execute: python myfirst.py
Miscelaneous
AFS access (not necessary for workshop)
If you need access to CERN AFS areas,
klog user@CERN.CH
Where user is your CERN AFS username. Note the UPPER CASE for the domain name. Be careful: Never do: ls /opt/ !! (It could start caching all atlas software...).