cmtool::CBAlgoCenterOfMassSmall Class Reference

#include "CBAlgoCenterOfMassSmall.h"

Inheritance diagram for cmtool::CBAlgoCenterOfMassSmall:

Public Member Functions
	CBAlgoCenterOfMassSmall ()
	Default constructor. More...
virtual	~CBAlgoCenterOfMassSmall ()
	Default destructor. More...
virtual bool	Bool (const ::cluster::ClusterParamsAlg &cluster1, const ::cluster::ClusterParamsAlg &cluster2)
virtual void	Reset ()
	Function to reset the algorithm instance ... maybe implemented via child class. More...
virtual void	Report ()
	Function to report what's going on per merging iteration. More...
void	SetDebug (bool on)
	Function to set Debug mode of output. More...
void	SetMaxHitsSmallClus (size_t n)
	Function to set Max hits for small clsuters. More...
void	SetMaxDistance (double d)
	Function to set Max Distance for COM to be from start-end. More...
void	SetMaxCOMDistance (double d)
	Function to set Max Distance between COMs. More...
void	UseCOMInPoly (bool on)
	Use COM in Poly algo to decide merging. More...
void	UseCOMClose (bool on)
	Use COM in Poly algo to decide merging. More...
void	UseCOMNearClus (bool on)
	Use COM in Poly algo to decide merging. More...
void	SetLengthReach (double frac)
	Set Length Reach: How for out the cone extends as percent of cluster length. More...
double	ShortestDistanceSquared (double point_x, double point_y, double start_x, double start_y, double end_x, double end_y) const
virtual void	EventBegin (const std::vector< cluster::ClusterParamsAlg > &)
virtual void	EventEnd ()
virtual void	IterationBegin (const std::vector< cluster::ClusterParamsAlg > &)
virtual void	IterationEnd ()
void	SetAnaFile (TFile *fout)
	Setter function for an output plot TFile pointer. More...
virtual void	SetVerbose (bool doit=true)
	Setter function for verbosity. More...

Protected Attributes
bool	_debug
size_t	_maxHits
double	_MaxDist
double	_MaxCOMDistSquared
double	_lengthReach
bool	_COMinPolyAlg
	How four out - as percent of cluster length - cone will extend from start point. More...
bool	_COMsClose
bool	_COMNearClus
TFile *	_fout
	TFile pointer to an output file. More...
bool	_verbose
	Boolean to choose verbose mode. Turned on if CMergeManager/CMatchManager's verbosity level is >= kPerMerging. More...

Detailed Description

Designed mainly for small clusters (< 10 hits): Find Cluster's center of mass weighing by Q Then see if COM is in polygon/cone of a big cluster If so -> merge

Definition at line 28 of file CBAlgoCenterOfMassSmall.h.

Constructor & Destructor Documentation

cmtool::CBAlgoCenterOfMassSmall::CBAlgoCenterOfMassSmall

(

)

Default constructor.

Definition at line 8 of file CBAlgoCenterOfMassSmall.cxx.

References SetDebug(), SetMaxCOMDistance(), SetMaxDistance(), SetMaxHitsSmallClus(), UseCOMClose(), UseCOMInPoly(), and UseCOMNearClus().

                                                   : CBoolAlgoBase()
  //----------------------------------------
  {

    SetDebug(false);
    SetMaxHitsSmallClus(30);
    SetMaxDistance(20.);
    SetMaxCOMDistance(25.);
    UseCOMInPoly(true);
    UseCOMClose(true);
    UseCOMNearClus(true);
  }

virtual cmtool::CBAlgoCenterOfMassSmall::~CBAlgoCenterOfMassSmall ( )

inlinevirtual

Default destructor.

Definition at line 35 of file CBAlgoCenterOfMassSmall.h.

References Bool().

{};

Member Function Documentation

bool cmtool::CBAlgoCenterOfMassSmall::Bool ( const ::cluster::ClusterParamsAlg &  cluster1, const ::cluster::ClusterParamsAlg &  cluster2  )

virtual

Core function: given the ClusterParamsAlg input, return whether a cluster should be merged or not.

Reimplemented from cmtool::CBoolAlgoBase.

Definition at line 22 of file CBAlgoCenterOfMassSmall.cxx.

References _COMinPolyAlg, _COMNearClus, _COMsClose, _debug, _MaxCOMDistSquared, _MaxDist, _maxHits, cmtool::CMAlgoBase::_verbose, Polygon2D::PointInside(), and ShortestDistanceSquared().

Referenced by ~CBAlgoCenterOfMassSmall().

  {

    int Nhits1 = 0;
    int Nhits2 = 0;

    //Both clusters should have less hits than some threshold
    if ((cluster1.GetHitVector().size() > _maxHits) or (cluster2.GetHitVector().size() > _maxHits))
      return false;

    //Define COM values on w & t
    double COM_t_1 = 0;
    double COM_w_1 = 0;
    double Q_1 = 0;
    double start_w_1;
    double start_t_1;
    double end_w_1;
    double end_t_1;
    Polygon2D poly1;
    double COM_t_2 = 0;
    double COM_w_2 = 0;
    double Q_2 = 0;
    double start_w_2;
    double start_t_2;
    double end_w_2;
    double end_t_2;
    Polygon2D poly2;

    //Get Hit vector for cluster 1
    //std::vector<util::PxHit> hits1;
    std::vector<util::PxHit> hits1;
    hits1 = cluster1.GetHitVector();
    Nhits1 = hits1.size();
    poly1 = cluster1.GetParams().PolyObject;
    start_w_1 = cluster1.GetParams().start_point.w;
    start_t_1 = cluster1.GetParams().start_point.t;
    end_w_1 = cluster1.GetParams().end_point.w;
    end_t_1 = cluster1.GetParams().end_point.t;
    //Get Hit vector for cluster 2
    //std::vector<util::PxHit> hits2;
    std::vector<util::PxHit> hits2;
    hits2 = cluster2.GetHitVector();
    Nhits2 = hits2.size();
    poly2 = cluster2.GetParams().PolyObject;
    start_w_2 = cluster2.GetParams().start_point.w;
    start_t_2 = cluster2.GetParams().start_point.t;
    end_w_2 = cluster2.GetParams().end_point.w;
    end_t_2 = cluster2.GetParams().end_point.t;

    //Find COM for cluster 1
    for (auto& hit : hits1) {
      COM_t_1 += hit.t * hit.charge;
      COM_w_1 += hit.w * hit.charge;
      Q_1 += hit.charge;
    }
    COM_t_1 /= Q_1;
    COM_w_1 /= Q_1;

    //Find COM for cluster 2
    for (auto& hit : hits2) {
      COM_t_2 += hit.t * hit.charge;
      COM_w_2 += hit.w * hit.charge;
      Q_2 += hit.charge;
    }
    COM_t_2 /= Q_2;
    COM_w_2 /= Q_2;

    if (_debug) {
      std::cout << "Cluster 1: " << std::endl;
      std::cout << "N Hits: " << Nhits1 << std::endl;
      std::cout << "COM: (w,t) -> (" << COM_w_1 << ", " << COM_t_1 << ")" << std::endl;
      std::cout << "Cluster 2: " << std::endl;
      std::cout << "N Hits: " << Nhits2 << std::endl;
      std::cout << "COM: (w,t) -> (" << COM_w_2 << ", " << COM_t_2 << ")" << std::endl;
      std::cout << std::endl;
    }

    //Get COM
    std::pair<float, float> COM_1;
    COM_1 = std::make_pair(COM_w_1, COM_t_1);
    std::pair<float, float> COM_2;
    COM_2 = std::make_pair(COM_w_2, COM_t_2);

    //look for polygon overlap
    if (((poly2.PointInside(COM_1)) and _COMinPolyAlg) or
        ((poly1.PointInside(COM_2)) and _COMinPolyAlg)) {
      if (_verbose) { std::cout << "Polygon Overlap -> Merge!" << std::endl << std::endl; }
      return true;
    }

    //look for COM of 1 close to COM of 2
    double distCOMs =
      (COM_w_1 - COM_w_2) * (COM_w_1 - COM_w_2) + (COM_t_1 - COM_t_2) * (COM_t_1 - COM_t_2);
    if (_COMsClose and (distCOMs < _MaxCOMDistSquared)) {
      if (_verbose) { std::cout << "COMs close to each other -> Merge!" << std::endl << std::endl; }
      return true;
    }

    //look for COM close to start-end of other cluster
    if (_COMNearClus and
        ((ShortestDistanceSquared(COM_w_1, COM_t_1, start_w_2, start_t_2, end_w_2, end_t_2) <
          _MaxDist) or
         (ShortestDistanceSquared(COM_w_2, COM_t_2, start_w_1, start_t_1, end_w_1, end_t_1) <
          _MaxDist))) {
      if (_verbose) { std::cout << "COM close to start-end -> Merge!" << std::endl; }
      return true;
    }

    return false;
  }

virtual void cmtool::CMAlgoBase::EventBegin ( const std::vector< cluster::ClusterParamsAlg > &  )

inlinevirtualinherited

Optional function: called at the beginning of 1st iteration. This is called per event.

Reimplemented in cmtool::CPAlgoArray, cmtool::CBAlgoArray, and cmtool::CBAlgoPolyShortestDist.

Definition at line 45 of file CMAlgoBase.h.

Referenced by cmtool::CMergeManager::EventBegin().

{}

virtual void cmtool::CMAlgoBase::EventEnd ( )

inlinevirtualinherited

Optional function: called at the end of event ... after the last merging iteration is over.

Reimplemented in cmtool::CPAlgoArray, and cmtool::CBAlgoArray.

Definition at line 50 of file CMAlgoBase.h.

Referenced by cmtool::CMatchManager::EventEnd(), and cmtool::CMergeManager::EventEnd().

{}

virtual void cmtool::CMAlgoBase::IterationBegin ( const std::vector< cluster::ClusterParamsAlg > &  )

inlinevirtualinherited

Optional function: called at the beggining of each iteration over all pairs of clusters. This provides all clusters' information in case the algorithm need them. Note this is called per iteration which may be more than once per event.

Reimplemented in cmtool::CPAlgoArray, and cmtool::CBAlgoArray.

Definition at line 57 of file CMAlgoBase.h.

Referenced by cmtool::CMatchManager::EventBegin(), cmtool::CMatchManager::IterationBegin(), and cmtool::CMergeManager::IterationBegin().

{}

virtual void cmtool::CMAlgoBase::IterationEnd ( )

inlinevirtualinherited

Optional function: called at the end of each iteration over all pairs of clusters.

Reimplemented in cmtool::CPAlgoArray, and cmtool::CBAlgoArray.

Definition at line 62 of file CMAlgoBase.h.

Referenced by cmtool::CMatchManager::IterationEnd(), and cmtool::CMergeManager::IterationEnd().

{}

void cmtool::CBAlgoCenterOfMassSmall::Report ( )

virtual

Function to report what's going on per merging iteration.

Reimplemented from cmtool::CMAlgoBase.

Definition at line 136 of file CBAlgoCenterOfMassSmall.cxx.

Referenced by Reset().

  {}

virtual void cmtool::CBAlgoCenterOfMassSmall::Reset ( )

inlinevirtual

Function to reset the algorithm instance ... maybe implemented via child class.

Reimplemented from cmtool::CMAlgoBase.

Definition at line 45 of file CBAlgoCenterOfMassSmall.h.

References Report().

{}

void cmtool::CMAlgoBase::SetAnaFile ( TFile *  fout )

inlineinherited

Setter function for an output plot TFile pointer.

Definition at line 72 of file CMAlgoBase.h.

References cmtool::CMAlgoBase::_fout.

Referenced by cmtool::CMergeManager::EventBegin().

{ _fout = fout; }

void cmtool::CBAlgoCenterOfMassSmall::SetDebug ( bool  on )

inline

Function to set Debug mode of output.

Definition at line 51 of file CBAlgoCenterOfMassSmall.h.

References _debug.

Referenced by CBAlgoCenterOfMassSmall().

{ _debug = on; }

void cmtool::CBAlgoCenterOfMassSmall::SetLengthReach ( double  frac )

inline

Set Length Reach: How for out the cone extends as percent of cluster length.

Definition at line 72 of file CBAlgoCenterOfMassSmall.h.

References _lengthReach, and ShortestDistanceSquared().

{ _lengthReach = frac; }

void cmtool::CBAlgoCenterOfMassSmall::SetMaxCOMDistance ( double  d )

inline

Function to set Max Distance between COMs.

Definition at line 60 of file CBAlgoCenterOfMassSmall.h.

References _MaxCOMDistSquared, and d.

Referenced by CBAlgoCenterOfMassSmall().

{ _MaxCOMDistSquared = d; }

void cmtool::CBAlgoCenterOfMassSmall::SetMaxDistance ( double  d )

inline

Function to set Max Distance for COM to be from start-end.

Definition at line 57 of file CBAlgoCenterOfMassSmall.h.

References _MaxDist, and d.

Referenced by CBAlgoCenterOfMassSmall().

{ _MaxDist = d; }

void cmtool::CBAlgoCenterOfMassSmall::SetMaxHitsSmallClus ( size_t  n )

inline

Function to set Max hits for small clsuters.

Definition at line 54 of file CBAlgoCenterOfMassSmall.h.

References _maxHits, and n.

Referenced by CBAlgoCenterOfMassSmall().

{ _maxHits = n; }

virtual void cmtool::CMAlgoBase::SetVerbose ( bool  doit = true )

inlinevirtualinherited

Setter function for verbosity.

Reimplemented in cmtool::CBAlgoArray, and cmtool::CFAlgoTimeOverlap.

Definition at line 75 of file CMAlgoBase.h.

References cmtool::CMAlgoBase::_verbose.

Referenced by cmtool::CMatchManager::EventBegin(), and cmtool::CMergeManager::EventBegin().

{ _verbose = doit; }

double cmtool::CBAlgoCenterOfMassSmall::ShortestDistanceSquared	(	double	point_x,
		double	point_y,
		double	start_x,
		double	start_y,
		double	end_x,
		double	end_y
	)		const

Definition at line 140 of file CBAlgoCenterOfMassSmall.cxx.

References cmtool::CMAlgoBase::_verbose.

Referenced by Bool(), and SetLengthReach().

  {

    //This code finds the shortest distance between a point and a line segment.
    //code based off sample from
    //http://stackoverflow.com/questions/849211/shortest-distance-between-a-point-and-a-line-segment
    //note to self: rewrite this with TVector2 and compare time differences...
    //TVector2 code might be more understandable

    double distance_squared = -1;

    // Line segment: from ("V") = (start_x, start_y) to ("W")=(end_x, end_y)
    double length_squared = pow((end_x - start_x), 2) + pow((end_y - start_y), 2);

    // Treat the case start & end point overlaps
    if (length_squared < 0.1) {
      if (_verbose) {
        std::cout << std::endl;
        std::cout << Form(" Provided very short line segment: (%g,%g) => (%g,%g)",
                          start_x,
                          start_y,
                          end_x,
                          end_y)
                  << std::endl;
        std::cout << " Likely this means one of two clusters have start & end point identical."
                  << std::endl;
        std::cout << " Check the cluster output!" << std::endl;
        std::cout << std::endl;
        std::cout << Form(" At this time, the algorithm uses a point (%g,%g)", start_x, start_y)
                  << std::endl;
        std::cout << " to represent this cluster's location." << std::endl;
        std::cout << std::endl;
      }

      return (pow((point_x - start_x), 2) + pow((point_y - start_y), 2));
    }

    //Find shortest distance between point ("P")=(point_x,point_y) to this line segment
    double t = ((point_x - start_x) * (end_x - start_x) + (point_y - start_y) * (end_y - start_y)) /
               length_squared;

    if (t < 0.0)
      distance_squared = pow((point_x - start_x), 2) + pow((point_y - start_y), 2);

    else if (t > 1.0)
      distance_squared = pow((point_x - end_x), 2) + pow(point_y - end_y, 2);

    else
      distance_squared = pow((point_x - (start_x + t * (end_x - start_x))), 2) +
                         pow((point_y - (start_y + t * (end_y - start_y))), 2);

    return distance_squared;

  } //end ShortestDistanceSquared function

void cmtool::CBAlgoCenterOfMassSmall::UseCOMClose ( bool  on )

inline

Use COM in Poly algo to decide merging.

Definition at line 66 of file CBAlgoCenterOfMassSmall.h.

References _COMsClose.

Referenced by CBAlgoCenterOfMassSmall().

{ _COMsClose = on; }

void cmtool::CBAlgoCenterOfMassSmall::UseCOMInPoly ( bool  on )

inline

Use COM in Poly algo to decide merging.

Definition at line 63 of file CBAlgoCenterOfMassSmall.h.

References _COMinPolyAlg.

Referenced by CBAlgoCenterOfMassSmall().

{ _COMinPolyAlg = on; }

void cmtool::CBAlgoCenterOfMassSmall::UseCOMNearClus ( bool  on )

inline

Use COM in Poly algo to decide merging.

Definition at line 69 of file CBAlgoCenterOfMassSmall.h.

References _COMNearClus.

Referenced by CBAlgoCenterOfMassSmall().

{ _COMNearClus = on; }

Member Data Documentation

bool cmtool::CBAlgoCenterOfMassSmall::_COMinPolyAlg

protected

How four out - as percent of cluster length - cone will extend from start point.

Definition at line 88 of file CBAlgoCenterOfMassSmall.h.

Referenced by Bool(), and UseCOMInPoly().

bool cmtool::CBAlgoCenterOfMassSmall::_COMNearClus

protected

Definition at line 90 of file CBAlgoCenterOfMassSmall.h.

Referenced by Bool(), and UseCOMNearClus().

bool cmtool::CBAlgoCenterOfMassSmall::_COMsClose

protected

Definition at line 89 of file CBAlgoCenterOfMassSmall.h.

Referenced by Bool(), and UseCOMClose().

bool cmtool::CBAlgoCenterOfMassSmall::_debug

protected

Definition at line 82 of file CBAlgoCenterOfMassSmall.h.

Referenced by Bool(), and SetDebug().

TFile* cmtool::CMAlgoBase::_fout

protectedinherited

TFile pointer to an output file.

Definition at line 79 of file CMAlgoBase.h.

Referenced by cmtool::CMAlgoBase::CMAlgoBase(), and cmtool::CMAlgoBase::SetAnaFile().

double cmtool::CBAlgoCenterOfMassSmall::_lengthReach

protected

Definition at line 87 of file CBAlgoCenterOfMassSmall.h.

Referenced by SetLengthReach().

double cmtool::CBAlgoCenterOfMassSmall::_MaxCOMDistSquared

protected

Definition at line 85 of file CBAlgoCenterOfMassSmall.h.

Referenced by Bool(), and SetMaxCOMDistance().

double cmtool::CBAlgoCenterOfMassSmall::_MaxDist

protected

Definition at line 84 of file CBAlgoCenterOfMassSmall.h.

Referenced by Bool(), and SetMaxDistance().

size_t cmtool::CBAlgoCenterOfMassSmall::_maxHits

protected

Definition at line 83 of file CBAlgoCenterOfMassSmall.h.

Referenced by Bool(), and SetMaxHitsSmallClus().

bool cmtool::CMAlgoBase::_verbose

protectedinherited

Boolean to choose verbose mode. Turned on if CMergeManager/CMatchManager's verbosity level is >= kPerMerging.

Definition at line 82 of file CMAlgoBase.h.

Referenced by cmtool::CBAlgoAngleAlign::Bool(), cmtool::CBAlgoAngleCompat::Bool(), cmtool::CBAlgoPolyOverlap::Bool(), cmtool::CBAlgoOutOfConeSeparate::Bool(), cmtool::CBAlgoAngleSeparate::Bool(), Bool(), cmtool::CBAlgoCenterOfMass::Bool(), cmtool::CBAlgoStartNearEnd::Bool(), cmtool::CBAlgoProhibitAllTracks::Bool(), cmtool::CMAlgoBase::CMAlgoBase(), cmtool::CFAlgoZOverlap::Float(), cmtool::CFAlgoQRatio::Float(), cmtool::CMAlgoBase::SetVerbose(), ShortestDistanceSquared(), and cmtool::CBAlgoCenterOfMass::ShortestDistanceSquared().

---

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

• larreco/v09_25_00/source/larreco/RecoAlg/CMTool/CMTAlgMerge/CBAlgoCenterOfMassSmall.h
• larreco/v09_25_00/source/larreco/RecoAlg/CMTool/CMTAlgMerge/CBAlgoCenterOfMassSmall.cxx