Thrust Class Reference

Get the e+ e- thrust basis and the thrust, thrust major and thrust minor scalars. More...

#include <Thrust.hh>

Inheritance diagram for Thrust:
Inheritance graph
[legend]
Collaboration diagram for Thrust:
Collaboration graph
[legend]

List of all members.

Public Member Functions

 Thrust ()
 Constructor.
 Thrust (const FinalState &fsp)
virtual const Projection * clone () const
 Clone on the heap.
bool before (const Projection &p) const
virtual const std::set< PdgIdPair > beamPairs () const
virtual std::string name () const
 Get the name of the projection.
Projection & addPdgIdPair (PdgId beam1, PdgId beam2)
 Add a colliding beam pair.
Log & getLog () const
 Get a Log object based on the getName() property of the calling projection object.
void setName (const std::string &name)
 Used by derived classes to set their name.

double thrust () const
double thrustMajor () const
 The thrust major scalar, $ M $, (thrust along thrust major axis).
double thrustMinor () const
 The thrust minor scalar, $ m $, (thrust along thrust minor axis).
double oblateness () const
 The oblateness, $ O = M - m $ .

const Vector3 & thrustAxis () const
const Vector3 & thrustMajorAxis () const
 The thrust major axis (axis of max thrust perpendicular to thrust axis).
const Vector3 & thrustMinorAxis () const
 The thrust minor axis (axis perpendicular to thrust and thrust major).

const Vector3 & axis1 () const
 AxesDefinition axis accessors.
const Vector3 & axis2 () const
 The 2nd most significant ("major") axis.
const Vector3 & axis3 () const
 The least significant ("minor") axis.
Direct methods

Ways to do the calculation directly, without engaging the caching system

void calc (const FinalState &fs)
 Manually calculate the thrust, without engaging the caching system.
void calc (const vector< Particle > &fsparticles)
 Manually calculate the thrust, without engaging the caching system.
void calc (const vector< FourMomentum > &fsmomenta)
 Manually calculate the thrust, without engaging the caching system.
void calc (const vector< Vector3 > &threeMomenta)
 Manually calculate the thrust, without engaging the caching system.
Projection "getting" functions

std::set< ConstProjectionPtr > getProjections () const
 Get the contained projections, including recursion.
template<typename PROJ >
const PROJ & getProjection (const std::string &name) const
 Get the named projection, specifying return type via a template argument.
const Projection & getProjection (const std::string &name) const
Projection applying functions

template<typename PROJ >
const PROJ & applyProjection (const Event &evt, const PROJ &proj) const
 Apply the supplied projection on event.
template<typename PROJ >
const PROJ & applyProjection (const Event &evt, const Projection &proj) const
 Apply the supplied projection on event.
template<typename PROJ >
const PROJ & applyProjection (const Event &evt, const std::string &name) const
 Apply the named projection on event.

Protected Member Functions

void project (const Event &e)
 Perform the projection on the Event.
int compare (const Projection &p) const
 Compare projections.
Cmp< Projection > mkNamedPCmp (const Projection &otherparent, const std::string &pname) const
Cmp< Projection > mkPCmp (const Projection &otherparent, const std::string &pname) const
ProjectionHandler & getProjHandler () const
 Get a reference to the ProjectionHandler for this thread.
Projection registration functions

template<typename PROJ >
const PROJ & addProjection (const PROJ &proj, const std::string &name)
const Projection & _addProjection (const Projection &proj, const std::string &name)
 Untemplated function to do the work...

Protected Attributes

bool _allowProjReg
 Flag to forbid projection registration in analyses until the init phase.

Private Member Functions

void _calcThrust (const vector< Vector3 > &fsmomenta)
 Explicitly calculate the thrust values.

Private Attributes

vector< double > _thrusts
 The thrust scalars.
vector< Vector3 > _thrustAxes
 The thrust axes.

Friends

class Event
 Event is a friend.
class Cmp< Projection >
 The Cmp specialization for Projection is a friend.

Detailed Description

Get the e+ e- thrust basis and the thrust, thrust major and thrust minor scalars.

Author:
Andy Buckley

The scalar (maximum) thrust is defined as

\[ T = \mathrm{max}_{\vec{n}} \frac{\sum_i \left|\vec{p}_i \cdot \vec{n} \right|}{\sum_i |\vec{p}_i|} \]

, with the direction of the unit vector $ \vec{n} $ which maximises $ T $ being identified as the thrust axis. The unit vector which maximises the thrust scalar in the plane perpendicular to $ \vec{n} $ is the "thrust major" direction, and the vector perpendicular to both the thrust and thrust major directions is the thrust minor. Both the major and minor directions have associated thrust scalars.

Thrust calculations have particularly simple forms for less than 4 particles, and in those cases this projection is computationally minimal. For 4 or more particles, a more general calculation must be carried out, based on the Brandt/Dahmen method from Z. Phys. C1 (1978). While a polynomial improvement on the exponential scaling of the naive method, this algorithm scales asymptotically as $ \mathcal{O}\left( n^3 \right) $. Be aware that the thrust may easily be the most computationally demanding projection in Rivet for large events!

The Rivet implementation of thrust is based heavily on Stefan Gieseke's Herwig++ re-coding of the 'tasso' code from HERWIG.

NB. special case with >= 4 coplanar particles will still fail. NB. Thrust assumes all momenta are in the CoM system: no explicit boost is performed. This can be dealt with by appropriate choice of the supplied FinalState.

Definition at line 44 of file Thrust.hh.

Constructor & Destructor Documentation

Thrust (  )  [inline]

Constructor.

Definition at line 48 of file Thrust.hh.

Referenced by Thrust::clone().

00048 {}

Thrust ( const FinalState &  fsp  )  [inline]

Definition at line 50 of file Thrust.hh.

References ProjectionApplier::addProjection(), and Projection::setName().

00050                                   {
00051       setName("Thrust");
00052       addProjection(fsp, "FS");
00053     }

Member Function Documentation

const Projection & _addProjection ( const Projection &  proj,
const std::string &  name 
) [protected, inherited]

Untemplated function to do the work...

Definition at line 33 of file ProjectionApplier.cc.

References ProjectionApplier::_allowProjReg, ProjectionApplier::getProjHandler(), ProjectionApplier::name(), Projection::name(), and ProjectionHandler::registerProjection().

Referenced by ProjectionApplier::addProjection().

00034                                                                              {
00035     if (!_allowProjReg) {
00036       cerr << "Trying to register projection '"
00037            << proj.name() << "' before init phase in '" << this->name() << "'." << endl;
00038       exit(2);
00039     }
00040     const Projection& reg = getProjHandler().registerProjection(*this, proj, name);
00041     return reg;
00042   }

void _calcThrust ( const vector< Vector3 > &  fsmomenta  )  [private]

Explicitly calculate the thrust values.

Todo:
Improve this --- special directions bad... (a,b,c) _|_ 1/(a^2+b^2) (b,-a,0) etc., but which combination minimises error?

Definition at line 103 of file Thrust.cc.

References Rivet::_calcT(), Thrust::_thrustAxes, Thrust::_thrusts, Rivet::cross(), Vector3::cross(), Log::DEBUG, Rivet::dot(), Projection::getLog(), Rivet::mod(), Rivet::unit(), Vector3::unit(), Vector3::x(), and Vector3::z().

Referenced by Thrust::calc().

00103                                                            {
00104     // Make a vector of the three-momenta in the final state
00105     double momentumSum(0.0);
00106     foreach (const Vector3& p3, fsmomenta) {
00107       momentumSum += mod(p3);
00108     }
00109     getLog() << Log::DEBUG << "Number of particles = " << fsmomenta.size() << endl;
00110 
00111 
00112     // Clear the caches
00113     _thrusts.clear();
00114     _thrustAxes.clear();
00115 
00116 
00117     // If there are fewer than 2 visible particles, we can't do much
00118     if (fsmomenta.size() < 2) {
00119       for (int i = 0; i < 3; ++i) {
00120         _thrusts.push_back(-1);
00121         _thrustAxes.push_back(Vector3(0,0,0));
00122       }
00123       return;
00124     }
00125 
00126 
00127     // Handle special case of thrust = 1 if there are only 2 particles
00128     if (fsmomenta.size() == 2) {
00129       Vector3 axis(0,0,0);
00130       _thrusts.push_back(1.0);
00131       _thrusts.push_back(0.0);
00132       _thrusts.push_back(0.0);
00133       axis = fsmomenta[0].unit();
00134       if (axis.z() < 0) axis = -axis;
00135       _thrustAxes.push_back(axis);
00136       /// @todo Improve this --- special directions bad...
00137       /// (a,b,c) _|_ 1/(a^2+b^2) (b,-a,0) etc., but which combination minimises error?
00138       if (axis.z() < 0.75)
00139         _thrustAxes.push_back( (axis.cross(Vector3(0,0,1))).unit() );
00140       else
00141         _thrustAxes.push_back( (axis.cross(Vector3(0,1,0))).unit() );
00142       _thrustAxes.push_back( _thrustAxes[0].cross(_thrustAxes[1]) );
00143       return;
00144     }
00145 
00146 
00147 
00148     // Temporary variables for calcs
00149     Vector3 axis(0,0,0);
00150     double val = 0.;
00151 
00152     // Get thrust
00153     _calcT(fsmomenta, val, axis);
00154     getLog() << Log::DEBUG << "Mom sum = " << momentumSum << endl;
00155     _thrusts.push_back(val / momentumSum);
00156     // Make sure that thrust always points along the +ve z-axis.
00157     if (axis.z() < 0) axis = -axis;
00158     axis = axis.unit();
00159     getLog() << Log::DEBUG << "Axis = " << axis << endl;
00160     _thrustAxes.push_back(axis);
00161 
00162     // Get thrust major
00163     vector<Vector3> threeMomenta;
00164     foreach (const Vector3& v, fsmomenta) {
00165       // Get the part of each 3-momentum which is perpendicular to the thrust axis
00166       const Vector3 vpar = dot(v, axis.unit()) * axis.unit();
00167       threeMomenta.push_back(v - vpar);
00168     }
00169     _calcT(threeMomenta, val, axis);
00170     _thrusts.push_back(val / momentumSum);
00171     if (axis.x() < 0) axis = -axis;
00172     axis = axis.unit();
00173     _thrustAxes.push_back(axis);
00174 
00175     // Get thrust minor
00176     if (_thrustAxes[0].dot(_thrustAxes[1]) < 1e-10) {
00177       axis = _thrustAxes[0].cross(_thrustAxes[1]);
00178       _thrustAxes.push_back(axis);
00179       val = 0.0;
00180       foreach (const Vector3& v, fsmomenta) {
00181         val += fabs(dot(axis, v));
00182       }
00183       _thrusts.push_back(val / momentumSum);
00184     } else {
00185       _thrusts.push_back(-1.0);
00186       _thrustAxes.push_back(Vector3(0,0,0));
00187     }
00188 
00189   }

Projection& addPdgIdPair ( PdgId  beam1,
PdgId  beam2 
) [inline, inherited]

Add a colliding beam pair.

Definition at line 107 of file Projection.hh.

References Projection::_beamPairs.

Referenced by Projection::Projection().

00107                                                        {
00108       _beamPairs.insert(PdgIdPair(beam1, beam2));
00109       return *this;
00110     }

const PROJ& addProjection ( const PROJ &  proj,
const std::string &  name 
) [inline, protected, inherited]

Register a contained projection. The type of the argument is used to instantiate a new projection internally: this new object is applied to events rather than the argument object. Hence you are advised to only use locally-scoped Projection objects in your Projection and Analysis constructors, and to avoid polymorphism (e.g. handling ConcreteProjection via a pointer or reference to type Projection) since this will screw up the internal type management.

Definition at line 113 of file ProjectionApplier.hh.

References ProjectionApplier::_addProjection().

Referenced by ZFinder::_init(), WFinder::_init(), VetoedFinalState::addVetoOnThisFinalState(), BeamThrust::BeamThrust(), CDF_2009_S8057893::CDF_2009_S8057893::init(), CentralEtHCM::CentralEtHCM(), ChargedFinalState::ChargedFinalState(), ChargedLeptons::ChargedLeptons(), ClusteredPhotons::ClusteredPhotons(), DISKinematics::DISKinematics(), DISLepton::DISLepton(), FinalState::FinalState(), FinalStateHCM::FinalStateHCM(), FoxWolframMoments::FoxWolframMoments(), FParameter::FParameter(), HadronicFinalState::HadronicFinalState(), Hemispheres::Hemispheres(), IdentifiedFinalState::IdentifiedFinalState(), ZEUS_2001_S4815815::init(), UA5_1989_S1926373::init(), UA5_1988_S1867512::init(), UA5_1987_S1640666::init(), UA5_1986_S1583476::init(), UA5_1982_S875503::init(), UA1_1990_S2044935::init(), TASSO_1990_S2148048::init(), STAR_2009_UE_HELEN::init(), STAR_2008_S7993412::init(), STAR_2008_S7869363::init(), STAR_2006_S6870392::init(), STAR_2006_S6860818::init(), STAR_2006_S6500200::init(), SFM_1984_S1178091::init(), PDG_HADRON_MULTIPLICITIES_RATIOS::init(), PDG_HADRON_MULTIPLICITIES::init(), OPAL_2004_S6132243::init(), OPAL_2001_S4553896::init(), OPAL_1998_S3780481::init(), OPAL_1993_S2692198::init(), MC_ZZJETS::init(), MC_ZJETS::init(), MC_WWJETS::init(), MC_WPOL::init(), MC_WJETS::init(), MC_TTBAR::init(), MC_SUSY::init(), MC_PHOTONJETUE::init(), MC_PHOTONJETS::init(), MC_LEADINGJETS::init(), MC_JETS::init(), MC_HJETS::init(), MC_GENERIC::init(), MC_DIPHOTON::init(), MC_DIJET::init(), LHCB_2010_S8758301::init(), JADE_OPAL_2000_S4300807::init(), JADE_1998_S3612880::init(), H1_2000_S4129130::init(), H1_1995_S3167097::init(), H1_1994_S2919893::init(), ExampleAnalysis::init(), E735_1998_S3905616::init(), DELPHI_2003_WUD_03_11::init(), DELPHI_2002_069_CONF_603::init(), DELPHI_1996_S3430090::init(), DELPHI_1995_S3137023::init(), D0_2010_S8821313::init(), D0_2010_S8671338::init(), D0_2010_S8570965::init(), D0_2010_S8566488::init(), D0_2009_S8349509::init(), D0_2009_S8320160::init(), D0_2009_S8202443::init(), D0_2008_S7863608::init(), D0_2008_S7837160::init(), D0_2008_S7719523::init(), D0_2008_S7662670::init(), D0_2008_S7554427::init(), D0_2008_S6879055::init(), D0_2007_S7075677::init(), D0_2006_S6438750::init(), D0_2004_S5992206::init(), D0_2001_S4674421::init(), D0_2000_S4480767::init(), D0_1996_S3324664::init(), D0_1996_S3214044::init(), CMS_2011_S8978280::init(), CMS_2011_S8968497::init(), CMS_2011_S8957746::init(), CMS_2011_S8884919::init(), CMS_2010_S8656010::init(), CMS_2010_S8547297::init(), CDF_2010_S8591881_QCD::init(), CDF_2010_S8591881_DY::init(), CDF_2009_S8436959::init(), CDF_2009_S8383952::init(), CDF_2009_S8233977::init(), CDF_2009_NOTE_9936::init(), CDF_2008_S8095620::init(), CDF_2008_S8093652::init(), CDF_2008_S7828950::init(), CDF_2008_S7782535::init(), CDF_2008_S7541902::init(), CDF_2008_S7540469::init(), CDF_2008_NOTE_9351::init(), CDF_2008_LEADINGJETS::init(), CDF_2007_S7057202::init(), CDF_2006_S6653332::init(), CDF_2006_S6450792::init(), CDF_2005_S6217184::init(), CDF_2005_S6080774::init(), CDF_2004_S5839831::init(), CDF_2002_S4796047::init(), CDF_2001_S4751469::init(), CDF_2001_S4563131::init(), CDF_2001_S4517016::init(), CDF_2000_S4266730::init(), CDF_2000_S4155203::init(), CDF_1998_S3618439::init(), CDF_1997_S3541940::init(), CDF_1996_S3418421::init(), CDF_1996_S3349578::init(), CDF_1996_S3108457::init(), CDF_1994_S2952106::init(), CDF_1993_S2742446::init(), CDF_1990_S2089246::init(), CDF_1988_S1865951::init(), BELLE_2006_S6265367::init(), ATLAS_2011_S9120807::init(), ATLAS_2011_S9019561::init(), ATLAS_2011_S9002537::init(), ATLAS_2011_S8994773::init(), ATLAS_2011_S8983313::init(), ATLAS_2011_S8971293::init(), ATLAS_2011_S8924791::init(), ATLAS_2011_CONF_2011_090::init(), ATLAS_2010_S8919674::init(), ATLAS_2010_S8918562::init(), ATLAS_2010_S8914702::init(), ATLAS_2010_S8894728::init(), ATLAS_2010_S8817804::init(), ATLAS_2010_S8591806::init(), ATLAS_2010_CONF_2010_049::init(), ALICE_2010_S8706239::init(), ALICE_2010_S8625980::init(), ALICE_2010_S8624100::init(), ALEPH_2004_S5765862::init(), ALEPH_1996_S3486095::init(), ALEPH_1996_S3196992::init(), ALEPH_1991_S2435284::init(), IsolationProjection< PROJ1, PROJ2, EST >::IsolationProjection(), JetAlg::JetAlg(), JetShape::JetShape(), LeadingParticlesFinalState::LeadingParticlesFinalState(), LeptonClusters::LeptonClusters(), LossyFinalState< ConstRandomFilter >::LossyFinalState(), MergedFinalState::MergedFinalState(), MissingMomentum::MissingMomentum(), Multiplicity::Multiplicity(), NeutralFinalState::NeutralFinalState(), ParisiTensor::ParisiTensor(), Sphericity::Sphericity(), Spherocity::Spherocity(), SVertex::SVertex(), Thrust::Thrust(), TotalVisibleMomentum::TotalVisibleMomentum(), TriggerCDFRun0Run1::TriggerCDFRun0Run1(), TriggerCDFRun2::TriggerCDFRun2(), TriggerUA5::TriggerUA5(), VetoedFinalState::VetoedFinalState(), and VisibleFinalState::VisibleFinalState().

00113                                                                        {
00114       const Projection& reg = _addProjection(proj, name);
00115       const PROJ& rtn = dynamic_cast<const PROJ&>(reg);
00116       return rtn;
00117     }

const PROJ& applyProjection ( const Event &  evt,
const std::string &  name 
) const [inline, inherited]

Apply the named projection on event.

Definition at line 81 of file ProjectionApplier.hh.

References ProjectionApplier::_applyProjection().

00081                                                                                {
00082       return pcast<PROJ>(_applyProjection(evt, name));
00083     }

const PROJ& applyProjection ( const Event &  evt,
const Projection &  proj 
) const [inline, inherited]

Apply the supplied projection on event.

Definition at line 74 of file ProjectionApplier.hh.

References ProjectionApplier::_applyProjection().

00074                                                                                 {
00075       return pcast<PROJ>(_applyProjection(evt, proj));
00076     }

const PROJ& applyProjection ( const Event &  evt,
const PROJ &  proj 
) const [inline, inherited]

Apply the supplied projection on event.

Definition at line 67 of file ProjectionApplier.hh.

References ProjectionApplier::_applyProjection().

Referenced by HadronicFinalState::project(), and FinalStateHCM::project().

00067                                                                           {
00068       return pcast<PROJ>(_applyProjection(evt, proj));
00069     }

const Vector3& axis1 (  )  const [inline, virtual]

AxesDefinition axis accessors.

Implements AxesDefinition.

Definition at line 98 of file Thrust.hh.

References Thrust::thrustAxis().

00098 { return thrustAxis(); }

const Vector3& axis2 (  )  const [inline, virtual]

The 2nd most significant ("major") axis.

Implements AxesDefinition.

Definition at line 99 of file Thrust.hh.

References Thrust::thrustMajorAxis().

00099 { return thrustMajorAxis(); }

const Vector3& axis3 (  )  const [inline, virtual]

The least significant ("minor") axis.

Implements AxesDefinition.

Definition at line 100 of file Thrust.hh.

References Thrust::thrustMinorAxis().

00100 { return thrustMinorAxis(); }

const set< PdgIdPair > beamPairs (  )  const [virtual, inherited]

Return the BeamConstraints for this projection, not including recursion. Derived classes should ensure that all contained projections are registered in the _projections set for the beam constraint chaining to work.

Definition at line 39 of file Projection.cc.

References Projection::_beamPairs, Projection::beamPairs(), Projection::getLog(), ProjectionApplier::getProjections(), Rivet::intersection(), and Log::TRACE.

Referenced by Projection::beamPairs().

00039                                                    {
00040     set<PdgIdPair> ret = _beamPairs;
00041     set<ConstProjectionPtr> projs = getProjections();
00042     for (set<ConstProjectionPtr>::const_iterator ip = projs.begin(); ip != projs.end(); ++ip) {
00043       ConstProjectionPtr p = *ip;
00044       getLog() << Log::TRACE << "Proj addr = " << p << endl;
00045       if (p) ret = intersection(ret, p->beamPairs());
00046     }
00047     return ret;
00048   }

bool before ( const Projection &  p  )  const [inherited]

Determine whether this object should be ordered before the object p given as argument. If p is of a different class than this, the before() function of the corresponding type_info objects is used. Otherwise, if the objects are of the same class, the virtual compare(const Projection &) will be returned.

Definition at line 28 of file Projection.cc.

References Projection::compare().

Referenced by less< const Rivet::Projection * >::operator()().

00028                                                    {
00029     const std::type_info& thisid = typeid(*this);
00030     const std::type_info& otherid = typeid(p);
00031     if (thisid == otherid) {
00032       return compare(p) < 0;
00033     } else {
00034       return thisid.before(otherid);
00035     }
00036   }

void calc ( const vector< Vector3 > &  threeMomenta  ) 

Manually calculate the thrust, without engaging the caching system.

Definition at line 33 of file Thrust.cc.

References Thrust::_calcThrust().

00033                                                     {
00034     _calcThrust(fsmomenta);
00035   }

void calc ( const vector< FourMomentum > &  fsmomenta  ) 

Manually calculate the thrust, without engaging the caching system.

Definition at line 24 of file Thrust.cc.

References Thrust::_calcThrust(), and FourVector::vector3().

00024                                                          {
00025     vector<Vector3> threeMomenta;
00026     threeMomenta.reserve(fsmomenta.size());
00027     foreach (const FourMomentum& v, fsmomenta) {
00028       threeMomenta.push_back(v.vector3());
00029     }
00030     _calcThrust(threeMomenta);
00031   }

void calc ( const vector< Particle > &  fsparticles  ) 

Manually calculate the thrust, without engaging the caching system.

Definition at line 14 of file Thrust.cc.

References Thrust::_calcThrust(), Particle::momentum(), and FourVector::vector3().

00014                                                        {
00015     vector<Vector3> threeMomenta;
00016     threeMomenta.reserve(fsparticles.size());
00017     foreach (const Particle& p, fsparticles) {
00018       const Vector3 p3 = p.momentum().vector3();
00019       threeMomenta.push_back(p3);
00020     }
00021     _calcThrust(threeMomenta);
00022   }

void calc ( const FinalState &  fs  ) 

Manually calculate the thrust, without engaging the caching system.

Definition at line 10 of file Thrust.cc.

References FinalState::particles().

Referenced by CMS_2011_S8957746::analyze(), and Thrust::project().

00010                                         {
00011     calc(fs.particles());
00012   }

virtual const Projection* clone (  )  const [inline, virtual]

Clone on the heap.

Implements AxesDefinition.

Definition at line 56 of file Thrust.hh.

References Thrust::Thrust().

00056                                             {
00057       return new Thrust(*this);
00058     }

int compare ( const Projection &  p  )  const [inline, protected, virtual]

Compare projections.

Implements Projection.

Definition at line 70 of file Thrust.hh.

References Projection::mkNamedPCmp().

00070                                            {
00071       return mkNamedPCmp(p, "FS");
00072     }

Log& getLog (  )  const [inline, inherited]

Get a Log object based on the getName() property of the calling projection object.

Reimplemented from ProjectionApplier.

Definition at line 114 of file Projection.hh.

References Projection::name().

Referenced by FParameter::_calcFParameter(), Sphericity::_calcSphericity(), Thrust::_calcThrust(), Projection::beamPairs(), InvMassFinalState::calc(), FinalState::FinalState(), JetAlg::JetAlg(), ZFinder::project(), WFinder::project(), VetoedFinalState::project(), UnstableFinalState::project(), TriggerUA5::project(), TriggerCDFRun2::project(), TriggerCDFRun0Run1::project(), PVertex::project(), NeutralFinalState::project(), MergedFinalState::project(), LossyFinalState< ConstRandomFilter >::project(), LeadingParticlesFinalState::project(), IsolationProjection< PROJ1, PROJ2, EST >::project(), InitialQuarks::project(), Hemispheres::project(), HadronicFinalState::project(), FoxWolframMoments::project(), ClusteredPhotons::project(), ChargedFinalState::project(), and TotalVisibleMomentum::TotalVisibleMomentum().

00114                         {
00115       string logname = "Rivet.Projection." + name();
00116       return Log::getLog(logname);
00117     }

const Projection& getProjection ( const std::string &  name  )  const [inline, inherited]

Get the named projection (non-templated, so returns as a reference to a Projection base class).

Definition at line 57 of file ProjectionApplier.hh.

References ProjectionHandler::getProjection(), and ProjectionApplier::getProjHandler().

00057                                                                  {
00058       return getProjHandler().getProjection(*this, name);
00059     }

const PROJ& getProjection ( const std::string &  name  )  const [inline, inherited]

Get the named projection, specifying return type via a template argument.

Definition at line 49 of file ProjectionApplier.hh.

References ProjectionHandler::getProjection(), and ProjectionApplier::getProjHandler().

Referenced by ProjectionApplier::_applyProjection(), Rivet::pcmp(), and Hemispheres::project().

00049                                                            {
00050       const Projection& p = getProjHandler().getProjection(*this, name);
00051       return pcast<PROJ>(p);
00052     }

std::set<ConstProjectionPtr> getProjections (  )  const [inline, inherited]

Get the contained projections, including recursion.

Definition at line 42 of file ProjectionApplier.hh.

References ProjectionHandler::DEEP, ProjectionHandler::getChildProjections(), and ProjectionApplier::getProjHandler().

Referenced by Projection::beamPairs().

00042                                                       {
00043       return getProjHandler().getChildProjections(*this, ProjectionHandler::DEEP);
00044     }

ProjectionHandler& getProjHandler (  )  const [inline, protected, inherited]

Get a reference to the ProjectionHandler for this thread.

Definition at line 94 of file ProjectionApplier.hh.

References ProjectionApplier::_projhandler.

Referenced by ProjectionApplier::_addProjection(), ProjectionApplier::getProjection(), ProjectionApplier::getProjections(), and ProjectionApplier::~ProjectionApplier().

00094                                               {
00095       return _projhandler;
00096     }

Cmp< Projection > mkNamedPCmp ( const Projection &  otherparent,
const std::string &  pname 
) const [protected, inherited]

Shortcut to make a named Cmp<Projection> comparison with the *this object automatically passed as one of the parent projections.

Definition at line 51 of file Projection.cc.

References Rivet::pcmp().

Referenced by ZFinder::compare(), WFinder::compare(), VisibleFinalState::compare(), VetoedFinalState::compare(), TotalVisibleMomentum::compare(), Thrust::compare(), SVertex::compare(), Spherocity::compare(), Sphericity::compare(), ParisiTensor::compare(), NeutralFinalState::compare(), Multiplicity::compare(), MissingMomentum::compare(), MergedFinalState::compare(), LossyFinalState< ConstRandomFilter >::compare(), LeptonClusters::compare(), LeadingParticlesFinalState::compare(), JetShape::compare(), IsolationProjection< PROJ1, PROJ2, EST >::compare(), InvMassFinalState::compare(), IdentifiedFinalState::compare(), Hemispheres::compare(), FParameter::compare(), FoxWolframMoments::compare(), FinalStateHCM::compare(), FastJets::compare(), DISLepton::compare(), DISKinematics::compare(), ClusteredPhotons::compare(), ChargedLeptons::compare(), ChargedFinalState::compare(), CentralEtHCM::compare(), and BeamThrust::compare().

00052                                                                      {
00053     return pcmp(*this, otherparent, pname);
00054   }

Cmp< Projection > mkPCmp ( const Projection &  otherparent,
const std::string &  pname 
) const [protected, inherited]

Shortcut to make a named Cmp<Projection> comparison with the *this object automatically passed as one of the parent projections.

Definition at line 57 of file Projection.cc.

References Rivet::pcmp().

00058                                                                 {
00059     return pcmp(*this, otherparent, pname);
00060   }

virtual std::string name (  )  const [inline, virtual, inherited]

Get the name of the projection.

Implements ProjectionApplier.

Definition at line 101 of file Projection.hh.

References Projection::_name.

Referenced by ProjectionApplier::_addProjection(), ProjectionHandler::_checkDuplicate(), ProjectionHandler::_clone(), ProjectionHandler::_getEquiv(), VetoedFinalState::addVetoOnThisFinalState(), Projection::getLog(), ZFinder::project(), ClusteredPhotons::project(), and ProjectionHandler::registerProjection().

00101                                    {
00102       return _name;
00103     }

double oblateness (  )  const [inline]

The oblateness, $ O = M - m $ .

Definition at line 85 of file Thrust.hh.

References Thrust::_thrusts.

Referenced by OPAL_2004_S6132243::analyze(), DELPHI_1996_S3430090::analyze(), ALEPH_2004_S5765862::analyze(), and ALEPH_1996_S3486095::analyze().

00085 { return _thrusts[1] - _thrusts[2]; }

void project ( const Event &  e  )  [inline, protected, virtual]

Perform the projection on the Event.

Implements Projection.

Definition at line 63 of file Thrust.hh.

References Thrust::calc(), and Rivet::particles().

00063                                  {
00064       const vector<Particle> ps
00065         = applyProjection<FinalState>(e, "FS").particles();
00066       calc(ps);
00067     }

void setName ( const std::string &  name  )  [inline, inherited]

Used by derived classes to set their name.

Definition at line 120 of file Projection.hh.

References Projection::_name.

Referenced by ZFinder::_init(), WFinder::_init(), FastJets::_init1(), FastJets::_init2(), FastJets::_init3(), Beam::Beam(), BeamThrust::BeamThrust(), CentralEtHCM::CentralEtHCM(), ChargedFinalState::ChargedFinalState(), ChargedLeptons::ChargedLeptons(), ClusteredPhotons::ClusteredPhotons(), ConstLossyFinalState::ConstLossyFinalState(), DISKinematics::DISKinematics(), DISLepton::DISLepton(), FinalState::FinalState(), FinalStateHCM::FinalStateHCM(), FoxWolframMoments::FoxWolframMoments(), FParameter::FParameter(), HadronicFinalState::HadronicFinalState(), Hemispheres::Hemispheres(), IdentifiedFinalState::IdentifiedFinalState(), InitialQuarks::InitialQuarks(), IsolationProjection< PROJ1, PROJ2, EST >::IsolationProjection(), JetAlg::JetAlg(), JetShape::JetShape(), LeadingParticlesFinalState::LeadingParticlesFinalState(), LeptonClusters::LeptonClusters(), LossyFinalState< ConstRandomFilter >::LossyFinalState(), MergedFinalState::MergedFinalState(), MissingMomentum::MissingMomentum(), Multiplicity::Multiplicity(), NeutralFinalState::NeutralFinalState(), ParisiTensor::ParisiTensor(), PVertex::PVertex(), Sphericity::Sphericity(), Spherocity::Spherocity(), SVertex::SVertex(), Thrust::Thrust(), TotalVisibleMomentum::TotalVisibleMomentum(), TriggerCDFRun0Run1::TriggerCDFRun0Run1(), TriggerCDFRun2::TriggerCDFRun2(), TriggerUA5::TriggerUA5(), UnstableFinalState::UnstableFinalState(), VetoedFinalState::VetoedFinalState(), and VisibleFinalState::VisibleFinalState().

00120                                         {
00121       _name = name;
00122     }

double thrust (  )  const [inline]

Thrust scalar accessors The thrust scalar, $ T $, (maximum thrust).

Definition at line 79 of file Thrust.hh.

References Thrust::_thrusts.

Referenced by TASSO_1990_S2148048::analyze(), OPAL_2004_S6132243::analyze(), JADE_1998_S3612880::analyze(), ExampleAnalysis::analyze(), DELPHI_1996_S3430090::analyze(), CMS_2011_S8957746::analyze(), ALEPH_2004_S5765862::analyze(), and ALEPH_1996_S3486095::analyze().

00079 { return _thrusts[0]; }

const Vector3& thrustAxis (  )  const [inline]

Thrust axis accessors The thrust axis.

Definition at line 90 of file Thrust.hh.

References Thrust::_thrustAxes.

Referenced by JADE_1998_S3612880::analyze(), DELPHI_1996_S3430090::analyze(), ALEPH_2004_S5765862::analyze(), ALEPH_1996_S3486095::analyze(), ALEPH_1996_S3196992::analyze(), and Thrust::axis1().

00090 { return _thrustAxes[0]; }

double thrustMajor (  )  const [inline]

The thrust major scalar, $ M $, (thrust along thrust major axis).

Definition at line 81 of file Thrust.hh.

References Thrust::_thrusts.

Referenced by OPAL_2004_S6132243::analyze(), ExampleAnalysis::analyze(), DELPHI_1996_S3430090::analyze(), CMS_2011_S8957746::analyze(), and ALEPH_2004_S5765862::analyze().

00081 { return _thrusts[1]; }

const Vector3& thrustMajorAxis (  )  const [inline]

The thrust major axis (axis of max thrust perpendicular to thrust axis).

Definition at line 92 of file Thrust.hh.

References Thrust::_thrustAxes.

Referenced by DELPHI_1996_S3430090::analyze(), ALEPH_2004_S5765862::analyze(), and Thrust::axis2().

00092 { return _thrustAxes[1]; }

double thrustMinor (  )  const [inline]

The thrust minor scalar, $ m $, (thrust along thrust minor axis).

Definition at line 83 of file Thrust.hh.

References Thrust::_thrusts.

Referenced by OPAL_2004_S6132243::analyze(), DELPHI_1996_S3430090::analyze(), ALEPH_2004_S5765862::analyze(), and ALEPH_1996_S3486095::analyze().

00083 { return _thrusts[2]; }

const Vector3& thrustMinorAxis (  )  const [inline]

The thrust minor axis (axis perpendicular to thrust and thrust major).

Definition at line 94 of file Thrust.hh.

References Thrust::_thrustAxes.

Referenced by DELPHI_1996_S3430090::analyze(), ALEPH_2004_S5765862::analyze(), and Thrust::axis3().

00094 { return _thrustAxes[2]; }

Friends And Related Function Documentation

friend class Cmp< Projection > [friend, inherited]

The Cmp specialization for Projection is a friend.

Definition at line 36 of file Projection.hh.

friend class Event [friend, inherited]

Event is a friend.

Definition at line 33 of file Projection.hh.

Member Data Documentation

bool _allowProjReg [protected, inherited]

Flag to forbid projection registration in analyses until the init phase.

Definition at line 140 of file ProjectionApplier.hh.

Referenced by ProjectionApplier::_addProjection(), and Analysis::Analysis().

vector<Vector3> _thrustAxes [private]

The thrust axes.

Definition at line 131 of file Thrust.hh.

Referenced by Thrust::_calcThrust(), Thrust::thrustAxis(), Thrust::thrustMajorAxis(), and Thrust::thrustMinorAxis().

vector<double> _thrusts [private]

The thrust scalars.

Definition at line 128 of file Thrust.hh.

Referenced by Thrust::_calcThrust(), Thrust::oblateness(), Thrust::thrust(), Thrust::thrustMajor(), and Thrust::thrustMinor().

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