ThreeDTransverseTracksAlgorithm class. More...

#include "ThreeDTransverseTracksAlgorithm.h"

Inheritance diagram for lar_content::ThreeDTransverseTracksAlgorithm:

Public Types
typedef OverlapTensor< TransverseOverlapResult >	TensorType

Public Member Functions
	ThreeDTransverseTracksAlgorithm ()
	Default constructor. More...

const TwoDSlidingFitResult &	GetCachedSlidingFitResult (const pandora::Cluster *const pCluster) const
	Get a sliding fit result from the algorithm cache. More...

unsigned int	GetSlidingFitWindow () const
	Get the layer window for the sliding linear fits. More...

virtual bool	MakeClusterSplits (const SplitPositionMap &splitPositionMap)
	Make cluster splits. More...

virtual bool	MakeClusterSplit (const pandora::CartesianVector &splitPosition, const pandora::Cluster &pCurrentCluster, const pandora::Cluster &pLowXCluster, const pandora::Cluster *&pHighXCluster) const
	Make a cluster split. More...

virtual void	UpdateForNewCluster (const pandora::Cluster *const pNewCluster)
	Update to reflect addition of a new cluster to the problem space. More...

virtual void	UpdateUponDeletion (const pandora::Cluster *const pDeletedCluster)
	Update to reflect cluster deletion. More...

virtual void	SelectInputClusters (const pandora::ClusterList *const pInputClusterList, pandora::ClusterList &selectedClusterList) const
	Select a subset of input clusters for processing in this algorithm. More...

virtual void	SetPfoParameters (const ProtoParticle &protoParticle, PandoraContentApi::ParticleFlowObject::Parameters &pfoParameters) const
	Calculate Pfo properties from proto particle. More...

virtual bool	CreateThreeDParticles (const ProtoParticleVector &protoParticleVector)
	Create particles using findings from recent algorithm processing. More...

virtual bool	MakeClusterMerges (const ClusterMergeMap &clusterMergeMap)
	Merge clusters together. More...

virtual void	RemoveUnavailableTensorElements ()
	Update tensor to remove all elements that have been added to pfos and so are unavailable. More...

const pandora::ClusterList &	GetInputClusterListU () const
	Get the input u cluster list. More...

const pandora::ClusterList &	GetInputClusterListV () const
	Get the input v cluster list. More...

const pandora::ClusterList &	GetInputClusterListW () const
	Get the input w cluster list. More...

const pandora::ClusterList &	GetSelectedClusterListU () const
	Get the selected u cluster list. More...

const pandora::ClusterList &	GetSelectedClusterListV () const
	Get the selected v cluster list. More...

const pandora::ClusterList &	GetSelectedClusterListW () const
	Get the selected w cluster list. More...

const std::string &	GetClusterListNameU () const
	Get the name of the u cluster list. More...

const std::string &	GetClusterListNameV () const
	Get the name of the v cluster list. More...

const std::string &	GetClusterListNameW () const
	Get the name of the w cluster list. More...

Static Public Member Functions
static bool	SortSplitPositions (const pandora::CartesianVector &lhs, const pandora::CartesianVector &rhs)
	Sort split position cartesian vectors by increasing x coordinate. More...

Protected Member Functions
virtual void	PreparationStep ()
	Perform any preparatory steps required, e.g. caching expensive fit results for clusters. More...

virtual void	PreparationStep (pandora::ClusterList &clusterList)
	Preparation step for a specific cluster list. More...

virtual void	TidyUp ()
	Tidy member variables in derived class. More...

void	AddToSlidingFitCache (const pandora::Cluster *const pCluster)
	Add a new sliding fit result, for the specified cluster, to the algorithm cache. More...

void	RemoveFromSlidingFitCache (const pandora::Cluster *const pCluster)
	Remova an existing sliding fit result, for the specified cluster, from the algorithm cache. More...

virtual void	SelectAllInputClusters ()
	Select a subset of input clusters for processing in this algorithm. More...

virtual void	PerformMainLoop ()
	Main loop over cluster combinations in order to populate the tensor. Responsible for calling CalculateOverlapResult. More...

Protected Attributes
unsigned int	m_slidingFitWindow
	The layer window for the sliding linear fits. More...

TwoDSlidingFitResultMap	m_slidingFitResultMap
	The sliding fit result map. More...

unsigned int	m_minClusterCaloHits
	The min number of hits in base cluster selection method. More...

float	m_minClusterLengthSquared
	The min length (squared) in base cluster selection method. More...

const pandora::ClusterList *	m_pInputClusterListU
	Address of the input cluster list U. More...

const pandora::ClusterList *	m_pInputClusterListV
	Address of the input cluster list V. More...

const pandora::ClusterList *	m_pInputClusterListW
	Address of the input cluster list W. More...

pandora::ClusterList	m_clusterListU
	The selected modified cluster list U. More...

pandora::ClusterList	m_clusterListV
	The selected modified cluster list V. More...

pandora::ClusterList	m_clusterListW
	The selected modified cluster list W. More...

TensorType	m_overlapTensor
	The overlap tensor. More...

Private Types
typedef std::map< unsigned int, TransverseOverlapResult >	FitSegmentToOverlapResultMap

typedef std::map< unsigned int, FitSegmentToOverlapResultMap >	FitSegmentMatrix

typedef std::map< unsigned int, FitSegmentMatrix >	FitSegmentTensor

typedef std::vector< TransverseTensorTool * >	TensorToolVector

Private Member Functions
void	CalculateOverlapResult (const pandora::Cluster const pClusterU, const pandora::Cluster const pClusterV, const pandora::Cluster *const pClusterW)
	Calculate cluster overlap result and store in tensor. More...

pandora::StatusCode	CalculateOverlapResult (const pandora::Cluster const pClusterU, const pandora::Cluster const pClusterV, const pandora::Cluster *const pClusterW, TransverseOverlapResult &overlapResult)
	Calculate the overlap result for given group of clusters. More...

void	GetFitSegmentTensor (const TwoDSlidingFitResult &slidingFitResultU, const TwoDSlidingFitResult &slidingFitResultV, const TwoDSlidingFitResult &slidingFitResultW, FitSegmentTensor &fitSegmentTensor) const
	Get the number of matched points for three fit segments and accompanying sliding fit results. More...

pandora::StatusCode	GetSegmentOverlap (const FitSegment &fitSegmentU, const FitSegment &fitSegmentV, const FitSegment &fitSegmentW, const TwoDSlidingFitResult &slidingFitResultU, const TwoDSlidingFitResult &slidingFitResultV, const TwoDSlidingFitResult &slidingFitResultW, TransverseOverlapResult &transverseOverlapResult) const
	Get the overlap result for three fit segments and the accompanying sliding fit results. More...

void	GetBestOverlapResult (const FitSegmentTensor &fitSegmentTensor, TransverseOverlapResult &bestTransverseOverlapResult) const
	Get the best overlap result, by examining the fit segment tensor. More...

void	GetPreviousOverlapResults (const unsigned int indexU, const unsigned int indexV, const unsigned int indexW, FitSegmentTensor &fitSegmentSumTensor, TransverseOverlapResultVector &transverseOverlapResultVector) const
	Get track overlap results for possible connected segments. More...

void	ExamineTensor ()
	Examine contents of tensor, collect together best-matching 2D particles and modify clusters as required. More...

pandora::StatusCode	ReadSettings (const pandora::TiXmlHandle xmlHandle)

Private Attributes
TensorToolVector	m_algorithmToolVector
	The algorithm tool vector. More...

unsigned int	m_nMaxTensorToolRepeats
	The maximum number of repeat loops over tensor tools. More...

unsigned int	m_maxFitSegmentIndex
	The maximum number of fit segments used when identifying best overlap result. More...

float	m_pseudoChi2Cut
	The pseudo chi2 cut to identify matched sampling points. More...

float	m_minSegmentMatchedFraction
	The minimum segment matched sampling fraction to allow segment grouping. More...

unsigned int	m_minSegmentMatchedPoints
	The minimum number of matched segment sampling points to allow segment grouping. More...

float	m_minOverallMatchedFraction
	The minimum matched sampling fraction to allow particle creation. More...

unsigned int	m_minOverallMatchedPoints
	The minimum number of matched segment sampling points to allow particle creation. More...

float	m_minSamplingPointsPerLayer
	The minimum number of sampling points per layer to allow particle creation. More...

Detailed Description

ThreeDTransverseTracksAlgorithm class.

Definition at line 28 of file ThreeDTransverseTracksAlgorithm.h.

Member Typedef Documentation

typedef std::map<unsigned int, FitSegmentToOverlapResultMap> lar_content::ThreeDTransverseTracksAlgorithm::FitSegmentMatrix

private

Definition at line 38 of file ThreeDTransverseTracksAlgorithm.h.

typedef std::map<unsigned int, FitSegmentMatrix> lar_content::ThreeDTransverseTracksAlgorithm::FitSegmentTensor

private

Definition at line 39 of file ThreeDTransverseTracksAlgorithm.h.

typedef std::map<unsigned int, TransverseOverlapResult> lar_content::ThreeDTransverseTracksAlgorithm::FitSegmentToOverlapResultMap

private

Definition at line 37 of file ThreeDTransverseTracksAlgorithm.h.

typedef std::vector<TransverseTensorTool*> lar_content::ThreeDTransverseTracksAlgorithm::TensorToolVector

private

Definition at line 106 of file ThreeDTransverseTracksAlgorithm.h.

typedef OverlapTensor<TransverseOverlapResult > lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::TensorType

inherited

Definition at line 45 of file ThreeDBaseAlgorithm.h.

Constructor & Destructor Documentation

lar_content::ThreeDTransverseTracksAlgorithm::ThreeDTransverseTracksAlgorithm ( )

Default constructor.

Definition at line 21 of file ThreeDTransverseTracksAlgorithm.cc.

References CalculateOverlapResult(), f, GetBestOverlapResult(), lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::GetCachedSlidingFitResult(), GetFitSegmentTensor(), lar_content::TrackOverlapResult::GetMatchedFraction(), lar_content::TwoDSlidingFitResult::GetMaxLayer(), lar_content::TwoDSlidingFitResult::GetMinLayer(), lar_content::TrackOverlapResult::GetNMatchedSamplingPoints(), lar_content::TrackOverlapResult::GetNSamplingPoints(), lar_content::TrackOverlapResult::IsInitialized(), m_minOverallMatchedFraction, m_minOverallMatchedPoints, m_minSamplingPointsPerLayer, lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::m_overlapTensor, and lar_content::OverlapTensor< T >::SetOverlapResult().

                                                                  :
     m_nMaxTensorToolRepeats(1000),
     m_maxFitSegmentIndex(50),
     m_pseudoChi2Cut(3.f),
     m_minSegmentMatchedFraction(0.1f),
     m_minSegmentMatchedPoints(3),
     m_minOverallMatchedFraction(0.5f),
     m_minOverallMatchedPoints(10),
     m_minSamplingPointsPerLayer(0.1f)
 {
 }

Member Function Documentation

void lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::AddToSlidingFitCache ( const pandora::Cluster *const pCluster )

protectedinherited

Add a new sliding fit result, for the specified cluster, to the algorithm cache.

Parameters

pCluster address of the relevant cluster

void lar_content::ThreeDTransverseTracksAlgorithm::CalculateOverlapResult	(	const pandora::Cluster *const	pClusterU,
		const pandora::Cluster *const	pClusterV,
		const pandora::Cluster *const	pClusterW
	)

privatevirtual

Calculate cluster overlap result and store in tensor.

Parameters

pClusterU	address of U view cluster
pClusterV	address of V view cluster
pClusterW	address of W view cluster

Implements lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >.

Referenced by ThreeDTransverseTracksAlgorithm().

pandora::StatusCode lar_content::ThreeDTransverseTracksAlgorithm::CalculateOverlapResult	(	const pandora::Cluster *const	pClusterU,
		const pandora::Cluster *const	pClusterV,
		const pandora::Cluster *const	pClusterW,
		TransverseOverlapResult &	overlapResult
	)

private

Calculate the overlap result for given group of clusters.

Parameters

pClusterU	the cluster from the U view
pClusterV	the cluster from the V view
pClusterW	the cluster from the W view
overlapResult	to receive the overlap result

Returns: statusCode, faster than throwing in regular use-cases

virtual bool lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::CreateThreeDParticles ( const ProtoParticleVector & protoParticleVector )

virtualinherited

Create particles using findings from recent algorithm processing.

Parameters

protoParticleVector	the proto particle vector
whether	particles were created

void lar_content::ThreeDTransverseTracksAlgorithm::ExamineTensor ( )

privatevirtual

Examine contents of tensor, collect together best-matching 2D particles and modify clusters as required.

Implements lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >.

Definition at line 288 of file ThreeDTransverseTracksAlgorithm.cc.

References m_algorithmToolVector, m_nMaxTensorToolRepeats, and lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::m_overlapTensor.

 {
     unsigned int repeatCounter(0);
 
     for (TensorToolVector::const_iterator iter = m_algorithmToolVector.begin(), iterEnd = m_algorithmToolVector.end(); iter != iterEnd; )
     {
         if ((*iter)->Run(this, m_overlapTensor))
         {
             iter = m_algorithmToolVector.begin();
 
             if (++repeatCounter > m_nMaxTensorToolRepeats)
                 break;
         }
         else
         {
             ++iter;
         }
     }
 }

void lar_content::ThreeDTransverseTracksAlgorithm::GetBestOverlapResult	(	const FitSegmentTensor &	fitSegmentTensor,
		TransverseOverlapResult &	bestTransverseOverlapResult
	)		const

private

Get the best overlap result, by examining the fit segment tensor.

Parameters

fitSegmentTensor	the fit segment tensor
bestTransverseOverlapResult	to receive the best transverse overlap result

Definition at line 188 of file ThreeDTransverseTracksAlgorithm.cc.

References GetPreviousOverlapResults(), lar_content::TrackOverlapResult::IsInitialized(), m_maxFitSegmentIndex, max, and min.

Referenced by ThreeDTransverseTracksAlgorithm().

 {
     if (fitSegmentTensor.empty())
     {
         bestTransverseOverlapResult = TransverseOverlapResult();
         return;
     }
 
     unsigned int maxIndexU(0), maxIndexV(0), maxIndexW(0);
     for (FitSegmentTensor::const_iterator tIter = fitSegmentTensor.begin(), tIterEnd = fitSegmentTensor.end(); tIter != tIterEnd; ++tIter)
     {
         maxIndexU = std::max(tIter->first, maxIndexU);
 
         for (FitSegmentMatrix::const_iterator mIter = tIter->second.begin(), mIterEnd = tIter->second.end(); mIter != mIterEnd; ++mIter)
         {
             maxIndexV = std::max(mIter->first, maxIndexV);
 
             for (FitSegmentToOverlapResultMap::const_iterator rIter = mIter->second.begin(), rIterEnd = mIter->second.end(); rIter != rIterEnd; ++rIter)
                 maxIndexW = std::max(rIter->first, maxIndexW);
         }
     }
 
     // ATTN Protect against longitudinal tracks winding back and forth; can cause large number of memory allocations
     maxIndexU = std::min(m_maxFitSegmentIndex, maxIndexU);
     maxIndexV = std::min(m_maxFitSegmentIndex, maxIndexV);
     maxIndexW = std::min(m_maxFitSegmentIndex, maxIndexW);
 
     FitSegmentTensor fitSegmentSumTensor;
     for (unsigned int indexU = 0; indexU <= maxIndexU; ++indexU)
     {
         for (unsigned int indexV = 0; indexV <= maxIndexV; ++indexV)
         {
             for (unsigned int indexW = 0; indexW <= maxIndexW; ++indexW)
             {
                 TransverseOverlapResultVector transverseOverlapResultVector;
                 this->GetPreviousOverlapResults(indexU, indexV, indexW, fitSegmentSumTensor, transverseOverlapResultVector);
 
                 TransverseOverlapResultVector::const_iterator maxElement = std::max_element(transverseOverlapResultVector.begin(), transverseOverlapResultVector.end());
                 TransverseOverlapResult maxTransverseOverlapResult((transverseOverlapResultVector.end() != maxElement) ? *maxElement : TransverseOverlapResult());
 
                 TransverseOverlapResult thisOverlapResult;
                 if (fitSegmentTensor.count(indexU) && (fitSegmentTensor.find(indexU))->second.count(indexV) && ((fitSegmentTensor.find(indexU))->second.find(indexV))->second.count(indexW))
                     thisOverlapResult = (((fitSegmentTensor.find(indexU))->second.find(indexV))->second.find(indexW))->second;
 
                 if (!thisOverlapResult.IsInitialized() && !maxTransverseOverlapResult.IsInitialized())
                     continue;
 
                 fitSegmentSumTensor[indexU][indexV][indexW] = thisOverlapResult + maxTransverseOverlapResult;
             }
         }
     }
 
     for (unsigned int indexU = 0; indexU <= maxIndexU; ++indexU)
     {
         for (unsigned int indexV = 0; indexV <= maxIndexV; ++indexV)
         {
             for (unsigned int indexW = 0; indexW <= maxIndexW; ++indexW)
             {
                 const TransverseOverlapResult &transverseOverlapResult(fitSegmentSumTensor[indexU][indexV][indexW]);
 
                 if (!transverseOverlapResult.IsInitialized())
                     continue;
 
                 if (transverseOverlapResult > bestTransverseOverlapResult)
                     bestTransverseOverlapResult = transverseOverlapResult;
             }
         }
     }
 }

const TwoDSlidingFitResult& lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::GetCachedSlidingFitResult ( const pandora::Cluster *const pCluster ) const

inherited

Get a sliding fit result from the algorithm cache.

Parameters

pCluster address of the relevant cluster

Referenced by ThreeDTransverseTracksAlgorithm().

const std::string& lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::GetClusterListNameU ( ) const

inherited

Get the name of the u cluster list.

const std::string& lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::GetClusterListNameV ( ) const

inherited

Get the name of the v cluster list.

const std::string& lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::GetClusterListNameW ( ) const

inherited

Get the name of the w cluster list.

void lar_content::ThreeDTransverseTracksAlgorithm::GetFitSegmentTensor	(	const TwoDSlidingFitResult &	slidingFitResultU,
		const TwoDSlidingFitResult &	slidingFitResultV,
		const TwoDSlidingFitResult &	slidingFitResultW,
		FitSegmentTensor &	fitSegmentTensor
	)		const

private

Get the number of matched points for three fit segments and accompanying sliding fit results.

Parameters

slidingFitResultU	sliding fit result for u cluster
slidingFitResultV	sliding fit result for v cluster
slidingFitResultW	sliding fit result for w cluster
fitSegmentTensor	the fit segment tensor

Definition at line 84 of file ThreeDTransverseTracksAlgorithm.cc.

References lar_content::TwoDSlidingFitResult::GetFitSegmentList(), GetSegmentOverlap(), m_minSegmentMatchedFraction, and m_minSegmentMatchedPoints.

Referenced by ThreeDTransverseTracksAlgorithm().

 {
     FitSegmentList fitSegmentListU(slidingFitResultU.GetFitSegmentList());
     FitSegmentList fitSegmentListV(slidingFitResultV.GetFitSegmentList());
     FitSegmentList fitSegmentListW(slidingFitResultW.GetFitSegmentList());
 
     for (unsigned int indexU = 0, indexUEnd = fitSegmentListU.size(); indexU < indexUEnd; ++indexU)
     {
         const FitSegment &fitSegmentU(fitSegmentListU.at(indexU));
 
         for (unsigned int indexV = 0, indexVEnd = fitSegmentListV.size(); indexV < indexVEnd; ++indexV)
         {
             const FitSegment &fitSegmentV(fitSegmentListV.at(indexV));
 
             for (unsigned int indexW = 0, indexWEnd = fitSegmentListW.size(); indexW < indexWEnd; ++indexW)
             {
                 const FitSegment &fitSegmentW(fitSegmentListW.at(indexW));
 
                 TransverseOverlapResult segmentOverlap;
                 if (STATUS_CODE_SUCCESS != this->GetSegmentOverlap(fitSegmentU, fitSegmentV, fitSegmentW, slidingFitResultU, slidingFitResultV, slidingFitResultW, segmentOverlap))
                     continue;
 
                 if ((segmentOverlap.GetMatchedFraction() < m_minSegmentMatchedFraction) || (segmentOverlap.GetNMatchedSamplingPoints() < m_minSegmentMatchedPoints))
                     continue;
 
                 fitSegmentTensor[indexU][indexV][indexW] = segmentOverlap;
             }
         }
     }
 }

const pandora::ClusterList& lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::GetInputClusterListU ( ) const

inherited

Get the input u cluster list.

const pandora::ClusterList& lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::GetInputClusterListV ( ) const

inherited

Get the input v cluster list.

const pandora::ClusterList& lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::GetInputClusterListW ( ) const

inherited

Get the input w cluster list.

void lar_content::ThreeDTransverseTracksAlgorithm::GetPreviousOverlapResults	(	const unsigned int	indexU,
		const unsigned int	indexV,
		const unsigned int	indexW,
		FitSegmentTensor &	fitSegmentSumTensor,
		TransverseOverlapResultVector &	transverseOverlapResultVector
	)		const

private

Get track overlap results for possible connected segments.

Parameters

indexU	the index u
indexV	the index v
indexW	the index w
transverseOverlapResultVector	the transverse overlap result vector

Definition at line 260 of file ThreeDTransverseTracksAlgorithm.cc.

References lar_content::TrackOverlapResult::IsInitialized(), and x1.

Referenced by GetBestOverlapResult().

 {
     for (unsigned int iPermutation = 1; iPermutation < 8; ++iPermutation)
     {
         const bool decrementU((iPermutation >> 0) & 0x1);
         const bool decrementV((iPermutation >> 1) & 0x1);
         const bool decrementW((iPermutation >> 2) & 0x1);
 
         if ((decrementU && (0 == indexU)) || (decrementV && (0 == indexV)) || (decrementW && (0 == indexW)))
             continue;
 
         const unsigned int newIndexU(decrementU ? indexU - 1 : indexU);
         const unsigned int newIndexV(decrementV ? indexV - 1 : indexV);
         const unsigned int newIndexW(decrementW ? indexW - 1 : indexW);
 
         const TransverseOverlapResult &transverseOverlapResult(fitSegmentSumTensor[newIndexU][newIndexV][newIndexW]);
 
         if (transverseOverlapResult.IsInitialized())
             transverseOverlapResultVector.push_back(transverseOverlapResult);
     }
 
     if (transverseOverlapResultVector.empty())
         transverseOverlapResultVector.push_back(TransverseOverlapResult());
 }

StatusCode lar_content::ThreeDTransverseTracksAlgorithm::GetSegmentOverlap	(	const FitSegment &	fitSegmentU,
		const FitSegment &	fitSegmentV,
		const FitSegment &	fitSegmentW,
		const TwoDSlidingFitResult &	slidingFitResultU,
		const TwoDSlidingFitResult &	slidingFitResultV,
		const TwoDSlidingFitResult &	slidingFitResultW,
		TransverseOverlapResult &	transverseOverlapResult
	)		const

private

Get the overlap result for three fit segments and the accompanying sliding fit results.

Parameters

fitSegmentU	the fit segment u
fitSegmentV	the fit segment v
fitSegmentW	the fit segment w
slidingFitResultU	sliding fit result for u cluster
slidingFitResultV	sliding fit result for v cluster
slidingFitResultW	sliding fit result for w cluster
transverseOverlapResult	to receive the transverse overlap result

Returns: statusCode, faster than throwing in regular use-cases

Definition at line 118 of file ThreeDTransverseTracksAlgorithm.cc.

References f, lar_content::FitSegment::GetEndLayer(), lar_content::FitSegment::GetMaxX(), lar_content::FitSegment::GetMinX(), lar_content::FitSegment::GetStartLayer(), lar_content::TwoDSlidingFitResult::GetTransverseProjection(), m_pseudoChi2Cut, max, lar_content::LArGeometryHelper::MergeTwoPositions(), min, n, w, and x.

Referenced by GetFitSegmentTensor().

 {
     // Assess x-overlap
     const float xSpanU(fitSegmentU.GetMaxX() - fitSegmentU.GetMinX());
     const float xSpanV(fitSegmentV.GetMaxX() - fitSegmentV.GetMinX());
     const float xSpanW(fitSegmentW.GetMaxX() - fitSegmentW.GetMinX());
 
     const float minX(std::max(fitSegmentU.GetMinX(), std::max(fitSegmentV.GetMinX(), fitSegmentW.GetMinX())));
     const float maxX(std::min(fitSegmentU.GetMaxX(), std::min(fitSegmentV.GetMaxX(), fitSegmentW.GetMaxX())));
     const float xOverlap(maxX - minX);
 
     if (xOverlap < std::numeric_limits<float>::epsilon())
         return STATUS_CODE_NOT_FOUND;
 
     // Sampling in x
     const float nPointsU(std::fabs((xOverlap / xSpanU) * static_cast<float>(fitSegmentU.GetEndLayer() - fitSegmentU.GetStartLayer())));
     const float nPointsV(std::fabs((xOverlap / xSpanV) * static_cast<float>(fitSegmentV.GetEndLayer() - fitSegmentV.GetStartLayer())));
     const float nPointsW(std::fabs((xOverlap / xSpanW) * static_cast<float>(fitSegmentW.GetEndLayer() - fitSegmentW.GetStartLayer())));
 
     const unsigned int nPoints(1 + static_cast<unsigned int>((nPointsU + nPointsV + nPointsW) / 3.f));
 
     // Chi2 calculations
     float pseudoChi2Sum(0.f);
     unsigned int nSamplingPoints(0), nMatchedSamplingPoints(0);
 
     for (unsigned int n = 0; n <= nPoints; ++n)
     {
         const float x(minX + (maxX - minX) * static_cast<float>(n) / static_cast<float>(nPoints));
 
         CartesianVector fitUVector(0.f, 0.f, 0.f), fitVVector(0.f, 0.f, 0.f), fitWVector(0.f, 0.f, 0.f);
         CartesianVector fitUDirection(0.f, 0.f, 0.f), fitVDirection(0.f, 0.f, 0.f), fitWDirection(0.f, 0.f, 0.f);
 
         if ((STATUS_CODE_SUCCESS != slidingFitResultU.GetTransverseProjection(x, fitSegmentU, fitUVector, fitUDirection)) ||
             (STATUS_CODE_SUCCESS != slidingFitResultV.GetTransverseProjection(x, fitSegmentV, fitVVector, fitVDirection)) ||
             (STATUS_CODE_SUCCESS != slidingFitResultW.GetTransverseProjection(x, fitSegmentW, fitWVector, fitWDirection)))
         {
             continue;
         }
 
         const float u(fitUVector.GetZ()), v(fitVVector.GetZ()), w(fitWVector.GetZ());
         const float uv2w(LArGeometryHelper::MergeTwoPositions(this->GetPandora(), TPC_VIEW_U, TPC_VIEW_V, u, v));
         const float uw2v(LArGeometryHelper::MergeTwoPositions(this->GetPandora(), TPC_VIEW_U, TPC_VIEW_W, u, w));
         const float vw2u(LArGeometryHelper::MergeTwoPositions(this->GetPandora(), TPC_VIEW_V, TPC_VIEW_W, v, w));
 
         ++nSamplingPoints;
         const float deltaU((vw2u - u) * fitUDirection.GetX());
         const float deltaV((uw2v - v) * fitVDirection.GetX());
         const float deltaW((uv2w - w) * fitWDirection.GetX());
 
         const float pseudoChi2(deltaW * deltaW + deltaV * deltaV + deltaU * deltaU);
         pseudoChi2Sum += pseudoChi2;
 
         if (pseudoChi2 < m_pseudoChi2Cut)
             ++nMatchedSamplingPoints;
     }
 
     if (0 == nSamplingPoints)
         return STATUS_CODE_NOT_FOUND;
 
     const XOverlap xOverlapObject(fitSegmentU.GetMinX(), fitSegmentU.GetMaxX(), fitSegmentV.GetMinX(),
         fitSegmentV.GetMaxX(), fitSegmentW.GetMinX(), fitSegmentW.GetMaxX(), xOverlap);
 
     transverseOverlapResult = TransverseOverlapResult(nMatchedSamplingPoints, nSamplingPoints, pseudoChi2Sum, xOverlapObject);
     return STATUS_CODE_SUCCESS;
 }

const pandora::ClusterList& lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::GetSelectedClusterListU ( ) const

inherited

Get the selected u cluster list.

const pandora::ClusterList& lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::GetSelectedClusterListV ( ) const

inherited

Get the selected v cluster list.

const pandora::ClusterList& lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::GetSelectedClusterListW ( ) const

inherited

Get the selected w cluster list.

unsigned int lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::GetSlidingFitWindow ( ) const

inherited

Get the layer window for the sliding linear fits.

Returns: the layer window for the sliding linear fits

virtual bool lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::MakeClusterMerges ( const ClusterMergeMap & clusterMergeMap )

virtualinherited

Merge clusters together.

Parameters

clusterMergeMap the cluster merge map

Returns: whether changes to the tensor have been made

virtual bool lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::MakeClusterSplit	(	const pandora::CartesianVector &	splitPosition,
		const pandora::Cluster *&	pCurrentCluster,
		const pandora::Cluster *&	pLowXCluster,
		const pandora::Cluster *&	pHighXCluster
	)		const

virtualinherited

Make a cluster split.

Parameters

splitPosition	the split position
pCurrentCluster	the cluster to split
pLowXCluster	to receive the low x cluster
pHighXCluster	to receive the high x cluster

Returns: whether a cluster split occurred

virtual bool lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::MakeClusterSplits ( const SplitPositionMap & splitPositionMap )

virtualinherited

Make cluster splits.

Parameters

splitPositionMap the split position map

Returns: whether changes to the tensor have been made

virtual void lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::PerformMainLoop ( )

protectedvirtualinherited

Main loop over cluster combinations in order to populate the tensor. Responsible for calling CalculateOverlapResult.

virtual void lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::PreparationStep ( )

protectedvirtualinherited

Perform any preparatory steps required, e.g. caching expensive fit results for clusters.

Reimplemented from lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >.

virtual void lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::PreparationStep ( pandora::ClusterList & clusterList )

protectedvirtualinherited

Preparation step for a specific cluster list.

Parameters

clusterList the cluster list

StatusCode lar_content::ThreeDTransverseTracksAlgorithm::ReadSettings ( const pandora::TiXmlHandle xmlHandle )

privatevirtual

Reimplemented from lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >.

Definition at line 311 of file ThreeDTransverseTracksAlgorithm.cc.

References m_algorithmToolVector, m_maxFitSegmentIndex, m_minOverallMatchedFraction, m_minOverallMatchedPoints, m_minSamplingPointsPerLayer, m_minSegmentMatchedFraction, m_minSegmentMatchedPoints, m_nMaxTensorToolRepeats, m_pseudoChi2Cut, and lar_content::ThreeDTracksBaseAlgorithm< T >::ReadSettings().

 {
     AlgorithmToolVector algorithmToolVector;
     PANDORA_RETURN_RESULT_IF(STATUS_CODE_SUCCESS, !=, XmlHelper::ProcessAlgorithmToolList(*this, xmlHandle,
         "TrackTools", algorithmToolVector));
 
     for (AlgorithmToolVector::const_iterator iter = algorithmToolVector.begin(), iterEnd = algorithmToolVector.end(); iter != iterEnd; ++iter)
     {
         TransverseTensorTool *const pTransverseTensorTool(dynamic_cast<TransverseTensorTool*>(*iter));
 
         if (NULL == pTransverseTensorTool)
             return STATUS_CODE_INVALID_PARAMETER;
 
         m_algorithmToolVector.push_back(pTransverseTensorTool);
     }
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle,
         "NMaxTensorToolRepeats", m_nMaxTensorToolRepeats));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle,
         "MaxFitSegmentIndex", m_maxFitSegmentIndex));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle,
         "PseudoChi2Cut", m_pseudoChi2Cut));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle,
         "MinSegmentMatchedFraction", m_minSegmentMatchedFraction));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle,
         "MinSegmentMatchedPoints", m_minSegmentMatchedPoints));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle,
         "MinOverallMatchedFraction", m_minOverallMatchedFraction));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle,
         "MinOverallMatchedPoints", m_minOverallMatchedPoints));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle,
         "MinSamplingPointsPerLayer", m_minSamplingPointsPerLayer));
 
     return ThreeDTracksBaseAlgorithm<TransverseOverlapResult>::ReadSettings(xmlHandle);
 }

void lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::RemoveFromSlidingFitCache ( const pandora::Cluster *const pCluster )

protectedinherited

Remova an existing sliding fit result, for the specified cluster, from the algorithm cache.

Parameters

pCluster address of the relevant cluster

virtual void lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::RemoveUnavailableTensorElements ( )

virtualinherited

Update tensor to remove all elements that have been added to pfos and so are unavailable.

virtual void lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::SelectAllInputClusters ( )

protectedvirtualinherited

Select a subset of input clusters for processing in this algorithm.

virtual void lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::SelectInputClusters	(	const pandora::ClusterList *const	pInputClusterList,
		pandora::ClusterList &	selectedClusterList
	)		const

virtualinherited

Select a subset of input clusters for processing in this algorithm.

Parameters

pInputClusterList	address of an input cluster list
selectedClusterList	to receive the selected cluster list

Implements lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >.

virtual void lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::SetPfoParameters	(	const ProtoParticle &	protoParticle,
		PandoraContentApi::ParticleFlowObject::Parameters &	pfoParameters
	)		const

virtualinherited

Calculate Pfo properties from proto particle.

Parameters

protoParticle	the input proto particle
pfoParameters	the output pfo parameters

Implements lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >.

static bool lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::SortSplitPositions	(	const pandora::CartesianVector &	lhs,
		const pandora::CartesianVector &	rhs
	)

staticinherited

Sort split position cartesian vectors by increasing x coordinate.

Parameters

lhs	the first cartesian vector
rhs	the second cartesian vector

virtual void lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::TidyUp ( )

protectedvirtualinherited

Tidy member variables in derived class.

Reimplemented from lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >.

virtual void lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::UpdateForNewCluster ( const pandora::Cluster *const pNewCluster )

virtualinherited

Update to reflect addition of a new cluster to the problem space.

Parameters

pNewCluster address of the new cluster

Reimplemented from lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >.

virtual void lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::UpdateUponDeletion ( const pandora::Cluster *const pDeletedCluster )

virtualinherited

Update to reflect cluster deletion.

Parameters

pDeletedCluster address of the deleted cluster

Reimplemented from lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >.

Member Data Documentation

TensorToolVector lar_content::ThreeDTransverseTracksAlgorithm::m_algorithmToolVector

private

The algorithm tool vector.

Definition at line 107 of file ThreeDTransverseTracksAlgorithm.h.

Referenced by ExamineTensor(), and ReadSettings().

pandora::ClusterList lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::m_clusterListU

protectedinherited

The selected modified cluster list U.

Definition at line 196 of file ThreeDBaseAlgorithm.h.

pandora::ClusterList lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::m_clusterListV

protectedinherited

The selected modified cluster list V.

Definition at line 197 of file ThreeDBaseAlgorithm.h.

pandora::ClusterList lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::m_clusterListW

protectedinherited

The selected modified cluster list W.

Definition at line 198 of file ThreeDBaseAlgorithm.h.

unsigned int lar_content::ThreeDTransverseTracksAlgorithm::m_maxFitSegmentIndex

private

The maximum number of fit segments used when identifying best overlap result.

Definition at line 110 of file ThreeDTransverseTracksAlgorithm.h.

Referenced by GetBestOverlapResult(), and ReadSettings().

unsigned int lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::m_minClusterCaloHits

protectedinherited

The min number of hits in base cluster selection method.

Definition at line 121 of file ThreeDTracksBaseAlgorithm.h.

float lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::m_minClusterLengthSquared

protectedinherited

The min length (squared) in base cluster selection method.

Definition at line 122 of file ThreeDTracksBaseAlgorithm.h.

float lar_content::ThreeDTransverseTracksAlgorithm::m_minOverallMatchedFraction

private

The minimum matched sampling fraction to allow particle creation.

Definition at line 114 of file ThreeDTransverseTracksAlgorithm.h.

Referenced by ReadSettings(), and ThreeDTransverseTracksAlgorithm().

unsigned int lar_content::ThreeDTransverseTracksAlgorithm::m_minOverallMatchedPoints

private

The minimum number of matched segment sampling points to allow particle creation.

Definition at line 115 of file ThreeDTransverseTracksAlgorithm.h.

Referenced by ReadSettings(), and ThreeDTransverseTracksAlgorithm().

float lar_content::ThreeDTransverseTracksAlgorithm::m_minSamplingPointsPerLayer

private

The minimum number of sampling points per layer to allow particle creation.

Definition at line 116 of file ThreeDTransverseTracksAlgorithm.h.

Referenced by ReadSettings(), and ThreeDTransverseTracksAlgorithm().

float lar_content::ThreeDTransverseTracksAlgorithm::m_minSegmentMatchedFraction

private

The minimum segment matched sampling fraction to allow segment grouping.

Definition at line 112 of file ThreeDTransverseTracksAlgorithm.h.

Referenced by GetFitSegmentTensor(), and ReadSettings().

unsigned int lar_content::ThreeDTransverseTracksAlgorithm::m_minSegmentMatchedPoints

private

The minimum number of matched segment sampling points to allow segment grouping.

Definition at line 113 of file ThreeDTransverseTracksAlgorithm.h.

Referenced by GetFitSegmentTensor(), and ReadSettings().

unsigned int lar_content::ThreeDTransverseTracksAlgorithm::m_nMaxTensorToolRepeats

private

The maximum number of repeat loops over tensor tools.

Definition at line 109 of file ThreeDTransverseTracksAlgorithm.h.

Referenced by ExamineTensor(), and ReadSettings().

TensorType lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::m_overlapTensor

protectedinherited

The overlap tensor.

Definition at line 200 of file ThreeDBaseAlgorithm.h.

Referenced by ExamineTensor(), and ThreeDTransverseTracksAlgorithm().

const pandora::ClusterList* lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::m_pInputClusterListU

protectedinherited

Address of the input cluster list U.

Definition at line 192 of file ThreeDBaseAlgorithm.h.

const pandora::ClusterList* lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::m_pInputClusterListV

protectedinherited

Address of the input cluster list V.

Definition at line 193 of file ThreeDBaseAlgorithm.h.

const pandora::ClusterList* lar_content::ThreeDBaseAlgorithm< TransverseOverlapResult >::m_pInputClusterListW

protectedinherited

Address of the input cluster list W.

Definition at line 194 of file ThreeDBaseAlgorithm.h.

float lar_content::ThreeDTransverseTracksAlgorithm::m_pseudoChi2Cut

private

The pseudo chi2 cut to identify matched sampling points.

Definition at line 111 of file ThreeDTransverseTracksAlgorithm.h.

Referenced by GetSegmentOverlap(), and ReadSettings().

TwoDSlidingFitResultMap lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::m_slidingFitResultMap

protectedinherited

The sliding fit result map.

Definition at line 119 of file ThreeDTracksBaseAlgorithm.h.

unsigned int lar_content::ThreeDTracksBaseAlgorithm< TransverseOverlapResult >::m_slidingFitWindow

protectedinherited

The layer window for the sliding linear fits.

Definition at line 118 of file ThreeDTracksBaseAlgorithm.h.

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

larpandoracontent/v03_13_02/source/larpandoracontent/LArThreeDReco/LArTransverseTrackMatching/ThreeDTransverseTracksAlgorithm.h
larpandoracontent/v03_13_02/source/larpandoracontent/LArThreeDReco/LArTransverseTrackMatching/ThreeDTransverseTracksAlgorithm.cc

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Types

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation