lar_content::TwoViewSimpleTracksTool Class Reference

TwoViewSimpleTracksTool class. More...

#include "TwoViewSimpleTracksTool.h"

Inheritance diagram for lar_content::TwoViewSimpleTracksTool:

Public Types
typedef TwoViewTransverseTracksAlgorithm::MatchingType::MatrixType	MatrixType
typedef std::vector< MatrixType::ElementList::const_iterator >	IteratorList

Public Member Functions
	TwoViewSimpleTracksTool ()
	Default constructor. More...
bool	Run (TwoViewTransverseTracksAlgorithm *const pAlgorithm, MatrixType &overlapMatrix)
	Run the algorithm tool. More...

Private Member Functions
void	FindBestTrack (const MatrixType &overlapMatrix, ProtoParticleVector &protoParticleVector) const
	Find best track match as a simple way to (try to) resolve ambiguities in the matrix. More...
bool	PassesElementCuts (MatrixType::ElementList::const_reverse_iterator eIter) const
	Whether a provided (iterator to a) matrix element passes the selection cuts for particle creation. More...
pandora::StatusCode	ReadSettings (const pandora::TiXmlHandle xmlHandle)

Private Attributes
float	m_minMatchedFraction
	The min matched sampling point fraction for particle creation. More...
float	m_minMatchingScore
	The min global matching score for particle creation. More...
unsigned int	m_minMatchedSamplingPoints
	The min number of matched sampling points for particle creation. More...
float	m_minXOverlapFraction
	The min x overlap fraction (in each view) for particle creation. More...

Detailed Description

TwoViewSimpleTracksTool class.

Definition at line 19 of file TwoViewSimpleTracksTool.h.

Member Typedef Documentation

typedef std::vector<MatrixType::ElementList::const_iterator> lar_content::TransverseMatrixTool::IteratorList

inherited

Definition at line 103 of file TwoViewTransverseTracksAlgorithm.h.

typedef TwoViewTransverseTracksAlgorithm::MatchingType::MatrixType lar_content::TransverseMatrixTool::MatrixType

inherited

Definition at line 102 of file TwoViewTransverseTracksAlgorithm.h.

Constructor & Destructor Documentation

lar_content::TwoViewSimpleTracksTool::TwoViewSimpleTracksTool

(

)

Default constructor.

Definition at line 18 of file TwoViewSimpleTracksTool.cc.

                                                 :
    m_minMatchedFraction(0.2f),
    m_minMatchingScore(0.9f),
    m_minMatchedSamplingPoints(5),
    m_minXOverlapFraction(0.5f)
{
}

Member Function Documentation

void lar_content::TwoViewSimpleTracksTool::FindBestTrack ( const MatrixType &  overlapMatrix, ProtoParticleVector &  protoParticleVector  ) const

private

Find best track match as a simple way to (try to) resolve ambiguities in the matrix.

Parameters

overlapMatrix	the overlap matrix
protoParticleVector	to receive the list of proto particles

Definition at line 41 of file TwoViewSimpleTracksTool.cc.

References lar_content::OverlapMatrix< T >::GetConnectedElements(), lar_content::OverlapMatrix< T >::GetSortedKeyClusters(), lar_content::ProtoParticle::m_clusterList, and PassesElementCuts().

Referenced by Run().

{
    ClusterVector sortedKeyClusters;
    overlapMatrix.GetSortedKeyClusters(sortedKeyClusters);

    for (const Cluster *const pKeyCluster : sortedKeyClusters)
    {
        if (!pKeyCluster->IsAvailable())
            continue;

        unsigned int n0(0), n1(0);
        MatrixType::ElementList elementList;
        overlapMatrix.GetConnectedElements(pKeyCluster, true, elementList, n0, n1);

        if (elementList.empty())
            continue;

        for (MatrixType::ElementList::const_reverse_iterator iIter = elementList.rbegin(); iIter != elementList.rend(); ++iIter)
        {
            if (this->PassesElementCuts(iIter))
            {
                if ((nullptr == iIter->GetCluster1()) || (nullptr == iIter->GetCluster2()))
                    continue;

                ProtoParticle protoParticle;
                protoParticle.m_clusterList.push_back(iIter->GetCluster1());
                protoParticle.m_clusterList.push_back(iIter->GetCluster2());
                protoParticleVector.push_back(protoParticle);

                return;
            }
        }
    }
}

bool lar_content::TwoViewSimpleTracksTool::PassesElementCuts ( MatrixType::ElementList::const_reverse_iterator  eIter ) const

private

Whether a provided (iterator to a) matrix element passes the selection cuts for particle creation.

Parameters

eIter

the iterator to the matrix element

Definition at line 78 of file TwoViewSimpleTracksTool.cc.

References m_minMatchedFraction, m_minMatchedSamplingPoints, m_minMatchingScore, and m_minXOverlapFraction.

Referenced by FindBestTrack().

{
    if (!eIter->GetOverlapResult().IsInitialized())
        return false;

    if (eIter->GetOverlapResult().GetLocallyMatchedFraction() < m_minMatchedFraction)
        return false;

    if (eIter->GetOverlapResult().GetMatchingScore() < m_minMatchingScore)
        return false;

    if (eIter->GetOverlapResult().GetNMatchedReUpsampledSamplingPoints() < m_minMatchedSamplingPoints)
        return false;

    const TwoViewXOverlap &xOverlap(eIter->GetOverlapResult().GetTwoViewXOverlap());

    if (!((xOverlap.GetXOverlapFraction0() > m_minXOverlapFraction) && (xOverlap.GetXOverlapFraction1() > m_minXOverlapFraction)))
    {
        return false;
    }

    return true;
}

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

private

Definition at line 104 of file TwoViewSimpleTracksTool.cc.

References m_minMatchedFraction, m_minMatchedSamplingPoints, m_minMatchingScore, and m_minXOverlapFraction.

{
    PANDORA_RETURN_RESULT_IF_AND_IF(
        STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "MinMatchedFraction", m_minMatchedFraction));

    PANDORA_RETURN_RESULT_IF_AND_IF(
        STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "MinMatchingScore", m_minMatchingScore));

    PANDORA_RETURN_RESULT_IF_AND_IF(STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=,
        XmlHelper::ReadValue(xmlHandle, "MinMatchedSamplingPoints", m_minMatchedSamplingPoints));

    PANDORA_RETURN_RESULT_IF_AND_IF(
        STATUS_CODE_SUCCESS, STATUS_CODE_NOT_FOUND, !=, XmlHelper::ReadValue(xmlHandle, "MinXOverlapFraction", m_minXOverlapFraction));

    return STATUS_CODE_SUCCESS;
}

bool lar_content::TwoViewSimpleTracksTool::Run ( TwoViewTransverseTracksAlgorithm *const  pAlgorithm, MatrixType &  overlapMatrix  )

virtual

Run the algorithm tool.

Parameters

pAlgorithm	address of the calling algorithm
overlapMatrix	the overlap matrix

Returns

whether changes have been made by the tool

Implements lar_content::TransverseMatrixTool.

Definition at line 28 of file TwoViewSimpleTracksTool.cc.

References lar_content::MatchingBaseAlgorithm::CreateThreeDParticles(), and FindBestTrack().

{
    if (PandoraContentApi::GetSettings(*pAlgorithm)->ShouldDisplayAlgorithmInfo())
        std::cout << "----> Running Algorithm Tool: " << this->GetInstanceName() << ", " << this->GetType() << std::endl;

    ProtoParticleVector protoParticleVector;
    this->FindBestTrack(overlapMatrix, protoParticleVector);

    return pAlgorithm->CreateThreeDParticles(protoParticleVector);
}

Member Data Documentation

float lar_content::TwoViewSimpleTracksTool::m_minMatchedFraction

private

The min matched sampling point fraction for particle creation.

Definition at line 47 of file TwoViewSimpleTracksTool.h.

Referenced by PassesElementCuts(), and ReadSettings().

unsigned int lar_content::TwoViewSimpleTracksTool::m_minMatchedSamplingPoints

private

The min number of matched sampling points for particle creation.

Definition at line 49 of file TwoViewSimpleTracksTool.h.

Referenced by PassesElementCuts(), and ReadSettings().

float lar_content::TwoViewSimpleTracksTool::m_minMatchingScore

private

The min global matching score for particle creation.

Definition at line 48 of file TwoViewSimpleTracksTool.h.

Referenced by PassesElementCuts(), and ReadSettings().

float lar_content::TwoViewSimpleTracksTool::m_minXOverlapFraction

private

The min x overlap fraction (in each view) for particle creation.

Definition at line 50 of file TwoViewSimpleTracksTool.h.

Referenced by PassesElementCuts(), and ReadSettings().

---

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

• larpandoracontent/v04_08_01/source/larpandoracontent/LArThreeDReco/LArTwoViewMatching/TwoViewSimpleTracksTool.h
• larpandoracontent/v04_08_01/source/larpandoracontent/LArThreeDReco/LArTwoViewMatching/TwoViewSimpleTracksTool.cc