Belle II Software  release-08-01-10
BKLMHit1d Class Reference

Store one reconstructed BKLM 1D hit as a ROOT object. More...

#include <BKLMHit1d.h>

Inheritance diagram for BKLMHit1d:
Collaboration diagram for BKLMHit1d:

Public Member Functions

 BKLMHit1d ()
 Empty constructor for ROOT IO (needed to make the class storable)
 
 BKLMHit1d (const std::vector< std::pair< const KLMDigit *, double >> &digitsWithTime)
 Constructor used in KLMReconstructor module. More...
 
 BKLMHit1d (const BKLMHit1d &)
 Copy constructor.
 
BKLMHit1doperator= (const BKLMHit1d &)
 Assignment operator.
 
 ~BKLMHit1d ()
 Destructor.
 
bool inRPC () const
 Determine whether this 1D hit is in RPC or scintillator. More...
 
int getSection () const
 Get section number. More...
 
int getSector () const
 Get sector number. More...
 
int getLayer () const
 Get layer number. More...
 
int getPlane () const
 Get plane number. More...
 
bool isPhiReadout () const
 Get readout coordinate. More...
 
int getStripMin () const
 Get lowest strip number of this 1D hit. More...
 
int getStripMax () const
 Get highest strip number of this 1D hit. More...
 
double getStripAve () const
 Get average strip number. More...
 
int getModuleID () const
 Get detector-module identifier. More...
 
float getTime () const
 Get reconstructed hit time. More...
 
void setTime (double time)
 Set reconstructed hit time. More...
 
float getEnergyDeposit () const
 Get energy deposition. More...
 
void addRelationTo (const RelationsInterface< BASE > *object, float weight=1.0, const std::string &namedRelation="") const
 Add a relation from this object to another object (with caching). More...
 
void addRelationTo (const TObject *object, float weight=1.0, const std::string &namedRelation="") const
 Add a relation from this object to another object (no caching, can be quite slow). More...
 
void copyRelations (const RelationsInterface< BASE > *sourceObj)
 Copies all relations of sourceObj (pointing from or to sourceObj) to this object (including weights). More...
 
template<class TO >
RelationVector< TO > getRelationsTo (const std::string &name="", const std::string &namedRelation="") const
 Get the relations that point from this object to another store array. More...
 
template<class FROM >
RelationVector< FROM > getRelationsFrom (const std::string &name="", const std::string &namedRelation="") const
 Get the relations that point from another store array to this object. More...
 
template<class T >
RelationVector< T > getRelationsWith (const std::string &name="", const std::string &namedRelation="") const
 Get the relations between this object and another store array. More...
 
template<class TO >
TO * getRelatedTo (const std::string &name="", const std::string &namedRelation="") const
 Get the object to which this object has a relation. More...
 
template<class FROM >
FROM * getRelatedFrom (const std::string &name="", const std::string &namedRelation="") const
 Get the object from which this object has a relation. More...
 
template<class T >
T * getRelated (const std::string &name="", const std::string &namedRelation="") const
 Get the object to or from which this object has a relation. More...
 
template<class TO >
std::pair< TO *, float > getRelatedToWithWeight (const std::string &name="", const std::string &namedRelation="") const
 Get first related object & weight of relation pointing to an array. More...
 
template<class FROM >
std::pair< FROM *, float > getRelatedFromWithWeight (const std::string &name="", const std::string &namedRelation="") const
 Get first related object & weight of relation pointing from an array. More...
 
template<class T >
std::pair< T *, float > getRelatedWithWeight (const std::string &name="", const std::string &namedRelation="") const
 Get first related object & weight of relation pointing from/to an array. More...
 
virtual std::string getName () const
 Return a short name that describes this object, e.g. More...
 
virtual std::string getInfoHTML () const
 Return a short summary of this object's contents in HTML format. More...
 
std::string getInfo () const
 Return a short summary of this object's contents in raw text format. More...
 
std::string getArrayName () const
 Get name of array this object is stored in, or "" if not found.
 
int getArrayIndex () const
 Returns this object's array index (in StoreArray), or -1 if not found.
 

Protected Member Functions

TClonesArray * getArrayPointer () const
 Returns the pointer to the raw DataStore array holding this object (protected since these arrays are easy to misuse).
 

Private Member Functions

 ClassDef (RelationsInterface, 0)
 defines interface for accessing relations of objects in StoreArray.
 

Private Attributes

int m_ModuleID
 detector-module identifier More...
 
float m_Time
 reconstructed hit time (ns)
 
float m_EnergyDeposit
 reconstructed pulse height (MeV)
 
DataStore::StoreEntrym_cacheDataStoreEntry
 Cache of the data store entry to which this object belongs.
 
int m_cacheArrayIndex
 Cache of the index in the TClonesArray to which this object belongs.
 

Detailed Description

Store one reconstructed BKLM 1D hit as a ROOT object.

Definition at line 30 of file BKLMHit1d.h.

Constructor & Destructor Documentation

◆ BKLMHit1d()

BKLMHit1d ( const std::vector< std::pair< const KLMDigit *, double >> &  digitsWithTime)
explicit

Constructor used in KLMReconstructor module.

Parameters
digitsWithTimevector of pair of contiguous KLMDigits with time; the value passed in the pair is used as digit time instead of the value returned by KLMDigit::getTime()

Definition at line 33 of file BKLMHit1d.cc.

33  :
35  m_ModuleID(0),
36  m_Time(0.0),
37  m_EnergyDeposit(0.0)
38 {
39  if (digitsWithTime.size() == 0) {
40  B2WARNING("Attempt to create a BKLMHit1d with no KLMDigits");
41  return;
42  }
43  int stripMin = INT_MAX;
44  int stripMax = INT_MIN;
45  const KLMDigit* bklmDigit = digitsWithTime.front().first;
46  if (bklmDigit->getSubdetector() != KLMElementNumbers::c_BKLM)
47  B2FATAL("Trying to construct a BKLMHit1d using KLMDigits from EKLM.");
53  for (const std::pair<const KLMDigit*, double>& digitWithTime : digitsWithTime) {
54  const KLMDigit* digit = digitWithTime.first;
55  double correctedTime = digitWithTime.second;
56  if (!(bklmDigit->getSection() == digit->getSection() &&
57  bklmDigit->getSector() == digit->getSector() &&
58  bklmDigit->getLayer() == digit->getLayer() &&
59  bklmDigit->getPlane() == digit->getPlane())) {
60  B2WARNING("Attempt to combine non-parallel or distinct-module KLMDigits");
61  continue;
62  }
63  m_Time += correctedTime;
65  int strip = digit->getStrip();
66  stripMin = std::min(stripMin, strip);
67  stripMax = std::max(stripMax, strip);
68  if (digit->isMultiStrip()) {
69  m_Time += correctedTime * (digit->getLastStrip() - strip);
70  stripMax = std::max(stripMax, digit->getLastStrip());
71  }
72  addRelationTo(digit);
73  }
74 
75  if (stripMax >= stripMin) {
76  m_Time /= ((stripMax - stripMin) + 1.0);
79  }
80 }
static void setStripInModule(int &module, int strip)
Set strip number in module identifier.
static void setLayerInModule(int &module, int layer)
Set layer number in module identifier.
static void setSectionInModule(int &module, int section)
Set section number in module identifier.
static void setSectorInModule(int &module, int sector)
Set sector number in module identifier.
static void setPlaneInModule(int &module, int plane)
Set plane number in module identifier.
float m_Time
reconstructed hit time (ns)
Definition: BKLMHit1d.h:152
float m_EnergyDeposit
reconstructed pulse height (MeV)
Definition: BKLMHit1d.h:155
int m_ModuleID
detector-module identifier
Definition: BKLMHit1d.h:149
static void setMaximalStrip(int &module, int strip)
Set maximal strip number.
Definition: BKLMStatus.h:49
KLM digit (class representing a digitized hit in RPCs or scintillators).
Definition: KLMDigit.h:29
int getSubdetector() const
Get subdetector number.
Definition: KLMDigit.h:72
int getLayer() const
Get layer number.
Definition: KLMDigit.h:126
int getSection() const
Get section number.
Definition: KLMDigit.h:90
int getPlane() const
Get plane number.
Definition: KLMDigit.h:144
int getStrip() const
Get strip number.
Definition: KLMDigit.h:162
bool isMultiStrip() const
Determine whether this digit is a multi-strip one or not.
Definition: KLMDigit.h:197
int getSector() const
Get sector number.
Definition: KLMDigit.h:108
int getLastStrip() const
Get last strip number (for multi-strip digits).
Definition: KLMDigit.h:180
float getEnergyDeposit() const
Get energy deposit.
Definition: KLMDigit.h:294
void addRelationTo(const RelationsInterface< BASE > *object, float weight=1.0, const std::string &namedRelation="") const
Add a relation from this object to another object (with caching).
RelationsInterface< TObject > RelationsObject
Provides interface for getting/adding relations to objects in StoreArrays.

Member Function Documentation

◆ addRelationTo() [1/2]

void addRelationTo ( const RelationsInterface< BASE > *  object,
float  weight = 1.0,
const std::string &  namedRelation = "" 
) const
inlineinherited

Add a relation from this object to another object (with caching).

Parameters
objectThe object to which the relation should point.
weightThe weight of the relation.
namedRelationAdditional name for the relation, or "" for the default naming

Definition at line 142 of file RelationsObject.h.

◆ addRelationTo() [2/2]

void addRelationTo ( const TObject *  object,
float  weight = 1.0,
const std::string &  namedRelation = "" 
) const
inlineinherited

Add a relation from this object to another object (no caching, can be quite slow).

Parameters
objectThe object to which the relation should point.
weightThe weight of the relation.
namedRelationAdditional name for the relation, or "" for the default naming

Definition at line 155 of file RelationsObject.h.

◆ copyRelations()

void copyRelations ( const RelationsInterface< BASE > *  sourceObj)
inlineinherited

Copies all relations of sourceObj (pointing from or to sourceObj) to this object (including weights).

Useful if you want to make a complete copy of a StoreArray object to make modifications to it, but retain all information on linked objects.

Note: this only works if sourceObj inherits from the same base (e.g. RelationsObject), and only for related objects that also inherit from the same base.

Definition at line 170 of file RelationsObject.h.

◆ getEnergyDeposit()

float getEnergyDeposit ( ) const
inline

Get energy deposition.

Returns
energy deposition (MeV)

Definition at line 140 of file BKLMHit1d.h.

141  {
142  return m_EnergyDeposit;
143  }

◆ getInfo()

std::string getInfo ( ) const
inlineinherited

Return a short summary of this object's contents in raw text format.

Returns the contents of getInfoHTML() while translating line-breaks etc.

Note
: You don't need to implement this function (it's not virtual), getInfoHTML() is enough.

Definition at line 370 of file RelationsObject.h.

◆ getInfoHTML()

virtual std::string getInfoHTML ( ) const
inlinevirtualinherited

Return a short summary of this object's contents in HTML format.

Reimplement this in your own class to provide useful output for display or debugging purposes. For example, you might do something like:

std::stringstream out;
out << "<b>PDG</b>: " << m_pdg << "<br>";
out << "<b>Covariance Matrix</b>: " << HTML::getString(getCovariance5()) << "<br>";
return out.str();
std::string getString(const TMatrixFBase &matrix, int precision=2, bool color=true)
get HTML table representing a matrix.
Definition: HTML.cc:24
See also
Particle::getInfoHTML() for a more complex example.
HTML for some utility functions.
Use getInfo() to get a raw text version of this output.

Reimplemented in RecoTrack, TRGSummary, TrackFitResult, Track, SoftwareTriggerResult, PIDLikelihood, MCParticle, Cluster, and Particle.

Definition at line 362 of file RelationsObject.h.

◆ getLayer()

int getLayer ( ) const
inline

Get layer number.

Returns
layer number (1..15) of this 1D hit

Definition at line 75 of file BKLMHit1d.h.

◆ getModuleID()

int getModuleID ( ) const
inline

Get detector-module identifier.

Returns
detector-module identifier
See also
BKLMStatus.h

Definition at line 119 of file BKLMHit1d.h.

◆ getName()

virtual std::string getName ( ) const
inlinevirtualinherited

Return a short name that describes this object, e.g.

pi+ for an MCParticle.

Reimplemented in SpacePoint, MCParticle, and Particle.

Definition at line 344 of file RelationsObject.h.

◆ getPlane()

int getPlane ( ) const
inline

Get plane number.

Returns
Plane number (0=z, 1=phi).

Definition at line 82 of file BKLMHit1d.h.

◆ getRelated()

T* getRelated ( const std::string &  name = "",
const std::string &  namedRelation = "" 
) const
inlineinherited

Get the object to or from which this object has a relation.

Template Parameters
TThe class of objects to or from which the relation points.
Parameters
nameThe name of the store array to or from which the relation points. If empty the default store array name for class T will be used. If the special name "ALL" is given all store arrays containing objects of type T are considered.
namedRelationAdditional name for the relation, or "" for the default naming
Returns
The first related object or a null pointer.

Definition at line 278 of file RelationsObject.h.

◆ getRelatedFrom()

FROM* getRelatedFrom ( const std::string &  name = "",
const std::string &  namedRelation = "" 
) const
inlineinherited

Get the object from which this object has a relation.

Template Parameters
FROMThe class of objects from which the relation points.
Parameters
nameThe name of the store array from which the relation points. If empty the default store array name for class FROM will be used. If the special name "ALL" is given all store arrays containing objects of type FROM are considered.
namedRelationAdditional name for the relation, or "" for the default naming
Returns
The first related object or a null pointer.

Definition at line 263 of file RelationsObject.h.

◆ getRelatedFromWithWeight()

std::pair<FROM*, float> getRelatedFromWithWeight ( const std::string &  name = "",
const std::string &  namedRelation = "" 
) const
inlineinherited

Get first related object & weight of relation pointing from an array.

Template Parameters
FROMThe class of objects from which the relation points.
Parameters
nameThe name of the store array from which the relation points. If empty the default store array name for class FROM will be used. If the special name "ALL" is given all store arrays containing objects of type FROM are considered.
namedRelationAdditional name for the relation, or "" for the default naming
Returns
Pair of first related object and the relation weight, or (NULL, 1.0) if none found.

Definition at line 314 of file RelationsObject.h.

◆ getRelatedTo()

TO* getRelatedTo ( const std::string &  name = "",
const std::string &  namedRelation = "" 
) const
inlineinherited

Get the object to which this object has a relation.

Template Parameters
TOThe class of objects to which the relation points.
Parameters
nameThe name of the store array to which the relation points. If empty the default store array name for class TO will be used. If the special name "ALL" is given all store arrays containing objects of type TO are considered.
namedRelationAdditional name for the relation, or "" for the default naming
Returns
The first related object or a null pointer.

Definition at line 248 of file RelationsObject.h.

◆ getRelatedToWithWeight()

std::pair<TO*, float> getRelatedToWithWeight ( const std::string &  name = "",
const std::string &  namedRelation = "" 
) const
inlineinherited

Get first related object & weight of relation pointing to an array.

Template Parameters
TOThe class of objects to which the relation points.
Parameters
nameThe name of the store array to which the relation points. If empty the default store array name for class TO will be used. If the special name "ALL" is given all store arrays containing objects of type TO are considered.
namedRelationAdditional name for the relation, or "" for the default naming
Returns
Pair of first related object and the relation weight, or (NULL, 1.0) if none found.

Definition at line 297 of file RelationsObject.h.

◆ getRelatedWithWeight()

std::pair<T*, float> getRelatedWithWeight ( const std::string &  name = "",
const std::string &  namedRelation = "" 
) const
inlineinherited

Get first related object & weight of relation pointing from/to an array.

Template Parameters
TThe class of objects to or from which the relation points.
Parameters
nameThe name of the store array to or from which the relation points. If empty the default store array name for class T will be used. If the special name "ALL" is given all store arrays containing objects of type T are considered.
namedRelationAdditional name for the relation, or "" for the default naming
Returns
Pair of first related object and the relation weight, or (NULL, 1.0) if none found.

Definition at line 331 of file RelationsObject.h.

◆ getRelationsFrom()

RelationVector<FROM> getRelationsFrom ( const std::string &  name = "",
const std::string &  namedRelation = "" 
) const
inlineinherited

Get the relations that point from another store array to this object.

Template Parameters
FROMThe class of objects from which the relations point.
Parameters
nameThe name of the store array from which the relations point. If empty the default store array name for class FROM will be used. If the special name "ALL" is given all store arrays containing objects of type FROM are considered.
namedRelationAdditional name for the relation, or "" for the default naming
Returns
A vector of relations.

Definition at line 212 of file RelationsObject.h.

◆ getRelationsTo()

RelationVector<TO> getRelationsTo ( const std::string &  name = "",
const std::string &  namedRelation = "" 
) const
inlineinherited

Get the relations that point from this object to another store array.

Template Parameters
TOThe class of objects to which the relations point.
Parameters
nameThe name of the store array to which the relations point. If empty the default store array name for class TO will be used. If the special name "ALL" is given all store arrays containing objects of type TO are considered.
namedRelationAdditional name for the relation, or "" for the default naming
Returns
A vector of relations.

Definition at line 197 of file RelationsObject.h.

◆ getRelationsWith()

RelationVector<T> getRelationsWith ( const std::string &  name = "",
const std::string &  namedRelation = "" 
) const
inlineinherited

Get the relations between this object and another store array.

Relations in both directions are returned.

Template Parameters
TThe class of objects to or from which the relations point.
Parameters
nameThe name of the store array to or from which the relations point. If empty the default store array name for class T will be used. If the special name "ALL" is given all store arrays containing objects of type T are considered.
namedRelationAdditional name for the relation, or "" for the default naming
Returns
A vector of relations.

Definition at line 230 of file RelationsObject.h.

◆ getSection()

int getSection ( ) const
inline

Get section number.

Returns
section number (1=forward or 0=backward) of this 1D hit

Definition at line 61 of file BKLMHit1d.h.

◆ getSector()

int getSector ( ) const
inline

Get sector number.

Returns
sector number (1..8) of this 1D hit

Definition at line 68 of file BKLMHit1d.h.

◆ getStripAve()

double getStripAve ( ) const
inline

Get average strip number.

Returns
average strip number of this 1D hit

Definition at line 111 of file BKLMHit1d.h.

◆ getStripMax()

int getStripMax ( ) const
inline

Get highest strip number of this 1D hit.

Returns
highest strip number of this 1D hit

Definition at line 104 of file BKLMHit1d.h.

◆ getStripMin()

int getStripMin ( ) const
inline

Get lowest strip number of this 1D hit.

Returns
lowest strip number of this 1D hit

Definition at line 97 of file BKLMHit1d.h.

◆ getTime()

float getTime ( ) const
inline

Get reconstructed hit time.

Returns
Reconstructed hit time (ns).

Definition at line 126 of file BKLMHit1d.h.

◆ inRPC()

bool inRPC ( ) const
inline

Determine whether this 1D hit is in RPC or scintillator.

Returns
whether this 1D hit is in RPC (true) or scintillator (false)

Definition at line 54 of file BKLMHit1d.h.

◆ isPhiReadout()

bool isPhiReadout ( ) const
inline

Get readout coordinate.

Returns
readout coordinate of this 1D hit

Definition at line 89 of file BKLMHit1d.h.

◆ setTime()

void setTime ( double  time)
inline

Set reconstructed hit time.

Parameters
[in]timeReconstructed hit time (ns).

Definition at line 133 of file BKLMHit1d.h.

Member Data Documentation

◆ m_ModuleID

int m_ModuleID
private

detector-module identifier

See also
BKLMStatus.h

Definition at line 149 of file BKLMHit1d.h.


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