FastJet  3.1.3
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Modules Pages
Public Member Functions | Protected Attributes | List of all members
fastjet::WrappedStructure Class Reference

This wraps a (shared) pointer to an underlying structure. More...

#include <fastjet/WrappedStructure.hh>

Inheritance diagram for fastjet::WrappedStructure:
Inheritance graph
[legend]
Collaboration diagram for fastjet::WrappedStructure:
Collaboration graph
[legend]

Public Member Functions

 WrappedStructure (const SharedPtr< PseudoJetStructureBase > &to_be_shared)
 default ctor the argument is the structure we need to wrap
 
virtual ~WrappedStructure ()
 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 ClusterSequenceassociated_cluster_sequence () const
 get a (const) pointer to the parent ClusterSequence (NULL if inexistent)
 
virtual bool has_valid_cluster_sequence () const
 returns true if this PseudoJet has an associated and still valid ClusterSequence. More...
 
virtual const ClusterSequencevalidated_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
 
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. More...
 
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. More...
 
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. More...
 
virtual bool object_in_jet (const PseudoJet &reference, const PseudoJet &jet) const
 check if the reference PseudoJet is contained the second one passed as argument. More...
 
virtual bool has_constituents () const
 return true if the structure supports constituents. More...
 
virtual std::vector< PseudoJetconstituents (const PseudoJet &reference) const
 retrieve the constituents. More...
 
virtual bool has_exclusive_subjets () const
 return true if the structure supports exclusive_subjets.
 
virtual std::vector< PseudoJetexclusive_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. More...
 
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() More...
 
virtual std::vector< PseudoJetexclusive_subjets_up_to (const PseudoJet &reference, int nsub) const
 return the list of subjets obtained by unclustering the supplied jet down to n subjets (or all constituents if there are fewer than n). More...
 
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. More...
 
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. More...
 
virtual bool has_pieces (const PseudoJet &reference) const
 return true if the structure supports pieces. More...
 
virtual std::vector< PseudoJetpieces (const PseudoJet &reference) const
 retrieve the pieces building the jet. More...
 
virtual bool has_area () const
 check if it has a defined area More...
 
virtual double area (const PseudoJet &reference) const
 return the jet (scalar) area. More...
 
virtual double area_error (const PseudoJet &reference) const
 return the error (uncertainty) associated with the determination of the area of this jet. More...
 
virtual PseudoJet area_4vector (const PseudoJet &reference) const
 return the jet 4-vector area. More...
 
virtual bool is_pure_ghost (const PseudoJet &reference) const
 true if this jet is made exclusively of ghosts. More...
 
- Public Member Functions inherited from fastjet::PseudoJetStructureBase
 PseudoJetStructureBase ()
 default ctor
 
virtual ~PseudoJetStructureBase ()
 default (virtual) dtor
 

Protected Attributes

SharedPtr< PseudoJetStructureBase_structure
 the wrapped structure
 

Detailed Description

This wraps a (shared) pointer to an underlying structure.

The typical use-case is when a PseusoJet needs to share its structure with another PseudoJet but also include extra information in its structure. For the memory management to be handled properly, it should hold a shared pointer to the shared structure. This is what this class ensures. Deriving a structure from this class would then allow for the implementation of the extra features.

Definition at line 53 of file WrappedStructure.hh.

Member Function Documentation

virtual bool fastjet::WrappedStructure::has_valid_cluster_sequence ( ) const
inlinevirtual

returns true if this PseudoJet has an associated and still valid ClusterSequence.

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 90 of file WrappedStructure.hh.

virtual bool fastjet::WrappedStructure::has_partner ( const PseudoJet reference,
PseudoJet partner 
) const
inlinevirtual

check if it has been recombined with another PseudoJet in which case, return its partner through the argument.

Otherwise, 'partner' is set to 0.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 122 of file WrappedStructure.hh.

virtual bool fastjet::WrappedStructure::has_child ( const PseudoJet reference,
PseudoJet child 
) const
inlinevirtual

check if it has been recombined with another PseudoJet in which case, return its child through the argument.

Otherwise, 'child' is set to 0.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 131 of file WrappedStructure.hh.

virtual bool fastjet::WrappedStructure::has_parents ( const PseudoJet reference,
PseudoJet parent1,
PseudoJet parent2 
) const
inlinevirtual

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.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 140 of file WrappedStructure.hh.

virtual bool fastjet::WrappedStructure::object_in_jet ( const PseudoJet reference,
const PseudoJet jet 
) const
inlinevirtual

check if the reference PseudoJet is contained the second one passed as argument.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 148 of file WrappedStructure.hh.

virtual bool fastjet::WrappedStructure::has_constituents ( ) const
inlinevirtual

return true if the structure supports constituents.

false by default

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 156 of file WrappedStructure.hh.

virtual std::vector<PseudoJet> fastjet::WrappedStructure::constituents ( const PseudoJet reference) const
inlinevirtual

retrieve the constituents.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 163 of file WrappedStructure.hh.

virtual std::vector<PseudoJet> fastjet::WrappedStructure::exclusive_subjets ( const PseudoJet reference,
const double &  dcut 
) const
inlinevirtual

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.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 182 of file WrappedStructure.hh.

virtual int fastjet::WrappedStructure::n_exclusive_subjets ( const PseudoJet reference,
const double &  dcut 
) const
inlinevirtual

return the size of exclusive_subjets(...); still n ln n with same coefficient, but marginally more efficient than manually taking exclusive_subjets.size()

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 191 of file WrappedStructure.hh.

virtual std::vector<PseudoJet> fastjet::WrappedStructure::exclusive_subjets_up_to ( const PseudoJet reference,
int  nsub 
) const
inlinevirtual

return the list of subjets obtained by unclustering the supplied jet down to n subjets (or all constituents if there are fewer than n).

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 200 of file WrappedStructure.hh.

virtual double fastjet::WrappedStructure::exclusive_subdmerge ( const PseudoJet reference,
int  nsub 
) const
inlinevirtual

return the dij that was present in the merging nsub+1 -> nsub subjets inside this jet.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 208 of file WrappedStructure.hh.

virtual double fastjet::WrappedStructure::exclusive_subdmerge_max ( const PseudoJet reference,
int  nsub 
) const
inlinevirtual

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.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 217 of file WrappedStructure.hh.

virtual bool fastjet::WrappedStructure::has_pieces ( const PseudoJet reference) const
inlinevirtual

return true if the structure supports pieces.

false by default

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 228 of file WrappedStructure.hh.

virtual std::vector<PseudoJet> fastjet::WrappedStructure::pieces ( const PseudoJet reference) const
inlinevirtual

retrieve the pieces building the jet.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 235 of file WrappedStructure.hh.

virtual bool fastjet::WrappedStructure::has_area ( ) const
inlinevirtual

check if it has a defined area

false by default

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 246 of file WrappedStructure.hh.

virtual double fastjet::WrappedStructure::area ( const PseudoJet reference) const
inlinevirtual

return the jet (scalar) area.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 253 of file WrappedStructure.hh.

virtual double fastjet::WrappedStructure::area_error ( const PseudoJet reference) const
inlinevirtual

return the error (uncertainty) associated with the determination of the area of this jet.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 261 of file WrappedStructure.hh.

virtual PseudoJet fastjet::WrappedStructure::area_4vector ( const PseudoJet reference) const
inlinevirtual

return the jet 4-vector area.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 268 of file WrappedStructure.hh.

virtual bool fastjet::WrappedStructure::is_pure_ghost ( const PseudoJet reference) const
inlinevirtual

true if this jet is made exclusively of ghosts.

By default, throws an Error

Reimplemented from fastjet::PseudoJetStructureBase.

Definition at line 275 of file WrappedStructure.hh.


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