Class managing the creation of a new recob::Cluster object. More...

#include "ClusterCreator.h"

Public Member Functions
	ClusterCreator (ClusterParamsAlgBase &algo, float start_wire, float sigma_start_wire, float start_tick, float sigma_start_tick, float end_wire, float sigma_end_wire, float end_tick, float sigma_end_tick, recob::Cluster::ID_t ID, geo::View_t view, geo::PlaneID const &plane, recob::Cluster::SentryArgument_t sentry=recob::Cluster::Sentry)
	Constructor: computes some information from hit list. More...

recob::Cluster &&	move ()
	Prepares the constructed hit to be moved away. More...

recob::Cluster const &	copy () const
	Returns the constructed wire. More...

Protected Member Functions
recob::Cluster	CreateCluster (ClusterParamsAlgBase &algo, float start_wire, float sigma_start_wire, float start_tick, float sigma_start_tick, float end_wire, float sigma_end_wire, float end_tick, float sigma_end_tick, recob::Cluster::ID_t ID, geo::View_t view, geo::PlaneID const &plane, recob::Cluster::SentryArgument_t sentry=recob::Cluster::Sentry)
	Creates a cluster from direct information and a hit list. More...

Protected Attributes
recob::Cluster	cluster
	Local instance of the cluster being constructed. More...

Detailed Description

Class managing the creation of a new recob::Cluster object.

A Creator is a class that creates a temporary data product, and at the end it yields it to the caller for storage. This last step should be by move construction, although a copy method is also provided.

An example of creating a Cluster object:

Todo:: Add the example!

cluster::ClusterCreator cluster(...);
cluster.push_back(cluster.move()); // cluster content becomes invalid

This is a one-step creation object: the cluster is constructed at the same time the ClusterCreator is, and no facility is offered to modify the constructed cluster, or to create another one.

Definition at line 44 of file ClusterCreator.h.

Constructor & Destructor Documentation

cluster::ClusterCreator::ClusterCreator	(	ClusterParamsAlgBase &	algo,
		float	start_wire,
		float	sigma_start_wire,
		float	start_tick,
		float	sigma_start_tick,
		float	end_wire,
		float	sigma_end_wire,
		float	end_tick,
		float	sigma_end_tick,
		recob::Cluster::ID_t	ID,
		geo::View_t	view,
		geo::PlaneID const &	plane,
		recob::Cluster::SentryArgument_t	sentry = `recob::Cluster::Sentry`
	)

Constructor: computes some information from hit list.

Parameters

algo	a configured and initialized algorithm set
start_wire	wire coordinate of the start of the cluster
sigma_start_wire	uncertainty on start_wire
start_tick	tick coordinate of the start of the cluster
sigma_start_tick	uncertainty on start_tick
end_wire	wire coordinate of the end of the cluster
sigma_end_wire	uncertainty on end_wire
end_tick	tick coordinate of the end of the cluster
sigma_end_tick	uncertainty on end_tick
ID	cluster ID
view	view for this cluster
plane	location of the start of the cluster
sentry	a check-point variable, optional

The algorithm set algo will compute and return:

start_charge: charge on the start wire
start_angle: angle of the start of the cluster, in $[ -\pi, \pi ]$
start_opening: opening angle at the start of the cluster
sigma_end_tick: uncertainty on end_tick
end_charge: charge on the end wire
end_angle: angle of the end of the cluster, in $[ -\pi, \pi ]$
end_opening: opening angle at the end of the cluster
integral: total charge from fitted shape of hits
integral_stddev: standard deviation of hit charge from fitted shape
summedADC: total charge from signal ADC of hits
summedADC_stddev: standard deviation of signal ADC of hits
n_hits: number of hits in the cluster
multiple_hit_density: wires covered by cluster divided by number of hits
width: a measure of the cluster width

Definition at line 29 of file ClusterCreator.cxx.

      :
     cluster(CreateCluster(
       algo,
       start_wire,
       sigma_start_wire,
       start_tick,
       sigma_start_tick,
       end_wire,
       sigma_end_wire,
       end_tick,
       sigma_end_tick,
       ID,
       view,
       plane,
       sentry
       ))
   {} // ClusterCreator::ClusterCreator()

Member Function Documentation

recob::Cluster const& cluster::ClusterCreator::copy ( ) const

inline

Returns the constructed wire.

Returns: a constant reference to the constructed wire

Despite the name, no copy happens in this function. Copy takes place in the caller code as proper; for example:

// be cluster a ClusterCreator instance:
std::vector<recob::Cluster> Clusters;
cluster.copy();                        // nothing happens
Clusters.push_back(cluster.copy());    // here a copy happens
recob::Cluster single_cluster(cluster.copy()); // copied again

Definition at line 132 of file ClusterCreator.h.

References cluster.

132 { return cluster; }

cluster::ClusterCreator::cluster

recob::Cluster cluster

Local instance of the cluster being constructed.

Definition: ClusterCreator.h:137

recob::Cluster cluster::ClusterCreator::CreateCluster	(	ClusterParamsAlgBase &	algo,
		float	start_wire,
		float	sigma_start_wire,
		float	start_tick,
		float	sigma_start_tick,
		float	end_wire,
		float	sigma_end_wire,
		float	end_tick,
		float	sigma_end_tick,
		recob::Cluster::ID_t	ID,
		geo::View_t	view,
		geo::PlaneID const &	plane,
		recob::Cluster::SentryArgument_t	sentry = `recob::Cluster::Sentry`
	)

protected

Creates a cluster from direct information and a hit list.

Parameters

algo	a configured and initialized algorithm set
start_wire	wire coordinate of the start of the cluster
sigma_start_wire	uncertainty on start_wire
start_tick	tick coordinate of the start of the cluster
sigma_start_tick	uncertainty on start_tick
end_wire	wire coordinate of the end of the cluster
sigma_end_wire	uncertainty on end_wire
end_tick	tick coordinate of the end of the cluster
sigma_end_tick	uncertainty on end_tick
ID	cluster ID
view	view for this cluster
plane	location of the start of the cluster
sentry	a check-point variable, optional

The algorithm set algo will compute and return:

start_charge: charge on the start wire
start_angle: angle of the start of the cluster, in $[ -\pi, \pi ]$
start_opening: opening angle at the start of the cluster
sigma_end_tick: uncertainty on end_tick
end_charge: charge on the end wire
end_angle: angle of the end of the cluster, in $[ -\pi, \pi ]$
end_opening: opening angle at the end of the cluster
integral: total charge from fitted shape of hits
integral_stddev: standard deviation of hit charge from fitted shape
summedADC: total charge from signal ADC of hits
summedADC_stddev: standard deviation of signal ADC of hits
n_hits: number of hits in the cluster
multiple_hit_density: wires covered by cluster divided by number of hits
width: a measure of the cluster width

Definition at line 63 of file ClusterCreator.cxx.

     {
     return recob::Cluster(
       start_wire,
       sigma_start_wire,
       start_tick,
       sigma_start_tick,
       algo.StartCharge().value(),       // start_charge
       algo.StartAngle().value(),        // start_angle
       algo.StartOpeningAngle().value(), // start_opening
       end_wire,
       sigma_end_wire,
       end_tick,
       sigma_end_tick,
       algo.EndCharge().value(),         // end_charge
       algo.EndAngle().value(),          // end_angle
       algo.EndOpeningAngle().value(),   // end_opening
       algo.Integral().value(),          // integral
       algo.IntegralStdDev().value(),    // integral_stddev
       algo.SummedADC().value(),         // summedADC
       algo.SummedADCStdDev().value(),   // summedADC_stddev
       algo.NHits(),                     // n_hits
       algo.MultipleHitDensity(),           // multiple_hit_density
       algo.Width(),                     // width
       ID,
       view,
       plane,
       sentry
       );
   } // ClusterCreator::CreateCluster()

recob::Cluster&& cluster::ClusterCreator::move ( )

inline

Prepares the constructed hit to be moved away.

Returns: a right-value reference to the constructed hit

Despite the name, no move happens in this function. Move takes place in the caller code as proper; for example:

// be cluster a ClusterCreator instance:
std::vector<recob::Cluster> Clusters;
cluster.move();                        // nothing happens
Clusters.push_back(cluster.move());    // here the move happens
recob::Cluster single_cluster(cluster.move()); // wrong! cluster is empty now

Definition at line 115 of file ClusterCreator.h.

Referenced by lar_pandora::LArPandoraOutput::BuildCluster().

115 { return std::move(cluster); }

cluster

Cluster finding and building.

Definition: SmallClusterFilter_module.cc:36

Member Data Documentation

recob::Cluster cluster::ClusterCreator::cluster

protected

Local instance of the cluster being constructed.

Definition at line 137 of file ClusterCreator.h.

Referenced by copy().

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

/cvmfs/larsoft.opensciencegrid.org/products/larreco/v07_10_02/source/larreco/ClusterFinder/ClusterCreator.h
/cvmfs/larsoft.opensciencegrid.org/products/larreco/v07_10_02/source/larreco/ClusterFinder/ClusterCreator.cxx

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation