#include "NViewMatchingAlgorithm.h"

Inheritance diagram for lar_content::NViewMatchingAlgorithm< T >:

[legend]

Collaboration diagram for lar_content::NViewMatchingAlgorithm< T >:

[legend]

Public Types
typedef T	MatchingType

Public Member Functions
	NViewMatchingAlgorithm ()
	Default constructor.

virtual	~NViewMatchingAlgorithm ()
	Destructor.

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

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

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

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

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

virtual void	CalculateOverlapResult (const pandora::Cluster const pCluster1, const pandora::Cluster const pCluster2, const pandora::Cluster *const pCluster3=nullptr)=0
	Calculate cluster overlap result and store in container.

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

virtual void	PrepareInputClusters (pandora::ClusterList &preparedClusterList)
	Perform any preparatory steps required on the input clusters, e.g. caching expensive fit results.

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

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

virtual void	SetPfoParameters (const ProtoParticle &protoParticle, PandoraContentApi::ParticleFlowObject::Parameters &pfoParameters) const
	Set Pfo properties.

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

const std::string &	GetType () const
	Get the type.

const std::string &	GetInstanceName () const
	Get the instance name.

const Pandora &	GetPandora () const
	Get the associated pandora instance.

Protected Member Functions
MatchingType &	GetMatchingControl ()
	Get the matching control.

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

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

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

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

virtual pandora::StatusCode	ReadSettings (const pandora::TiXmlHandle xmlHandle)
	Read the algorithm settings.

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

virtual StatusCode	Initialize ()
	Perform any operations that must occur after reading settings, but before running the process.

virtual StatusCode	Reset ()
	Perform any operations when pandora is reset, typically at the end of each event.

StatusCode	RegisterDetails (const Pandora *const pPandora, const std::string &type, const std::string &instanceName)
	Register i) the pandora instance that will run the process and ii) the process type.

Protected Attributes
MatchingType	m_matchingControl
	The matching control.

const Pandora *	m_pPandora
	The pandora object that will run the process.

std::string	m_type
	The process type.

std::string	m_instanceName
	The process instance name.

Private Member Functions
pandora::StatusCode	Run ()
	Run the algorithm.

Private Attributes
std::string	m_outputPfoListName
	The output pfo list name.

Detailed Description

template<typename T>
class lar_content::NViewMatchingAlgorithm< T >

NViewMatchingAlgorithm class.

Definition at line 20 of file NViewMatchingAlgorithm.h.

Member Typedef Documentation

◆ MatchingType

template<typename T >

typedef T lar_content::NViewMatchingAlgorithm< T >::MatchingType

Definition at line 23 of file NViewMatchingAlgorithm.h.

Constructor & Destructor Documentation

◆ NViewMatchingAlgorithm()

template<typename T >

lar_content::NViewMatchingAlgorithm< T >::NViewMatchingAlgorithm ( )

Default constructor.

Definition at line 27 of file NViewMatchingAlgorithm.cc.

◆ ~NViewMatchingAlgorithm()

template<typename T >

lar_content::NViewMatchingAlgorithm< T >::~NViewMatchingAlgorithm ( )

virtual

Destructor.

Definition at line 34 of file NViewMatchingAlgorithm.cc.

Member Function Documentation

◆ CalculateOverlapResult()

virtual void lar_content::MatchingBaseAlgorithm::CalculateOverlapResult	(	const pandora::Cluster *const	pCluster1,
		const pandora::Cluster *const	pCluster2,
		const pandora::Cluster *const	pCluster3 = `nullptr`
	)

pure virtualinherited

Calculate cluster overlap result and store in container.

Parameters

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

Implemented in lar_content::TwoViewDeltaRayMatchingAlgorithm, lar_content::TwoViewTransverseTracksAlgorithm, lar_content::ThreeViewDeltaRayMatchingAlgorithm, lar_content::ThreeViewLongitudinalTracksAlgorithm, lar_content::ThreeViewRemnantsAlgorithm, lar_content::ThreeViewShowersAlgorithm, lar_content::ThreeViewTrackFragmentsAlgorithm, and lar_content::ThreeViewTransverseTracksAlgorithm.

◆ CreateThreeDParticles()

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.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ExamineOverlapContainer()

virtual void lar_content::MatchingBaseAlgorithm::ExamineOverlapContainer ( )

protectedpure virtualinherited

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

Implemented in lar_content::ThreeViewDeltaRayMatchingAlgorithm, lar_content::TwoViewDeltaRayMatchingAlgorithm, lar_content::ThreeViewLongitudinalTracksAlgorithm, lar_content::ThreeViewRemnantsAlgorithm, lar_content::ThreeViewShowersAlgorithm, lar_content::ThreeViewTrackFragmentsAlgorithm, lar_content::ThreeViewTransverseTracksAlgorithm, and lar_content::TwoViewTransverseTracksAlgorithm.

Here is the caller graph for this function:

◆ GetClusterListName()

template<typename T >

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

virtual

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.

Definition at line 57 of file NViewMatchingAlgorithm.cc.

Here is the caller graph for this function:

◆ GetInputClusterList()

template<typename T >

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

virtual

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.

Definition at line 65 of file NViewMatchingAlgorithm.cc.

Here is the caller graph for this function:

◆ GetInstanceName()

const std::string & pandora::Process::GetInstanceName ( ) const

inlineinherited

Get the instance name.

Returns: The instance name

Definition at line 109 of file Process.h.

◆ GetMatchingControl()

template<typename T >

T & lar_content::NViewMatchingAlgorithm< T >::GetMatchingControl ( )

inlineprotected

Get the matching control.

Definition at line 59 of file NViewMatchingAlgorithm.h.

Here is the caller graph for this function:

◆ GetPandora()

const Pandora & pandora::Process::GetPandora ( ) const

inlineinherited

Get the associated pandora instance.

Returns: the associated pandora instance

Definition at line 116 of file Process.h.

◆ GetSelectedClusterList()

template<typename T >

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

virtual

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.

Definition at line 73 of file NViewMatchingAlgorithm.cc.

Here is the caller graph for this function:

◆ GetType()

const std::string & pandora::Process::GetType ( ) const

inlineinherited

Get the type.

Returns: The type

Definition at line 102 of file Process.h.

◆ Initialize()

StatusCode pandora::Process::Initialize ( )

inlineprotectedvirtualinherited

Perform any operations that must occur after reading settings, but before running the process.

Reimplemented in lar_content::BdtBeamParticleIdTool, lar_content::BeamParticleIdTool, lar_content::CosmicRayTaggingTool, lar_content::EventReadingAlgorithm, lar_content::EventWritingAlgorithm, lar_content::LArPseudoLayerPlugin, lar_content::LArRotationalTransformationPlugin, EventReadingAlgorithm, and EventWritingAlgorithm.

Definition at line 126 of file Process.h.

Here is the caller graph for this function:

◆ MakeClusterMerges()

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.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ PerformMainLoop()

template<typename T >

void lar_content::NViewMatchingAlgorithm< T >::PerformMainLoop ( )

protectedvirtual

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

Implements lar_content::MatchingBaseAlgorithm.

Reimplemented in lar_content::ThreeViewTrackFragmentsAlgorithm.

Definition at line 105 of file NViewMatchingAlgorithm.cc.

◆ PrepareAllInputClusters()

template<typename T >

void lar_content::NViewMatchingAlgorithm< T >::PrepareAllInputClusters ( )

protectedvirtual

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

Implements lar_content::MatchingBaseAlgorithm.

Definition at line 89 of file NViewMatchingAlgorithm.cc.

◆ PrepareInputClusters()

void lar_content::MatchingBaseAlgorithm::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 in lar_content::NViewDeltaRayMatchingAlgorithm< T >, lar_content::NViewDeltaRayMatchingAlgorithm< ThreeViewMatchingControl< DeltaRayOverlapResult > >, lar_content::NViewDeltaRayMatchingAlgorithm< TwoViewMatchingControl< TwoViewDeltaRayOverlapResult > >, lar_content::ThreeViewShowersAlgorithm, lar_content::NViewTrackMatchingAlgorithm< T >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< FragmentOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< LongitudinalOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< TransverseOverlapResult > >, and lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >.

Definition at line 42 of file MatchingBaseAlgorithm.cc.

◆ ReadSettings()

template<typename T >

StatusCode lar_content::NViewMatchingAlgorithm< T >::ReadSettings ( const pandora::TiXmlHandle xmlHandle )

protectedvirtual

Read the algorithm settings.

Parameters

xmlHandle the relevant xml handle

Reimplemented from lar_content::MatchingBaseAlgorithm.

Reimplemented in lar_content::NViewDeltaRayMatchingAlgorithm< T >, lar_content::NViewDeltaRayMatchingAlgorithm< ThreeViewMatchingControl< DeltaRayOverlapResult > >, lar_content::NViewDeltaRayMatchingAlgorithm< TwoViewMatchingControl< TwoViewDeltaRayOverlapResult > >, lar_content::ThreeViewDeltaRayMatchingAlgorithm, lar_content::TwoViewDeltaRayMatchingAlgorithm, lar_content::ThreeViewLongitudinalTracksAlgorithm, lar_content::ThreeViewRemnantsAlgorithm, lar_content::ThreeViewShowersAlgorithm, lar_content::NViewTrackMatchingAlgorithm< T >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< FragmentOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< LongitudinalOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< TransverseOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >, lar_content::ThreeViewTrackFragmentsAlgorithm, lar_content::ThreeViewTransverseTracksAlgorithm, and lar_content::TwoViewTransverseTracksAlgorithm.

Definition at line 113 of file NViewMatchingAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RegisterDetails()

StatusCode pandora::Process::RegisterDetails	(	const Pandora *const	pPandora,
		const std::string &	type,
		const std::string &	instanceName
	)

inlineprotectedinherited

Register i) the pandora instance that will run the process and ii) the process type.

Parameters

pPandora	address of the pandora object that will run the process
type	the process type
instanceName	the process instance name

Definition at line 146 of file Process.h.

Here is the caller graph for this function:

◆ Reset()

StatusCode pandora::Process::Reset ( )

inlineprotectedvirtualinherited

Perform any operations when pandora is reset, typically at the end of each event.

Reimplemented in lar_content::MasterAlgorithm, lar_content::PostProcessingAlgorithm, and lar_content::PreProcessingAlgorithm.

Definition at line 133 of file Process.h.

Here is the caller graph for this function:

◆ Run()

StatusCode lar_content::MatchingBaseAlgorithm::Run ( )

privatevirtualinherited

Run the algorithm.

Implements pandora::Algorithm.

Definition at line 135 of file MatchingBaseAlgorithm.cc.

Here is the call graph for this function:

◆ SelectAllInputClusters()

template<typename T >

void lar_content::NViewMatchingAlgorithm< T >::SelectAllInputClusters ( )

protectedvirtual

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

Implements lar_content::MatchingBaseAlgorithm.

Definition at line 81 of file NViewMatchingAlgorithm.cc.

◆ SelectInputClusters()

void lar_content::MatchingBaseAlgorithm::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 in lar_content::NViewDeltaRayMatchingAlgorithm< T >, lar_content::NViewDeltaRayMatchingAlgorithm< ThreeViewMatchingControl< DeltaRayOverlapResult > >, lar_content::NViewDeltaRayMatchingAlgorithm< TwoViewMatchingControl< TwoViewDeltaRayOverlapResult > >, lar_content::ThreeViewRemnantsAlgorithm, lar_content::ThreeViewShowersAlgorithm, lar_content::NViewTrackMatchingAlgorithm< T >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< FragmentOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< LongitudinalOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< TransverseOverlapResult > >, and lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >.

Definition at line 32 of file MatchingBaseAlgorithm.cc.

◆ SetPfoParameters()

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.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetPfoParticleId()

void lar_content::MatchingBaseAlgorithm::SetPfoParticleId ( PandoraContentApi::ParticleFlowObject::Parameters & pfoParameters ) const

virtualinherited

Set pfo particle id.

Parameters

pfoParameters the output pfo parameters

Reimplemented in lar_content::NViewTrackMatchingAlgorithm< T >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< FragmentOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< LongitudinalOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< TransverseOverlapResult > >, and lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >.

Definition at line 128 of file MatchingBaseAlgorithm.cc.

Here is the caller graph for this function:

◆ TidyUp()

template<typename T >

void lar_content::NViewMatchingAlgorithm< T >::TidyUp ( )

protectedvirtual

Tidy member variables in derived class.

Implements lar_content::MatchingBaseAlgorithm.

Reimplemented in lar_content::NViewDeltaRayMatchingAlgorithm< T >, lar_content::NViewDeltaRayMatchingAlgorithm< ThreeViewMatchingControl< DeltaRayOverlapResult > >, lar_content::NViewDeltaRayMatchingAlgorithm< TwoViewMatchingControl< TwoViewDeltaRayOverlapResult > >, lar_content::ThreeViewShowersAlgorithm, lar_content::NViewTrackMatchingAlgorithm< T >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< FragmentOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< LongitudinalOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< TransverseOverlapResult > >, and lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >.

Definition at line 97 of file NViewMatchingAlgorithm.cc.

Here is the caller graph for this function:

◆ UpdateForNewCluster()

template<typename T >

void lar_content::NViewMatchingAlgorithm< T >::UpdateForNewCluster ( const pandora::Cluster *const pNewCluster )

virtual

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

Parameters

pNewCluster address of the new cluster

Implements lar_content::MatchingBaseAlgorithm.

Reimplemented in lar_content::ThreeViewShowersAlgorithm, lar_content::NViewTrackMatchingAlgorithm< T >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< FragmentOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< LongitudinalOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< TransverseOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >, and lar_content::ThreeViewTrackFragmentsAlgorithm.

Definition at line 41 of file NViewMatchingAlgorithm.cc.

Here is the caller graph for this function:

◆ UpdateUponDeletion()

template<typename T >

void lar_content::NViewMatchingAlgorithm< T >::UpdateUponDeletion ( const pandora::Cluster *const pDeletedCluster )

virtual

Update to reflect cluster deletion.

Parameters

pDeletedCluster address of the deleted cluster

Implements lar_content::MatchingBaseAlgorithm.

Reimplemented in lar_content::ThreeViewShowersAlgorithm, lar_content::NViewTrackMatchingAlgorithm< T >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< FragmentOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< LongitudinalOverlapResult > >, lar_content::NViewTrackMatchingAlgorithm< ThreeViewMatchingControl< TransverseOverlapResult > >, and lar_content::NViewTrackMatchingAlgorithm< TwoViewMatchingControl< TwoViewTransverseOverlapResult > >.

Definition at line 49 of file NViewMatchingAlgorithm.cc.

Here is the caller graph for this function:

Member Data Documentation

◆ m_instanceName

std::string pandora::Process::m_instanceName

protectedinherited

The process instance name.

Definition at line 89 of file Process.h.

◆ m_matchingControl

template<typename T >

MatchingType lar_content::NViewMatchingAlgorithm< T >::m_matchingControl

protected

The matching control.

Definition at line 53 of file NViewMatchingAlgorithm.h.

◆ m_outputPfoListName

std::string lar_content::MatchingBaseAlgorithm::m_outputPfoListName

privateinherited

The output pfo list name.

Definition at line 181 of file MatchingBaseAlgorithm.h.

◆ m_pPandora

const Pandora* pandora::Process::m_pPandora

protectedinherited

The pandora object that will run the process.

Definition at line 87 of file Process.h.

◆ m_type

std::string pandora::Process::m_type

protectedinherited

The process type.

Definition at line 88 of file Process.h.

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

LArContent/larpandoracontent/LArThreeDReco/LArThreeDBase/NViewMatchingAlgorithm.h
LArContent/larpandoracontent/LArThreeDReco/LArThreeDBase/NViewMatchingAlgorithm.cc

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ MatchingType

Constructor & Destructor Documentation

◆ NViewMatchingAlgorithm()

◆ ~NViewMatchingAlgorithm()

Member Function Documentation

◆ CalculateOverlapResult()

◆ CreateThreeDParticles()

◆ ExamineOverlapContainer()

◆ GetClusterListName()

◆ GetInputClusterList()

◆ GetInstanceName()

◆ GetMatchingControl()

◆ GetPandora()

◆ GetSelectedClusterList()

◆ GetType()

◆ Initialize()

◆ MakeClusterMerges()

◆ PerformMainLoop()

◆ PrepareAllInputClusters()

◆ PrepareInputClusters()

◆ ReadSettings()

◆ RegisterDetails()

◆ Reset()

◆ Run()

◆ SelectAllInputClusters()

◆ SelectInputClusters()

◆ SetPfoParameters()

◆ SetPfoParticleId()

◆ TidyUp()

◆ UpdateForNewCluster()

◆ UpdateUponDeletion()

Member Data Documentation

◆ m_instanceName

◆ m_matchingControl

◆ m_outputPfoListName

◆ m_pPandora

◆ m_type