FastJet 3.0.2
|
Contains any information related to the clustering that should be directly accessible to PseudoJet. More...
#include <fastjet/ClusterSequenceStructure.hh>
Public Member Functions | |
ClusterSequenceStructure () | |
default ctor | |
ClusterSequenceStructure (const ClusterSequence *cs) | |
ctor with initialisation to a given ClusterSequence | |
virtual | ~ClusterSequenceStructure () |
default (virtual) dtor | |
virtual std::string | description () const |
description | |
Direct access to the associated ClusterSequence object. | |
Get access to the associated ClusterSequence (if any) | |
virtual bool | has_associated_cluster_sequence () const |
returns true if there is an associated ClusterSequence | |
virtual const ClusterSequence * | associated_cluster_sequence () const |
get a (const) pointer to the parent ClusterSequence (NULL if inexistent) | |
virtual bool | has_valid_cluster_sequence () const |
returns true if there is a valid associated ClusterSequence | |
virtual const ClusterSequence * | validated_cs () const |
if the jet has a valid associated cluster sequence then return a pointer to it; otherwise throw an error | |
virtual const ClusterSequenceAreaBase * | validated_csab () const |
if the jet has valid area information then return a pointer to the associated ClusterSequenceAreaBase object; otherwise throw an error | |
virtual void | set_associated_cs (const ClusterSequence *new_cs) |
set the associated csw | |
Methods for access to information about jet structure | |
These allow access to jet constituents, and other jet subtructure information. They only work if the jet is associated with a ClusterSequence. | |
virtual bool | has_partner (const PseudoJet &reference, PseudoJet &partner) const |
check if it has been recombined with another PseudoJet in which case, return its partner through the argument. | |
virtual bool | has_child (const PseudoJet &reference, PseudoJet &child) const |
check if it has been recombined with another PseudoJet in which case, return its child through the argument. | |
virtual bool | has_parents (const PseudoJet &reference, PseudoJet &parent1, PseudoJet &parent2) const |
check if it is the product of a recombination, in which case return the 2 parents through the 'parent1' and 'parent2' arguments. | |
virtual bool | object_in_jet (const PseudoJet &reference, const PseudoJet &jet) const |
check if the reference PseudoJet is contained in the second one passed as argument. | |
virtual bool | has_constituents () const |
return true if the structure supports constituents. | |
virtual std::vector< PseudoJet > | constituents (const PseudoJet &reference) const |
retrieve the constituents. | |
virtual bool | has_exclusive_subjets () const |
return true if the structure supports exclusive_subjets. | |
virtual std::vector< PseudoJet > | exclusive_subjets (const PseudoJet &reference, const double &dcut) const |
return a vector of all subjets of the current jet (in the sense of the exclusive algorithm) that would be obtained when running the algorithm with the given dcut. | |
virtual int | n_exclusive_subjets (const PseudoJet &reference, const double &dcut) const |
return the size of exclusive_subjets(...); still n ln n with same coefficient, but marginally more efficient than manually taking exclusive_subjets.size() | |
virtual std::vector< PseudoJet > | exclusive_subjets_up_to (const PseudoJet &reference, int nsub) const |
return the list of subjets obtained by unclustering the supplied jet down to nsub subjets (or all constituents if there are fewer than nsub). | |
virtual double | exclusive_subdmerge (const PseudoJet &reference, int nsub) const |
return the dij that was present in the merging nsub+1 -> nsub subjets inside this jet. | |
virtual double | exclusive_subdmerge_max (const PseudoJet &reference, int nsub) const |
return the maximum dij that occurred in the whole event at the stage that the nsub+1 -> nsub merge of subjets occurred inside this jet. | |
virtual bool | has_pieces (const PseudoJet &reference) const |
by convention, a jet associated with a ClusterSequence will have its parents as pieces | |
virtual std::vector< PseudoJet > | pieces (const PseudoJet &reference) const |
by convention, a jet associated with a ClusterSequence will have its parents as pieces | |
virtual bool | has_area () const |
check if it has a defined area | |
virtual double | area (const PseudoJet &reference) const |
return the jet (scalar) area. | |
virtual double | area_error (const PseudoJet &reference) const |
return the error (uncertainty) associated with the determination of the area of this jet. | |
virtual PseudoJet | area_4vector (const PseudoJet &reference) const |
return the jet 4-vector area. | |
virtual bool | is_pure_ghost (const PseudoJet &reference) const |
true if this jet is made exclusively of ghosts. | |
Protected Attributes | |
const ClusterSequence * | _associated_cs |
Contains any information related to the clustering that should be directly accessible to PseudoJet.
By default, this class implements basic access to the ClusterSequence related to a PseudoJet (like its constituents or its area). But it can be overloaded in order e.g. to give access to the jet substructure.
Definition at line 59 of file ClusterSequenceStructure.hh.
fastjet::ClusterSequenceStructure::ClusterSequenceStructure | ( | const ClusterSequence * | cs | ) | [inline] |
ctor with initialisation to a given ClusterSequence
In principle, this is reserved for initialisation by the parent ClusterSequence
Definition at line 68 of file ClusterSequenceStructure.hh.
bool fastjet::ClusterSequenceStructure::has_partner | ( | const PseudoJet & | reference, |
PseudoJet & | partner | ||
) | const [virtual] |
check if it has been recombined with another PseudoJet in which case, return its partner through the argument.
Otherwise, 'partner' is set to 0.
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 96 of file ClusterSequenceStructure.cc.
bool fastjet::ClusterSequenceStructure::has_child | ( | const PseudoJet & | reference, |
PseudoJet & | child | ||
) | const [virtual] |
check if it has been recombined with another PseudoJet in which case, return its child through the argument.
Otherwise, 'child' is set to 0.
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 106 of file ClusterSequenceStructure.cc.
bool fastjet::ClusterSequenceStructure::has_parents | ( | const PseudoJet & | reference, |
PseudoJet & | parent1, | ||
PseudoJet & | parent2 | ||
) | const [virtual] |
check if it is the product of a recombination, in which case return the 2 parents through the 'parent1' and 'parent2' arguments.
Otherwise, set these to 0.
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 116 of file ClusterSequenceStructure.cc.
bool fastjet::ClusterSequenceStructure::object_in_jet | ( | const PseudoJet & | reference, |
const PseudoJet & | jet | ||
) | const [virtual] |
check if the reference PseudoJet is contained in the second one passed as argument.
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
false is returned if the 2 PseudoJet do not belong the same ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 125 of file ClusterSequenceStructure.cc.
bool fastjet::ClusterSequenceStructure::has_constituents | ( | ) | const [virtual] |
return true if the structure supports constituents.
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 139 of file ClusterSequenceStructure.cc.
vector< PseudoJet > fastjet::ClusterSequenceStructure::constituents | ( | const PseudoJet & | reference | ) | const [virtual] |
retrieve the constituents.
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 149 of file ClusterSequenceStructure.cc.
bool fastjet::ClusterSequenceStructure::has_exclusive_subjets | ( | ) | const [virtual] |
return true if the structure supports exclusive_subjets.
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 157 of file ClusterSequenceStructure.cc.
std::vector< PseudoJet > fastjet::ClusterSequenceStructure::exclusive_subjets | ( | const PseudoJet & | reference, |
const double & | dcut | ||
) | const [virtual] |
return a vector of all subjets of the current jet (in the sense of the exclusive algorithm) that would be obtained when running the algorithm with the given dcut.
Time taken is O(m ln m), where m is the number of subjets that are found. If m gets to be of order of the total number of constituents in the jet, this could be substantially slower than just getting that list of constituents.
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 175 of file ClusterSequenceStructure.cc.
int fastjet::ClusterSequenceStructure::n_exclusive_subjets | ( | const PseudoJet & | reference, |
const double & | dcut | ||
) | const [virtual] |
return the size of exclusive_subjets(...); still n ln n with same coefficient, but marginally more efficient than manually taking exclusive_subjets.size()
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 185 of file ClusterSequenceStructure.cc.
std::vector< PseudoJet > fastjet::ClusterSequenceStructure::exclusive_subjets_up_to | ( | const PseudoJet & | reference, |
int | nsub | ||
) | const [virtual] |
return the list of subjets obtained by unclustering the supplied jet down to nsub subjets (or all constituents if there are fewer than nsub).
requires nsub ln nsub time
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 197 of file ClusterSequenceStructure.cc.
double fastjet::ClusterSequenceStructure::exclusive_subdmerge | ( | const PseudoJet & | reference, |
int | nsub | ||
) | const [virtual] |
return the dij that was present in the merging nsub+1 -> nsub subjets inside this jet.
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 206 of file ClusterSequenceStructure.cc.
double fastjet::ClusterSequenceStructure::exclusive_subdmerge_max | ( | const PseudoJet & | reference, |
int | nsub | ||
) | const [virtual] |
return the maximum dij that occurred in the whole event at the stage that the nsub+1 -> nsub merge of subjets occurred inside this jet.
an Error is thrown if this PseudoJet has no currently valid associated ClusterSequence
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 216 of file ClusterSequenceStructure.cc.
vector< PseudoJet > fastjet::ClusterSequenceStructure::pieces | ( | const PseudoJet & | reference | ) | const [virtual] |
by convention, a jet associated with a ClusterSequence will have its parents as pieces
if it has no parents, then there will only be a single piece: itself
Note that to answer that question, we need to access the cluster sequence. If the cluster sequence has gone out of scope, an error will be thrown
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 240 of file ClusterSequenceStructure.cc.
double fastjet::ClusterSequenceStructure::area | ( | const PseudoJet & | reference | ) | const [virtual] |
return the jet (scalar) area.
throws an Error if there is no support for area in the parent CS
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 274 of file ClusterSequenceStructure.cc.
double fastjet::ClusterSequenceStructure::area_error | ( | const PseudoJet & | reference | ) | const [virtual] |
return the error (uncertainty) associated with the determination of the area of this jet.
throws an Error if there is no support for area in the parent CS
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 281 of file ClusterSequenceStructure.cc.
PseudoJet fastjet::ClusterSequenceStructure::area_4vector | ( | const PseudoJet & | reference | ) | const [virtual] |
return the jet 4-vector area.
throws an Error if there is no support for area in the parent CS
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 287 of file ClusterSequenceStructure.cc.
bool fastjet::ClusterSequenceStructure::is_pure_ghost | ( | const PseudoJet & | reference | ) | const [virtual] |
true if this jet is made exclusively of ghosts.
throws an Error if there is no support for area in the parent CS
Reimplemented from fastjet::PseudoJetStructureBase.
Definition at line 293 of file ClusterSequenceStructure.cc.