Node class. More...

#include <LArHierarchyHelper.h>

Public Member Functions
	Node (const RecoHierarchy &hierarchy, const pandora::ParticleFlowObject *pPfo)
	Create a node with a primary PFO. More...

	Node (const RecoHierarchy &hierarchy, const pandora::PfoList &pfoList, const pandora::CaloHitList &caloHitList)
	Create a node from a list of PFOs. More...

virtual	~Node ()
	Destructor. More...

void	FillHierarchy (const pandora::ParticleFlowObject *pRoot, const FoldingParameters &foldParameters)
	Recursively fill the hierarchy based on the criteria established for this RecoHierarchy. More...

void	FillFlat (const pandora::ParticleFlowObject *pRoot)
	Fill this node by folding all descendent particles to this node. More...

const NodeVector &	GetChildren () const
	Return the vector of children for this node. More...

const pandora::PfoList &	GetRecoParticles () const
	Retrieve the PFOs associated with this node. More...

const pandora::CaloHitList &	GetCaloHits () const
	Retrieve the CaloHits associated with this node. More...

int	GetParticleId () const
	Retrieve the PDG code for the leading particle in this node Note, for reco objects the PDG codes represent tracks (muon PDG) and showers (electron PDG) More...

const std::string	ToString (const std::string &prefix) const
	Produce a string representation of the hierarchy. More...

Private Attributes
const RecoHierarchy &	m_hierarchy
	The parent reco hierarchy. More...

pandora::PfoList	m_pfos
	The list of PFOs of which this node is composed. More...

pandora::CaloHitList	m_caloHits
	The list of calo hits of which this node is composed. More...

NodeVector	m_children
	The child nodes of this node. More...

int	m_pdg
	The particle ID (track = muon, shower = electron) More...

Detailed Description

Node class.

Definition at line 436 of file LArHierarchyHelper.h.

Constructor & Destructor Documentation

lar_content::LArHierarchyHelper::RecoHierarchy::Node::Node	(	const RecoHierarchy &	hierarchy,
		const pandora::ParticleFlowObject *	pPfo
	)

Create a node with a primary PFO.

Parameters

hierarchy	The parent hierarchy of this node
pPfo	The primary PFO with which this node should be created

Definition at line 880 of file LArHierarchyHelper.cc.

                                                                                                         :
     m_hierarchy(hierarchy),
     m_pdg{0}
 {
     if (pPfo)
     {
         m_pdg = pPfo->GetParticleId();
         m_pfos.emplace_back(pPfo);
     }
 }

lar_content::LArHierarchyHelper::RecoHierarchy::Node::Node	(	const RecoHierarchy &	hierarchy,
		const pandora::PfoList &	pfoList,
		const pandora::CaloHitList &	caloHitList
	)

Create a node from a list of PFOs.

Parameters

hierarchy	The parent hierarchy of this node
pfoList	The PFO list with which this node should be created caloHitList The CaloHit list with which this node should be created

lar_content::LArHierarchyHelper::RecoHierarchy::Node::~Node ( )

virtual

Destructor.

Definition at line 907 of file LArHierarchyHelper.cc.

 {
     m_pfos.clear();
     m_caloHits.clear();
     for (const Node *node : m_children)
         delete node;
     m_children.clear();
 }

Member Function Documentation

void lar_content::LArHierarchyHelper::RecoHierarchy::Node::FillFlat ( const pandora::ParticleFlowObject * pRoot )

Fill this node by folding all descendent particles to this node.

Parameters

pRoot The PFO acting as the root of the current branch of the hierarchy

Definition at line 953 of file LArHierarchyHelper.cc.

 {
     PfoList allParticles;
     LArPfoHelper::GetAllDownstreamPfos(pRoot, allParticles);
     CaloHitList allHits;
     for (const ParticleFlowObject *pPfo : allParticles)
         LArPfoHelper::GetAllCaloHits(pPfo, allHits);
     Node *pNode{new Node(m_hierarchy, allParticles, allHits)};
     m_children.emplace_back(pNode);
 }

void lar_content::LArHierarchyHelper::RecoHierarchy::Node::FillHierarchy	(	const pandora::ParticleFlowObject *	pRoot,
		const FoldingParameters &	foldParameters
	)

Recursively fill the hierarchy based on the criteria established for this RecoHierarchy.

Parameters

pRoot	The PFO acting as the root of the current branch of the hierarchy
foldParameters	The folding parameters

Definition at line 918 of file LArHierarchyHelper.cc.

 {
     PfoList allParticles;
     int pdg{std::abs(pRoot->GetParticleId())};
     const bool isShower{pdg == E_MINUS};
     if (foldParameters.m_foldToTier && LArPfoHelper::GetHierarchyTier(pRoot) >= foldParameters.m_tier)
         LArPfoHelper::GetAllDownstreamPfos(pRoot, allParticles);
     else if (foldParameters.m_foldToLeadingShowers && isShower)
         LArPfoHelper::GetAllDownstreamPfos(pRoot, allParticles);
     else
         allParticles.emplace_back(pRoot);
 
     CaloHitList allHits;
     for (const ParticleFlowObject *pPfo : allParticles)
         LArPfoHelper::GetAllCaloHits(pPfo, allHits);
     const bool hasChildren{(foldParameters.m_foldToTier && LArPfoHelper::GetHierarchyTier(pRoot) < foldParameters.m_tier) ||
                            (!foldParameters.m_foldToTier && !foldParameters.m_foldToLeadingShowers) ||
                            (foldParameters.m_foldToLeadingShowers && !isShower)};
 
     if (hasChildren || (!hasChildren && !allHits.empty()))
     {
         Node *pNode{new Node(m_hierarchy, allParticles, allHits)};
         m_children.emplace_back(pNode);
 
         if (hasChildren)
         {
             const PfoList &children{pRoot->GetDaughterPfoList()};
             for (const ParticleFlowObject *pChild : children)
                 pNode->FillHierarchy(pChild, foldParameters);
         }
     }
 }

const CaloHitList & lar_content::LArHierarchyHelper::RecoHierarchy::Node::GetCaloHits ( ) const

Retrieve the CaloHits associated with this node.

Returns: The list of CaloHits associated with this node

Definition at line 973 of file LArHierarchyHelper.cc.

 {
     return m_caloHits;
 }

const LArHierarchyHelper::RecoHierarchy::NodeVector & lar_content::LArHierarchyHelper::RecoHierarchy::Node::GetChildren ( ) const

inline

Return the vector of children for this node.

Returns: The vector of children

Definition at line 977 of file LArHierarchyHelper.h.

 {
     return m_children;
 }

int lar_content::LArHierarchyHelper::RecoHierarchy::Node::GetParticleId ( ) const

Retrieve the PDG code for the leading particle in this node Note, for reco objects the PDG codes represent tracks (muon PDG) and showers (electron PDG)

Returns: The PDG code for the leading particle in this node

Definition at line 980 of file LArHierarchyHelper.cc.

 {
     return m_pdg;
 }

const PfoList & lar_content::LArHierarchyHelper::RecoHierarchy::Node::GetRecoParticles ( ) const

Retrieve the PFOs associated with this node.

Returns: The PFOs associated with this node

Definition at line 966 of file LArHierarchyHelper.cc.

 {
     return m_pfos;
 }

const std::string lar_content::LArHierarchyHelper::RecoHierarchy::Node::ToString ( const std::string & prefix ) const

Produce a string representation of the hierarchy.

Returns: The string representation of the hierarchy

Definition at line 987 of file LArHierarchyHelper.cc.

 {
     std::string str(prefix + "PDG: " + std::to_string(m_pdg) + " Hits: " + std::to_string(m_caloHits.size()) + "\n");
     for (const Node *pChild : m_children)
         str += pChild->ToString(prefix + "   ");
 
     return str;
 }

Member Data Documentation

pandora::CaloHitList lar_content::LArHierarchyHelper::RecoHierarchy::Node::m_caloHits

private

The list of calo hits of which this node is composed.

Definition at line 515 of file LArHierarchyHelper.h.

NodeVector lar_content::LArHierarchyHelper::RecoHierarchy::Node::m_children

private

The child nodes of this node.

Definition at line 516 of file LArHierarchyHelper.h.

const RecoHierarchy& lar_content::LArHierarchyHelper::RecoHierarchy::Node::m_hierarchy

private

The parent reco hierarchy.

Definition at line 513 of file LArHierarchyHelper.h.

int lar_content::LArHierarchyHelper::RecoHierarchy::Node::m_pdg

private

The particle ID (track = muon, shower = electron)

Definition at line 517 of file LArHierarchyHelper.h.

pandora::PfoList lar_content::LArHierarchyHelper::RecoHierarchy::Node::m_pfos

private

The list of PFOs of which this node is composed.

Definition at line 514 of file LArHierarchyHelper.h.

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

larpandoracontent/larpandoracontent/LArHelpers/LArHierarchyHelper.h
larpandoracontent/larpandoracontent/LArHelpers/LArHierarchyHelper.cc

Public Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation