Difference between revisions of "MuonCalib Tutorial"

From Atlas Wiki
Jump to navigation Jump to search
Line 16: Line 16:
  
 
'''Why segments?'''
 
'''Why 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. If you do not have an ATLAS account yet you can get an account [https://uimon.cern.ch/twiki/bin/view/Atlas/WorkBookGetAccount here].
 
−
 
−
The content of the Calibration Segment Ntuple can be found [[MuonCalib_NtupleContent]].
 
−
 
−
The content of the ntuple described in the [http://agenda.cern.ch/fullAgenda.php?ida=a057588 Calibration Segment Ntuple] talk is not available in release 11.0.0 . In order to be able to make ntuples is this format one should use more recent versions of MuonCalib. These have to be checked out from CVS and to be recompiled in the right order (in order to set the libraries in the right way).
 
−
 
−
* log on to ''lxplus'':
 
−
<font color = red> <tt>ssh <username>@lxplus.cern.ch </tt></font>
 
−
* create a work area (here called ''11.0.0'')
 
−
<font color = red><tt>mkdir 11.0.0</tt>
 
−
 
−
<tt>cd 11.0.0/</tt></font>
 
−
* create a ''requirements'' file which should look like this:
 
−
<pre>
 
−
set          CMTSITE          CERN
 
−
 
−
macro        ATLAS_DIST_AREA  "/afs/cern.ch/atlas/software/dist"
 
−
macro        ATLAS_RELEASE    "11.0.0"
 
−
 
−
use          AtlasSettings v* $(ATLhttp://agenda.cern.ch/fullAgenda.php?ida=a057588AS_DIST_AREA)
 
−
 
−
path_remove  CMTPATH          ${PWD}
 
−
path_prepend CMTPATH          ${PWD}
 
−
</pre>
 
−
* build your CMT environment:
 
−
<font color = red><tt>source /afs/cern.ch/sw/contrib/CMT/v1r18p20050501/mgr/setup.(c)sh</tt>
 
−
 
−
<tt>cmt config</tt>
 
−
 
−
<tt>source setup.(c)sh -tag=opt</tt></font>
 
−
 
−
* 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 [https://uimon.cern.ch/twiki/bin/view/Atlas/MuonCalibrationFramework MuonCalibrationFramework] page.
 
−
<font color = red><tt>cmt co Reconstruction/RecExample/RecExCommon</tt> </font> (at head) or
 
−
 
−
<font color = red><tt>cmt co -r RecExCommon-version Reconstruction/RecExample/RecExCommon</tt> </font>  for your favorite version. Currently, the head version of RecExCommon fails to run quickly. A working version is for instance RecExCommon-00-04-20.
 
−
 
−
* build ''RecExCommon''
 
−
<font color = red><tt>cd Recontruction/RecExample/RecExCommon/RecExCommon-*/cmt </tt>
 
−
 
−
<tt>cmt config </tt>
 
−
 
−
<tt>source setup.(c)sh </tt>
 
−
 
−
<tt>gmake </tt> </font> 
 
−
 
−
* go to the ''run'' directory and load some auxilliary libraries:
 
−
<font color = red><tt>cd ../run/ </tt>
 
−
 
−
<tt>source ../share/RecExCommon_links.(c)sh </tt></font> 
 
−
 
−
* now we can run Athena, provided to have the right ''jobOptions'' files. (The following command dumps the messages and writes them to the logfile.)
 
−
<font color = red><tt>athena jobOptions.py | tee athena.log </tt></font> 
 
−
 
−
'''Running on single muons samples'''
 
−
 
−
* a good example of a ''jobOptions'' file that produces segment ntuples is provided in Zdenko's public:
 
−
<font color = red><tt> cp /afs/cern.ch/user/z/zvankest/public/myTopOptions.py .</tt></font>
 
−
 
−
* you can customize this jobOption file to your own needs...
 
−
<pre>
 
−
Change the number of events in the ntuple
 
−
Change the tracking software (Moore <-> MuonBoy, and Jochem's cosmic pattern finder package in the future)
 
−
Change the muon-sample (note! The file should be present in your PoolFileCatalog):
 
−
        in your run directory, add the file to your PoolFileCatalog by calling
 
−
              pool_insertFileToCatalog <physical path of your favorite POOL file>
 
−
        in your myTopOptions.py, replace the following line
 
−
              PoolRDOInput = [ "rfio:/castor/*/*.pool.root" ]
 
−
        by
 
−
              PoolRDOInput = [ "<POOl file path>" ]
 
−
</pre>
 
−
 
−
From the ntuple on, we can operate Athena-independent.
 
−
 
−
==Segment analysis==
 
−
 
−
'''The Calibration Event Data Model (EDM)'''
 
−
 
−
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, <math> \vartheta </math>, <math> \varphi </math>, q/p)''. These patterns are described in the class ''MuonCalib::MuonGlobalPattern''. Patterns are built from a number of ''segments''.
 
−
 
−
* a segment is described by ''MuonCalib::MuonCalibSegment'', which is basically a line segment which matches the hits stored in the segment. So segments describe the premature track at ''chamber level''. A line is given by a vector and a direction. This information can be found on the segment as well, in two co-ordinate systems: the ''global'' ATLAS co-ordinates and the ''local'' chamber co-ordinates.
 
−
 
−
* the hits on the segment are implemented as ''MuonCalib::XxxCalibHitBase'' 's with ''Xxx'' the technology which recorded the hits (i.e. Mdt, Tgc, Csc or Rpc). Each hitBase has their own dedicated content relevant for doing calibration; thus RPCs do ''not'' have drifttimes and MDTs do ''not'' provide timemeasurements. They do have common members such as (local en global) position and ''MuonCalib::MuonFixedId'' 's. Since the Calibration EDM classes are Athena-independent, the ''identifiers'' defined for the hit classes are decoupled from the ATLAS data-base (which is Athena-dependent).
 
−
 
−
In order to do an analysis on segment level from the ntuple, the content from the ntuple must be casted into the Calibration EDM. This can be done with help of a ''skeleton analysis package''.
 
−
 
−
'''The CalibNtupleAnalysis package'''
 
−
 
−
<<work in progress>>
 
−
At this moment, the tarfile containing the CalibNtupleAnalysis package treats ntuples made by release 10.5.0 and 11.0.0 without updated Calibration Service. Since half november 2005, the content of the Calibration Segment Ntuple has changed, causing a mismatch of ntuple format of what the analysis package expects. This will be repaired before the <font color=red>5th of december </font>.
 
−
 
−
The 'old MuonCalib ntuple' contains only patterns, segments and Mdthits (called 'hits'). The 'new MuonCalib ntuple' contains the information given above.
 
−
 
−
 
−
This package consists of a number of objects:
 
−
<pre>
 
−
CalibNtupleAnalysis
 
−
 
−
                  NTReader                    Reads the ntuple and stores events in Calibration EDM classes
 
−
                  MuonCalibEvent              Container class for the MuonCalib::MuonGlobalPatterns
 
−
                  SegmentAnalysis            Steers the analysis performed on the ntuple
 
−
</pre>
 
−
 
−
'''Setting up the analysis package'''
 
−
* go to your work space at your ATLAS account
 
−
<font color = red><tt> cd 11.0.0/ </tt></font>
 
−
* get the CalibNtupleAnalysis package (in the future this can be checked out from the release):
 
−
<font color = red><tt> cp ~zvankest/public/CalibNtupleAnalysis.tgz </tt></font>
 
−
* and get the hacked MuonSpectrometer/MuonCalib/MuonCalibEventBase package from the same place. This is needed because some incompatibility problems of the MuonCalibEvent class and the MuonGlobalPattern class. In the future this won't be needed, so bear with this for the moment.
 
−
<font color = red><tt> cp ~zvankest/public/MuonSpectrometer.tgz </tt></font>
 
−
* unpack the tarred files
 
−
<font color = red><tt> tar -xvfz <package>.tgz </tt></font>
 
−
 
−
*An example of an analysis is given in the executable ''exe/Main.cxx''. Try running it after building the package:
 
−
<font color = red><tt>cd CalibNtupleAnalysis/v*/cmt/</tt>
 
−
 
−
<tt>cmt config</tt>
 
−
 
−
<tt>source setup.(c)sh</tt>
 
−
 
−
<tt>gmake </tt>
 
−
 
−
<tt>../i686-slc3-gcc323-opt/Run.exe</tt> </font>
 
−
* After a succesfull Run, you will be provided with the following files:
 
−
<pre>
 
−
SegmentAnalysis.root              Containing the Histograms and SegmentDisplays generated by the
 
−
                                  SegmentAnalysis framework. Note that one event may generate over
 
−
                                  100 segments.
 
−
</pre>
 
−
'''Customizing your favorite analysis'''
 
−
 
−
A skeleton needs some 'meat'... Some example routines will be provided:
 
−
<pre>
 
−
plotATLAS(MdtCalibSegment*)        Plots the hits on the segment in global coordinates. In the example
 
−
                                    an extra feature is shown; one can select MDTchambers by stationtype
 
−
                                    with a simple call on the MuonFixedId.
 
−
dumpSegment(MdtCalibSegment*)      Dumps MdtCalibSegment information. Invaluable for debugging.
 
−
refitSegment(MdtCalibSegment)      Refits the MdtCalibSegment with a DCSLFitter provided by the
 
−
                                    Calibration framework.
 
−
showSegment(MdtCalibSegment*)      Calls a simple eventdisplay in which the hits are drawn as drifcircles
 
−
                                    and the segment as line. The displays can be written to a PSfile.
 
−
circleResidual(MdtCalibSegment*)    Given the trackparameters and the hits on the segment, this routine
 
−
                                    calculates the expected residuals by extrapolating the track in the
 
−
                                    local y-z plane in which the driftradii of the hits are circles.
 
−
stripResidual(MdtCalibSegment*)    Given the trackparameters and the hits on the segment, this routine
 
−
                                    calculates the expected residuals by extrapolating the track in the
 
−
                                    local x-y plane in which the RPC strips are the precision coordinates.
 
−
</pre>
 
  
 
Maybe needed to explain the concept of segments and the calibration EDM, is to be written (work in progress). A starting point of Calibration Segments and its scope in the Reconstruction EDM can be found in a presentation given by Zdenko during the ATLAS Muonweek september-2005 called [http://agenda.cern.ch/fullAgenda.php?ida=a057588 Calibration Segment Ntuple]
 
Maybe needed to explain the concept of segments and the calibration EDM, is to be written (work in progress). A starting point of Calibration Segments and its scope in the Reconstruction EDM can be found in a presentation given by Zdenko during the ATLAS Muonweek september-2005 called [http://agenda.cern.ch/fullAgenda.php?ida=a057588 Calibration Segment Ntuple]
  
 
==Getting started==
 
==Getting started==
−
In order to get started one should know that this field is prone to many changes over time. Backward compatibility is surely broken since the ntuple format changed a lot in the period of november 2005. The ntuple format is defined by the MuonCalib package (''MuonCalibNtuple''), and the analysis package needs a certain ntuple format to be able to fill the MuonCalib EDM classes offline. In the following sections, recipes will be provided for different kinds of ntuple formats.
+
In order to get started one should know that this field is prone to many changes over time. Backward compatibility is surely broken since the ntuple format changed a lot in the period of november 2005. The ntuple format is defined by the MuonCalib package ('MuonCalibNtuple'), and the analysis package needs a certain ntuple format to be able to fill the MuonCalib EDM classes offline. In the following sections, recipes will be provided for different kinds of ntuple formats.

Revision as of 11:15, 30 November 2005

Muon calibration tutorial

Welcome to the Muon Calibration Tutorial Page! After doing this tutorial, you will be able to run Athena, make your ntuples containing segment information. This ntuple can then be used as input to do analysis with help of the skeleton analysis package provided. This analysis package CalibSegmentAnalysis relies heavily on the Calibration framework but is Athena independent.

Much information on validation, calibration and alignment can be found at the MuonSpectrometer homepage.

Introduction

Calibration

General information about the need of calibration in the MuonSpectrometer.


Calibration framework

A clear Wiki page on the Calibration Framework by Domizia and Niels can be found on the MuonCalibrationFramework Wiki. At this site, the Calibration EDM is explained.


Why segments?

Maybe needed to explain the concept of segments and the calibration EDM, is to be written (work in progress). A starting point of Calibration Segments and its scope in the Reconstruction EDM can be found in a presentation given by Zdenko during the ATLAS Muonweek september-2005 called Calibration Segment Ntuple

Getting started

In order to get started one should know that this field is prone to many changes over time. Backward compatibility is surely broken since the ntuple format changed a lot in the period of november 2005. The ntuple format is defined by the MuonCalib package ('MuonCalibNtuple'), and the analysis package needs a certain ntuple format to be able to fill the MuonCalib EDM classes offline. In the following sections, recipes will be provided for different kinds of ntuple formats.

Retrieved from "https://wiki.nikhef.nl/atlas/index.php?title=MuonCalib_Tutorial&oldid=816"