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 102 of file Thrust.cc.

References Rivet::_calcT(), Thrust::_thrustAxes, Thrust::_thrusts, Rivet::cross(), Vector3::cross(), Rivet::dot(), Rivet::mod(), MSG_DEBUG, Vector3::unit(), Vector3::x(), and Vector3::z().

Referenced by Thrust::calc().

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

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(), DISFinalState::DISFinalState(), DISKinematics::DISKinematics(), DISLepton::DISLepton(), FinalState::FinalState(), 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_VH2BB::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_S9120041::init(), CMS_2011_S9088458::init(), CMS_2011_S9086218::init(), CMS_2011_S8978280::init(), CMS_2011_S8968497::init(), CMS_2011_S8957746::init(), CMS_2011_S8950903::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_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_S9225137::init(), ATLAS_2011_S9212183::init(), ATLAS_2011_S9131140::init(), ATLAS_2011_S9128077::init(), ATLAS_2011_S9126244::init(), ATLAS_2011_S9120807::init(), ATLAS_2011_S9108483::init(), ATLAS_2011_S9041966::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_I925932::init(), ATLAS_2011_I919017::init(), ATLAS_2011_CONF_2011_098::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_2011_S8945144::init(), ALICE_2011_S8909580::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(), NonHadronicFinalState::NonHadronicFinalState(), 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 DISFinalState::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 Projection::beamPairs(), InvMassFinalState::calc(), VetoedFinalState::project(), UnstableFinalState::project(), LossyFinalState< ConstRandomFilter >::project(), IsolationProjection< PROJ1, PROJ2, EST >::project(), InitialQuarks::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(), FastJets::compare(), DISLepton::compare(), DISKinematics::compare(), DISFinalState::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(), 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(), DISFinalState::DISFinalState(), DISKinematics::DISKinematics(), DISLepton::DISLepton(), FinalState::FinalState(), 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(), NonHadronicFinalState::NonHadronicFinalState(), 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: