MuonCalib Tutorial

Muon calibration tutorial

Welcome to the Muon Calibration Page! After doing this tutorial, you will be able to run Athena, make your ntuples containing segment information and use this ntuple to do Athena-independent analysis.

Introduction

Calibration

General information about the need of calibration in the MuonSpectrometer.

Calibration framework

Link to Niels' stuff on calibration.

Why segments?

Maybe needed to explain the concept of segments.

Making segment ntuples

Setting up ATHENA

Making segment ntuples from scratch can be done with Athena running on release 10.5.0 or higher. It is recommended to run at the most recent release, in order to be up-to-date. This section covers working in release 11.0.0 . Since this release is not stalled at NIKHEF yet, it is recommended to work at CERN. If you do not have an ATLAS account yet you can get an account here.

• log on to lxplus:

ssh <username>@lxplus.cern.ch

• create a work area (here called 11.0.0)

mkdir 11.0.0

cd 11.0.0/

• create a requirements file which should look like this:

set          CMTSITE          CERN

macro        ATLAS_DIST_AREA  "/afs/cern.ch/atlas/software/dist"
macro        ATLAS_RELEASE    "11.0.0"

use          AtlasSettings v* $(ATLAS_DIST_AREA)

path_remove  CMTPATH          ${PWD}
path_prepend CMTPATH          ${PWD}

• build your CMT environment:

source /afs/cern.ch/sw/contrib/CMT/v1r18p20050501/mgr/setup.(c)sh

cmt config

source setup.(c)sh -tag=opt

• the last command line must be typed in every time you open a new terminal. If you want to fill your ntuple with segments from ATLAS reconstructed muons check out the RecExCommon package. For other environments (such as CTB etcetera take a closer look at the MuonCalibrationFramework page.

cmt co Reconstruction/RecExample/RecExCommon (at head) or

cmt co -r RecExCommon-version Reconstruction/RecExample/RecExCommon for your favorite version

• build RecExCommon

cd Recontruction/RecExample/RecExCommon/RecExCommon-*/cmt

cmt config

source setup.(c)sh

gmake

• go to the run directory and load some auxilliary stuff:

cd ../run/

source ../share/RecExCommon_links.(c)sh

• now we can run Athena, provided to have the right jobOptions files. (The following command dumps the messages and writes them to the logfile.)

athena jobOptions.py | tee athena.log

Running on single muons samples

• a good example of a jobOptions file that produces segment ntuples is provided by Domizia:

cp /afs/cern.ch/user/d/domizia/public/MuonCalib_files/myTopOptions.py

• you can customize this jobOption file to your own needs...

Change the number of events in the ntuple
Change the tracking software (Moore <-> MuonBoy)
Change the muon-sample (note! The file should be in your PoolFileCatalog)

From the ntuple on, we can operate Athena-independent <<whew!!>>.

Segment analysis

The MuonCalibration-framework works with a Calibration EDM, which defines the objects used in the Calibration. The structure is more or less like this:

• each event contains a certain number of Patterns. Concider these as potential tracks, containing information such as the Chi Squared of the pattern, the track parameters (z0, r0, $/theta$, $\phi$, q/p).

Setting up the analysis package

• go to your work space at your ATLAS account

cd 11.0.0/

• get the CalibNtupleAnalysis package (in the future this can be checked out from the release):

cp ~/zvankest/public/CalibNtupleAnalysis.tar

tar -xvf CalibNtupleAnalysis.tar

Customizing your favorite analysis

A skeleton needs some 'meat'...