JetIsolationTool Class Reference

#include <JetIsolationTool.h>

Inheritance diagram for JetIsolationTool:

List of all members.

Public Member Functions
	JetIsolationTool (const std::string &myname)
	Ctor.
	~JetIsolationTool ()
	Dtor.
StatusCode	initialize ()
StatusCode	finalize ()
int	modify (xAOD::JetContainer &jets) const
	Loop over calls to modifyJet.
int	modifyJet (xAOD::Jet &) const
Friends
class	jet::JetIsolation::IsolationCalculator

---

Detailed Description

Calculate isolation variables for jets and set them as jet attributes.

Properties: IsolationCalculations: List of calculations to perform (see below) PseudoJetGetter: Pseudojet getter (ToolHandle<IPseudoJetGetter>)

The isolation variables are calculated from a list of input constituents. which are close to the jet but not part of its constituents. There are multiple options to find this list and then to calculate the variables. They are passed to the tools by giving a list of string identifiers through the IsolationCalculations property as in

IsolationCalculations = ["IsoKR:11:Perp","IsoKR:11:Par", "IsoFixedCone:10:SumPt",]

where the strings have the form "ISOCRITERIA:NN:VAR"

• ISOCRITERIA : encode the method used to find isolation particles (IsoKR, IsoDelta, IsoFixedCone, IsoFixedArea, Iso6To8, signification detailed below)
• NN : encode the value of the main parameter of ISOCRITERIA : the actual parameter used is NN/10. (same convetion as jet radius in JetContainer names)
• VAR : encode the variable to be calculated (Per, Par, SumPt, P, significations detailed below)

The resulting attribute name is simply the identifier string with ':' removed. Example "IsoKR:11:Perp" -> "IsoKR11Perp"

The input particles container from which constituents come from must be specified in the ConstituentContainer property. This must correspond to an IParticleContainer in the event store. (longer term : make it possible to pass PseudoJetContainer)

There are several technical difficulties

• the multiplicity of possible variables
• the dependency on the calibration state of the constituents
• the calculation time (looking up the full input container for each jet constituents can be *very* slow) These are solved at the cost of increased complexity (internal helper classes, usage of a special fast lookup map), details in the .cxx file.

WARNING : currently works well only for LCTopoJets, TrackJets, TruthJets AND small R jets (R ~<0.8)

WARNING: The constituents are pseudojets objtained from a pseudojet getter. This should be the same pseudojet getter used in the jet finding. The isolation tool must be run in the same job as the jet finding.

Isolation Criteria ("param" below is the main parameter) :

• IsoKR : iso area == cone of size __jetRadius*param__
• IsoDelta : iso area == cone of size __jetRadius+param__
• IsoFixedCone : iso are == cone of size __param__
• IsoFixedArea : iso are == cone of size __sqrt(jetRadius*jetRadius+param/M_PI)__
• Iso6To8 : iso area == annulus between R=0.6 and R=0.8

Isolation Variables (iso4vec = sum of 4-vec in isolation area, not part of jet)

• Perp : iso4Vec.Perp( jetDirection )
• Par : iso4Vec.Dot( jetDirection )
• SumPt : sum Pt of 4-vec contibuting to iso4Vec
• P : iso4Vec.Vect().Mag()

---

Member Function Documentation

StatusCode JetIsolationTool::initialize

(

void

)

[virtual]

Dummy implementation of the initialisation function

It's here to allow the dual-use tools to skip defining an initialisation function. Since many are doing so...

Reimplemented from asg::AsgTool.

int JetIsolationTool::modifyJet

(

xAOD::Jet &

jet

)

const [inline, virtual]

Method to modify a jet. Returns 0 for success.

Implements ISingleJetModifier.

---

The documentation for this class was generated from the following files:

• /cvmfs/atlas.cern.ch/repo/sw/ASG/AnalysisBase/2.4.31/JetMomentTools/JetMomentTools/JetIsolationTool.h
• /cvmfs/atlas.cern.ch/repo/sw/ASG/AnalysisBase/2.4.31/JetMomentTools/src/JetIsolationTool.cxx