cluster::ClusterMerger Class Reference

Class merging clusters: recomputes start and end position and hit list. More...

Inheritance diagram for cluster::ClusterMerger:

Public Types
using	HitPtr_t = art::Ptr< recob::Hit >
	type of pointer to hits More...
using	HitVector_t = std::vector< HitPtr_t >
	vector of pointers to hits More...
using	ID_t = recob::Cluster::ID_t
	Type of cluster ID. More...
using	ClusterEnds_t = recob::Cluster::ClusterEnds_t

Public Member Functions
	ClusterMerger ()=default
	ClusterMerger (recob::Cluster const &cluster)
bool	Add (recob::Cluster const &cluster)
	Merges a single cluster into this object. More...

Accessors
float	fEndWires [ClusterEnds_t::NEnds]
	Data referring to start and end of the cluster. More...
float	fSigmaEndWires [ClusterEnds_t::NEnds]
	Uncertainty on wire coordinate of the start and end of the cluster. More...
float	fEndTicks [ClusterEnds_t::NEnds]
	Tick coordinate of the start and end of the cluster. More...
float	fSigmaEndTicks [ClusterEnds_t::NEnds]
	Uncertainty on tick coordinate of the start and end of the cluster. More...
float	fEndCharges [ClusterEnds_t::NEnds]
	Charge on the start and end wire of the cluster. More...
float	fAngles [ClusterEnds_t::NEnds]
	Angle of the start and end of the cluster, defined in [-pi,pi]. More...
float	fOpeningAngles [ClusterEnds_t::NEnds]
	Opening angle of the cluster shape at the start and end of the cluster. More...
float	fWidth
	A measure of the cluster width, in homogenized units. More...
geo::View_t	fView
	View for this cluster. More...
geo::PlaneID	fPlaneID
	Location of the start of the cluster. More...
unsigned int	n_clusters = 0
	number of clusters added so far More...
float	StartWire () const
	Returns the wire coordinate of the start of the cluster. More...
float	StartTick () const
	Returns the tick coordinate of the start of the cluster. More...
float	SigmaStartWire () const
	Returns the uncertainty on wire coordinate of the start of the cluster. More...
float	SigmaStartTick () const
	Data referring to start and end of the cluster. More...
float	EndWire () const
	Returns the wire coordinate of the end of the cluster. More...
float	EndTick () const
	Returns the tick coordinate of the end of the cluster. More...
float	SigmaEndWire () const
	Returns the uncertainty on wire coordinate of the end of the cluster. More...
float	SigmaEndTick () const
	Returns the uncertainty on tick coordinate of the end of the cluster. More...
float	WireCoord (ClusterEnds_t side) const
	Returns the wire coordinate of one of the end sides of the cluster. More...
float	TickCoord (ClusterEnds_t side) const
	Returns the tick coordinate of one of the end sides of the cluster. More...
float	SigmaWireCoord (ClusterEnds_t side) const
	Returns the uncertainty on wire coordinate of one of the end sides of the cluster. More...
float	SigmaTickCoord (ClusterEnds_t side) const
	Returns the uncertainty on tick coordinate of one of the end sides of the cluster. More...
float	StartCharge () const
	Returns the charge on the first wire of the cluster. More...
float	StartAngle () const
	Returns the starting angle of the cluster. More...
float	StartOpeningAngle () const
	Returns the opening angle at the start of the cluster. More...
float	EndCharge () const
	Returns the charge on the last wire of the cluster. More...
float	EndAngle () const
	Returns the ending angle of the cluster. More...
float	EndOpeningAngle () const
	Returns the opening angle at the end of the cluster. More...
float	EdgeCharge (ClusterEnds_t side) const
	Returns the charge on the first or last wire of the cluster. More...
float	Angle (ClusterEnds_t side) const
	Returns the angle at either end of the cluster. More...
float	OpeningAngle (ClusterEnds_t side) const
	Returns the opening angle at either end of the cluster. More...
float	Width () const
	A measure of the cluster width, in homogenized units. More...
geo::View_t	View () const
	Returns the view for this cluster. More...
geo::PlaneID	Plane () const
	Returns the plane ID this cluster lies on. More...
bool	hasPlane () const
	Returns whether geometry plane is valid. More...
void	AdoptEnd (recob::Cluster const &cluster, ClusterEnds_t iEnd)
	Imports all the member of the corresponding end. More...
template<typename T >
static void	top (T &var, T value)
	Data referring to start and end of the cluster. More...
template<typename T >
static void	bot (T &var, T value)
	Data referring to start and end of the cluster. More...

Detailed Description

Class merging clusters: recomputes start and end position and hit list.

Definition at line 71 of file LineMerger_module.cc.

Member Typedef Documentation

using cluster::ClusterMerger::ClusterEnds_t = recob::Cluster::ClusterEnds_t

Definition at line 80 of file LineMerger_module.cc.

using cluster::ClusterMerger::HitPtr_t = art::Ptr<recob::Hit>

type of pointer to hits

Definition at line 76 of file LineMerger_module.cc.

using cluster::ClusterMerger::HitVector_t = std::vector<HitPtr_t>

vector of pointers to hits

Definition at line 77 of file LineMerger_module.cc.

using cluster::ClusterMerger::ID_t = recob::Cluster::ID_t

Type of cluster ID.

Definition at line 79 of file LineMerger_module.cc.

Constructor & Destructor Documentation

cluster::ClusterMerger::ClusterMerger ( )

default

cluster::ClusterMerger::ClusterMerger ( recob::Cluster const &  cluster )

inline

Definition at line 93 of file LineMerger_module.cc.

: ClusterMerger() { Add(cluster); }

Member Function Documentation

bool cluster::ClusterMerger::Add

(

recob::Cluster const &

cluster

)

Merges a single cluster into this object.

Parameters

cluster

the cluster to be merged

Returns

whether the addition was successful

The two ends of the cluster are merged into this one, that gets extended.

The new cluster must have the same view as the prevopus ones and must lay on the same plane. If the new cluster has invalid plane, the current one is kept; if the current plane is invalid, it is overwritten (that means that if both are invalid, the merged cluster will also have an invalid plane).

Note that this code is crap unless the cluster is track-like.

Definition at line 255 of file LineMerger_module.cc.

References recob::Cluster::EndWire(), recob::Cluster::hasPlane(), recob::Cluster::isValid(), recob::Cluster::Plane(), recob::Cluster::StartWire(), recob::Cluster::View(), and recob::Cluster::Width().

Referenced by cluster::ClusterAndHitMerger::Add().

  {
    if (!cluster.isValid()) return false;

    if (n_clusters == 0) { // special case: we are still empty
      AdoptEnd(cluster, ClusterEnds_t::clStart);
      AdoptEnd(cluster, ClusterEnds_t::clEnd);
      fWidth = cluster.Width();
      fView = cluster.View();
      fPlaneID = cluster.Plane();
      ++n_clusters;
      return true;
    } // if empty

    if (cluster.View() != View()) return false;

    if (cluster.hasPlane() && hasPlane() && (cluster.Plane() != Plane())) return false;

    // this code has been moved here from the old recon::Cluster::operator+
    // of recob::Cluster v13.
    if (cluster.StartWire() < StartWire()) { // adopt the new start
      AdoptEnd(cluster, ClusterEnds_t::clStart);
    }
    if (cluster.EndWire() < EndWire()) { // adopt the new end
      AdoptEnd(cluster, ClusterEnds_t::clEnd);
    }

    top(fWidth, cluster.Width()); // extend width

    if (!hasPlane()) fPlaneID = cluster.Plane();

    return true;
  } // ClusterMerger::Add(Cluster)

void cluster::ClusterMerger::AdoptEnd ( recob::Cluster const &  cluster, ClusterEnds_t  iEnd  )

protected

Imports all the member of the corresponding end.

Definition at line 243 of file LineMerger_module.cc.

References recob::Cluster::Angle(), recob::Cluster::EdgeCharge(), recob::Cluster::OpeningAngle(), recob::Cluster::SigmaTickCoord(), recob::Cluster::SigmaWireCoord(), recob::Cluster::TickCoord(), and recob::Cluster::WireCoord().

  {
    const ClusterEnds_t iDestEnd = iSrcEnd;
    fEndWires[iDestEnd] = cluster.WireCoord(iSrcEnd);
    fSigmaEndWires[iDestEnd] = cluster.SigmaWireCoord(iSrcEnd);
    fEndTicks[iDestEnd] = cluster.TickCoord(iSrcEnd);
    fSigmaEndTicks[iDestEnd] = cluster.SigmaTickCoord(iSrcEnd);
    fEndCharges[iDestEnd] = cluster.EdgeCharge(iSrcEnd);
    fAngles[iDestEnd] = cluster.Angle(iSrcEnd);
    fOpeningAngles[iDestEnd] = cluster.OpeningAngle(iSrcEnd);
  } // ClusterMerger::AdoptEnd()

float cluster::ClusterMerger::Angle ( ClusterEnds_t  side ) const

inline

Returns the angle at either end of the cluster.

Definition at line 178 of file LineMerger_module.cc.

{ return fAngles[side]; }

template<typename T >

static void cluster::ClusterMerger::bot ( T &  var, T  value  )

inlinestaticprotected

Data referring to start and end of the cluster.

Definition at line 237 of file LineMerger_module.cc.

References value.

    {
      if (value < var) var = value;
    }

float cluster::ClusterMerger::EdgeCharge ( ClusterEnds_t  side ) const

inline

Returns the charge on the first or last wire of the cluster.

Definition at line 174 of file LineMerger_module.cc.

{ return fEndCharges[side]; }

float cluster::ClusterMerger::EndAngle ( ) const

inline

Returns the ending angle of the cluster.

Definition at line 168 of file LineMerger_module.cc.

{ return fAngles[ClusterEnds_t::clEnd]; }

float cluster::ClusterMerger::EndCharge ( ) const

inline

Returns the charge on the last wire of the cluster.

Definition at line 165 of file LineMerger_module.cc.

{ return fEndCharges[ClusterEnds_t::clEnd]; }

float cluster::ClusterMerger::EndOpeningAngle ( ) const

inline

Returns the opening angle at the end of the cluster.

Definition at line 171 of file LineMerger_module.cc.

{ return fOpeningAngles[ClusterEnds_t::clEnd]; }

float cluster::ClusterMerger::EndTick ( ) const

inline

Returns the tick coordinate of the end of the cluster.

Definition at line 131 of file LineMerger_module.cc.

{ return fEndTicks[ClusterEnds_t::clEnd]; }

float cluster::ClusterMerger::EndWire ( ) const

inline

Returns the wire coordinate of the end of the cluster.

Definition at line 128 of file LineMerger_module.cc.

{ return fEndWires[ClusterEnds_t::clEnd]; }

bool cluster::ClusterMerger::hasPlane ( ) const

inline

Returns whether geometry plane is valid.

Definition at line 195 of file LineMerger_module.cc.

{ return Plane().isValid; }

float cluster::ClusterMerger::OpeningAngle ( ClusterEnds_t  side ) const

inline

Returns the opening angle at either end of the cluster.

Definition at line 182 of file LineMerger_module.cc.

{ return fOpeningAngles[side]; }

geo::PlaneID cluster::ClusterMerger::Plane ( ) const

inline

Returns the plane ID this cluster lies on.

Definition at line 192 of file LineMerger_module.cc.

{ return fPlaneID; }

float cluster::ClusterMerger::SigmaEndTick ( ) const

inline

Returns the uncertainty on tick coordinate of the end of the cluster.

Definition at line 137 of file LineMerger_module.cc.

{ return fSigmaEndTicks[ClusterEnds_t::clEnd]; }

float cluster::ClusterMerger::SigmaEndWire ( ) const

inline

Returns the uncertainty on wire coordinate of the end of the cluster.

Definition at line 134 of file LineMerger_module.cc.

{ return fSigmaEndWires[ClusterEnds_t::clEnd]; }

float cluster::ClusterMerger::SigmaStartTick ( ) const

inline

Data referring to start and end of the cluster.

Definition at line 125 of file LineMerger_module.cc.

{ return fSigmaEndTicks[ClusterEnds_t::clStart]; }

float cluster::ClusterMerger::SigmaStartWire ( ) const

inline

Returns the uncertainty on wire coordinate of the start of the cluster.

Definition at line 122 of file LineMerger_module.cc.

{ return fSigmaEndWires[ClusterEnds_t::clStart]; }

float cluster::ClusterMerger::SigmaTickCoord ( ClusterEnds_t  side ) const

inline

Returns the uncertainty on tick coordinate of one of the end sides of the cluster.

Definition at line 152 of file LineMerger_module.cc.

{ return fSigmaEndTicks[side]; }

float cluster::ClusterMerger::SigmaWireCoord ( ClusterEnds_t  side ) const

inline

Returns the uncertainty on wire coordinate of one of the end sides of the cluster.

Definition at line 148 of file LineMerger_module.cc.

{ return fSigmaEndWires[side]; }

float cluster::ClusterMerger::StartAngle ( ) const

inline

Returns the starting angle of the cluster.

Definition at line 159 of file LineMerger_module.cc.

{ return fAngles[ClusterEnds_t::clStart]; }

float cluster::ClusterMerger::StartCharge ( ) const

inline

Returns the charge on the first wire of the cluster.

Definition at line 156 of file LineMerger_module.cc.

{ return fEndCharges[ClusterEnds_t::clStart]; }

float cluster::ClusterMerger::StartOpeningAngle ( ) const

inline

Returns the opening angle at the start of the cluster.

Definition at line 162 of file LineMerger_module.cc.

{ return fOpeningAngles[ClusterEnds_t::clStart]; }

float cluster::ClusterMerger::StartTick ( ) const

inline

Returns the tick coordinate of the start of the cluster.

Definition at line 119 of file LineMerger_module.cc.

{ return fEndTicks[ClusterEnds_t::clStart]; }

float cluster::ClusterMerger::StartWire ( ) const

inline

Returns the wire coordinate of the start of the cluster.

Definition at line 116 of file LineMerger_module.cc.

{ return fEndWires[ClusterEnds_t::clStart]; }

float cluster::ClusterMerger::TickCoord ( ClusterEnds_t  side ) const

inline

Returns the tick coordinate of one of the end sides of the cluster.

Definition at line 144 of file LineMerger_module.cc.

{ return fEndTicks[side]; }

template<typename T >

static void cluster::ClusterMerger::top ( T &  var, T  value  )

inlinestaticprotected

Data referring to start and end of the cluster.

Definition at line 232 of file LineMerger_module.cc.

References value.

    {
      if (value > var) var = value;
    }

geo::View_t cluster::ClusterMerger::View ( ) const

inline

Returns the view for this cluster.

Definition at line 189 of file LineMerger_module.cc.

{ return fView; }

float cluster::ClusterMerger::Width ( ) const

inline

A measure of the cluster width, in homogenized units.

Definition at line 186 of file LineMerger_module.cc.

{ return fWidth; }

float cluster::ClusterMerger::WireCoord ( ClusterEnds_t  side ) const

inline

Returns the wire coordinate of one of the end sides of the cluster.

Definition at line 140 of file LineMerger_module.cc.

{ return fEndWires[side]; }

Member Data Documentation

float cluster::ClusterMerger::fAngles[ClusterEnds_t::NEnds]

protected

Angle of the start and end of the cluster, defined in [-pi,pi].

Definition at line 214 of file LineMerger_module.cc.

float cluster::ClusterMerger::fEndCharges[ClusterEnds_t::NEnds]

protected

Charge on the start and end wire of the cluster.

Definition at line 211 of file LineMerger_module.cc.

float cluster::ClusterMerger::fEndTicks[ClusterEnds_t::NEnds]

protected

Tick coordinate of the start and end of the cluster.

Definition at line 205 of file LineMerger_module.cc.

float cluster::ClusterMerger::fEndWires[ClusterEnds_t::NEnds]

protected

Data referring to start and end of the cluster.

Definition at line 199 of file LineMerger_module.cc.

float cluster::ClusterMerger::fOpeningAngles[ClusterEnds_t::NEnds]

protected

Opening angle of the cluster shape at the start and end of the cluster.

Definition at line 217 of file LineMerger_module.cc.

geo::PlaneID cluster::ClusterMerger::fPlaneID

protected

Location of the start of the cluster.

Definition at line 224 of file LineMerger_module.cc.

float cluster::ClusterMerger::fSigmaEndTicks[ClusterEnds_t::NEnds]

protected

Uncertainty on tick coordinate of the start and end of the cluster.

Definition at line 208 of file LineMerger_module.cc.

float cluster::ClusterMerger::fSigmaEndWires[ClusterEnds_t::NEnds]

protected

Uncertainty on wire coordinate of the start and end of the cluster.

Definition at line 202 of file LineMerger_module.cc.

geo::View_t cluster::ClusterMerger::fView

protected

View for this cluster.

Definition at line 222 of file LineMerger_module.cc.

float cluster::ClusterMerger::fWidth

protected

A measure of the cluster width, in homogenized units.

Definition at line 220 of file LineMerger_module.cc.

unsigned int cluster::ClusterMerger::n_clusters = 0

protected

number of clusters added so far

Definition at line 226 of file LineMerger_module.cc.

---

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

• larreco/v09_25_00/source/larreco/ClusterFinder/LineMerger_module.cc