TwoViewTransverseTracksAlgorithm class. More...

#include "TwoViewTransverseTracksAlgorithm.h"

Inheritance diagram for lar_content::TwoViewTransverseTracksAlgorithm:

Public Types
typedef NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >	BaseAlgorithm

typedef std::set< unsigned int >	UIntSet

typedef TwoViewMatchingControl< TwoViewTransverseOverlapResult >	MatchingType

Public Member Functions
	TwoViewTransverseTracksAlgorithm ()
	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	PrepareInputClusters (pandora::ClusterList &preparedClusterList)
	Perform any preparatory steps required on the input clusters, e.g. caching expensive fit results. More...

virtual void	SetPfoParticleId (PandoraContentApi::ParticleFlowObject::Parameters &pfoParameters) const
	Set pfo particle id. More...

const std::string &	GetClusterListName (const pandora::HitType hitType) const
	Get the cluster list name corresponding to a specified hit type. More...

const pandora::ClusterList &	GetInputClusterList (const pandora::HitType hitType) const
	Get the input cluster list corresponding to a specified hit type. More...

const pandora::ClusterList &	GetSelectedClusterList (const pandora::HitType hitType) const
	Get the selected cluster list corresponding to a specified hit type. More...

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

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

virtual void	SetPfoParameters (const ProtoParticle &protoParticle, PandoraContentApi::ParticleFlowObject::Parameters &pfoParameters) const
	Set Pfo properties. 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
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	TidyUp ()
	Tidy member variables in derived class. More...

MatchingType &	GetMatchingControl ()
	Get the matching control. More...

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

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

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

Protected Attributes
MatchingType	m_matchingControl
	The matching control. More...

Private Types
typedef std::vector< TransverseMatrixTool * >	MatrixToolVector

Private Member Functions
void	CalculateOverlapResult (const pandora::Cluster const pCluster1, const pandora::Cluster const pCluster2, const pandora::Cluster *const)
	Calculate cluster overlap result and store in container. More...

pandora::StatusCode	CalculateOverlapResult (const pandora::Cluster const pCluster1, const pandora::Cluster const pCluster2, TwoViewTransverseOverlapResult &overlapResult)
	Calculates the two view overlap result. More...

unsigned int	CalculateNumberOfLocallyMatchingSamplingPoints (const DiscreteProbabilityVector &discreteProbabilityVector1, const DiscreteProbabilityVector &discreteProbabilityVector2, std::mt19937 &randomNumberGenerator)
	Calculates the number of the sliding windows that contains charge bins that locally match. More...

float	GetPrimaryAxisDotDriftAxis (const pandora::Cluster *const pCluster)
	Get the dot product between the cluster's primary axis and the drift axis. More...

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

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

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

unsigned int	m_nMaxMatrixToolRepeats
	The maximum number of repeat loops over matrix tools. More...

unsigned int	m_downsampleFactor
	The downsampling (hit merging) applied to hits in the overlap region. More...

unsigned int	m_minSamples
	The minimum number of samples needed for comparing charges. More...

unsigned int	m_nPermutations
	The number of permutations for calculating p-values. More...

float	m_localMatchingScoreThreshold
	The minimum score to classify a local region as matching. More...

float	m_maxDotProduct

float	m_minOverallMatchingScore
	M The maximum allowed cluster primary qxis Dot drift axis to fill the overlap result. More...

float	m_minOverallLocallyMatchedFraction
	The minimum required lcoally matched fraction to fill the overlap result. More...

std::mt19937	m_randomNumberGenerator
	The random number generator. More...

Detailed Description

TwoViewTransverseTracksAlgorithm class.

Definition at line 32 of file TwoViewTransverseTracksAlgorithm.h.

Member Typedef Documentation

typedef NViewTrackMatchingAlgorithm<TwoViewMatchingControl<TwoViewTransverseOverlapResult> > lar_content::TwoViewTransverseTracksAlgorithm::BaseAlgorithm

Definition at line 35 of file TwoViewTransverseTracksAlgorithm.h.

typedef TwoViewMatchingControl< TwoViewTransverseOverlapResult > lar_content::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::MatchingType

inherited

Definition at line 23 of file NViewMatchingAlgorithm.h.

typedef std::vector<TransverseMatrixTool *> lar_content::TwoViewTransverseTracksAlgorithm::MatrixToolVector

private

Definition at line 80 of file TwoViewTransverseTracksAlgorithm.h.

typedef std::set<unsigned int> lar_content::TwoViewTransverseTracksAlgorithm::UIntSet

Definition at line 36 of file TwoViewTransverseTracksAlgorithm.h.

Constructor & Destructor Documentation

lar_content::TwoViewTransverseTracksAlgorithm::TwoViewTransverseTracksAlgorithm ( )

Default constructor.

Definition at line 23 of file TwoViewTransverseTracksAlgorithm.cc.

References lar_content::LArDiscreteProbabilityHelper::CalculateCorrelationCoefficient(), lar_content::LArDiscreteProbabilityHelper::CalculateCorrelationCoefficientPValueFromPermutationTest(), CalculateNumberOfLocallyMatchingSamplingPoints(), CalculateOverlapResult(), f, lar_content::LArClusterHelper::GetCaloHitListInBoundingBox(), lar_content::LArGeometryHelper::GetCommonDaughterVolumes(), lar_content::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::GetMatchingControl(), lar_content::TwoViewMatchingControl< T >::GetOverlapMatrix(), GetPrimaryAxisDotDriftAxis(), lar_content::DiscreteProbabilityVector::GetSize(), lar_content::TwoViewXOverlap::GetTwoViewXOverlapMax(), lar_content::TwoViewXOverlap::GetTwoViewXOverlapMin(), lar_content::TwoViewXOverlap::GetTwoViewXOverlapSpan(), lar_content::TwoViewXOverlap::GetXSpan0(), lar_content::TwoViewXOverlap::GetXSpan1(), lar_content::TrackTwoViewOverlapResult::IsInitialized(), m_downsampleFactor, m_maxDotProduct, m_minOverallLocallyMatchedFraction, m_minOverallMatchingScore, m_minSamples, m_nPermutations, m_randomNumberGenerator, and lar_content::OverlapMatrix< T >::SetOverlapResult().

                                                                    :
     m_nMaxMatrixToolRepeats(1000),
     m_downsampleFactor(5),
     m_minSamples(11),
     m_nPermutations(1000),
     m_localMatchingScoreThreshold(0.99f),
     m_maxDotProduct(0.998f),
     m_minOverallMatchingScore(0.1f),
     m_minOverallLocallyMatchedFraction(0.1f),
     m_randomNumberGenerator(static_cast<std::mt19937::result_type>(0))
 {
 }

Member Function Documentation

void lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::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

unsigned int lar_content::TwoViewTransverseTracksAlgorithm::CalculateNumberOfLocallyMatchingSamplingPoints	(	const DiscreteProbabilityVector &	discreteProbabilityVector1,
		const DiscreteProbabilityVector &	discreteProbabilityVector2,
		std::mt19937 &	randomNumberGenerator
	)

private

Calculates the number of the sliding windows that contains charge bins that locally match.

Parameters

discreteProbabilityVector1	the view 0 discrete probability vector containing the charge information
pCluster2	the view 1 discrete probability vector containing the charge information
randomNumberGenerator	a seeded random number generator

Returns: the number of locally matching sampling points

Definition at line 145 of file TwoViewTransverseTracksAlgorithm.cc.

References lar_content::LArDiscreteProbabilityHelper::CalculateCorrelationCoefficientPValueFromPermutationTest(), f, lar_content::DiscreteProbabilityVector::GetProbability(), lar_content::DiscreteProbabilityVector::GetSize(), m_localMatchingScoreThreshold, m_minSamples, and m_nPermutations.

Referenced by TwoViewTransverseTracksAlgorithm().

 {
     if (discreteProbabilityVector1.GetSize() != discreteProbabilityVector2.GetSize() ||
         0 == discreteProbabilityVector1.GetSize() * discreteProbabilityVector2.GetSize())
         throw STATUS_CODE_INVALID_PARAMETER;
 
     if (m_minSamples > discreteProbabilityVector1.GetSize())
         throw STATUS_CODE_INVALID_PARAMETER;
 
     pandora::FloatVector localValues1, localValues2;
     unsigned int nMatchedComparisons(0);
 
     for (unsigned int iValue = 0; iValue < discreteProbabilityVector1.GetSize(); ++iValue)
     {
         localValues1.emplace_back(discreteProbabilityVector1.GetProbability(iValue));
         localValues2.emplace_back(discreteProbabilityVector2.GetProbability(iValue));
         if (localValues1.size() == m_minSamples)
         {
             float localPValue(0);
             try
             {
                 localPValue = LArDiscreteProbabilityHelper::CalculateCorrelationCoefficientPValueFromPermutationTest(
                     localValues1, localValues2, randomNumberGenerator, m_nPermutations);
             }
             catch (const StatusCodeException &)
             {
                 std::cout << "TwoViewTransverseTracksAlgorithm: failed to calculate correlation coefficient p-value for these numbers" << std::endl;
                 ;
                 std::cout << "----view 0: ";
                 for (unsigned int iElement = 0; iElement < localValues1.size(); ++iElement)
                     std::cout << localValues1.at(iElement) << " ";
                 std::cout << std::endl;
                 std::cout << "----view 1: ";
                 for (unsigned int iElement = 0; iElement < localValues2.size(); ++iElement)
                     std::cout << localValues2.at(iElement) << " ";
                 std::cout << std::endl;
             }
 
             if ((1.f - localPValue) - m_localMatchingScoreThreshold > std::numeric_limits<float>::epsilon())
                 nMatchedComparisons++;
 
             localValues1.erase(localValues1.begin());
             localValues2.erase(localValues2.begin());
         }
     }
     return nMatchedComparisons;
 }

void lar_content::TwoViewTransverseTracksAlgorithm::CalculateOverlapResult	(	const pandora::Cluster *const	pCluster1,
		const pandora::Cluster *const	pCluster2,
		const pandora::Cluster *	pCluster3
	)

privatevirtual

Calculate cluster overlap result and store in container.

Parameters

pCluster1	address of cluster1
pCluster2	address of cluster2
pCluster3	address of cluster3

Implements lar_content::MatchingBaseAlgorithm.

Referenced by TwoViewTransverseTracksAlgorithm().

pandora::StatusCode lar_content::TwoViewTransverseTracksAlgorithm::CalculateOverlapResult	(	const pandora::Cluster *const	pCluster1,
		const pandora::Cluster *const	pCluster2,
		TwoViewTransverseOverlapResult &	overlapResult
	)

private

Calculates the two view overlap result.

Parameters

pCluster1	the view 0 cluster
pCluster2	the view 1 cluster
overlapResult	the two view overlap result

bool lar_content::MatchingBaseAlgorithm::CreateThreeDParticles ( const ProtoParticleVector & protoParticleVector )

virtualinherited

Create particles using findings from recent algorithm processing.

Parameters

protoParticleVector	the proto particle vector
whether	particles were created

Definition at line 88 of file MatchingBaseAlgorithm.cc.

 {
     bool particlesMade(false);
     const PfoList *pPfoList(nullptr);
     std::string pfoListName;
     PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=, PandoraContentApi::CreateTemporaryListAndSetCurrent(*this, pPfoList, pfoListName));
 
     for (const ProtoParticle &protoParticle : protoParticleVector)
     {
         PandoraContentApi::ParticleFlowObject::Parameters pfoParameters;
         this->SetPfoParameters(protoParticle, pfoParameters);
 
         const ParticleFlowObject *pPfo(nullptr);
         PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=, PandoraContentApi::ParticleFlowObject::Create(*this, pfoParameters, pPfo));
         particlesMade = true;
     }
 
     if (!pPfoList->empty())
     {
         PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=, PandoraContentApi::SaveList<Pfo>(*this, m_outputPfoListName));
         PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=, PandoraContentApi::ReplaceCurrentList<Pfo>(*this, m_outputPfoListName));
     }
 
     return particlesMade;
 }

void lar_content::TwoViewTransverseTracksAlgorithm::ExamineOverlapContainer ( )

privatevirtual

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

Implements lar_content::MatchingBaseAlgorithm.

Definition at line 213 of file TwoViewTransverseTracksAlgorithm.cc.

References m_algorithmToolVector, and m_nMaxMatrixToolRepeats.

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

const TwoDSlidingFitResult& lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::GetCachedSlidingFitResult ( const pandora::Cluster *const pCluster ) const

inherited

Get a sliding fit result from the algorithm cache.

Parameters

pCluster address of the relevant cluster

const std::string& lar_content::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::GetClusterListName ( const pandora::HitType hitType ) const

virtualinherited

Get the cluster list name corresponding to a specified hit type.

Parameters

hitType the hit type

Returns: the cluster list name

Implements lar_content::MatchingBaseAlgorithm.

const pandora::ClusterList& lar_content::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::GetInputClusterList ( const pandora::HitType hitType ) const

virtualinherited

Get the input cluster list corresponding to a specified hit type.

Parameters

hitType the hit type

Returns: the input cluster list

Implements lar_content::MatchingBaseAlgorithm.

MatchingType& lar_content::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::GetMatchingControl ( )

protectedinherited

Get the matching control.

Referenced by TwoViewTransverseTracksAlgorithm().

float lar_content::TwoViewTransverseTracksAlgorithm::GetPrimaryAxisDotDriftAxis ( const pandora::Cluster *const pCluster )

private

Get the dot product between the cluster's primary axis and the drift axis.

Parameters

pCluster the cluster

Returns: dot product

Definition at line 196 of file TwoViewTransverseTracksAlgorithm.cc.

References f, lar_content::LArClusterHelper::GetCoordinateVector(), and lar_content::LArPcaHelper::RunPca().

Referenced by TwoViewTransverseTracksAlgorithm().

 {
     pandora::CartesianPointVector pointVector;
     LArClusterHelper::GetCoordinateVector(pCluster, pointVector);
 
     pandora::CartesianVector centroid(0.f, 0.f, 0.f);
     LArPcaHelper::EigenVectors eigenVecs;
     LArPcaHelper::EigenValues eigenValues(0.f, 0.f, 0.f);
     LArPcaHelper::RunPca(pointVector, centroid, eigenValues, eigenVecs);
 
     const pandora::CartesianVector primaryAxis(eigenVecs.at(0));
     const pandora::CartesianVector driftAxis(1.f, 0.f, 0.f);
     return primaryAxis.GetDotProduct(driftAxis);
 }

const pandora::ClusterList& lar_content::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::GetSelectedClusterList ( const pandora::HitType hitType ) const

virtualinherited

Get the selected cluster list corresponding to a specified hit type.

Parameters

hitType the hit type

Returns: the selected cluster list

Implements lar_content::MatchingBaseAlgorithm.

unsigned int lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::GetSlidingFitWindow ( ) const

inherited

Get the layer window for the sliding linear fits.

Returns: the layer window for the sliding linear fits

bool lar_content::MatchingBaseAlgorithm::MakeClusterMerges ( const ClusterMergeMap & clusterMergeMap )

virtualinherited

Merge clusters together.

Parameters

clusterMergeMap the cluster merge map

Returns: whether changes to the overlap container have been made

Definition at line 48 of file MatchingBaseAlgorithm.cc.

Referenced by lar_content::SplitShowersTool::ApplyChanges(), lar_content::ThreeDKinkBaseTool::ApplyChanges(), lar_content::TwoViewThreeDKinkTool::ApplyChanges(), lar_content::ConnectedRemnantsTool::Run(), and lar_content::MissingTrackSegmentTool::Run().

 {
     ClusterSet deletedClusters;
 
     ClusterList parentClusters;
     for (const auto &mapEntry : clusterMergeMap)
         parentClusters.push_back(mapEntry.first);
     parentClusters.sort(LArClusterHelper::SortByNHits);
 
     for (const Cluster *const pParentCluster : parentClusters)
     {
         const HitType hitType(LArClusterHelper::GetClusterHitType(pParentCluster));
         const std::string &clusterListName(this->GetClusterListName(hitType));
 
         if (!((TPC_VIEW_U == hitType) || (TPC_VIEW_V == hitType) || (TPC_VIEW_W == hitType)))
             throw StatusCodeException(STATUS_CODE_FAILURE);
 
         ClusterList daughterClusters(clusterMergeMap.at(pParentCluster));
         daughterClusters.sort(LArClusterHelper::SortByNHits);
 
         for (const Cluster *const pDaughterCluster : daughterClusters)
         {
             if (deletedClusters.count(pParentCluster) || deletedClusters.count(pDaughterCluster))
                 throw StatusCodeException(STATUS_CODE_FAILURE);
 
             this->UpdateUponDeletion(pDaughterCluster);
             this->UpdateUponDeletion(pParentCluster);
             PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=,
                 PandoraContentApi::MergeAndDeleteClusters(*this, pParentCluster, pDaughterCluster, clusterListName, clusterListName));
 
             this->UpdateForNewCluster(pParentCluster);
             deletedClusters.insert(pDaughterCluster);
         }
     }
 
     return !(deletedClusters.empty());
 }

virtual bool lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::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::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::MakeClusterSplits ( const SplitPositionMap & splitPositionMap )

virtualinherited

Make cluster splits.

Parameters

splitPositionMap the split position map

Returns: whether changes to the overlap container have been made

virtual void lar_content::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::PerformMainLoop ( )

protectedvirtualinherited

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

Implements lar_content::MatchingBaseAlgorithm.

virtual void lar_content::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::PrepareAllInputClusters ( )

protectedvirtualinherited

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

Implements lar_content::MatchingBaseAlgorithm.

virtual void lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::PrepareInputClusters ( pandora::ClusterList & preparedClusterList )

virtualinherited

Perform any preparatory steps required on the input clusters, e.g. caching expensive fit results.

Parameters

preparedClusterList to receive the prepared cluster list, non const so as to be able to modify input selected list

Reimplemented from lar_content::MatchingBaseAlgorithm.

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

privatevirtual

Reimplemented from lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >.

Definition at line 234 of file TwoViewTransverseTracksAlgorithm.cc.

References m_algorithmToolVector, m_downsampleFactor, m_localMatchingScoreThreshold, m_maxDotProduct, m_minOverallLocallyMatchedFraction, m_minOverallMatchingScore, m_minSamples, m_nMaxMatrixToolRepeats, m_nPermutations, and lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::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)
     {
         TransverseMatrixTool *const pTransverseMatrixTool(dynamic_cast<TransverseMatrixTool *>(*iter));
 
         if (!pTransverseMatrixTool)
             return STATUS_CODE_INVALID_PARAMETER;
 
         m_algorithmToolVector.push_back(pTransverseMatrixTool);
     }
 
     PANDORA_RETURN_RESULT_IF_AND_IF(
         STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "NMaxMatrixToolRepeats", m_nMaxMatrixToolRepeats));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(
         STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "DownsampleFactor", m_downsampleFactor));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "MinSamples", m_minSamples));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "NPermutations", m_nPermutations));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=,
         XmlHelper::ReadValue(xmlHandle, "LocalMatchingScoreThreshold", m_localMatchingScoreThreshold));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "MaxDotProduct", m_maxDotProduct));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=,
         XmlHelper::ReadValue(xmlHandle, "MinOverallMatchingScore", m_minOverallMatchingScore));
 
     PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=,
         XmlHelper::ReadValue(xmlHandle, "MinOverallLocallyMatchedFraction", m_minOverallLocallyMatchedFraction));
 
     return BaseAlgorithm::ReadSettings(xmlHandle);
 }

void lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::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::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::SelectAllInputClusters ( )

protectedvirtualinherited

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

Implements lar_content::MatchingBaseAlgorithm.

virtual void lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::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

Reimplemented from lar_content::MatchingBaseAlgorithm.

void lar_content::MatchingBaseAlgorithm::SetPfoParameters	(	const ProtoParticle &	protoParticle,
		PandoraContentApi::ParticleFlowObject::Parameters &	pfoParameters
	)		const

virtualinherited

Set Pfo properties.

Parameters

protoParticle	the input proto particle
pfoParameters	the output pfo parameters

Definition at line 116 of file MatchingBaseAlgorithm.cc.

References f, and lar_content::ProtoParticle::m_clusterList.

 {
     this->SetPfoParticleId(pfoParameters);
     pfoParameters.m_charge = PdgTable::GetParticleCharge(pfoParameters.m_particleId.Get());
     pfoParameters.m_mass = PdgTable::GetParticleMass(pfoParameters.m_particleId.Get());
     pfoParameters.m_energy = 0.f;
     pfoParameters.m_momentum = CartesianVector(0.f, 0.f, 0.f);
     pfoParameters.m_clusterList = protoParticle.m_clusterList;
 }

virtual void lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::SetPfoParticleId ( PandoraContentApi::ParticleFlowObject::Parameters & pfoParameters ) const

virtualinherited

Set pfo particle id.

Parameters

pfoParameters the output pfo parameters

Reimplemented from lar_content::MatchingBaseAlgorithm.

static bool lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::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::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::TidyUp ( )

protectedvirtualinherited

Tidy member variables in derived class.

Reimplemented from lar_content::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >.

virtual void lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::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::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >.

virtual void lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::UpdateUponDeletion ( const pandora::Cluster *const pDeletedCluster )

virtualinherited

Update to reflect cluster deletion.

Parameters

pDeletedCluster address of the deleted cluster

Reimplemented from lar_content::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >.

Member Data Documentation

MatrixToolVector lar_content::TwoViewTransverseTracksAlgorithm::m_algorithmToolVector

private

The algorithm tool vector.

Definition at line 81 of file TwoViewTransverseTracksAlgorithm.h.

Referenced by ExamineOverlapContainer(), and ReadSettings().

unsigned int lar_content::TwoViewTransverseTracksAlgorithm::m_downsampleFactor

private

The downsampling (hit merging) applied to hits in the overlap region.

Definition at line 84 of file TwoViewTransverseTracksAlgorithm.h.

Referenced by ReadSettings(), and TwoViewTransverseTracksAlgorithm().

float lar_content::TwoViewTransverseTracksAlgorithm::m_localMatchingScoreThreshold

private

The minimum score to classify a local region as matching.

Definition at line 87 of file TwoViewTransverseTracksAlgorithm.h.

Referenced by CalculateNumberOfLocallyMatchingSamplingPoints(), and ReadSettings().

MatchingType lar_content::NViewMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >::m_matchingControl

protectedinherited

The matching control.

Definition at line 53 of file NViewMatchingAlgorithm.h.

float lar_content::TwoViewTransverseTracksAlgorithm::m_maxDotProduct

private

Definition at line 88 of file TwoViewTransverseTracksAlgorithm.h.

Referenced by ReadSettings(), and TwoViewTransverseTracksAlgorithm().

float lar_content::TwoViewTransverseTracksAlgorithm::m_minOverallLocallyMatchedFraction

private

The minimum required lcoally matched fraction to fill the overlap result.

Definition at line 90 of file TwoViewTransverseTracksAlgorithm.h.

Referenced by ReadSettings(), and TwoViewTransverseTracksAlgorithm().

float lar_content::TwoViewTransverseTracksAlgorithm::m_minOverallMatchingScore

private

M The maximum allowed cluster primary qxis Dot drift axis to fill the overlap result.

The minimum required global matching score to fill the overlap result

Definition at line 89 of file TwoViewTransverseTracksAlgorithm.h.

Referenced by ReadSettings(), and TwoViewTransverseTracksAlgorithm().

unsigned int lar_content::TwoViewTransverseTracksAlgorithm::m_minSamples

private

The minimum number of samples needed for comparing charges.

Definition at line 85 of file TwoViewTransverseTracksAlgorithm.h.

Referenced by CalculateNumberOfLocallyMatchingSamplingPoints(), ReadSettings(), and TwoViewTransverseTracksAlgorithm().

unsigned int lar_content::TwoViewTransverseTracksAlgorithm::m_nMaxMatrixToolRepeats

private

The maximum number of repeat loops over matrix tools.

Definition at line 83 of file TwoViewTransverseTracksAlgorithm.h.

Referenced by ExamineOverlapContainer(), and ReadSettings().

unsigned int lar_content::TwoViewTransverseTracksAlgorithm::m_nPermutations

private

The number of permutations for calculating p-values.

Definition at line 86 of file TwoViewTransverseTracksAlgorithm.h.

Referenced by CalculateNumberOfLocallyMatchingSamplingPoints(), ReadSettings(), and TwoViewTransverseTracksAlgorithm().

std::mt19937 lar_content::TwoViewTransverseTracksAlgorithm::m_randomNumberGenerator

private

The random number generator.

Definition at line 91 of file TwoViewTransverseTracksAlgorithm.h.

Referenced by TwoViewTransverseTracksAlgorithm().

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

larpandoracontent/v04_08_01/source/larpandoracontent/LArThreeDReco/LArTwoViewMatching/TwoViewTransverseTracksAlgorithm.h
larpandoracontent/v04_08_01/source/larpandoracontent/LArThreeDReco/LArTwoViewMatching/TwoViewTransverseTracksAlgorithm.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