LArSoft  v09_90_00
Liquid Argon Software toolkit - https://larsoft.org/
lar_content::SlidingConeClusterMopUpAlgorithm Class Reference

SlidingConeClusterMopUpAlgorithm class. More...

#include "SlidingConeClusterMopUpAlgorithm.h"

Inheritance diagram for lar_content::SlidingConeClusterMopUpAlgorithm:
lar_content::PfoMopUpBaseAlgorithm lar_content::MopUpBaseAlgorithm

Classes

class  ClusterMerge
 ClusterMerge class. More...
 

Public Member Functions

 SlidingConeClusterMopUpAlgorithm ()
 Default constructor. More...
 
virtual void MergeAndDeletePfos (const pandora::ParticleFlowObject *const pPfoToEnlarge, const pandora::ParticleFlowObject *const pPfoToDelete) const
 Merge and delete a pair of pfos, with a specific set of conventions for cluster merging, vertex use, etc. More...
 
template<typename T >
const std::string GetListName (const T *const pT) const
 Find the name of the list hosting a specific object. More...
 

Static Public Member Functions

static const pandora::Cluster * GetParentCluster (const pandora::ClusterList &clusterList, const pandora::HitType hitType)
 Select the parent cluster (same hit type and most hits) using a provided cluster list and hit type. More...
 

Protected Attributes

pandora::StringVector m_daughterListNames
 The list of potential daughter object list names. More...
 

Private Types

typedef std::vector< ClusterMergeClusterMergeList
 
typedef std::unordered_map< const pandora::Cluster *, const pandora::ParticleFlowObject * > ClusterToPfoMap
 
typedef std::unordered_map< const pandora::Cluster *, ClusterMergeListClusterMergeMap
 

Private Member Functions

pandora::StatusCode Run ()
 
void GetInteractionVertex (const pandora::Vertex *&pVertex) const
 Get the neutrino interaction vertex if it is available and if the algorithm is configured to do so. More...
 
void GetThreeDClusters (pandora::ClusterVector &clusters3D, ClusterToPfoMap &clusterToPfoMap) const
 Get all 3d clusters contained in the input pfo lists and a mapping from clusters to pfos. More...
 
void GetAvailableTwoDClusters (pandora::ClusterVector &availableClusters2D) const
 Get all available 2d clusters contained in the input cluster lists. More...
 
void GetClusterMergeMap (const pandora::Vertex *const pVertex, const pandora::ClusterVector &clusters3D, const pandora::ClusterVector &availableClusters2D, ClusterMergeMap &clusterMergeMap) const
 Get the cluster merge map describing all potential 3d cluster merges. More...
 
void MakeClusterMerges (const ClusterToPfoMap &clusterToPfoMap, const ClusterMergeMap &clusterMergeMap) const
 Make cluster merges based on the provided cluster merge map. More...
 
pandora::StatusCode ReadSettings (const pandora::TiXmlHandle xmlHandle)
 

Private Attributes

pandora::StringVector m_inputPfoListNames
 The input pfo list names. More...
 
bool m_useVertex
 Whether to use the interaction vertex to select useful cone directions. More...
 
unsigned int m_maxIterations
 The maximum allowed number of algorithm iterations. More...
 
unsigned int m_maxHitsToConsider3DTrack
 The maximum number of hits in a 3d track cluster to warrant inclusion in algorithm. More...
 
unsigned int m_minHitsToConsider3DShower
 The minimum number of hits in a 3d shower cluster to attempt cone fits. More...
 
unsigned int m_maxHitsToConsider2DCluster
 The maximum number of hits in a 2d cluster to allow pick-up via sliding cone fits. More...
 
unsigned int m_halfWindowLayers
 The number of layers to use for half-window of sliding fit. More...
 
unsigned int m_nConeFitLayers
 The number of layers over which to sum fitted direction to obtain cone fit. More...
 
unsigned int m_nConeFits
 The number of cone fits to perform, spread roughly uniformly along the shower length. More...
 
float m_coneLengthMultiplier
 The cone length multiplier to use when calculating bounded cluster fractions. More...
 
float m_maxConeLength
 The maximum allowed cone length to use when calculating bounded cluster fractions. More...
 
float m_coneTanHalfAngle
 The cone tan half angle to use when calculating bounded cluster fractions. More...
 
float m_coneBoundedFraction
 The minimum cluster bounded fraction for association. More...
 

Detailed Description

Member Typedef Documentation

typedef std::unordered_map<const pandora::Cluster *, ClusterMergeList> lar_content::SlidingConeClusterMopUpAlgorithm::ClusterMergeMap
private

Definition at line 109 of file SlidingConeClusterMopUpAlgorithm.h.

typedef std::unordered_map<const pandora::Cluster *, const pandora::ParticleFlowObject *> lar_content::SlidingConeClusterMopUpAlgorithm::ClusterToPfoMap
private

Definition at line 92 of file SlidingConeClusterMopUpAlgorithm.h.

Constructor & Destructor Documentation

lar_content::SlidingConeClusterMopUpAlgorithm::SlidingConeClusterMopUpAlgorithm ( )

Default constructor.

Definition at line 24 of file SlidingConeClusterMopUpAlgorithm.cc.

24  :
25  m_useVertex(true),
26  m_maxIterations(1000),
31  m_nConeFitLayers(40),
32  m_nConeFits(5),
34  m_maxConeLength(126.f),
37 {
38 }
bool m_useVertex
Whether to use the interaction vertex to select useful cone directions.
unsigned int m_nConeFits
The number of cone fits to perform, spread roughly uniformly along the shower length.
unsigned int m_maxIterations
The maximum allowed number of algorithm iterations.
unsigned int m_nConeFitLayers
The number of layers over which to sum fitted direction to obtain cone fit.
unsigned int m_maxHitsToConsider2DCluster
The maximum number of hits in a 2d cluster to allow pick-up via sliding cone fits.
TFile f
Definition: plotHisto.C:6
float m_coneLengthMultiplier
The cone length multiplier to use when calculating bounded cluster fractions.
unsigned int m_halfWindowLayers
The number of layers to use for half-window of sliding fit.
unsigned int m_minHitsToConsider3DShower
The minimum number of hits in a 3d shower cluster to attempt cone fits.
unsigned int m_maxHitsToConsider3DTrack
The maximum number of hits in a 3d track cluster to warrant inclusion in algorithm.
float m_coneBoundedFraction
The minimum cluster bounded fraction for association.
float m_coneTanHalfAngle
The cone tan half angle to use when calculating bounded cluster fractions.
float m_maxConeLength
The maximum allowed cone length to use when calculating bounded cluster fractions.

Member Function Documentation

void lar_content::SlidingConeClusterMopUpAlgorithm::GetAvailableTwoDClusters ( pandora::ClusterVector &  availableClusters2D) const
private

Get all available 2d clusters contained in the input cluster lists.

Parameters
availableClusters2Dto receive the sorted list of available 2d clusters

Definition at line 120 of file SlidingConeClusterMopUpAlgorithm.cc.

References lar_content::MopUpBaseAlgorithm::m_daughterListNames, m_maxHitsToConsider2DCluster, and lar_content::LArClusterHelper::SortByNHits().

Referenced by Run().

121 {
122  for (const std::string &clusterListName : m_daughterListNames)
123  {
124  const ClusterList *pClusterList(nullptr);
125 
126  if (STATUS_CODE_SUCCESS != PandoraContentApi::GetList(*this, clusterListName, pClusterList))
127  continue;
128 
129  for (const Cluster *const pCluster : *pClusterList)
130  {
131  if (!PandoraContentApi::IsAvailable(*this, pCluster))
132  continue;
133 
134  if (pCluster->GetNCaloHits() > m_maxHitsToConsider2DCluster)
135  continue;
136 
137  availableClusters2D.push_back(pCluster);
138  }
139  }
140 
141  std::sort(availableClusters2D.begin(), availableClusters2D.end(), LArClusterHelper::SortByNHits);
142 }
static bool SortByNHits(const pandora::Cluster *const pLhs, const pandora::Cluster *const pRhs)
Sort clusters by number of hits, then layer span, then inner layer, then position, then pulse-height.
pandora::StringVector m_daughterListNames
The list of potential daughter object list names.
unsigned int m_maxHitsToConsider2DCluster
The maximum number of hits in a 2d cluster to allow pick-up via sliding cone fits.
void lar_content::SlidingConeClusterMopUpAlgorithm::GetClusterMergeMap ( const pandora::Vertex *const  pVertex,
const pandora::ClusterVector &  clusters3D,
const pandora::ClusterVector &  availableClusters2D,
ClusterMergeMap clusterMergeMap 
) const
private

Get the cluster merge map describing all potential 3d cluster merges.

Parameters
pVertexthe neutrino interaction vertex, if available
clusters3Dthe sorted list of 3d clusters
availableClusters2Dthe sorted list of available 2d clusters
clusterMergeMapto receive the populated cluster merge map

Definition at line 146 of file SlidingConeClusterMopUpAlgorithm.cc.

References lar_content::CONE_BACKWARD_ONLY, lar_content::CONE_BOTH_DIRECTIONS, lar_content::CONE_FORWARD_ONLY, f, lar_content::SlidingConeClusterMopUpAlgorithm::ClusterMerge::GetBoundedFraction(), lar_content::LArClusterHelper::GetClusterHitType(), lar_content::ThreeDSlidingFitResult::GetGlobalMaxLayerPosition(), lar_content::ThreeDSlidingFitResult::GetGlobalMinLayerPosition(), lar_content::SlidingConeClusterMopUpAlgorithm::ClusterMerge::GetParentCluster(), lar_content::ThreeDSlidingConeFitResult::GetSimpleConeList(), lar_content::ThreeDSlidingConeFitResult::GetSlidingFitResult(), lar_content::LArGeometryHelper::GetWirePitch(), m_coneBoundedFraction, m_coneLengthMultiplier, m_coneTanHalfAngle, m_halfWindowLayers, m_maxConeLength, m_nConeFitLayers, m_nConeFits, and lar_content::LArGeometryHelper::ProjectPosition().

Referenced by Run().

148 {
149  for (const Cluster *const pShowerCluster : clusters3D)
150  {
151  float coneLength3D(0.f);
152  SimpleConeList simpleConeList3D;
153 
154  try
155  {
156  HitType view{LArClusterHelper::GetClusterHitType(pShowerCluster)};
157  if (!(view == TPC_VIEW_U || view == TPC_VIEW_V))
158  view = TPC_VIEW_W;
159  const float layerPitch(LArGeometryHelper::GetWirePitch(this->GetPandora(), view));
160  const ThreeDSlidingConeFitResult slidingConeFitResult3D(pShowerCluster, m_halfWindowLayers, layerPitch);
161 
162  const CartesianVector &minLayerPosition(slidingConeFitResult3D.GetSlidingFitResult().GetGlobalMinLayerPosition());
163  const CartesianVector &maxLayerPosition(slidingConeFitResult3D.GetSlidingFitResult().GetGlobalMaxLayerPosition());
164  coneLength3D = std::min(m_coneLengthMultiplier * (maxLayerPosition - minLayerPosition).GetMagnitude(), m_maxConeLength);
165 
166  const float vertexToMinLayer(!pVertex ? 0.f : (pVertex->GetPosition() - minLayerPosition).GetMagnitude());
167  const float vertexToMaxLayer(!pVertex ? 0.f : (pVertex->GetPosition() - maxLayerPosition).GetMagnitude());
168  const ConeSelection coneSelection(!pVertex ? CONE_BOTH_DIRECTIONS
169  : (vertexToMaxLayer > vertexToMinLayer) ? CONE_FORWARD_ONLY
171 
172  slidingConeFitResult3D.GetSimpleConeList(m_nConeFitLayers, m_nConeFits, coneSelection, simpleConeList3D);
173  }
174  catch (const StatusCodeException &)
175  {
176  continue;
177  }
178 
179  for (const Cluster *const pNearbyCluster2D : availableClusters2D)
180  {
181  ClusterMerge bestClusterMerge(nullptr, 0.f, 0.f);
182  const HitType hitType(LArClusterHelper::GetClusterHitType(pNearbyCluster2D));
183 
184  for (const SimpleCone &simpleCone3D : simpleConeList3D)
185  {
186  const CartesianVector coneBaseCentre3D(simpleCone3D.GetConeApex() + simpleCone3D.GetConeDirection() * coneLength3D);
187  const CartesianVector coneApex2D(LArGeometryHelper::ProjectPosition(this->GetPandora(), simpleCone3D.GetConeApex(), hitType));
188  const CartesianVector coneBaseCentre2D(LArGeometryHelper::ProjectPosition(this->GetPandora(), coneBaseCentre3D, hitType));
189 
190  const CartesianVector apexToBase2D(coneBaseCentre2D - coneApex2D);
191  const SimpleCone simpleCone2D(coneApex2D, apexToBase2D.GetUnitVector(), apexToBase2D.GetMagnitude(), m_coneTanHalfAngle);
192  const ClusterMerge clusterMerge(
193  pShowerCluster, simpleCone2D.GetBoundedHitFraction(pNearbyCluster2D), simpleCone2D.GetMeanRT(pNearbyCluster2D));
194 
195  if (clusterMerge < bestClusterMerge)
196  bestClusterMerge = clusterMerge;
197  }
198 
199  if (bestClusterMerge.GetParentCluster() && (bestClusterMerge.GetBoundedFraction() > m_coneBoundedFraction))
200  clusterMergeMap[pNearbyCluster2D].push_back(bestClusterMerge);
201  }
202  }
203 
204  for (ClusterMergeMap::value_type &mapEntry : clusterMergeMap)
205  std::sort(mapEntry.second.begin(), mapEntry.second.end());
206 }
unsigned int m_nConeFits
The number of cone fits to perform, spread roughly uniformly along the shower length.
std::vector< SimpleCone > SimpleConeList
static pandora::CartesianVector ProjectPosition(const pandora::Pandora &pandora, const pandora::CartesianVector &position3D, const pandora::HitType view)
Project 3D position into a given 2D view.
unsigned int m_nConeFitLayers
The number of layers over which to sum fitted direction to obtain cone fit.
static pandora::HitType GetClusterHitType(const pandora::Cluster *const pCluster)
Get the hit type associated with a two dimensional cluster.
TFile f
Definition: plotHisto.C:6
float m_coneLengthMultiplier
The cone length multiplier to use when calculating bounded cluster fractions.
unsigned int m_halfWindowLayers
The number of layers to use for half-window of sliding fit.
static float GetWirePitch(const pandora::Pandora &pandora, const pandora::HitType view, const float maxWirePitchDiscrepancy=0.01)
Return the wire pitch.
float m_coneBoundedFraction
The minimum cluster bounded fraction for association.
HitType
Definition: HitType.h:12
float m_coneTanHalfAngle
The cone tan half angle to use when calculating bounded cluster fractions.
ConeSelection
ConeSelection enum.
float m_maxConeLength
The maximum allowed cone length to use when calculating bounded cluster fractions.
void lar_content::SlidingConeClusterMopUpAlgorithm::GetInteractionVertex ( const pandora::Vertex *&  pVertex) const
private

Get the neutrino interaction vertex if it is available and if the algorithm is configured to do so.

Parameters
pVertexto receive the neutrino interaction vertex

Definition at line 71 of file SlidingConeClusterMopUpAlgorithm.cc.

References m_useVertex.

Referenced by Run().

72 {
73  if (!m_useVertex)
74  return;
75 
76  const VertexList *pVertexList = nullptr;
77  PANDORA_THROW_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_INITIALIZED, !=, PandoraContentApi::GetCurrentList(*this, pVertexList));
78 
79  pVertex =
80  ((pVertexList && (pVertexList->size() == 1) && (VERTEX_3D == (*(pVertexList->begin()))->GetVertexType())) ? *(pVertexList->begin()) : nullptr);
81 }
bool m_useVertex
Whether to use the interaction vertex to select useful cone directions.
std::list< Vertex > VertexList
Definition: DCEL.h:169
template<typename T >
template const std::string lar_content::MopUpBaseAlgorithm::GetListName ( const T *const  pT) const
inherited

Find the name of the list hosting a specific object.

Parameters
pTthe address of the object
Returns
the name of the list

Definition at line 19 of file MopUpBaseAlgorithm.cc.

Referenced by lar_content::IsolatedClusterMopUpAlgorithm::DissolveClustersToHits(), lar_content::ClusterMopUpBaseAlgorithm::MakeClusterMerges(), and MakeClusterMerges().

20 {
21  std::string currentListName;
22  const MANAGED_CONTAINER<const T *> *pCurrentList(nullptr);
23  (void)PandoraContentApi::GetCurrentList(*this, pCurrentList, currentListName);
24 
25  if (pCurrentList && (pCurrentList->end() != std::find(pCurrentList->begin(), pCurrentList->end(), pT)))
26  return currentListName;
27 
28  for (const std::string &listName : m_daughterListNames)
29  {
30  const MANAGED_CONTAINER<const T *> *pList(nullptr);
31  (void)PandoraContentApi::GetList(*this, listName, pList);
32 
33  if (pList && (pList->end() != std::find(pList->begin(), pList->end(), pT)))
34  return listName;
35  }
36 
37  throw StatusCodeException(STATUS_CODE_NOT_FOUND);
38 }
pandora::StringVector m_daughterListNames
The list of potential daughter object list names.
const Cluster * lar_content::PfoMopUpBaseAlgorithm::GetParentCluster ( const pandora::ClusterList &  clusterList,
const pandora::HitType  hitType 
)
staticinherited

Select the parent cluster (same hit type and most hits) using a provided cluster list and hit type.

Parameters
clusterListthe cluster list
hitTypethe hit type
Returns
the address of the parent cluster

Definition at line 61 of file PfoMopUpBaseAlgorithm.cc.

Referenced by MakeClusterMerges(), lar_content::SlidingConeClusterMopUpAlgorithm::ClusterMerge::operator<(), lar_content::SlidingConePfoMopUpAlgorithm::ClusterMerge::operator<(), and lar_content::MasterAlgorithm::StitchPfos().

62 {
63  unsigned int mostHits(0);
64  const Cluster *pBestParentCluster(nullptr);
65 
66  for (const Cluster *const pParentCluster : clusterList)
67  {
68  if (hitType != LArClusterHelper::GetClusterHitType(pParentCluster))
69  continue;
70 
71  const unsigned int nParentHits(pParentCluster->GetNCaloHits());
72 
73  if (nParentHits > mostHits)
74  {
75  mostHits = nParentHits;
76  pBestParentCluster = pParentCluster;
77  }
78  }
79 
80  return pBestParentCluster;
81 }
static pandora::HitType GetClusterHitType(const pandora::Cluster *const pCluster)
Get the hit type associated with a two dimensional cluster.
void lar_content::SlidingConeClusterMopUpAlgorithm::GetThreeDClusters ( pandora::ClusterVector &  clusters3D,
ClusterToPfoMap clusterToPfoMap 
) const
private

Get all 3d clusters contained in the input pfo lists and a mapping from clusters to pfos.

Parameters
clusters3Dto receive the sorted list of 3d clusters
clusterToPfoMapto receive the mapping from 3d cluster to pfo

Definition at line 85 of file SlidingConeClusterMopUpAlgorithm.cc.

References lar_content::LArPfoHelper::GetThreeDClusterList(), lar_content::LArPfoHelper::IsShower(), lar_content::LArPfoHelper::IsTrack(), m_inputPfoListNames, m_maxHitsToConsider3DTrack, m_minHitsToConsider3DShower, and lar_content::LArClusterHelper::SortByNHits().

Referenced by Run().

86 {
87  for (const std::string &pfoListName : m_inputPfoListNames)
88  {
89  const PfoList *pPfoList(nullptr);
90 
91  if (STATUS_CODE_SUCCESS != PandoraContentApi::GetList(*this, pfoListName, pPfoList))
92  continue;
93 
94  for (const Pfo *const pPfo : *pPfoList)
95  {
96  ClusterList pfoClusters3D;
97  LArPfoHelper::GetThreeDClusterList(pPfo, pfoClusters3D);
98 
99  for (const Cluster *const pCluster3D : pfoClusters3D)
100  {
101  if (LArPfoHelper::IsTrack(pPfo) && (pCluster3D->GetNCaloHits() > m_maxHitsToConsider3DTrack))
102  continue;
103 
104  if (LArPfoHelper::IsShower(pPfo) && (pCluster3D->GetNCaloHits() < m_minHitsToConsider3DShower))
105  continue;
106 
107  if (!clusterToPfoMap.insert(ClusterToPfoMap::value_type(pCluster3D, pPfo)).second)
108  throw StatusCodeException(STATUS_CODE_ALREADY_PRESENT);
109 
110  clusters3D.push_back(pCluster3D);
111  }
112  }
113  }
114 
115  std::sort(clusters3D.begin(), clusters3D.end(), LArClusterHelper::SortByNHits);
116 }
static bool SortByNHits(const pandora::Cluster *const pLhs, const pandora::Cluster *const pRhs)
Sort clusters by number of hits, then layer span, then inner layer, then position, then pulse-height.
static bool IsTrack(const pandora::ParticleFlowObject *const pPfo)
Return track flag based on Pfo Particle ID.
static bool IsShower(const pandora::ParticleFlowObject *const pPfo)
Return shower flag based on Pfo Particle ID.
unsigned int m_minHitsToConsider3DShower
The minimum number of hits in a 3d shower cluster to attempt cone fits.
unsigned int m_maxHitsToConsider3DTrack
The maximum number of hits in a 3d track cluster to warrant inclusion in algorithm.
static void GetThreeDClusterList(const pandora::ParticleFlowObject *const pPfo, pandora::ClusterList &clusterList)
Get the list of 3D clusters from an input pfo.
pandora::StringVector m_inputPfoListNames
The input pfo list names.
void lar_content::SlidingConeClusterMopUpAlgorithm::MakeClusterMerges ( const ClusterToPfoMap clusterToPfoMap,
const ClusterMergeMap clusterMergeMap 
) const
private

Make cluster merges based on the provided cluster merge map.

Parameters
clusterToPfoMapthe mapping from 3d cluster to pfo
clusterMergeMapthe populated cluster merge map

Definition at line 210 of file SlidingConeClusterMopUpAlgorithm.cc.

References lar_content::LArClusterHelper::GetClusterHitType(), lar_content::MopUpBaseAlgorithm::GetListName(), lar_content::PfoMopUpBaseAlgorithm::GetParentCluster(), and lar_content::LArClusterHelper::SortByNHits().

Referenced by Run().

211 {
212  ClusterVector daughterClusters;
213  for (const ClusterMergeMap::value_type &mapEntry : clusterMergeMap)
214  daughterClusters.push_back(mapEntry.first);
215  std::sort(daughterClusters.begin(), daughterClusters.end(), LArClusterHelper::SortByNHits);
216 
217  for (ClusterVector::const_reverse_iterator rIter = daughterClusters.rbegin(), rIterEnd = daughterClusters.rend(); rIter != rIterEnd; ++rIter)
218  {
219  const Cluster *const pDaughterCluster(*rIter);
220  const HitType daughterHitType(LArClusterHelper::GetClusterHitType(pDaughterCluster));
221  const Cluster *const pParentCluster3D(clusterMergeMap.at(pDaughterCluster).at(0).GetParentCluster());
222 
223  const Pfo *const pParentPfo(clusterToPfoMap.at(pParentCluster3D));
224  const Cluster *const pParentCluster(this->GetParentCluster(pParentPfo->GetClusterList(), daughterHitType));
225 
226  if (pParentCluster)
227  {
228  PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=,
229  PandoraContentApi::MergeAndDeleteClusters(
230  *this, pParentCluster, pDaughterCluster, this->GetListName(pParentCluster), this->GetListName(pDaughterCluster)));
231  }
232  else
233  {
234  PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=, PandoraContentApi::AddToPfo(*this, pParentPfo, pDaughterCluster));
235  }
236  }
237 }
static bool SortByNHits(const pandora::Cluster *const pLhs, const pandora::Cluster *const pRhs)
Sort clusters by number of hits, then layer span, then inner layer, then position, then pulse-height.
static pandora::HitType GetClusterHitType(const pandora::Cluster *const pCluster)
Get the hit type associated with a two dimensional cluster.
const std::string GetListName(const T *const pT) const
Find the name of the list hosting a specific object.
static const pandora::Cluster * GetParentCluster(const pandora::ClusterList &clusterList, const pandora::HitType hitType)
Select the parent cluster (same hit type and most hits) using a provided cluster list and hit type...
HitType
Definition: HitType.h:12
std::vector< art::Ptr< recob::Cluster > > ClusterVector
void lar_content::PfoMopUpBaseAlgorithm::MergeAndDeletePfos ( const pandora::ParticleFlowObject *const  pPfoToEnlarge,
const pandora::ParticleFlowObject *const  pPfoToDelete 
) const
virtualinherited

Merge and delete a pair of pfos, with a specific set of conventions for cluster merging, vertex use, etc.

Parameters
pPfoToEnlargethe address of the pfo to enlarge
pPfoToDeletethe address of the pfo to delete (will become a dangling pointer)

Definition at line 20 of file PfoMopUpBaseAlgorithm.cc.

Referenced by lar_content::SlidingConePfoMopUpAlgorithm::MakePfoMerges(), and lar_content::VertexBasedPfoMopUpAlgorithm::MergePfos().

21 {
22  if (pPfoToEnlarge == pPfoToDelete)
23  throw StatusCodeException(STATUS_CODE_NOT_ALLOWED);
24 
25  const PfoList daughterPfos(pPfoToDelete->GetDaughterPfoList());
26  const ClusterVector daughterClusters(pPfoToDelete->GetClusterList().begin(), pPfoToDelete->GetClusterList().end());
27  const VertexVector daughterVertices(pPfoToDelete->GetVertexList().begin(), pPfoToDelete->GetVertexList().end());
28 
29  PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=, PandoraContentApi::Delete(*this, pPfoToDelete, this->GetListName(pPfoToDelete)));
30 
31  for (const ParticleFlowObject *const pDaughterPfo : daughterPfos)
32  {
33  PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=, PandoraContentApi::SetPfoParentDaughterRelationship(*this, pPfoToEnlarge, pDaughterPfo));
34  }
35 
36  for (const Vertex *const pDaughterVertex : daughterVertices)
37  {
38  PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=, PandoraContentApi::Delete(*this, pDaughterVertex, this->GetListName(pDaughterVertex)));
39  }
40 
41  for (const Cluster *const pDaughterCluster : daughterClusters)
42  {
43  const HitType daughterHitType(LArClusterHelper::GetClusterHitType(pDaughterCluster));
44  const Cluster *pParentCluster(PfoMopUpBaseAlgorithm::GetParentCluster(pPfoToEnlarge->GetClusterList(), daughterHitType));
45 
46  if (pParentCluster)
47  {
48  PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=,
49  PandoraContentApi::MergeAndDeleteClusters(
50  *this, pParentCluster, pDaughterCluster, this->GetListName(pParentCluster), this->GetListName(pDaughterCluster)));
51  }
52  else
53  {
54  PANDORA_THROW_RESULT_IF(STATUS_CODE_SUCCESS, !=, PandoraContentApi::AddToPfo(*this, pPfoToEnlarge, pDaughterCluster));
55  }
56  }
57 }
static pandora::HitType GetClusterHitType(const pandora::Cluster *const pCluster)
Get the hit type associated with a two dimensional cluster.
const std::string GetListName(const T *const pT) const
Find the name of the list hosting a specific object.
static const pandora::Cluster * GetParentCluster(const pandora::ClusterList &clusterList, const pandora::HitType hitType)
Select the parent cluster (same hit type and most hits) using a provided cluster list and hit type...
HitType
Definition: HitType.h:12
std::vector< art::Ptr< recob::Vertex > > VertexVector
boost::graph_traits< ModuleGraph >::vertex_descriptor Vertex
Definition: ModuleGraph.h:25
std::vector< art::Ptr< recob::Cluster > > ClusterVector
StatusCode lar_content::SlidingConeClusterMopUpAlgorithm::ReadSettings ( const pandora::TiXmlHandle  xmlHandle)
privatevirtual

Reimplemented from lar_content::PfoMopUpBaseAlgorithm.

Definition at line 265 of file SlidingConeClusterMopUpAlgorithm.cc.

References m_coneBoundedFraction, m_coneLengthMultiplier, m_coneTanHalfAngle, m_halfWindowLayers, m_inputPfoListNames, m_maxConeLength, m_maxHitsToConsider2DCluster, m_maxHitsToConsider3DTrack, m_maxIterations, m_minHitsToConsider3DShower, m_nConeFitLayers, m_nConeFits, m_useVertex, and lar_content::PfoMopUpBaseAlgorithm::ReadSettings().

266 {
267  PANDORA_RETURN_RESULT_IF_AND_IF(
268  STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadVectorOfValues(xmlHandle, "InputPfoListNames", m_inputPfoListNames));
269 
270  PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "UseVertex", m_useVertex));
271 
272  PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "MaxIterations", m_maxIterations));
273 
274  PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=,
275  XmlHelper::ReadValue(xmlHandle, "MaxHitsToConsider3DTrack", m_maxHitsToConsider3DTrack));
276 
277  PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=,
278  XmlHelper::ReadValue(xmlHandle, "MinHitsToConsider3DShower", m_minHitsToConsider3DShower));
279 
280  PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=,
281  XmlHelper::ReadValue(xmlHandle, "MaxHitsToConsider2DCluster", m_maxHitsToConsider2DCluster));
282 
283  PANDORA_RETURN_RESULT_IF_AND_IF(
284  STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "SlidingFitHalfWindow", m_halfWindowLayers));
285 
286  PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "NConeFitLayers", m_nConeFitLayers));
287 
288  PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "NConeFits", m_nConeFits));
289 
290  PANDORA_RETURN_RESULT_IF_AND_IF(
291  STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "ConeLengthMultiplier", m_coneLengthMultiplier));
292 
293  PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "MaxConeLength", m_maxConeLength));
294 
295  PANDORA_RETURN_RESULT_IF_AND_IF(
296  STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "ConeTanHalfAngle", m_coneTanHalfAngle));
297 
298  PANDORA_RETURN_RESULT_IF_AND_IF(
299  STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "ConeBoundedFraction", m_coneBoundedFraction));
300 
301  return PfoMopUpBaseAlgorithm::ReadSettings(xmlHandle);
302 }
bool m_useVertex
Whether to use the interaction vertex to select useful cone directions.
unsigned int m_nConeFits
The number of cone fits to perform, spread roughly uniformly along the shower length.
unsigned int m_maxIterations
The maximum allowed number of algorithm iterations.
unsigned int m_nConeFitLayers
The number of layers over which to sum fitted direction to obtain cone fit.
unsigned int m_maxHitsToConsider2DCluster
The maximum number of hits in a 2d cluster to allow pick-up via sliding cone fits.
float m_coneLengthMultiplier
The cone length multiplier to use when calculating bounded cluster fractions.
unsigned int m_halfWindowLayers
The number of layers to use for half-window of sliding fit.
unsigned int m_minHitsToConsider3DShower
The minimum number of hits in a 3d shower cluster to attempt cone fits.
unsigned int m_maxHitsToConsider3DTrack
The maximum number of hits in a 3d track cluster to warrant inclusion in algorithm.
virtual pandora::StatusCode ReadSettings(const pandora::TiXmlHandle xmlHandle)
float m_coneBoundedFraction
The minimum cluster bounded fraction for association.
pandora::StringVector m_inputPfoListNames
The input pfo list names.
float m_coneTanHalfAngle
The cone tan half angle to use when calculating bounded cluster fractions.
float m_maxConeLength
The maximum allowed cone length to use when calculating bounded cluster fractions.
StatusCode lar_content::SlidingConeClusterMopUpAlgorithm::Run ( )
private

Definition at line 42 of file SlidingConeClusterMopUpAlgorithm.cc.

References GetAvailableTwoDClusters(), GetClusterMergeMap(), GetInteractionVertex(), GetThreeDClusters(), m_useVertex, and MakeClusterMerges().

43 {
44  const Vertex *pVertex(nullptr);
45  this->GetInteractionVertex(pVertex);
46 
47  if (m_useVertex && !pVertex)
48  {
49  if (PandoraContentApi::GetSettings(*this)->ShouldDisplayAlgorithmInfo())
50  std::cout << "SlidingConeClusterMopUpAlgorithm - interaction vertex not available for use." << std::endl;
51  return STATUS_CODE_SUCCESS;
52  }
53 
54  ClusterVector clusters3D;
55  ClusterToPfoMap clusterToPfoMap;
56  this->GetThreeDClusters(clusters3D, clusterToPfoMap);
57 
58  ClusterVector availableClusters2D;
59  this->GetAvailableTwoDClusters(availableClusters2D);
60 
61  ClusterMergeMap clusterMergeMap;
62  this->GetClusterMergeMap(pVertex, clusters3D, availableClusters2D, clusterMergeMap);
63 
64  this->MakeClusterMerges(clusterToPfoMap, clusterMergeMap);
65 
66  return STATUS_CODE_SUCCESS;
67 }
bool m_useVertex
Whether to use the interaction vertex to select useful cone directions.
void GetThreeDClusters(pandora::ClusterVector &clusters3D, ClusterToPfoMap &clusterToPfoMap) const
Get all 3d clusters contained in the input pfo lists and a mapping from clusters to pfos...
std::unordered_map< const pandora::Cluster *, ClusterMergeList > ClusterMergeMap
void GetClusterMergeMap(const pandora::Vertex *const pVertex, const pandora::ClusterVector &clusters3D, const pandora::ClusterVector &availableClusters2D, ClusterMergeMap &clusterMergeMap) const
Get the cluster merge map describing all potential 3d cluster merges.
void MakeClusterMerges(const ClusterToPfoMap &clusterToPfoMap, const ClusterMergeMap &clusterMergeMap) const
Make cluster merges based on the provided cluster merge map.
std::unordered_map< const pandora::Cluster *, const pandora::ParticleFlowObject * > ClusterToPfoMap
void GetAvailableTwoDClusters(pandora::ClusterVector &availableClusters2D) const
Get all available 2d clusters contained in the input cluster lists.
void GetInteractionVertex(const pandora::Vertex *&pVertex) const
Get the neutrino interaction vertex if it is available and if the algorithm is configured to do so...
boost::graph_traits< ModuleGraph >::vertex_descriptor Vertex
Definition: ModuleGraph.h:25
std::vector< art::Ptr< recob::Cluster > > ClusterVector

Member Data Documentation

float lar_content::SlidingConeClusterMopUpAlgorithm::m_coneBoundedFraction
private

The minimum cluster bounded fraction for association.

Definition at line 144 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetClusterMergeMap(), and ReadSettings().

float lar_content::SlidingConeClusterMopUpAlgorithm::m_coneLengthMultiplier
private

The cone length multiplier to use when calculating bounded cluster fractions.

Definition at line 141 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetClusterMergeMap(), and ReadSettings().

float lar_content::SlidingConeClusterMopUpAlgorithm::m_coneTanHalfAngle
private

The cone tan half angle to use when calculating bounded cluster fractions.

Definition at line 143 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetClusterMergeMap(), and ReadSettings().

pandora::StringVector lar_content::MopUpBaseAlgorithm::m_daughterListNames
protectedinherited
unsigned int lar_content::SlidingConeClusterMopUpAlgorithm::m_halfWindowLayers
private

The number of layers to use for half-window of sliding fit.

Definition at line 138 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetClusterMergeMap(), and ReadSettings().

pandora::StringVector lar_content::SlidingConeClusterMopUpAlgorithm::m_inputPfoListNames
private

The input pfo list names.

Definition at line 132 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetThreeDClusters(), and ReadSettings().

float lar_content::SlidingConeClusterMopUpAlgorithm::m_maxConeLength
private

The maximum allowed cone length to use when calculating bounded cluster fractions.

Definition at line 142 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetClusterMergeMap(), and ReadSettings().

unsigned int lar_content::SlidingConeClusterMopUpAlgorithm::m_maxHitsToConsider2DCluster
private

The maximum number of hits in a 2d cluster to allow pick-up via sliding cone fits.

Definition at line 137 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetAvailableTwoDClusters(), and ReadSettings().

unsigned int lar_content::SlidingConeClusterMopUpAlgorithm::m_maxHitsToConsider3DTrack
private

The maximum number of hits in a 3d track cluster to warrant inclusion in algorithm.

Definition at line 135 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetThreeDClusters(), and ReadSettings().

unsigned int lar_content::SlidingConeClusterMopUpAlgorithm::m_maxIterations
private

The maximum allowed number of algorithm iterations.

Definition at line 134 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by ReadSettings().

unsigned int lar_content::SlidingConeClusterMopUpAlgorithm::m_minHitsToConsider3DShower
private

The minimum number of hits in a 3d shower cluster to attempt cone fits.

Definition at line 136 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetThreeDClusters(), and ReadSettings().

unsigned int lar_content::SlidingConeClusterMopUpAlgorithm::m_nConeFitLayers
private

The number of layers over which to sum fitted direction to obtain cone fit.

Definition at line 139 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetClusterMergeMap(), and ReadSettings().

unsigned int lar_content::SlidingConeClusterMopUpAlgorithm::m_nConeFits
private

The number of cone fits to perform, spread roughly uniformly along the shower length.

Definition at line 140 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetClusterMergeMap(), and ReadSettings().

bool lar_content::SlidingConeClusterMopUpAlgorithm::m_useVertex
private

Whether to use the interaction vertex to select useful cone directions.

Definition at line 133 of file SlidingConeClusterMopUpAlgorithm.h.

Referenced by GetInteractionVertex(), ReadSettings(), and Run().


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