WWANA: A DELPHI WW Analysis Package
WWANA
A standard package for W analyses
Version 6.00
|
For a full description of WWANA you can have a look at the
WWANA delphi note.
For an update of settings and inputs to WWANA version 6.00 and a detailed
description of its new ntuple structure please read the documentation
in wwana afs public area (see the location of the code) or in the following
postscript format.
Here you will find a flow chart of the
program.
Aim
WWANA is intended as a standard DELPHI package for use in WW physics
analysis: it provides information relevant to both W mass measurements and
TGC studies.
The program is written in PATCHY format (click here for
reference manual
) and uses the
SKELANA
package to fill the common blocks which contain the information from the
DST.
The main output of the package is a column wise ntuple organised
in blocks of relevance to particular W decay channels and of more general
event information. By setting logical parameters, the user can choose which
blocks of information to include in the ntuple. This choice will depend
on which analysis and which W decay channels the user is interested in
studying. All the variables and the physical quantities that have been
evaluated are stored in common blocks; these have the same structure as the
ntuple blocks.
Location of the code
The WWANA program is composed of several PAM files, which are located
in the common area for DELPHI LEP200 physics on afs machines:
/afs/cern.ch/delphi/tasks/lep200/wphysics/wwana
The core of the program is composed of two PAM files:
- wwcde.car contains all the commons and parameter declarations
useful for the analysis: it also contains the user-defined basic selections.
- wwana.car is the main program with all the `tool subroutines'.
Two versions of the main program are stored in this area: a
stable version wwanaxx.car, wwcdexx.car updated every few
weeks, and a development version wwana.car_vyyy, wwcde.car_vyyy
updated as soon as changes are suggested.
WWANA also uses the following files:
- wwfit.car contains the routines for the kinematic fit
(the PUFITC+ package, by N.Kjaer and M.Mulders)
- sprime.car is the SPRIME package by P.Abreu et al.,
to calculate the effective centre of mass energy (from $DELPHI_PAM)
- durham.car contains the routine for the DURHAM jet reconstruction
algorithm
- fixcal.car contains the routines for the correction of
electromagnetic calorimetric energy (M.Calvi and M.Margoni) in '96 data
and Montecarlo
A further two files are provided in this area to assist the WWANA user:
- wwana.cra contains an example PATCHY cradle file which shows
how to use these PAM files
- wwana.manual documents the stable version of WWANA
How to use WWANA
WWANA works in SKELANA framework. To be appended to SKELANA the user has to
include:
- a call to the routine WWINI in USER00
- a call to the routine WWANA in USER02
- a call to the routine WWEND in USER99
WWANA handles the flags for the filling of the SKELANA common blocks in
the WWINI subroutine, where they should be set to the desired values.
The SKELANA LVLOCK array is used inside WWANA for track selection; WWANA
re-orders the VECP array so that the locked tracks are at the end.
The users can perform their own track selection
within SKELANA or use the W team track selection within WWANA by switching
the corresponding logical word in the file wwcde.car.
The user can set general cuts to be used inside
WWANA for the tagging of the different WW decay channels. These cuts
are defined inside +KEEP,WWCUTS. in wwcde.car and are set
by default to very loose values in order to maximize the tagging
efficiency, thus leaving complete control to the user. The full list
of the cuts is reported in the documentation (at the beginning of the
page).
The user can also set a certain number of parameters
which control the logic of the analysis. They are related to the options
for the constrained fit, the lepton identification and the jet clustering
algorithm to be used. The full list of the parameters with their default
and allowed values is reported in the documentation.
A Column-Wise Ntuple is used to store all the event information:
this choice allows the use of a block structure for the ntuple.
The user can therefore decide which of the blocks they want to include
in their ntuple in order to meet the individual needs of their analysis.
The ntuple output file ww.ntp is generated automatically when running
the program.
Ntuple blocks
The optional blocks of the ntuple and their contents are
described below.
Only the TITLE block, the HEADER block and the EVENT block are always filled,
while the other blocks can be excluded (or included) by changing the
corresponding logical word in wwcde.car.
- TITLE BLOCK This contains a user defined 'nickname' for
the ntuple. It can
be used to store information about the ntuple production: e.g.
MC generator, clusterization algorithm, etc...
- HEADER BLOCK General information about the run.
- MCINFO BLOCK Montecarlo information about the event.
- EVENT BLOCK General event quantities.
- QQANA BLOCK Information about the four jet analysis.
The jet combination
with the best chi square after the constrained kinematic fit
has been performed is retained.
- QQ4C BLOCK This block provides 4C fit information to be
used for the fully hadronic channel.
- QQOTHER BLOCK Information on the other possible
di-jet combinations after the kinematic fit.
- QLANA BLOCK Information for two jet, one lepton analysis,
where the lepton is identified as an electron or a muon.
- QTANA BLOCK Information for two jet, one lepton analysis,
where the lepton is either an unidentified charged track or a narrow,
low multiplicity, jet. Intended for qqtauv channels selection.
- FLANA BLOCK Information for the fully leptonic channel analysis.
- JETANA BLOCK Information on the jets - clusterized
according to the selected criteria.
- LEPTON BLOCK Information on the selected leptons in the event
according to the chosen criteria.
- NEUT BLOCK Information on highest energy neutral particles.
- Last update on June 2nd, 1998
R. C. :
(Send me an e-mail)