#include "MatchingBaseAlgorithm.h"

Inheritance diagram for lar_content::MatchingBaseAlgorithm:

[legend]

Collaboration diagram for lar_content::MatchingBaseAlgorithm:

[legend]

Public Member Functions
	MatchingBaseAlgorithm ()
	Default constructor.

virtual	~MatchingBaseAlgorithm ()
	Destructor.

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

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

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

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

virtual const pandora::ClusterList &	GetSelectedClusterList (const pandora::HitType hitType) const =0
	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
virtual void	SelectAllInputClusters ()=0
	Select a subset of input clusters for processing in this algorithm.

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

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

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

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

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

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
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

MatchingBaseAlgorithm class.

Definition at line 38 of file MatchingBaseAlgorithm.h.

Constructor & Destructor Documentation

◆ MatchingBaseAlgorithm()

lar_content::MatchingBaseAlgorithm::MatchingBaseAlgorithm ( )

Default constructor.

Definition at line 20 of file MatchingBaseAlgorithm.cc.

◆ ~MatchingBaseAlgorithm()

lar_content::MatchingBaseAlgorithm::~MatchingBaseAlgorithm ( )

virtual

Destructor.

Definition at line 26 of file MatchingBaseAlgorithm.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 virtual

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 )

virtual

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 virtual

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()

virtual const std::string & lar_content::MatchingBaseAlgorithm::GetClusterListName ( const pandora::HitType hitType ) const

pure virtual

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

Parameters

hitType the hit type

Returns: the cluster list name

Here is the caller graph for this function:

◆ GetInputClusterList()

virtual const pandora::ClusterList & lar_content::MatchingBaseAlgorithm::GetInputClusterList ( const pandora::HitType hitType ) const

pure virtual

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

Parameters

hitType the hit type

Returns: the input cluster list

◆ 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.

◆ 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()

virtual const pandora::ClusterList & lar_content::MatchingBaseAlgorithm::GetSelectedClusterList ( const pandora::HitType hitType ) const

pure virtual

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

Parameters

hitType the hit type

Returns: the selected cluster list

◆ 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 )

virtual

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()

virtual void lar_content::MatchingBaseAlgorithm::PerformMainLoop ( )

protectedpure virtual

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

Here is the caller graph for this function:

◆ PrepareAllInputClusters()

virtual void lar_content::MatchingBaseAlgorithm::PrepareAllInputClusters ( )

protectedpure virtual

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

Here is the caller graph for this function:

◆ PrepareInputClusters()

void lar_content::MatchingBaseAlgorithm::PrepareInputClusters ( pandora::ClusterList & preparedClusterList )

virtual

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()

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

protectedvirtual

Read the algorithm settings.

Parameters

xmlHandle the relevant xml handle

Implements pandora::Process.

Definition at line 158 of file MatchingBaseAlgorithm.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 ( )

privatevirtual

Run the algorithm.

Implements pandora::Algorithm.

Definition at line 135 of file MatchingBaseAlgorithm.cc.

Here is the call graph for this function:

◆ SelectAllInputClusters()

virtual void lar_content::MatchingBaseAlgorithm::SelectAllInputClusters ( )

protectedpure virtual

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

Here is the caller graph for this function:

◆ SelectInputClusters()

void lar_content::MatchingBaseAlgorithm::SelectInputClusters	(	const pandora::ClusterList *const	pInputClusterList,
		pandora::ClusterList &	selectedClusterList
	)		const

virtual

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

virtual

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

virtual

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()

virtual void lar_content::MatchingBaseAlgorithm::TidyUp ( )

protectedpure virtual

Tidy member variables in derived class.

Here is the caller graph for this function:

◆ UpdateForNewCluster()

virtual void lar_content::MatchingBaseAlgorithm::UpdateForNewCluster ( const pandora::Cluster *const pNewCluster )

pure virtual

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

Parameters

pNewCluster address of the new cluster

Here is the caller graph for this function:

◆ UpdateUponDeletion()

virtual void lar_content::MatchingBaseAlgorithm::UpdateUponDeletion ( const pandora::Cluster *const pDeletedCluster )

pure virtual

Update to reflect cluster deletion.

Parameters

pDeletedCluster address of the deleted cluster

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_outputPfoListName

std::string lar_content::MatchingBaseAlgorithm::m_outputPfoListName

private

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/MatchingBaseAlgorithm.h
LArContent/larpandoracontent/LArThreeDReco/LArThreeDBase/MatchingBaseAlgorithm.cc

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ MatchingBaseAlgorithm()

◆ ~MatchingBaseAlgorithm()

Member Function Documentation

◆ CalculateOverlapResult()

◆ CreateThreeDParticles()

◆ ExamineOverlapContainer()

◆ GetClusterListName()

◆ GetInputClusterList()

◆ GetInstanceName()

◆ 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_outputPfoListName

◆ m_pPandora

◆ m_type