Algorithm class inheriting cluster parameters. More...

#include "LazyClusterParamsAlg.h"

Inheritance diagram for cluster::LazyClusterParamsAlg:

Public Types
using	Measure_t = ClusterParamsAlgBase::Measure_t

Public Member Functions
	LazyClusterParamsAlg (cluster_params const &new_params)
	Constructor: references to the parameters (no copy is performed!) More...

void	Clear () override
	Restores the class to post-configuration, pre-initialization state; dummy. More...

void	SetHitsFromPointers (util::GeometryUtilities const &, std::vector< recob::Hit const * > const &) override
	Sets the list of input hits. More...

size_t	NHits () override
	Returns the number of hits in the cluster. More...

float	MultipleHitDensity () override
	Fraction of wires in the cluster with more than one hit. More...

float	Width (util::GeometryUtilities const &) override
	Computes the width of the cluster. More...

cluster_params const &	GetParams () const
	Returns the original precomputed parameters. More...

virtual void	SetHits (util::GeometryUtilities const &gser, std::vector< recob::Hit > const &hits)
	Sets the list of input hits. More...

virtual void	SetVerbose (int level=1)
	Set the verbosity level. More...


Measure_t	StartCharge (util::GeometryUtilities const &gser) override
	Computes the charge on the first and last wire of the track. More...

Measure_t	EndCharge (util::GeometryUtilities const &gser) override
	Computes the charge on the first and last wire of the track. More...


Measure_t	StartAngle () override
	Computes the angle of the cluster. More...

Measure_t	EndAngle () override
	Computes the angle of the cluster. More...


Measure_t	StartOpeningAngle () override
	Computes the opening angle at the start or end of the cluster. More...

Measure_t	EndOpeningAngle () override
	Computes the opening angle at the start or end of the cluster. More...

Cluster charge
Measure_t	Integral () override
	Computes the total charge of the cluster from Hit::Integral() More...

Measure_t	IntegralStdDev () override
	Computes the standard deviation on the charge of the cluster hits. More...

Measure_t	SummedADC () override
	Computes the total charge of the cluster from Hit::SummedADC() More...

Measure_t	SummedADCStdDev () override
	Computes the standard deviation on the charge of the cluster hits. More...

Static Protected Member Functions
static std::logic_error	NotImplemented (std::string function_name)

Protected Attributes
cluster_params const &	params
	the parameters, already computed More...

int	verbose = 0
	verbosity level: 0 is normal, negative is even quieter More...

Detailed Description

Algorithm class inheriting cluster parameters.

See also: ClusterParamsAlg

This class wraps ClusterParamsAlg class, designed in the context of shower reconstruction, to expose a standard ClusterParamsBaseAlg interface. All the information is supposed to have been computed already.

In addition to the standard interface, GetParams() is also available.

Definition at line 38 of file LazyClusterParamsAlg.h.

Member Typedef Documentation

using cluster::LazyClusterParamsAlg::Measure_t = ClusterParamsAlgBase::Measure_t

Definition at line 40 of file LazyClusterParamsAlg.h.

Constructor & Destructor Documentation

cluster::LazyClusterParamsAlg::LazyClusterParamsAlg ( cluster_params const & new_params )

inline

Constructor: references to the parameters (no copy is performed!)

Definition at line 43 of file LazyClusterParamsAlg.h.

43 : params(new_params) {}

cluster::LazyClusterParamsAlg::params

cluster_params const & params

the parameters, already computed

Definition: LazyClusterParamsAlg.h:175

Member Function Documentation

void cluster::LazyClusterParamsAlg::Clear ( )

inlineoverridevirtual

Restores the class to post-configuration, pre-initialization state; dummy.

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 46 of file LazyClusterParamsAlg.h.

46 {}

cluster::LazyClusterParamsAlg::Measure_t cluster::LazyClusterParamsAlg::EndAngle ( )

overridevirtual

Computes the angle of the cluster.

Returns: angle of the cluster in the wire x time space, in radians

Uses the coordinates from the hits, weighted by charge (Hit::Integral()) to compute a slope in the homogenized wire x time space. The homogenized space has both wires and ticks converted into a distance (by using detector parameters: wire pitch and drift velocity).

The angle is in the $[ -\pi, \pi ]$ range, with 0 corresponding to a cluster parallel to the wire plane and $\pi$ to a cluster orthogonal to the wire plane, going farther from it.

Note: Both the methods return the same value.

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 42 of file LazyClusterParamsAlg.cxx.

References StartAngle().

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   return StartAngle();
 }

cluster::LazyClusterParamsAlg::Measure_t cluster::LazyClusterParamsAlg::EndCharge ( util::GeometryUtilities const & gser )

overridevirtual

Computes the charge on the first and last wire of the track.

Returns: the charge in ADC counts, with uncertainty

The implementation in ClusterParamsAlg provides an estimation of the charge collected in the first or last 1 cm of the cluster, using a linear fit on the deposited charge to reduce fluctuations.

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 29 of file LazyClusterParamsAlg.cxx.

References cluster::cluster_params::end_charge, and params.

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   return {(float)params.end_charge};
 }

cluster::LazyClusterParamsAlg::Measure_t cluster::LazyClusterParamsAlg::EndOpeningAngle ( )

overridevirtual

Computes the opening angle at the start or end of the cluster.

Returns: angle at the start of the cluster, in radians

This algorithm returns an opening angle after weighting the hits by their charge (as defined bu Hit::Integral());

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 54 of file LazyClusterParamsAlg.cxx.

References cluster::cluster_params::closing_angle_charge_wgt, and params.

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   return {(float)params.closing_angle_charge_wgt};
 }

cluster_params const& cluster::LazyClusterParamsAlg::GetParams ( ) const

inline

Returns the original precomputed parameters.

Definition at line 172 of file LazyClusterParamsAlg.h.

172 { return params; }

cluster::LazyClusterParamsAlg::params

cluster_params const & params

the parameters, already computed

Definition: LazyClusterParamsAlg.h:175

cluster::LazyClusterParamsAlg::Measure_t cluster::LazyClusterParamsAlg::Integral ( )

overridevirtual

Computes the total charge of the cluster from Hit::Integral()

Returns: total charge of the cluster, in ADC count units

See also: IntegralStdDev(), SummedADC()

ClusterParamsAlg computes the sum from all hits.

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 60 of file LazyClusterParamsAlg.cxx.

References params, and cluster::cluster_params::sum_charge.

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   return {(float)params.sum_charge};
 }

cluster::LazyClusterParamsAlg::Measure_t cluster::LazyClusterParamsAlg::IntegralStdDev ( )

overridevirtual

Computes the standard deviation on the charge of the cluster hits.

Returns: the standard deviation of charge of hits, in ADC count units

See also: Integral()

ClusterParamsAlg computes the standard deviation of the sample of charges from all hits. Hit charge is obtained by recob::Hit::Integral().

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 66 of file LazyClusterParamsAlg.cxx.

References params, and cluster::cluster_params::rms_charge.

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   return {(float)params.rms_charge};
 }

float cluster::LazyClusterParamsAlg::MultipleHitDensity ( )

overridevirtual

Fraction of wires in the cluster with more than one hit.

Returns: fraction of wires with more than one hit, or 0 if no wires

Returns a quantity defined as NMultiHitWires / NWires, where NWires is the number of wires hosting at least one hit of this cluster, and NMultiHitWires is the number of wires which have more than just one hit.

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 91 of file LazyClusterParamsAlg.cxx.

References cluster::cluster_params::multi_hit_wires, cluster::cluster_params::N_Wires, and params.

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   return params.N_Wires ? params.multi_hit_wires / params.N_Wires : 0.;
 }

size_t cluster::LazyClusterParamsAlg::NHits ( )

overridevirtual

Returns the number of hits in the cluster.

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 85 of file LazyClusterParamsAlg.cxx.

References cluster::cluster_params::N_Hits, and params.

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   return (size_t)params.N_Hits;
 }

static std::logic_error cluster::ClusterParamsAlgBase::NotImplemented ( std::string function_name )

inlinestaticprotectedinherited

Definition at line 242 of file ClusterParamsAlgBase.h.

     {
       return std::logic_error(function_name + "() not implemented.");
     }

virtual void cluster::ClusterParamsAlgBase::SetHits	(	util::GeometryUtilities const &	gser,
		std::vector< recob::Hit > const &	hits
	)

inlinevirtualinherited

Sets the list of input hits.

Parameters

hits	list of hits (hits will not be modified)

Exceptions

undefined in case of error, this method can throw (anything)

The same general directions apply as for SetHits() version with pointers. This version takes a list of recob::Hit, rather than their pointers. It can simplify upstream handling when the original list is not recob::Hit and creation of temporary recob::Hit is needed. In that case, managing to obtain pointers to these temporary objects can be inefficient.

The default implementation provided here is not efficient either, since it just creates an additional vector of recob::Hit pointers and uses it. If an implementation is concerned with efficiency, it can reimplement this to initialize the algorithm in a more direct way.

Reimplemented in cluster::OverriddenClusterParamsAlg< AlgoBase >, and cluster::StandardClusterParamsAlg.

Definition at line 138 of file ClusterParamsAlgBase.h.

Referenced by cluster::StandardClusterParamsAlg::SetHits().

     {
       std::vector<recob::Hit const*> hitptrs;
       hitptrs.reserve(hits.size());
       std::transform(hits.begin(),
                      hits.end(),
                      std::back_inserter(hitptrs),
                      [](recob::Hit const& hit) { return &hit; });
       SetHitsFromPointers(gser, hitptrs);
     }

void cluster::LazyClusterParamsAlg::SetHitsFromPointers	(	util::GeometryUtilities const &	,
		std::vector< recob::Hit const * > const &
	)

inlineoverridevirtual

Sets the list of input hits.

Parameters

hits	list of hits

Exceptions

undefined in case of error, this method can throw (anything)

The parameters have already been computed. This function is dummy.

Implements cluster::ClusterParamsAlgBase.

Definition at line 56 of file LazyClusterParamsAlg.h.

58 {}

virtual void cluster::ClusterParamsAlgBase::SetVerbose ( int level = 1 )

inlinevirtualinherited

Set the verbosity level.

Reimplemented in cluster::OverriddenClusterParamsAlg< AlgoBase >, and cluster::StandardClusterParamsAlg.

Definition at line 150 of file ClusterParamsAlgBase.h.

Referenced by cluster::StandardClusterParamsAlg::SetVerbose(), and cluster::OverriddenClusterParamsAlg< AlgoBase >::SetVerbose().

150 { verbose = level; }

cluster::ClusterParamsAlgBase::verbose

int verbose

verbosity level: 0 is normal, negative is even quieter

Definition: ClusterParamsAlgBase.h:240

cluster::LazyClusterParamsAlg::Measure_t cluster::LazyClusterParamsAlg::StartAngle ( )

overridevirtual

Computes the angle of the cluster.

Returns: angle of the cluster in the wire x time space, in radians

Uses the coordinates from the hits, weighted by charge (Hit::Integral()) to compute a slope in the homogenized wire x time space. The homogenized space has both wires and ticks converted into a distance (by using detector parameters: wire pitch and drift velocity).

The angle is in the $[ -\pi, \pi ]$ range, with 0 corresponding to a cluster parallel to the wire plane and $\pi$ to a cluster orthogonal to the wire plane, going farther from it.

Note: Both the methods return the same value.

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 36 of file LazyClusterParamsAlg.cxx.

References cluster::cluster_params::cluster_angle_2d, util::DegreesToRadians(), and params.

Referenced by cluster::ClusterMergeHelper::AppendResult(), and EndAngle().

 {
   return {(float)util::DegreesToRadians(params.cluster_angle_2d)};
 }

cluster::LazyClusterParamsAlg::Measure_t cluster::LazyClusterParamsAlg::StartCharge ( util::GeometryUtilities const & gser )

overridevirtual

Computes the charge on the first and last wire of the track.

Returns: the charge in ADC counts, with uncertainty

The implementation in ClusterParamsAlg provides an estimation of the charge collected in the first or last 1 cm of the cluster, using a linear fit on the deposited charge to reduce fluctuations.

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 22 of file LazyClusterParamsAlg.cxx.

References params, and cluster::cluster_params::start_charge.

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   return {(float)params.start_charge};
 }

cluster::LazyClusterParamsAlg::Measure_t cluster::LazyClusterParamsAlg::StartOpeningAngle ( )

overridevirtual

Computes the opening angle at the start or end of the cluster.

Returns: angle at the start of the cluster, in radians

This algorithm returns an opening angle after weighting the hits by their charge (as defined bu Hit::Integral());

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 48 of file LazyClusterParamsAlg.cxx.

References cluster::cluster_params::opening_angle_charge_wgt, and params.

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   return {(float)params.opening_angle_charge_wgt};
 }

cluster::LazyClusterParamsAlg::Measure_t cluster::LazyClusterParamsAlg::SummedADC ( )

overridevirtual

Computes the total charge of the cluster from Hit::SummedADC()

Returns: total charge of the cluster, in ADC count units

See also: SummedADCStdDev(), Integral()

ClusterParamsAlg computes the sum from all hits.

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 72 of file LazyClusterParamsAlg.cxx.

References params, and cluster::cluster_params::sum_ADC.

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   const double sumADC = params.sum_ADC;
   return {(float)sumADC, (float)std::sqrt(sumADC)};
 }

cluster::LazyClusterParamsAlg::Measure_t cluster::LazyClusterParamsAlg::SummedADCStdDev ( )

overridevirtual

Computes the standard deviation on the charge of the cluster hits.

Returns: the standard deviation of charge of hits, in ADC count units

See also: SummedADC()

ClusterParamsAlg computes the standard deviation of the sample of charges from all hits. Hit charge is obtained by recob::Hit::SummedADC().

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 79 of file LazyClusterParamsAlg.cxx.

References params, and cluster::cluster_params::rms_ADC.

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   return {(float)params.rms_ADC};
 }

float cluster::LazyClusterParamsAlg::Width ( util::GeometryUtilities const & )

overridevirtual

Computes the width of the cluster.

Returns: width of the cluster

Todo:: provide a description of the algorithm by words

Reimplemented from cluster::ClusterParamsAlgBase.

Definition at line 97 of file LazyClusterParamsAlg.cxx.

References params, and cluster::cluster_params::width.

Referenced by cluster::ClusterMergeHelper::AppendResult().

 {
   return params.width;
 }

Member Data Documentation

cluster_params const& cluster::LazyClusterParamsAlg::params

protected

the parameters, already computed

Definition at line 175 of file LazyClusterParamsAlg.h.

Referenced by EndCharge(), EndOpeningAngle(), Integral(), IntegralStdDev(), MultipleHitDensity(), NHits(), StartAngle(), StartCharge(), StartOpeningAngle(), SummedADC(), SummedADCStdDev(), and Width().

int cluster::ClusterParamsAlgBase::verbose = 0

protectedinherited

verbosity level: 0 is normal, negative is even quieter

Definition at line 240 of file ClusterParamsAlgBase.h.

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

larreco/v09_25_00/source/larreco/RecoAlg/ClusterRecoUtil/LazyClusterParamsAlg.h
larreco/v09_25_00/source/larreco/RecoAlg/ClusterRecoUtil/LazyClusterParamsAlg.cxx

Public Types

Public Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation