TrackRefinementBaseAlgorithm class. More...

#include "TrackRefinementBaseAlgorithm.h"

Inheritance diagram for lar_content::TrackRefinementBaseAlgorithm:

[legend]

Collaboration diagram for lar_content::TrackRefinementBaseAlgorithm:

[legend]

Classes
class	SortByDistanceAlongLine
	SortByDistanceAlongLine class. More...

Public Member Functions
	TrackRefinementBaseAlgorithm ()
	Default constructor.

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 Types
typedef std::pair< TwoDSlidingFitResultMap , TwoDSlidingFitResultMap >	SlidingFitResultMapPair

typedef std::unordered_map< const pandora::Cluster *, pandora::CaloHitList >	ClusterToCaloHitListMap

Protected Member Functions
virtual pandora::StatusCode	Run ()=0
	Run the algorithm.

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

template<typename T >
void	InitialiseContainers (const pandora::ClusterList *pClusterList, const T sortFunction, pandora::ClusterVector &clusterVector, SlidingFitResultMapPair &slidingFitResultMapPair) const
	Fill the cluster vector and sliding fit maps with clusters that are determined to be track-like.

bool	GetClusterMergingCoordinates (const TwoDSlidingFitResult &clusterMicroFitResult, const TwoDSlidingFitResult &clusterMacroFitResult, const TwoDSlidingFitResult &associatedMacroFitResult, const bool isEndUpstream, pandora::CartesianVector &clusterMergePosition, pandora::CartesianVector &clusterMergeDirection) const
	Get the merging coordinate and direction for an input cluster with respect to an associated cluster.

void	GetHitsInBoundingBox (const pandora::CartesianVector &firstCorner, const pandora::CartesianVector &secondCorner, const pandora::ClusterList *const pClusterList, ClusterToCaloHitListMap &clusterToCaloHitListMap, const pandora::ClusterList &unavailableProtectedClusters=pandora::ClusterList(), const float distanceToLine=-1.f) const
	Find the unprotected hits that are contained within a defined box with the option to apply a cut on the distance to the connecting line.

bool	IsInBoundingBox (const float minX, const float maxX, const float minZ, const float maxZ, const pandora::CartesianVector &hitPosition) const
	check whether a hit is contained within a defined square region

bool	IsCloseToLine (const pandora::CartesianVector &hitPosition, const pandora::CartesianVector &lineStart, const pandora::CartesianVector &lineDirection, const float distanceToLine) const
	Check whether a hit is close to a line.

bool	AreExtrapolatedHitsGood (const ClusterToCaloHitListMap &clusterToCaloHitListMap, ClusterAssociation &clusterAssociation) const
	Perform topological checks on the collected hits to ensure no gaps are present.

virtual bool	AreExtrapolatedHitsNearBoundaries (const pandora::CaloHitVector &extrapolatedHitVector, ClusterAssociation &clusterAssociation) const =0
	Check the separation of the extremal extrapolated hits with the expected endpoints or, in the case of no hits, the clusterMergePoint themselves.

bool	IsNearBoundary (const pandora::CaloHit *const pCaloHit, const pandora::CartesianVector &boundaryPosition2D, const float boundaryTolerance) const
	Check whether a hit is close to a boundary point.

bool	IsTrackContinuous (const ClusterAssociation &clusterAssociation, const pandora::CaloHitVector &extrapolatedCaloHitVector) const
	Check whether the extrapolatedCaloHitVector contains a continuous line of hits between the cluster merge points.

void	GetTrackSegmentBoundaries (const ClusterAssociation &clusterAssociation, pandora::CartesianPointVector &trackSegmentBoundaries) const
	Obtain the segment boundaries of the connecting line to test whether extrapolated hits are continuous.

void	RepositionIfInGap (const pandora::CartesianVector &mergeDirection, pandora::CartesianVector &trackPoint) const
	Move an input position to the higher line gap edge if it lies within a gap.

float	DistanceInGap (const pandora::CartesianVector &upstreamPoint, const pandora::CartesianVector &downstreamPoint, const pandora::CartesianVector &connectingLine, pandora::DetectorGapList &consideredGaps) const
	Calculate the track length between two points that lies in gaps.

bool	IsInLineSegment (const pandora::CartesianVector &lowerBoundary, const pandora::CartesianVector &upperBoundary, const pandora::CartesianVector &point) const
	Whether a position falls within a specified segment of the cluster connecting line.

const pandora::Cluster *	RemoveOffAxisHitsFromTrack (const pandora::Cluster *const pCluster, const pandora::CartesianVector &splitPosition, const bool isEndUpstream, const ClusterToCaloHitListMap &clusterToCaloHitListMap, pandora::ClusterList &remnantClusterList, TwoDSlidingFitResultMap &microSlidingFitResultMap, TwoDSlidingFitResultMap &macroSlidingFitResultMap) const
	Remove any hits in the upstream/downstream cluster that lie off of the main track axis (i.e. clustering errors)

void	AddHitsToMainTrack (const pandora::Cluster const pMainTrackCluster, const pandora::Cluster const pShowerTrackCluster, const pandora::CaloHitList &caloHitsToMerge, const ClusterAssociation &clusterAssociation, pandora::ClusterList &remnantClusterList) const
	Remove the hits from a shower cluster that belong to the main track and add them into the main track cluster.

void	ProcessRemnantClusters (const pandora::ClusterList &remnantClusterList, const pandora::Cluster const pMainTrackCluster, const pandora::ClusterList const pClusterList, pandora::ClusterList &createdClusters) const
	Process the remnant clusters separating those that stradle the main track.

bool	AddToNearestCluster (const pandora::Cluster const pClusterToMerge, const pandora::Cluster const pMainTrackCluster, const pandora::ClusterList *const pClusterList) const
	Add a cluster to the nearest cluster satisfying separation distance thresholds.

bool	IsClusterRemnantDisconnected (const pandora::Cluster *const pRemnantCluster) const
	Whether a remnant cluster is considered to be disconnected and therefore should undergo further fragmentation.

void	FragmentRemnantCluster (const pandora::Cluster *const pRemnantCluster, pandora::ClusterList &fragmentedClusterList) const
	Fragment a cluster using simple hit separation logic.

template<typename T >
void	UpdateContainers (const pandora::ClusterList &clustersToAdd, const pandora::ClusterList &clustersToDelete, const T sortFunction, pandora::ClusterVector &clusterVector, SlidingFitResultMapPair &slidingFitResultMapPair) const
	Remove deleted clusters from the cluster vector and sliding fit maps and add in created clusters that are determined to be track-like.

void	RemoveClusterFromContainers (const pandora::Cluster *const pClustertoRemove, pandora::ClusterVector &clusterVector, SlidingFitResultMapPair &slidingFitResultMapPair) const
	Remove a cluster from the cluster vector and sliding fit maps.

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
float	m_minClusterLength
	The minimum length of a considered cluster.

unsigned int	m_microSlidingFitWindow
	The sliding fit window used in the fits contained within the microSlidingFitResultMap.

unsigned int	m_macroSlidingFitWindow
	The sliding fit window used in the fits contained within the macroSlidingFitResultMap.

float	m_stableRegionClusterFraction
	The threshold fraction of fit contributing layers which defines the stable region.

float	m_mergePointMinCosAngleDeviation
	The threshold cos opening angle between the cluster local gradient and the associated cluster global gradient used to determine merge points.

float	m_minHitFractionForHitRemoval
	The threshold fraction of hits to be removed from the cluster for hit removal to proceed.

float	m_maxDistanceFromMainTrack
	The threshold distance for a hit to be added to the main track.

float	m_maxHitDistanceFromCluster
	The threshold separation between a hit and cluster for the hit to be merged into the cluster.

float	m_maxHitSeparationForConnectedCluster
	The maximum separation between two adjacent (in z) hits in a connected cluster.

unsigned int	m_maxTrackGaps
	The maximum number of graps allowed in the extrapolated hit vector.

float	m_lineSegmentLength
	The length of a track gap.

bool	m_hitWidthMode
	Whether to consider the width of hits.

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.

Detailed Description

TrackRefinementBaseAlgorithm class.

Definition at line 21 of file TrackRefinementBaseAlgorithm.h.

Member Typedef Documentation

◆ ClusterToCaloHitListMap

typedef std::unordered_map<const pandora::Cluster *, pandora::CaloHitList> lar_content::TrackRefinementBaseAlgorithm::ClusterToCaloHitListMap

protected

Definition at line 31 of file TrackRefinementBaseAlgorithm.h.

◆ SlidingFitResultMapPair

typedef std::pair<TwoDSlidingFitResultMap *, TwoDSlidingFitResultMap *> lar_content::TrackRefinementBaseAlgorithm::SlidingFitResultMapPair

protected

Definition at line 30 of file TrackRefinementBaseAlgorithm.h.

Constructor & Destructor Documentation

◆ TrackRefinementBaseAlgorithm()

lar_content::TrackRefinementBaseAlgorithm::TrackRefinementBaseAlgorithm ( )

Default constructor.

Definition at line 21 of file TrackRefinementBaseAlgorithm.cc.

Member Function Documentation

◆ AddHitsToMainTrack()

void lar_content::TrackRefinementBaseAlgorithm::AddHitsToMainTrack	(	const pandora::Cluster *const	pMainTrackCluster,
		const pandora::Cluster *const	pShowerTrackCluster,
		const pandora::CaloHitList &	caloHitsToMerge,
		const ClusterAssociation &	clusterAssociation,
		pandora::ClusterList &	remnantClusterList
	)		const

protected

Remove the hits from a shower cluster that belong to the main track and add them into the main track cluster.

Parameters

pMainTrackCluster	the main track cluster
pShowerCluster	the input shower cluster
caloHitsToMerge	the list of calo hits to remove from the shower cluster
clusterAssociation	the clusterAssociation
remnantClusterList	the input list to store the remnant clusters

Definition at line 573 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ AddToNearestCluster()

bool lar_content::TrackRefinementBaseAlgorithm::AddToNearestCluster	(	const pandora::Cluster *const	pClusterToMerge,
		const pandora::Cluster *const	pMainTrackCluster,
		const pandora::ClusterList *const	pClusterList
	)		const

protected

Add a cluster to the nearest cluster satisfying separation distance thresholds.

Parameters

pClusterToMerge	the cluster to merge
pMainTrackCluster	the main track cluster
pClusterList	the list of all clusters

Returns: whether cluster was added to a nearby cluster

Definition at line 668 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ AreExtrapolatedHitsGood()

bool lar_content::TrackRefinementBaseAlgorithm::AreExtrapolatedHitsGood	(	const ClusterToCaloHitListMap &	clusterToCaloHitListMap,
		ClusterAssociation &	clusterAssociation
	)		const

protected

Perform topological checks on the collected hits to ensure no gaps are present.

Parameters

clusterToCaloHitListMap	the input map [parent cluster -> list of hits which belong to the main track]
clusterAssociation	the clusterAssociation

Returns: whether the checks pass

Definition at line 188 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ AreExtrapolatedHitsNearBoundaries()

virtual bool lar_content::TrackRefinementBaseAlgorithm::AreExtrapolatedHitsNearBoundaries	(	const pandora::CaloHitVector &	extrapolatedHitVector,
		ClusterAssociation &	clusterAssociation
	)		const

protectedpure virtual

Check the separation of the extremal extrapolated hits with the expected endpoints or, in the case of no hits, the clusterMergePoint themselves.

Parameters

extrapolatedHitVector	the extrapolated hit vector (ordered closest hit to the upstream merge point -> furthest hit)
clusterAssociation	the clusterAssociation

Returns: whether the check passes

Implemented in lar_content::TrackMergeRefinementAlgorithm.

Here is the caller graph for this function:

◆ DistanceInGap()

float lar_content::TrackRefinementBaseAlgorithm::DistanceInGap	(	const pandora::CartesianVector &	upstreamPoint,
		const pandora::CartesianVector &	downstreamPoint,
		const pandora::CartesianVector &	connectingLine,
		pandora::DetectorGapList &	consideredGaps
	)		const

protected

Calculate the track length between two points that lies in gaps.

Parameters

upstreamPoint	the upstream point
downstreamPoint	the downstream point
connectingLine	the track direction
consideredGaps	the list of gaps to ignore

Definition at line 385 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ FragmentRemnantCluster()

void lar_content::TrackRefinementBaseAlgorithm::FragmentRemnantCluster	(	const pandora::Cluster *const	pRemnantCluster,
		pandora::ClusterList &	fragmentedClusterList
	)		const

protected

Fragment a cluster using simple hit separation logic.

Parameters

pRemnantCluster	the input remnant cluster to fragment
fragmentedClusterList	the input list to store the final remnant clusters

Definition at line 731 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetClusterMergingCoordinates()

bool lar_content::TrackRefinementBaseAlgorithm::GetClusterMergingCoordinates	(	const TwoDSlidingFitResult &	clusterMicroFitResult,
		const TwoDSlidingFitResult &	clusterMacroFitResult,
		const TwoDSlidingFitResult &	associatedMacroFitResult,
		const bool	isEndUpstream,
		pandora::CartesianVector &	clusterMergePosition,
		pandora::CartesianVector &	clusterMergeDirection
	)		const

protected

Get the merging coordinate and direction for an input cluster with respect to an associated cluster.

Parameters

clusterMicroFitResult	the local TwoDSlidingFitResult of the cluster
clusterMacroFitResult	the global TwoDSlidingFitResult of the cluster
associatedMacroFitReult	the global TwoDSlidingFitResult of the associated cluster
isEndUpstream	whether the sought cluster merge point is the upstream
clusterMergePosition	the merge position of the cluster
clusterMergeDirection	the merge direction of the cluster

Returns: whether it was possible to find a suitable merge position

Definition at line 69 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetHitsInBoundingBox()

void lar_content::TrackRefinementBaseAlgorithm::GetHitsInBoundingBox	(	const pandora::CartesianVector &	firstCorner,
		const pandora::CartesianVector &	secondCorner,
		const pandora::ClusterList *const	pClusterList,
		ClusterToCaloHitListMap &	clusterToCaloHitListMap,
		const pandora::ClusterList &	unavailableProtectedClusters = `pandora::ClusterList()`,
		const float	distanceToLine = `-1.f`
	)		const

protected

Find the unprotected hits that are contained within a defined box with the option to apply a cut on the distance to the connecting line.

Parameters

firstCorner	the position of one corner
secondCorner	the position of the opposite corner
pClusterList	the list of all clusters
clusterToCaloHitListMap	the output map [parent cluster -> list of hits which belong to the main track]
unavailableProtectedClusters	the list of clusters whose hits are protected
distanceToLine	the maximum perpendicular distance of a collected hit from the connecting line

Definition at line 130 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

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.

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

◆ GetTrackSegmentBoundaries()

void lar_content::TrackRefinementBaseAlgorithm::GetTrackSegmentBoundaries	(	const ClusterAssociation &	clusterAssociation,
		pandora::CartesianPointVector &	trackSegmentBoundaries
	)		const

protected

Obtain the segment boundaries of the connecting line to test whether extrapolated hits are continuous.

Parameters

clusterAssociation	the clusterAssociation
trackSegmentBoundaries	the output vector of segment boundaries

Definition at line 275 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

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.

◆ InitialiseContainers()

template<typename T >

template void lar_content::TrackRefinementBaseAlgorithm::InitialiseContainers< SortFunction >	(	const pandora::ClusterList *	pClusterList,
		const T	sortFunction,
		pandora::ClusterVector &	clusterVector,
		SlidingFitResultMapPair &	slidingFitResultMapPair
	)		const

protected

Fill the cluster vector and sliding fit maps with clusters that are determined to be track-like.

Parameters

pClusterList	the list of input clusters
sortFunction	the sort class or function used to sort the clusterVector
clusterVector	the input vector to store clusters considered within the algorithm
slidingFitResultMapPair	the {micro, macro} pair of [cluster -> TwoDSlidingFitResult] maps

Definition at line 40 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

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

◆ IsCloseToLine()

bool lar_content::TrackRefinementBaseAlgorithm::IsCloseToLine	(	const pandora::CartesianVector &	hitPosition,
		const pandora::CartesianVector &	lineStart,
		const pandora::CartesianVector &	lineDirection,
		const float	distanceToLine
	)		const

protected

Check whether a hit is close to a line.

Parameters

hitPosition	the position of the hit
lineStart	the start point of the line (can actually be any point on the line)
lineDirection	the unit vector of the line direction
distanceToLine	the definition of 'close'

Returns: whether the hit is close to the line

Definition at line 178 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsClusterRemnantDisconnected()

bool lar_content::TrackRefinementBaseAlgorithm::IsClusterRemnantDisconnected ( const pandora::Cluster *const pRemnantCluster ) const

protected

Whether a remnant cluster is considered to be disconnected and therefore should undergo further fragmentation.

Parameters

pRemnantCluster the input remnant cluster

Returns: whether the remnant cluster is disconnected

Definition at line 702 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsInBoundingBox()

bool lar_content::TrackRefinementBaseAlgorithm::IsInBoundingBox	(	const float	minX,
		const float	maxX,
		const float	minZ,
		const float	maxZ,
		const pandora::CartesianVector &	hitPosition
	)		const

protected

check whether a hit is contained within a defined square region

Parameters

minX	the minimum x coordinate of the square region
maxX	the maximum x coordinate of the square region
minZ	the minimum z coordinate of the square region
maxZ	the maximum z coordinate of the square region
hitPosition	the position of the hit

Returns: whether the hit is contained within the square region

Definition at line 170 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsInLineSegment()

bool lar_content::TrackRefinementBaseAlgorithm::IsInLineSegment	(	const pandora::CartesianVector &	lowerBoundary,
		const pandora::CartesianVector &	upperBoundary,
		const pandora::CartesianVector &	point
	)		const

protected

Whether a position falls within a specified segment of the cluster connecting line.

Parameters

lowerBoundary	the lower boundary of the segment
upperBoundary	the upper boundary of the segment
point	the position

Returns: whether the position falls within segment

Definition at line 472 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsNearBoundary()

bool lar_content::TrackRefinementBaseAlgorithm::IsNearBoundary	(	const pandora::CaloHit *const	pCaloHit,
		const pandora::CartesianVector &	boundaryPosition2D,
		const float	boundaryTolerance
	)		const

protected

Check whether a hit is close to a boundary point.

Parameters

pCaloHit	the input calo hit
boundaryPosition2D	the position of the 2D boundary point
boundaryTolerance	the definition of close

Returns: whether the check passes

Definition at line 212 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsTrackContinuous()

bool lar_content::TrackRefinementBaseAlgorithm::IsTrackContinuous	(	const ClusterAssociation &	clusterAssociation,
		const pandora::CaloHitVector &	extrapolatedCaloHitVector
	)		const

protected

Check whether the extrapolatedCaloHitVector contains a continuous line of hits between the cluster merge points.

Parameters

clusterAssociation	the clusterAssociation
extrapolatedCaloHitVector	the vector of extrapolated calo hits

Returns: whether the calo hits are continuous

Definition at line 221 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ProcessRemnantClusters()

void lar_content::TrackRefinementBaseAlgorithm::ProcessRemnantClusters	(	const pandora::ClusterList &	remnantClusterList,
		const pandora::Cluster *const	pMainTrackCluster,
		const pandora::ClusterList *const	pClusterList,
		pandora::ClusterList &	createdClusters
	)		const

protected

Process the remnant clusters separating those that stradle the main track.

Parameters

remnantClusterList	the list of remnant clusters to process
pMainTrackCluster	the main track cluster
pClusterList	the list of all clusters
createdClusters	the input list to store the final remnant clusters

Definition at line 641 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ReadSettings()

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

protectedpure virtual

Read the algorithm settings.

Parameters

xmlHandle the relevant xml handle

Implements pandora::Process.

Implemented in lar_content::TrackMergeRefinementAlgorithm.

Definition at line 823 of file TrackRefinementBaseAlgorithm.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:

◆ RemoveClusterFromContainers()

void lar_content::TrackRefinementBaseAlgorithm::RemoveClusterFromContainers	(	const pandora::Cluster *const	pClustertoRemove,
		pandora::ClusterVector &	clusterVector,
		SlidingFitResultMapPair &	slidingFitResultMapPair
	)		const

protected

Remove a cluster from the cluster vector and sliding fit maps.

Parameters

pClustertoRemove	the clusters to remove from the containers
clusterVector	the vector to store clusters considered within the algorithm
slidingFitResultMapPair	the {micro, macro} pair of [cluster -> TwoDSlidingFitResult] maps

Definition at line 805 of file TrackRefinementBaseAlgorithm.cc.

Here is the caller graph for this function:

◆ RemoveOffAxisHitsFromTrack()

const Cluster * lar_content::TrackRefinementBaseAlgorithm::RemoveOffAxisHitsFromTrack	(	const pandora::Cluster *const	pCluster,
		const pandora::CartesianVector &	splitPosition,
		const bool	isEndUpstream,
		const ClusterToCaloHitListMap &	clusterToCaloHitListMap,
		pandora::ClusterList &	remnantClusterList,
		TwoDSlidingFitResultMap &	microSlidingFitResultMap,
		TwoDSlidingFitResultMap &	macroSlidingFitResultMap
	)		const

protected

Remove any hits in the upstream/downstream cluster that lie off of the main track axis (i.e. clustering errors)

Parameters

pCluster	the input cluster
splitPosition	the position after which hits are considered for removal
isEndUpstream	whether the upstream end is to be refined
clusterToCaloHitListMap	the map [parent cluster -> list of hits which belong to the main track]
remnantClusterList	the input list to store the remnant clusters
microSlidingFitResultMap	the mapping [cluster -> TwoDSlidingFitResult] where fits correspond to local gradients
macroSlidingFitResultMap	the mapping [cluster -> TwoDSlidingFitResult] where fits correspond to global cluster gradients

Returns: the address of the (possibly) modified cluster

Definition at line 496 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RepositionIfInGap()

void lar_content::TrackRefinementBaseAlgorithm::RepositionIfInGap	(	const pandora::CartesianVector &	mergeDirection,
		pandora::CartesianVector &	trackPoint
	)		const

protected

Move an input position to the higher line gap edge if it lies within a gap.

Parameters

mergeDirection	the direction of the track
trackPoint	the input position

Definition at line 341 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

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

virtual pandora::StatusCode lar_content::TrackRefinementBaseAlgorithm::Run ( )

protectedpure virtual

Run the algorithm.

Implements pandora::Algorithm.

Implemented in lar_content::TrackMergeRefinementAlgorithm.

◆ UpdateContainers()

template<typename T >

template void lar_content::TrackRefinementBaseAlgorithm::UpdateContainers< SortFunction >	(	const pandora::ClusterList &	clustersToAdd,
		const pandora::ClusterList &	clustersToDelete,
		const T	sortFunction,
		pandora::ClusterVector &	clusterVector,
		SlidingFitResultMapPair &	slidingFitResultMapPair
	)		const

protected

Remove deleted clusters from the cluster vector and sliding fit maps and add in created clusters that are determined to be track-like.

Parameters

clustersToAdd	the list of clusters to add to the containers
clustersToDelete	the list of clusters to remove from the containers
sortFunction	the sort class or function used to sort the clusterVector
clusterVector	the vector to store clusters considered within the algorithm
slidingFitResultMapPair	the {micro, macro} pair of [cluster -> TwoDSlidingFitResult] maps

Definition at line 793 of file TrackRefinementBaseAlgorithm.cc.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ m_hitWidthMode

bool lar_content::TrackRefinementBaseAlgorithm::m_hitWidthMode

protected

Whether to consider the width of hits.

Definition at line 318 of file TrackRefinementBaseAlgorithm.h.

◆ m_instanceName

std::string pandora::Process::m_instanceName

protectedinherited

The process instance name.

Definition at line 89 of file Process.h.

◆ m_lineSegmentLength

float lar_content::TrackRefinementBaseAlgorithm::m_lineSegmentLength

protected

The length of a track gap.

Definition at line 317 of file TrackRefinementBaseAlgorithm.h.

◆ m_macroSlidingFitWindow

unsigned int lar_content::TrackRefinementBaseAlgorithm::m_macroSlidingFitWindow

protected

The sliding fit window used in the fits contained within the macroSlidingFitResultMap.

Definition at line 309 of file TrackRefinementBaseAlgorithm.h.

◆ m_maxDistanceFromMainTrack

float lar_content::TrackRefinementBaseAlgorithm::m_maxDistanceFromMainTrack

protected

The threshold distance for a hit to be added to the main track.

Definition at line 313 of file TrackRefinementBaseAlgorithm.h.

◆ m_maxHitDistanceFromCluster

float lar_content::TrackRefinementBaseAlgorithm::m_maxHitDistanceFromCluster

protected

The threshold separation between a hit and cluster for the hit to be merged into the cluster.

Definition at line 314 of file TrackRefinementBaseAlgorithm.h.

◆ m_maxHitSeparationForConnectedCluster

float lar_content::TrackRefinementBaseAlgorithm::m_maxHitSeparationForConnectedCluster

protected

The maximum separation between two adjacent (in z) hits in a connected cluster.

Definition at line 315 of file TrackRefinementBaseAlgorithm.h.

◆ m_maxTrackGaps

unsigned int lar_content::TrackRefinementBaseAlgorithm::m_maxTrackGaps

protected

The maximum number of graps allowed in the extrapolated hit vector.

Definition at line 316 of file TrackRefinementBaseAlgorithm.h.

◆ m_mergePointMinCosAngleDeviation

float lar_content::TrackRefinementBaseAlgorithm::m_mergePointMinCosAngleDeviation

protected

The threshold cos opening angle between the cluster local gradient and the associated cluster global gradient used to determine merge points.

Definition at line 311 of file TrackRefinementBaseAlgorithm.h.

◆ m_microSlidingFitWindow

unsigned int lar_content::TrackRefinementBaseAlgorithm::m_microSlidingFitWindow

protected

The sliding fit window used in the fits contained within the microSlidingFitResultMap.

Definition at line 308 of file TrackRefinementBaseAlgorithm.h.

◆ m_minClusterLength

float lar_content::TrackRefinementBaseAlgorithm::m_minClusterLength

protected

The minimum length of a considered cluster.

Definition at line 307 of file TrackRefinementBaseAlgorithm.h.

◆ m_minHitFractionForHitRemoval

float lar_content::TrackRefinementBaseAlgorithm::m_minHitFractionForHitRemoval

protected

The threshold fraction of hits to be removed from the cluster for hit removal to proceed.

Definition at line 312 of file TrackRefinementBaseAlgorithm.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_stableRegionClusterFraction

float lar_content::TrackRefinementBaseAlgorithm::m_stableRegionClusterFraction

protected

The threshold fraction of fit contributing layers which defines the stable region.

Definition at line 310 of file TrackRefinementBaseAlgorithm.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/LArTwoDReco/LArCosmicRay/TrackRefinementBaseAlgorithm.h
LArContent/larpandoracontent/LArTwoDReco/LArCosmicRay/TrackRefinementBaseAlgorithm.cc

Classes

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ ClusterToCaloHitListMap

◆ SlidingFitResultMapPair

Constructor & Destructor Documentation

◆ TrackRefinementBaseAlgorithm()

Member Function Documentation

◆ AddHitsToMainTrack()

◆ AddToNearestCluster()

◆ AreExtrapolatedHitsGood()

◆ AreExtrapolatedHitsNearBoundaries()

◆ DistanceInGap()

◆ FragmentRemnantCluster()

◆ GetClusterMergingCoordinates()

◆ GetHitsInBoundingBox()

◆ GetInstanceName()

◆ GetPandora()

◆ GetTrackSegmentBoundaries()

◆ GetType()

◆ InitialiseContainers()

◆ Initialize()

◆ IsCloseToLine()

◆ IsClusterRemnantDisconnected()

◆ IsInBoundingBox()

◆ IsInLineSegment()

◆ IsNearBoundary()

◆ IsTrackContinuous()

◆ ProcessRemnantClusters()

◆ ReadSettings()

◆ RegisterDetails()

◆ RemoveClusterFromContainers()

◆ RemoveOffAxisHitsFromTrack()

◆ RepositionIfInGap()

◆ Reset()

◆ Run()

◆ UpdateContainers()

Member Data Documentation

◆ m_hitWidthMode

◆ m_instanceName

◆ m_lineSegmentLength

◆ m_macroSlidingFitWindow

◆ m_maxDistanceFromMainTrack

◆ m_maxHitDistanceFromCluster

◆ m_maxHitSeparationForConnectedCluster

◆ m_maxTrackGaps

◆ m_mergePointMinCosAngleDeviation

◆ m_microSlidingFitWindow

◆ m_minClusterLength

◆ m_minHitFractionForHitRemoval

◆ m_pPandora

◆ m_stableRegionClusterFraction

◆ m_type