#include "PMAlgTracking.h"

Inheritance diagram for pma::PMAlgTracker:

Classes
struct	Config

Public Types
enum	EValidationMode { kHits = 1, kAdc = 2, kCalib = 3 }

Public Member Functions
	PMAlgTracker (const std::vector< art::Ptr< recob::Hit >> &allhitlist, const std::vector< recob::Wire > &wires, const pma::ProjectionMatchingAlg::Config &pmalgConfig, const pma::PMAlgTracker::Config &pmalgTrackerConfig, const pma::PMAlgVertexing::Config &pmvtxConfig, const pma::PMAlgStitching::Config &pmstitchConfig, const pma::PMAlgCosmicTagger::Config &pmtaggerConfig, const std::vector< TH1F * > &hpassing, const std::vector< TH1F * > &hrejected)

void	init (const art::FindManyP< recob::Hit > &hitsFromClusters)

void	init (const art::FindManyP< recob::Hit > &hitsFromClusters, const std::vector< float > &trackLike)

void	init (const art::FindManyP< recob::Hit > &hitsFromClusters, const art::FindManyP< recob::Hit > &hitsFromEmParts)

int	build (detinfo::DetectorClocksData const &clockData, detinfo::DetectorPropertiesData const &detProp)

const pma::TrkCandidateColl &	result ()

std::vector< std::pair< TVector3, std::vector< std::pair< size_t, bool > > > >	getVertices (bool onlyBranching=false) const

std::vector< std::pair< TVector3, size_t > >	getKinks () const

Protected Member Functions
void	guideEndpoints (detinfo::DetectorPropertiesData const &detProp, pma::TrkCandidateColl &tracks)

Protected Attributes
pma::cryo_tpc_view_hitmap	fHitMap

pma::ProjectionMatchingAlg	fProjectionMatchingAlg

pma::PMAlgVertexing	fPMAlgVertexing

pma::TrkCandidateColl	fResult

Private Member Functions
double	collectSingleViewEnd (pma::Track3D &trk, std::vector< art::Ptr< recob::Hit >> &hits) const

double	collectSingleViewFront (pma::Track3D &trk, std::vector< art::Ptr< recob::Hit >> &hits) const

bool	reassignHits_1 (detinfo::DetectorPropertiesData const &detProp, const std::vector< art::Ptr< recob::Hit >> &hits, pma::TrkCandidateColl &tracks, size_t trk_idx, double dist2)

bool	reassignSingleViewEnds_1 (detinfo::DetectorPropertiesData const &detProp, pma::TrkCandidateColl &tracks)

bool	areCoLinear (pma::Track3D trk1, pma::Track3D trk2, double &dist, double &cos3d, bool &reverseOrder, double distThr, double distThrMin, double distProjThr, double cosThr) const

void	freezeBranchingNodes (pma::TrkCandidateColl &tracks) const

void	releaseAllNodes (pma::TrkCandidateColl &tracks) const

bool	mergeCoLinear (detinfo::DetectorPropertiesData const &detProp, pma::TrkCandidateColl &tracks) const

void	mergeCoLinear (detinfo::DetectorClocksData const &clockData, detinfo::DetectorPropertiesData const &detProp, pma::tpc_track_map &tracks) const

double	validate (detinfo::DetectorPropertiesData const &detProp, pma::Track3D &trk, unsigned int testView)

void	fromMaxCluster_tpc (detinfo::DetectorPropertiesData const &detProp, pma::TrkCandidateColl &result, size_t minBuildSize, unsigned int tpc, unsigned int cryo)

size_t	matchTrack (detinfo::DetectorPropertiesData const &detProp, const pma::TrkCandidateColl &tracks, const std::vector< art::Ptr< recob::Hit >> &hits) const

pma::TrkCandidate	matchCluster (detinfo::DetectorPropertiesData const &detProp, int first_clu_idx, const std::vector< art::Ptr< recob::Hit >> &first_hits, size_t minSizeCompl, unsigned int tpc, unsigned int cryo, geo::View_t first_view)

pma::TrkCandidate	matchCluster (detinfo::DetectorPropertiesData const &detProp, int first_clu_idx, size_t minSizeCompl, unsigned int tpc, unsigned int cryo, geo::View_t first_view)

int	matchCluster (detinfo::DetectorPropertiesData const &detProp, const pma::TrkCandidate &trk, size_t minSize, double fraction, unsigned int preferedView, unsigned int testView) const

bool	extendTrack (detinfo::DetectorPropertiesData const &detProp, pma::TrkCandidate &candidate, const std::vector< art::Ptr< recob::Hit >> &hits, unsigned int testView, bool add_nodes)

int	maxCluster (detinfo::DetectorPropertiesData const &detProp, int first_idx_tag, const pma::TrkCandidateColl &candidates, float xmin, float xmax, size_t min_clu_size, geo::View_t view, unsigned int tpc, unsigned int cryo) const

int	maxCluster (size_t min_clu_size, geo::View_t view, unsigned int tpc, unsigned int cryo) const

void	listUsedClusters (detinfo::DetectorPropertiesData const &detProp) const

bool	has (const std::vector< size_t > &v, size_t idx) const

Private Attributes
const std::vector< recob::Wire > &	fWires

std::vector< std::vector< art::Ptr< recob::Hit > > >	fCluHits

std::vector< float >	fCluWeights

std::vector< size_t >	fUsedClusters
	More...

std::vector< size_t >	fInitialClusters

std::map< unsigned int, std::vector< size_t > >	fTriedClusters

std::vector< geo::View_t >	fAvailableViews

size_t	fMinSeedSize1stPass
	More...

size_t	fMinSeedSize2ndPass

float	fTrackLikeThreshold

double	fMinTwoViewFraction

bool	fFlipToBeam

bool	fFlipDownward

bool	fFlipToX

bool	fAutoFlip_dQdx

bool	fMergeWithinTPC

double	fMergeTransverseShift

double	fMergeAngle

pma::PMAlgCosmicTagger	fCosmicTagger

bool	fTagCosmicTracks

bool	fStitchBetweenTPCs

double	fStitchDistToWall

double	fStitchTransverseShift

double	fStitchAngle

bool	fMatchT0inAPACrossing

bool	fMatchT0inCPACrossing

pma::PMAlgStitching	fStitcher

bool	fRunVertexing

EValidationMode	fValidation

std::vector< img::DataProviderAlg >	fAdcImages

std::vector< double >	fAdcValidationThr

const std::vector< TH1F * > &	fAdcInPassingPoints

const std::vector< TH1F * > &	fAdcInRejectedPoints

geo::GeometryCore const *	fGeom

Detailed Description

Definition at line 155 of file PMAlgTracking.h.

Member Enumeration Documentation

enum pma::PMAlgTracker::EValidationMode

Enumerator
kHits
kAdc
kCalib

Definition at line 157 of file PMAlgTracking.h.

157 { kHits = 1, kAdc = 2, kCalib = 3 };

pma::PMAlgTracker::kAdc

Definition: PMAlgTracking.h:157

pma::PMAlgTracker::kHits

Definition: PMAlgTracking.h:157

pma::PMAlgTracker::kCalib

Definition: PMAlgTracking.h:157

Constructor & Destructor Documentation

pma::PMAlgTracker::PMAlgTracker	(	const std::vector< art::Ptr< recob::Hit >> &	allhitlist,
		const std::vector< recob::Wire > &	wires,
		const pma::ProjectionMatchingAlg::Config &	pmalgConfig,
		const pma::PMAlgTracker::Config &	pmalgTrackerConfig,
		const pma::PMAlgVertexing::Config &	pmvtxConfig,
		const pma::PMAlgStitching::Config &	pmstitchConfig,
		const pma::PMAlgCosmicTagger::Config &	pmtaggerConfig,
		const std::vector< TH1F * > &	hpassing,
		const std::vector< TH1F * > &	hrejected
	)

Definition at line 284 of file PMAlgTracking.cxx.

References pma::PMAlgTracker::Config::AdcImageAlg, pma::PMAlgTracker::Config::AdcValidationThr, fAdcImages, fAdcValidationThr, fAvailableViews, fGeom, fValidation, kAdc, kCalib, kHits, geo::GeometryCore::MaxPlanes(), pma::PMAlgTracker::Config::Validation, and geo::GeometryCore::Views().

   : PMAlgTrackingBase(allhitlist, pmalgConfig, pmvtxConfig)
   , fWires(wires)
   , fMinSeedSize1stPass(pmalgTrackerConfig.MinSeedSize1stPass())
   , fMinSeedSize2ndPass(pmalgTrackerConfig.MinSeedSize2ndPass())
   , fTrackLikeThreshold(pmalgTrackerConfig.TrackLikeThreshold())
   , fMinTwoViewFraction(pmalgConfig.MinTwoViewFraction())
   , fFlipToBeam(pmalgTrackerConfig.FlipToBeam())
   , fFlipDownward(pmalgTrackerConfig.FlipDownward())
   , fFlipToX(pmalgTrackerConfig.FlipToX())
   , fAutoFlip_dQdx(pmalgTrackerConfig.AutoFlip_dQdx())
   , fMergeWithinTPC(pmalgTrackerConfig.MergeWithinTPC())
   , fMergeTransverseShift(pmalgTrackerConfig.MergeTransverseShift())
   , fMergeAngle(pmalgTrackerConfig.MergeAngle())
   , fCosmicTagger(pmtaggerConfig)
   , fTagCosmicTracks(fCosmicTagger.tagAny())
   , fStitchBetweenTPCs(pmalgTrackerConfig.StitchBetweenTPCs())
   , fStitchDistToWall(pmalgTrackerConfig.StitchDistToWall())
   , fStitchTransverseShift(pmalgTrackerConfig.StitchTransverseShift())
   , fStitchAngle(pmalgTrackerConfig.StitchAngle())
   , fMatchT0inAPACrossing(pmalgTrackerConfig.MatchT0inAPACrossing())
   , fMatchT0inCPACrossing(pmalgTrackerConfig.MatchT0inCPACrossing())
   , fStitcher(pmstitchConfig)
   , fRunVertexing(pmalgTrackerConfig.RunVertexing())
   , fAdcInPassingPoints(hpassing)
   , fAdcInRejectedPoints(hrejected)
   , fGeom(&*(art::ServiceHandle<geo::Geometry const>()))
 {
   for (const auto v : fGeom->Views()) {
     fAvailableViews.push_back(v);
   }
   std::reverse(fAvailableViews.begin(), fAvailableViews.end());
 
   mf::LogVerbatim("PMAlgTracker") << "Using views in the following order:";
   for (const auto v : fAvailableViews) {
     mf::LogInfo("PMAlgTracker") << " " << v;
   }
 
   // ************************* track validation settings: **************************
   mf::LogVerbatim("PMAlgTracker") << "Validation mode in config: "
                                   << pmalgTrackerConfig.Validation();
 
   size_t nplanes = fGeom->MaxPlanes();
   for (size_t p = 0; p < nplanes; ++p) {
     fAdcImages.emplace_back(pmalgTrackerConfig.AdcImageAlg());
   }
 
   if (pmalgTrackerConfig.Validation() == "hits") { fValidation = pma::PMAlgTracker::kHits; }
   else if (pmalgTrackerConfig.Validation() == "adc") {
     fValidation = pma::PMAlgTracker::kAdc;
   }
   else if (pmalgTrackerConfig.Validation() == "calib") {
     fValidation = pma::PMAlgTracker::kCalib;
   }
   else {
     throw cet::exception("pma::PMAlgTracker") << "validation name not supported" << std::endl;
   }
 
   if ((nplanes < 3) && (fValidation != pma::PMAlgTracker::kHits)) {
     mf::LogWarning("PMAlgTracker")
       << "Not enough planes to perform validation, switch mode to hits.";
     fValidation = pma::PMAlgTracker::kHits;
   }
 
   fAdcValidationThr = pmalgTrackerConfig.AdcValidationThr();
   if (fValidation == pma::PMAlgTracker::kAdc) {
     mf::LogVerbatim("PMAlgTracker") << "Validation ADC thresholds per plane:";
     for (auto thr : fAdcValidationThr) {
       mf::LogVerbatim("PMAlgTracker") << "   " << thr;
     }
   }
 }

Member Function Documentation

bool pma::PMAlgTracker::areCoLinear	(	pma::Track3D *	trk1,
		pma::Track3D *	trk2,
		double &	dist,
		double &	cos3d,
		bool &	reverseOrder,
		double	distThr,
		double	distThrMin,
		double	distProjThr,
		double	cosThr
	)		const

private

Definition at line 633 of file PMAlgTracking.cxx.

References pma::Track3D::back(), d, pma::Dist2(), pma::Track3D::Flip(), pma::Track3D::front(), pma::GetProjectionToSegment(), pma::Track3D::Length(), pma::Track3D::Nodes(), pma::Hit3D::Point3D(), pma::Track3D::Segments(), and tmp.

Referenced by mergeCoLinear().

 {
   double lmax;
   double l1 = trk1->Length();
   double l2 = trk2->Length();
 
   if (l1 > l2)
     lmax = l1;
   else
     lmax = l2;
 
   double d = lmax * distThr;
   if (d < distThrMin) d = distThrMin;
 
   unsigned int k = 0;
   double distFF = pma::Dist2(trk1->front()->Point3D(), trk2->front()->Point3D());
   dist = distFF;
 
   double distFB = pma::Dist2(trk1->front()->Point3D(), trk2->back()->Point3D());
   if (distFB < dist) {
     k = 1;
     dist = distFB;
   }
 
   double distBF = pma::Dist2(trk1->back()->Point3D(), trk2->front()->Point3D());
   if (distBF < dist) {
     k = 2;
     dist = distBF;
   }
 
   double distBB = pma::Dist2(trk1->back()->Point3D(), trk2->back()->Point3D());
   if (distBB < dist) {
     k = 3;
     dist = distBB;
   }
 
   dist = sqrt(dist);
   cos3d = 0.0;
 
   if (dist < d) {
     pma::Track3D* tmp = 0;
     switch (k) // swap or flip to get trk1 end before trk2 start
     {
     case 0:
       trk1->Flip(); // detProp);
       break;
     case 1:
       tmp = trk1;
       trk1 = trk2;
       trk2 = tmp;
       break;
     case 2: break;
     case 3:
       trk2->Flip(); // detProp);
       break;
     default: mf::LogError("PMAlgTracker") << "Should never happen.";
     }
     if (k == 1)
       reverseOrder = true;
     else
       reverseOrder = false;
 
     size_t nodeEndIdx = trk1->Nodes().size() - 1;
 
     TVector3 endpoint1 = trk1->back()->Point3D();
     TVector3 trk2front0 = trk2->Nodes()[0]->Point3D();
     TVector3 trk2front1 = trk2->Nodes()[1]->Point3D();
     TVector3 proj1 = pma::GetProjectionToSegment(endpoint1, trk2front0, trk2front1);
     double distProj1 = sqrt(pma::Dist2(endpoint1, proj1));
 
     TVector3 endpoint2 = trk2->front()->Point3D();
     TVector3 trk1back0 = trk1->Nodes()[nodeEndIdx]->Point3D();
     TVector3 trk1back1 = trk1->Nodes()[nodeEndIdx - 1]->Point3D();
     TVector3 proj2 = pma::GetProjectionToSegment(endpoint2, trk1back1, trk1back0);
     double distProj2 = sqrt(pma::Dist2(endpoint2, proj2));
 
     pma::Vector3D dir1 = trk1->Segments().back()->GetDirection3D();
     pma::Vector3D dir2 = trk2->Segments().front()->GetDirection3D();
 
     cos3d = dir1.Dot(dir2);
 
     if ((cos3d > cosThr) && (distProj1 < distProjThr) && (distProj2 < distProjThr))
       return true;
     else // check if parallel to wires & colinear in 2D
     {
       const double maxCosXZ = 0.996195; // 5 deg
 
       pma::Vector3D dir1_xz(dir1.X(), 0., dir1.Z());
       dir1_xz *= 1.0 / dir1_xz.R();
 
       pma::Vector3D dir2_xz(dir2.X(), 0., dir2.Z());
       dir2_xz *= 1.0 / dir2_xz.R();
 
       if ((fabs(dir1_xz.Z()) > maxCosXZ) && (fabs(dir2_xz.Z()) > maxCosXZ)) {
         endpoint1.SetY(0.);
         trk2front0.SetY(0.);
         trk2front1.SetY(0.);
         proj1 = pma::GetProjectionToSegment(endpoint1, trk2front0, trk2front1);
         distProj1 = sqrt(pma::Dist2(endpoint1, proj1));
 
         endpoint2.SetY(0.);
         trk1back0.SetY(0.);
         trk1back1.SetY(0.);
         proj2 = pma::GetProjectionToSegment(endpoint2, trk1back1, trk1back0);
         distProj2 = sqrt(pma::Dist2(endpoint2, proj2));
 
         double cosThrXZ = cos(0.5 * acos(cosThr));
         double distProjThrXZ = 0.5 * distProjThr;
         double cosXZ = dir1_xz.Dot(dir2_xz);
         if ((cosXZ > cosThrXZ) && (distProj1 < distProjThrXZ) && (distProj2 < distProjThrXZ))
           return true;
       }
     }
   }
   return false;
 }

int pma::PMAlgTracker::build	(	detinfo::DetectorClocksData const &	clockData,
		detinfo::DetectorPropertiesData const &	detProp
	)

Definition at line 946 of file PMAlgTracking.cxx.

References fAdcImages, fAutoFlip_dQdx, fCosmicTagger, fFlipDownward, fFlipToBeam, fFlipToX, fGeom, fInitialClusters, pma::TrkCandidateColl::flipTreesByDQdx(), pma::TrkCandidateColl::flipTreesToCoordinate(), fMatchT0inAPACrossing, fMatchT0inCPACrossing, fMergeWithinTPC, fMinSeedSize1stPass, fMinSeedSize2ndPass, pma::PMAlgTrackingBase::fPMAlgVertexing, pma::PMAlgTrackingBase::fResult, fromMaxCluster_tpc(), fRunVertexing, fStitchBetweenTPCs, fStitcher, fTagCosmicTracks, fTriedClusters, fUsedClusters, fValidation, fWires, pma::PMAlgTrackingBase::guideEndpoints(), geo::GeometryCore::Iterate(), kHits, listUsedClusters(), geo::GeometryCore::MaxPlanes(), mergeCoLinear(), pma::TrkCandidateColl::push_back(), reassignSingleViewEnds_1(), pma::PMAlgVertexing::run(), pma::TrkCandidateColl::setParentDaughterConnections(), pma::TrkCandidateColl::setTreeIds(), pma::TrkCandidateColl::size(), pma::PMAlgStitching::StitchTracksAPA(), pma::PMAlgStitching::StitchTracksCPA(), and pma::PMAlgCosmicTagger::tag().

 {
   fInitialClusters.clear();
   fTriedClusters.clear();
   fUsedClusters.clear();
 
   size_t nplanes = fGeom->MaxPlanes();
 
   pma::tpc_track_map tracks; // track parts in tpc's
 
   for (auto const& tpcid : fGeom->Iterate<geo::TPCID>()) {
     mf::LogVerbatim("PMAlgTracker")
       << "Reconstruct tracks within Cryo:" << tpcid.Cryostat << " / TPC:" << tpcid.TPC << ".";
 
     if (fValidation != pma::PMAlgTracker::kHits) // initialize ADC images for all planes in
                                                  // this TPC (in "adc" and "calib")
     {
       mf::LogVerbatim("PMAlgTracker") << "Prepare validation ADC images...";
       bool ok = true;
       for (size_t p = 0; p < nplanes; ++p) {
         ok &=
           fAdcImages[p].setWireDriftData(clockData, detProp, fWires, p, tpcid.TPC, tpcid.Cryostat);
       }
       if (ok) { mf::LogVerbatim("PMAlgTracker") << "  ...done."; }
       else {
         mf::LogVerbatim("PMAlgTracker") << "  ...failed.";
         continue;
       }
     }
 
     // find reasonably large parts
     fromMaxCluster_tpc(detProp, tracks[tpcid.TPC], fMinSeedSize1stPass, tpcid.TPC, tpcid.Cryostat);
     // loop again to find small things
     fromMaxCluster_tpc(detProp, tracks[tpcid.TPC], fMinSeedSize2ndPass, tpcid.TPC, tpcid.Cryostat);
 
     //tryClusterLeftovers();
 
     mf::LogVerbatim("PMAlgTracker") << "Found tracks: " << tracks[tpcid.TPC].size();
     if (tracks[tpcid.TPC].empty()) { continue; }
 
     // add 3D ref.points for clean endpoints of wire-plane parallel track
     guideEndpoints(detProp, tracks[tpcid.TPC]);
     // try correcting single-view sections spuriously merged on 2D clusters
     // level
     reassignSingleViewEnds_1(detProp, tracks[tpcid.TPC]);
 
     if (fMergeWithinTPC) {
       mf::LogVerbatim("PMAlgTracker") << "Merge co-linear tracks within TPC " << tpcid.TPC << ".";
       while (mergeCoLinear(detProp, tracks[tpcid.TPC])) {
         mf::LogVerbatim("PMAlgTracker") << "  found co-linear tracks";
       }
     }
   }
 
   if (fStitchBetweenTPCs) {
     mf::LogVerbatim("PMAlgTracker") << "Stitch co-linear tracks between TPCs.";
     mergeCoLinear(clockData, detProp, tracks);
   }
 
   for (auto& tpc_entry : tracks) // put tracks in the single collection
     for (auto& trk : tpc_entry.second.tracks()) {
       if (trk.Track()->HasTwoViews() && (trk.Track()->Nodes().size() > 1)) {
         fResult.push_back(trk);
       }
       else {
         trk.DeleteTrack();
       }
     }
 
   if (fTagCosmicTracks) {
     mf::LogVerbatim("PMAlgTracker") << "Tag cosmic tracks activity.";
     fCosmicTagger.tag(clockData, fResult);
   }
 
   if (fRunVertexing) {
     mf::LogVerbatim("PMAlgTracker") << "Vertex finding / track-vertex reoptimization.";
     fPMAlgVertexing.run(detProp, fResult);
   }
 
   fResult.setTreeIds();
 
   if (fMatchT0inCPACrossing) {
     mf::LogVerbatim("PMAlgTracker") << "Find co-linear CPA-crossing tracks with any T0.";
     fStitcher.StitchTracksCPA(clockData, detProp, fResult);
   }
 
   if (fMatchT0inAPACrossing) {
     mf::LogVerbatim("PMAlgTracker") << "Find co-linear APA-crossing tracks with any T0.";
     fStitcher.StitchTracksAPA(clockData, detProp, fResult);
   }
 
   if (fTagCosmicTracks) {
     mf::LogVerbatim("PMAlgTracker") << "Second pass cosmic tagging for stitched tracks";
     fCosmicTagger.tag(clockData, fResult);
   }
 
   if (fFlipToBeam)
     fResult.flipTreesToCoordinate(detProp,
                                   2); // flip the tracks / trees to the beam direction (Z)
   else if (fFlipDownward)
     fResult.flipTreesToCoordinate(detProp,
                                   1); // flip the tracks / trees to point downward (-Y)
   else if (fFlipToX)
     fResult.flipTreesToCoordinate(detProp,
                                   0); // flip the tracks / trees to point in -X
                                       // direction (downwards for dual phase)
 
   if (fAutoFlip_dQdx)
     fResult.flipTreesByDQdx(); // flip the tracks / trees to get best dQ/dx sequences
 
   fResult.setParentDaughterConnections();
 
   listUsedClusters(detProp);
   return fResult.size();
 }

double pma::PMAlgTracker::collectSingleViewEnd	(	pma::Track3D &	trk,
		std::vector< art::Ptr< recob::Hit >> &	hits
	)		const

private

Definition at line 568 of file PMAlgTracking.cxx.

References pma::Dist2(), hits(), and pma::Track3D::size().

Referenced by reassignSingleViewEnds_1().

 {
   size_t idx = 0;
   while ((idx < trk.size() - 1) && !(trk[idx]->IsEnabled())) {
     hits.push_back(trk[idx++]->Hit2DPtr());
   }
 
   double d2 = 0.0;
   if (idx > 0) {
     if ((idx < trk.size() - 1) && (trk[idx]->View2D() == trk[idx - 1]->View2D())) {
       double dprev = pma::Dist2(trk[idx]->Point3D(), trk[idx - 1]->Point3D());
       double dnext = pma::Dist2(trk[idx]->Point3D(), trk[idx + 1]->Point3D());
       if (dprev < dnext) { hits.push_back(trk[idx++]->Hit2DPtr()); }
     }
     d2 = pma::Dist2(trk[idx]->Point3D(), trk[idx - 1]->Point3D());
   }
   return d2;
 }

double pma::PMAlgTracker::collectSingleViewFront	(	pma::Track3D &	trk,
		std::vector< art::Ptr< recob::Hit >> &	hits
	)		const

private

Definition at line 588 of file PMAlgTracking.cxx.

References pma::Dist2(), hits(), and pma::Track3D::size().

Referenced by reassignSingleViewEnds_1().

 {
   size_t idx = trk.size() - 1;
   while ((idx > 0) && !(trk[idx]->IsEnabled())) {
     hits.push_back(trk[idx--]->Hit2DPtr());
   }
 
   double d2 = 0.0;
   if (idx < trk.size() - 1) {
     if ((idx > 0) && (trk[idx]->View2D() == trk[idx + 1]->View2D())) {
       double dprev = pma::Dist2(trk[idx]->Point3D(), trk[idx + 1]->Point3D());
       double dnext = pma::Dist2(trk[idx]->Point3D(), trk[idx - 1]->Point3D());
       if (dprev < dnext) { hits.push_back(trk[idx--]->Hit2DPtr()); }
     }
     d2 = pma::Dist2(trk[idx]->Point3D(), trk[idx + 1]->Point3D());
   }
   return d2;
 }

bool pma::PMAlgTracker::extendTrack	(	detinfo::DetectorPropertiesData const &	detProp,
		pma::TrkCandidate &	candidate,
		const std::vector< art::Ptr< recob::Hit >> &	hits,
		unsigned int	testView,
		bool	add_nodes
	)

private

Definition at line 1295 of file PMAlgTracking.cxx.

References pma::ProjectionMatchingAlg::extendTrack(), pma::PMAlgTrackingBase::fProjectionMatchingAlg, pma::Track3D::GetMse(), hits(), pma::TrkCandidate::Mse(), pma::TrkCandidate::SetMse(), pma::TrkCandidate::SetTrack(), pma::TrkCandidate::SetValidation(), pma::Track3D::SortHits(), pma::TrkCandidate::Track(), validate(), and pma::TrkCandidate::Validation().

Referenced by matchCluster().

 {
   double m_max = 2.0 * candidate.Mse(); // max acceptable MSE value
   if (m_max < 0.05) m_max = 0.05;       // this is still good, low MSE value
 
   double v_min1 = 0.98 * candidate.Validation();
   double v_min2 = 0.9 * candidate.Validation();
 
   pma::Track3D* copy =
     fProjectionMatchingAlg.extendTrack(detProp, *(candidate.Track()), hits, add_nodes);
   double m1 = copy->GetMse();
   double v1 = validate(detProp, *copy, testView);
 
   if (((m1 < candidate.Mse()) && (v1 >= v_min2)) ||
       ((m1 < 0.5) && (m1 <= m_max) && (v1 >= v_min1))) {
     mf::LogVerbatim("PMAlgTracker") << "  track EXTENDED, MSE = " << m1 << ", v = " << v1;
     candidate.SetTrack(copy); // replace with the new track (deletes old one)
     copy->SortHits();         // sort hits in the new track
 
     candidate.SetMse(m1); // save info
     candidate.SetValidation(v1);
 
     return true;
   }
   else {
     mf::LogVerbatim("PMAlgTracker") << "  track NOT extended, MSE = " << m1 << ", v = " << v1;
     delete copy;
     return false;
   }
 }

void pma::PMAlgTracker::freezeBranchingNodes ( pma::TrkCandidateColl & tracks ) const

private

Definition at line 821 of file PMAlgTracking.cxx.

References pma::TrkCandidateColl::tracks().

 {
   for (auto const& trk : tracks.tracks())
     for (auto node : trk.Track()->Nodes())
       if (node->IsBranching()) node->SetFrozen(true);
 }

void pma::PMAlgTracker::fromMaxCluster_tpc	(	detinfo::DetectorPropertiesData const &	detProp,
		pma::TrkCandidateColl &	result,
		size_t	minBuildSize,
		unsigned int	tpc,
		unsigned int	cryo
	)

private

Definition at line 1065 of file PMAlgTracking.cxx.

References util::empty(), fCluHits, fInitialClusters, pma::TrkCandidate::IsGood(), geo::kUnknown, matchCluster(), maxCluster(), and pma::TrkCandidateColl::push_back().

Referenced by build().

 {
   fInitialClusters.clear();
 
   size_t minSizeCompl = minBuildSize / 8; // smaller minimum required in complementary views
   if (minSizeCompl < 2) minSizeCompl = 2; // but at least two hits!
 
   int max_first_idx = 0;
   while (max_first_idx >= 0) // loop over clusters, any view, starting from the largest
   {
     mf::LogVerbatim("PMAlgTracker") << "Find max cluster...";
     max_first_idx =
       maxCluster(minBuildSize, geo::kUnknown, tpc, cryo); // any view, but must be track-like
     if ((max_first_idx >= 0) && !fCluHits[max_first_idx].empty()) {
       geo::View_t first_view = fCluHits[max_first_idx].front()->View();
 
       pma::TrkCandidate candidate =
         matchCluster(detProp, max_first_idx, minSizeCompl, tpc, cryo, first_view);
 
       if (candidate.IsGood()) result.push_back(candidate);
     }
     else
       mf::LogVerbatim("PMAlgTracker") << "small clusters only";
   }
 
   fInitialClusters.clear();
 }

std::vector<std::pair<TVector3, size_t> > pma::PMAlgTrackingBase::getKinks ( ) const

inlineinherited

Definition at line 74 of file PMAlgTracking.h.

References lar::dump::vector().

   {
     return fPMAlgVertexing.getKinks(fResult);
   }

std::vector<std::pair<TVector3, std::vector<std::pair<size_t, bool> > > > pma::PMAlgTrackingBase::getVertices ( bool onlyBranching = false ) const

inlineinherited

Definition at line 68 of file PMAlgTracking.h.

   {
     return fPMAlgVertexing.getVertices(fResult, onlyBranching);
   }

void pma::PMAlgTrackingBase::guideEndpoints	(	detinfo::DetectorPropertiesData const &	detProp,
		pma::TrkCandidateColl &	tracks
	)

protectedinherited

Definition at line 79 of file PMAlgTracking.cxx.

References pma::PMAlgTrackingBase::fHitMap, pma::PMAlgTrackingBase::fProjectionMatchingAlg, pma::ProjectionMatchingAlg::guideEndpoints(), pma::Track3D::kBegin, pma::Track3D::kEnd, and pma::TrkCandidateColl::tracks().

Referenced by pma::PMAlgFitter::build(), and build().

 {
   for (auto const& t : tracks.tracks()) {
     auto& trk = *(t.Track());
 
     unsigned int tpc = trk.FrontTPC(), cryo = trk.FrontCryo();
     if ((tpc == trk.BackTPC()) && (cryo == trk.BackCryo())) {
       fProjectionMatchingAlg.guideEndpoints(detProp, trk, fHitMap[cryo][tpc]);
     }
     else {
       fProjectionMatchingAlg.guideEndpoints(
         detProp, trk, pma::Track3D::kBegin, fHitMap[trk.FrontCryo()][trk.FrontTPC()]);
       fProjectionMatchingAlg.guideEndpoints(
         detProp, trk, pma::Track3D::kEnd, fHitMap[trk.BackCryo()][trk.BackTPC()]);
     }
   }
 }

bool pma::PMAlgTracker::has	(	const std::vector< size_t > &	v,
		size_t	idx
	)		const

inlineprivate

Definition at line 356 of file PMAlgTracking.h.

Referenced by listUsedClusters(), matchCluster(), and maxCluster().

   {
     for (auto c : v)
       if (c == idx) return true;
     return false;
   }

void pma::PMAlgTracker::init ( const art::FindManyP< recob::Hit > & hitsFromClusters )

Definition at line 367 of file PMAlgTracking.cxx.

References fCluHits, fCluWeights, and lar::dump::vector().

Referenced by trkf::PMAlgTrackMaker::init().

 {
   mf::LogVerbatim("PMAlgTracker") << "Sort hits by clusters...";
   fCluHits.clear();
   fCluHits.reserve(hitsFromClusters.size());
   fCluWeights.clear();
   fCluWeights.reserve(fCluHits.size());
   for (size_t i = 0; i < hitsFromClusters.size(); ++i) {
     auto v = hitsFromClusters.at(i);
     fCluHits.push_back(std::vector<art::Ptr<recob::Hit>>());
     for (auto const& h : v)
       fCluHits.back().push_back(h);
     fCluWeights.push_back(1);
   }
   mf::LogVerbatim("PMAlgTracker") << "...done, " << fCluHits.size() << " clusters for 3D tracking.";
 }

void pma::PMAlgTracker::init	(	const art::FindManyP< recob::Hit > &	hitsFromClusters,
		const std::vector< float > &	trackLike
	)

Definition at line 385 of file PMAlgTracking.cxx.

References fCluHits, fCluWeights, and lar::dump::vector().

 {
   mf::LogVerbatim("PMAlgTracker") << "Filter track-like clusters using likelihood values...";
   fCluHits.clear();
   fCluHits.reserve(hitsFromClusters.size());
   fCluWeights.clear();
   fCluWeights.reserve(fCluHits.size());
   for (size_t i = 0; i < hitsFromClusters.size(); ++i) {
     auto v = hitsFromClusters.at(i);
     fCluHits.push_back(std::vector<art::Ptr<recob::Hit>>());
     for (auto const& h : v)
       fCluHits.back().push_back(h);
     fCluWeights.push_back(trackLike[i]);
   }
 }

void pma::PMAlgTracker::init	(	const art::FindManyP< recob::Hit > &	hitsFromClusters,
		const art::FindManyP< recob::Hit > &	hitsFromEmParts
	)

Definition at line 403 of file PMAlgTracking.cxx.

References fCluHits, fCluWeights, n, and lar::dump::vector().

 {
   mf::LogVerbatim("PMAlgTracker") << "Filter track-like clusters...";
   fCluHits.clear();
   fCluHits.reserve(hitsFromClusters.size());
   fCluWeights.clear();
   fCluWeights.reserve(fCluHits.size());
   size_t n = 0; // count not-empty clusters
   for (size_t i = 0; i < hitsFromClusters.size(); ++i) {
     auto v = hitsFromClusters.at(i);
     fCluHits.push_back(std::vector<art::Ptr<recob::Hit>>());
     for (auto const& h : v) {
       bool trkLike = true;
       for (size_t j = 0; j < hitsFromEmParts.size(); ++j) {
         auto u = hitsFromEmParts.at(j);
         for (auto const& g : u) // is hit clustered in one of em-like?
         {
           if (g.key() == h.key()) {
             trkLike = false;
             break;
           }
         }
         if (!trkLike) break;
       }
       if (trkLike) fCluHits.back().push_back(h);
     }
     if (!fCluHits.back().empty()) {
       fCluWeights.push_back(1);
       ++n;
     }
     else {
       fCluWeights.push_back(0);
     }
   }
   mf::LogVerbatim("PMAlgTracker") << "...done, " << n << " clusters for 3D tracking.";
 }

void pma::PMAlgTracker::listUsedClusters ( detinfo::DetectorPropertiesData const & detProp ) const

private

Definition at line 1459 of file PMAlgTracking.cxx.

References util::empty(), fCluHits, fCluWeights, pma::PMAlgTrackingBase::fResult, fUsedClusters, has(), matchTrack(), and util::size().

Referenced by build().

 {
   mf::LogVerbatim("PMAlgTracker") << std::endl << "----------- matched clusters: -----------";
   for (size_t i = 0; i < fCluHits.size(); ++i) {
     if (!fCluHits[i].empty() && has(fUsedClusters, i)) {
       mf::LogVerbatim("PMAlgTracker")
         << "    tpc: " << fCluHits[i].front()->WireID().TPC
         << ";\tview: " << fCluHits[i].front()->View() << ";\tsize: " << fCluHits[i].size()
         << ";\tweight: " << fCluWeights[i];
     }
   }
 
   mf::LogVerbatim("PMAlgTracker") << "--------- not matched clusters: ---------";
   size_t nsingles = 0;
   for (size_t i = 0; i < fCluHits.size(); ++i) {
     if (!fCluHits[i].empty() && !has(fUsedClusters, i)) {
       if (fCluHits[i].size() == 1) { nsingles++; }
       else {
         mf::LogVerbatim("PMAlgTracker")
           << "    tpc: " << fCluHits[i].front()->WireID().TPC
           << ";\tview: " << fCluHits[i].front()->View() << ";\tsize: " << fCluHits[i].size()
           << ";\tweight: " << fCluWeights[i]
           << ";\tmatch: " << matchTrack(detProp, fResult, fCluHits[i]);
       }
     }
   }
   mf::LogVerbatim("PMAlgTracker") << "    single hits: " << nsingles;
   mf::LogVerbatim("PMAlgTracker") << "-----------------------------------------";
 }

pma::TrkCandidate pma::PMAlgTracker::matchCluster	(	detinfo::DetectorPropertiesData const &	detProp,
		int	first_clu_idx,
		const std::vector< art::Ptr< recob::Hit >> &	first_hits,
		size_t	minSizeCompl,
		unsigned int	tpc,
		unsigned int	cryo,
		geo::View_t	first_view
	)

private

Definition at line 1098 of file PMAlgTracking.cxx.

Referenced by fromMaxCluster_tpc(), and reassignHits_1().

 {
   pma::TrkCandidate result;
 
   for (auto av : fAvailableViews) {
     fTriedClusters[av].clear();
   }
 
   if (first_clu_idx >= 0) {
     fTriedClusters[first_view].push_back((size_t)first_clu_idx);
     fInitialClusters.push_back((size_t)first_clu_idx);
   }
 
   unsigned int nFirstHits = first_hits.size(), first_plane_idx = first_hits.front()->WireID().Plane;
   mf::LogVerbatim("PMAlgTracker") << std::endl << "--- start new candidate ---";
   mf::LogVerbatim("PMAlgTracker") << "use view  *** " << first_view << " *** plane idx "
                                   << first_plane_idx << " ***  size: " << nFirstHits;
 
   float xmax = detProp.ConvertTicksToX(first_hits.front()->PeakTime(), first_plane_idx, tpc, cryo);
   float xmin = xmax;
   for (size_t j = 1; j < first_hits.size(); ++j) {
     float x = detProp.ConvertTicksToX(first_hits[j]->PeakTime(), first_plane_idx, tpc, cryo);
     if (x > xmax) { xmax = x; }
     if (x < xmin) { xmin = x; }
   }
 
   pma::TrkCandidateColl candidates; // possible solutions of the selected cluster and clusters in
                                     // complementary views
 
   size_t imatch = 0;
   bool try_build = true;
   while (try_build) // loop over complementary views
   {
     pma::TrkCandidate candidate;
     if (first_clu_idx >= 0) candidate.Clusters().push_back((size_t)first_clu_idx);
 
     try_build = false;
     int idx = -1, av_idx = -1;
     unsigned int nMaxHits = 0, nHits = 0;
     unsigned int testView = geo::kUnknown, bestView = geo::kUnknown;
     for (auto av : fAvailableViews) {
       if (av == first_view) continue;
 
       av_idx =
         maxCluster(detProp, first_clu_idx, candidates, xmin, xmax, minSizeCompl, av, tpc, cryo);
       if (av_idx >= 0) {
         nHits = fCluHits[av_idx].size();
         if ((nHits > nMaxHits) && (nHits >= minSizeCompl)) {
           nMaxHits = nHits;
           idx = av_idx;
           bestView = av;
           fTriedClusters[av].push_back(idx);
           try_build = true;
         }
       }
     }
     for (auto av : fAvailableViews) {
       if ((av != first_view) && (av != bestView)) {
         testView = av;
         break;
       }
     }
 
     if (try_build) {
       mf::LogVerbatim("PMAlgTracker") << "--> " << imatch++ << " match with:";
       mf::LogVerbatim("PMAlgTracker")
         << "    cluster in view  *** " << bestView << " ***  size: " << nMaxHits;
 
       if (!fGeom->TPC(geo::TPCID(cryo, tpc)).HasPlane(testView)) {
         mf::LogVerbatim("PMAlgTracker") << "    no validation plane  *** ";
         testView = geo::kUnknown;
       }
       else {
         mf::LogVerbatim("PMAlgTracker") << "    validation plane  *** " << testView << " ***";
       }
 
       double m0 = 0.0, v0 = 0.0;
       double mseThr = 0.15, validThr = 0.7; // cuts for a good track candidate
 
       candidate.Clusters().push_back(idx);
       candidate.SetTrack(fProjectionMatchingAlg.buildTrack(detProp, first_hits, fCluHits[idx]));
 
       if (candidate.IsValid() && // no track if hits from 2 views do not alternate
           fProjectionMatchingAlg.isContained(*(candidate.Track()), 2.0F)) // sticks out of TPC's?
       {
         m0 = candidate.Track()->GetMse();
         if (m0 < mseThr) // check validation only if MSE is OK - thanks for Tracy for noticing this
         {
           v0 = validate(detProp, *(candidate.Track()), testView);
         }
       }
 
       if (candidate.Track() && (m0 < mseThr) && (v0 > validThr)) // good candidate, try to extend it
       {
         mf::LogVerbatim("PMAlgTracker") << "  good track candidate, MSE = " << m0 << ", v = " << v0;
 
         candidate.SetMse(m0);
         candidate.SetValidation(v0);
         candidate.SetGood(true);
 
         size_t minSize = 5;    // min size for clusters matching
         double fraction = 0.5; // min fraction of close hits
 
         idx = 0;
         while (idx >= 0) // try to collect matching clusters, use **any** plane except validation
         {
           idx = matchCluster(detProp, candidate, minSize, fraction, geo::kUnknown, testView);
           if (idx >= 0) {
             // try building extended copy:
             //                src,        hits,      valid.plane, add nodes
             if (extendTrack(detProp, candidate, fCluHits[idx], testView, true)) {
               candidate.Clusters().push_back(idx);
             }
             else
               idx = -1;
           }
         }
 
         mf::LogVerbatim("PMAlgTracker") << "merge clusters from the validation plane";
         fraction = 0.7; // only well matching the existing track
 
         idx = 0;
         bool extended = false;
         while ((idx >= 0) &&
                (testView != geo::kUnknown)) { //                     match clusters from the
                                               //                     plane used previously
                                               //                     for the validation
           idx = matchCluster(detProp, candidate, minSize, fraction, testView, geo::kUnknown);
           if (idx >= 0) {
             // validation not checked here, no new nodes:
             if (extendTrack(detProp, candidate, fCluHits[idx], geo::kUnknown, false)) {
               candidate.Clusters().push_back(idx);
               extended = true;
             }
             else
               idx = -1;
           }
         }
         // need to calculate again only if trk was extended w/o checking
         // validation:
         if (extended) candidate.SetValidation(validate(detProp, *(candidate.Track()), testView));
       }
       else {
         mf::LogVerbatim("PMAlgTracker") << "track REJECTED, MSE = " << m0 << "; v = " << v0;
         candidate.SetGood(false); // save also bad matches to avoid trying again
                                   // the same pair of clusters
       }
       candidates.push_back(candidate);
     }
     else {
       mf::LogVerbatim("PMAlgTracker") << "no matching clusters";
     }
   } // end loop over complementary views
 
   if (!candidates.empty()) // return best candidate, release other tracks and clusters
   {
     int best_trk = -1;
     double f, max_f = 0., min_mse = 10., max_v = 0.;
     for (size_t t = 0; t < candidates.size(); t++)
       if (candidates[t].IsGood() && (candidates[t].Track()->Nodes().size() > 1) &&
           candidates[t].Track()->HasTwoViews()) {
         f = fProjectionMatchingAlg.twoViewFraction(*(candidates[t].Track()));
 
         if ((f > max_f) || ((f == max_f) && ((candidates[t].Validation() > max_v) ||
                                              (candidates[t].Mse() < min_mse)))) {
           max_f = f;
           min_mse = candidates[t].Mse();
           max_v = candidates[t].Validation();
           best_trk = t;
         }
       }
 
     if ((best_trk > -1) && candidates[best_trk].IsGood() && (max_f > fMinTwoViewFraction)) {
       candidates[best_trk].Track()->ShiftEndsToHits();
 
       for (auto c : candidates[best_trk].Clusters())
         fUsedClusters.push_back(c);
 
       result = candidates[best_trk];
     }
 
     for (size_t t = 0; t < candidates.size(); t++) {
       if (int(t) != best_trk) candidates[t].DeleteTrack();
     }
   }
 
   return result;
 }

pma::TrkCandidate pma::PMAlgTracker::matchCluster	(	detinfo::DetectorPropertiesData const &	detProp,
		int	first_clu_idx,
		size_t	minSizeCompl,
		unsigned int	tpc,
		unsigned int	cryo,
		geo::View_t	first_view
	)

inlineprivate

Definition at line 318 of file PMAlgTracking.h.

References hits(), and lar::dump::vector().

   {
     return matchCluster(
       detProp, first_clu_idx, fCluHits[first_clu_idx], minSizeCompl, tpc, cryo, first_view);
   }

int pma::PMAlgTracker::matchCluster	(	detinfo::DetectorPropertiesData const &	detProp,
		const pma::TrkCandidate &	trk,
		size_t	minSize,
		double	fraction,
		unsigned int	preferedView,
		unsigned int	testView
	)		const

private

Definition at line 1331 of file PMAlgTracking.cxx.

References pma::TrkCandidate::Clusters(), util::empty(), f, fCluHits, pma::PMAlgTrackingBase::fProjectionMatchingAlg, fUsedClusters, has(), geo::kUnknown, n, pma::ProjectionMatchingAlg::testHits(), and pma::TrkCandidate::Track().

 {
   double f, fmax = 0.0;
   unsigned int n, max = 0;
   int idx = -1;
   for (size_t i = 0; i < fCluHits.size(); ++i) {
     if (fCluHits[i].empty()) continue;
 
     unsigned int view = fCluHits[i].front()->View();
     unsigned int nhits = fCluHits[i].size();
 
     if (has(fUsedClusters, i) ||  // don't try already used clusters
         has(trk.Clusters(), i) || // don't try clusters from this candidate
         (view == testView) ||     // don't use clusters from validation view
         ((preferedView != geo::kUnknown) &&
          (view != preferedView)) || // only prefered view if specified
         (nhits < minSize))          // skip small clusters
       continue;
 
     n = fProjectionMatchingAlg.testHits(detProp, *(trk.Track()), fCluHits[i]);
     f = n / (double)nhits;
     if ((f > fraction) && (n > max)) {
       max = n;
       fmax = f;
       idx = i;
     }
   }
 
   if (idx >= 0)
     mf::LogVerbatim("PMAlgTracker") << "max matching hits: " << max << " (" << fmax << ")";
   else
     mf::LogVerbatim("PMAlgTracker") << "no clusters to extend the track";
 
   return idx;
 }

size_t pma::PMAlgTracker::matchTrack	(	detinfo::DetectorPropertiesData const &	detProp,
		const pma::TrkCandidateColl &	tracks,
		const std::vector< art::Ptr< recob::Hit >> &	hits
	)		const

private

Definition at line 932 of file PMAlgTracking.cxx.

References pma::PMAlgTrackingBase::fProjectionMatchingAlg, hits(), n, pma::ProjectionMatchingAlg::testHits(), and pma::TrkCandidateColl::tracks().

Referenced by listUsedClusters().

 {
   size_t max_hits = 0;
   for (auto const& t : tracks.tracks()) {
     size_t n = fProjectionMatchingAlg.testHits(detProp, *(t.Track()), hits);
     if (n > max_hits) { max_hits = n; }
   }
   return max_hits;
 }

int pma::PMAlgTracker::maxCluster	(	detinfo::DetectorPropertiesData const &	detProp,
		int	first_idx_tag,
		const pma::TrkCandidateColl &	candidates,
		float	xmin,
		float	xmax,
		size_t	min_clu_size,
		geo::View_t	view,
		unsigned int	tpc,
		unsigned int	cryo
	)		const

private

Definition at line 1373 of file PMAlgTracking.cxx.

References detinfo::DetectorPropertiesData::ConvertTicksToX(), fCluHits, fInitialClusters, fTriedClusters, fUsedClusters, has(), util::size(), pma::TrkCandidateColl::tracks(), and x.

Referenced by fromMaxCluster_tpc(), and matchCluster().

 {
   int idx = -1;
   size_t s_max = 0, s;
   double fraction = 0.0;
   float x;
 
   size_t first_idx = 0;
   bool has_first = false;
   if (first_idx_tag >= 0) {
     first_idx = (size_t)first_idx_tag;
     has_first = true;
   }
 
   for (size_t i = 0; i < fCluHits.size(); ++i) {
     if ((fCluHits[i].size() < min_clu_size) || (fCluHits[i].front()->View() != view) ||
         has(fUsedClusters, i) || has(fInitialClusters, i) || has(fTriedClusters[view], i))
       continue;
 
     bool pair_checked = false;
     for (auto const& c : candidates.tracks())
       if (has_first && has(c.Clusters(), first_idx) && has(c.Clusters(), i)) {
         pair_checked = true;
         break;
       }
     if (pair_checked) continue;
 
     const auto& v = fCluHits[i];
 
     if ((v.front()->WireID().TPC == tpc) && (v.front()->WireID().Cryostat == cryo)) {
       s = 0;
       for (size_t j = 0; j < v.size(); ++j) {
         x = detProp.ConvertTicksToX(v[j]->PeakTime(), v[j]->WireID().Plane, tpc, cryo);
         if ((x >= xmin) && (x <= xmax)) s++;
       }
 
       if (s > s_max) {
         s_max = s;
         idx = i;
         fraction = s / (double)v.size();
       }
     }
   }
   if (fraction > 0.4) return idx;
 
   return -1;
 }

int pma::PMAlgTracker::maxCluster	(	size_t	min_clu_size,
		geo::View_t	view,
		unsigned int	tpc,
		unsigned int	cryo
	)		const

private

Definition at line 1430 of file PMAlgTracking.cxx.

References fCluHits, fCluWeights, fInitialClusters, fTrackLikeThreshold, fTriedClusters, fUsedClusters, has(), and geo::kUnknown.

 {
   int idx = -1;
   size_t s_max = 0;
 
   for (size_t i = 0; i < fCluHits.size(); ++i) {
     const auto& v = fCluHits[i];
 
     if (v.empty() || (fCluWeights[i] < fTrackLikeThreshold) || has(fUsedClusters, i) ||
         has(fInitialClusters, i) || has(fTriedClusters[view], i) ||
         ((view != geo::kUnknown) && (v.front()->View() != view)))
       continue;
 
     if ((v.front()->WireID().TPC == tpc) && (v.front()->WireID().Cryostat == cryo)) {
       size_t s = v.size();
       if ((s >= min_clu_size) && (s > s_max)) {
         s_max = s;
         idx = i;
       }
     }
   }
   return idx;
 }

bool pma::PMAlgTracker::mergeCoLinear	(	detinfo::DetectorPropertiesData const &	detProp,
		pma::TrkCandidateColl &	tracks
	)		const

private

Definition at line 758 of file PMAlgTracking.cxx.

References areCoLinear(), pma::Track3D::back(), d, pma::Dist2(), pma::TrkCandidateColl::erase_at(), fMergeAngle, fMergeTransverseShift, pma::PMAlgTrackingBase::fProjectionMatchingAlg, pma::Track3D::front(), pma::ProjectionMatchingAlg::mergeTracks(), pma::Hit3D::Point3D(), r, pma::TrkCandidateColl::size(), pma::Track3D::size(), and pma::TrkCandidateColl::tracks().

Referenced by build().

 {
   double distThr = 0.25;   // max gap as a fraction of the longer track length
   double distThrMin = 0.5; // lower limit of max gap threshold [cm]
 
   double distProjThr = fMergeTransverseShift;
   double cosThr = cos(TMath::Pi() * fMergeAngle / 180.0);
 
   bool foundMerge = false;
 
   std::sort(tracks.tracks().begin(), tracks.tracks().end(), pma::bTrack3DLonger());
 
   bool r;
   double d, dmin, c, cmax, l, lbest;
   size_t t = 0, u = 0;
   while (t < tracks.size()) {
     pma::Track3D* trk1 = tracks[t].Track();
 
     pma::Track3D* trk2 = 0;
     pma::Track3D* best_trk2 = 0;
     dmin = 1.0e12;
     cmax = 0;
     lbest = 0;
     size_t ubest = 0;
     for (u = t + 1; u < tracks.size(); u++) {
       trk2 = tracks[u].Track();
       if (areCoLinear(trk1, trk2, d, c, r, distThr, distThrMin, distProjThr, cosThr)) {
         l = std::sqrt(pma::Dist2(trk2->front()->Point3D(), trk2->back()->Point3D()));
         if (((c > cmax) && (d < dmin + 0.5 * lbest)) || ((d < dmin) && (l > 1.5 * lbest))) {
           cmax = c;
           dmin = d;
           best_trk2 = trk2;
           lbest = l;
           ubest = u;
         }
       }
       trk2 = 0;
     }
     trk2 = best_trk2;
 
     if (trk2) {
       mf::LogVerbatim("PMAlgTracker")
         << "Merge track (" << trk1->size() << ") with track (" << trk2->size() << ")";
       if (r) {
         fProjectionMatchingAlg.mergeTracks(detProp, *trk2, *trk1, true);
         tracks[t].SetTrack(trk2); // deletes old trk1
       }
       else {
         fProjectionMatchingAlg.mergeTracks(detProp, *trk1, *trk2, true);
         tracks[ubest].DeleteTrack();
       }
       tracks.erase_at(ubest);
       foundMerge = true;
     }
     else
       t++;
   }
 
   return foundMerge;
 }

void pma::PMAlgTracker::mergeCoLinear	(	detinfo::DetectorClocksData const &	clockData,
		detinfo::DetectorPropertiesData const &	detProp,
		pma::tpc_track_map &	tracks
	)		const

private

Definition at line 834 of file PMAlgTracking.cxx.

References pma::Track3D::ApplyDriftShiftInTree(), areCoLinear(), pma::Track3D::back(), d, geo::TPCGeo::DetectDriftDirection(), pma::Dist2(), pma::PMAlgTrackingBase::fProjectionMatchingAlg, pma::Track3D::front(), fStitchAngle, fStitchDistToWall, fStitchTransverseShift, pma::ProjectionMatchingAlg::mergeTracks(), pma::Track3D::Nodes(), pma::Hit3D::Point3D(), r, pma::TrkCandidateColl::size(), and pma::Track3D::size().

 {
   double distThr = 0.25;   // max gap as a fraction of the longer track length
   double distThrMin = 2.5; // lower limit of max gap threshold [cm]
 
   double distProjThr = fStitchTransverseShift;
   double cosThr = cos(TMath::Pi() * fStitchAngle / 180.0);
 
   double wallDistThr = fStitchDistToWall;
   double dfront1, dback1, dfront2, dback2;
 
   for (auto& tpc_entry1 : tracks) {
     unsigned int tpc1 = tpc_entry1.first;
     pma::TrkCandidateColl& tracks1 = tpc_entry1.second;
 
     size_t t = 0;
     while (t < tracks1.size()) {
       bool r, reverse = false;
       double l, lbest = 0, d, dmin = 1.0e12, c, cmax = 0.0;
       pma::Track3D* best_trk2 = 0;
       unsigned int best_tpc = 0;
       size_t best_idx = 0;
 
       pma::Track3D* trk1 = tracks1[t].Track();
       dfront1 = trk1->Nodes().front()->GetDistToWall();
       dback1 = trk1->Nodes().back()->GetDistToWall();
       if ((dfront1 < wallDistThr) || (dback1 < wallDistThr)) {
         for (auto& tpc_entry2 : tracks) {
           unsigned int tpc2 = tpc_entry2.first;
           if (tpc2 == tpc1) continue;
 
           pma::TrkCandidateColl& tracks2 = tpc_entry2.second;
 
           for (size_t u = 0; u < tracks2.size(); u++) {
             pma::Track3D* trk2 = tracks2[u].Track();
             dfront2 = trk2->Nodes().front()->GetDistToWall();
             dback2 = trk2->Nodes().back()->GetDistToWall();
             if ((dfront2 < wallDistThr) || (dback2 < wallDistThr)) {
               if (areCoLinear(trk1, trk2, d, c, r, distThr, distThrMin, distProjThr, cosThr)) {
                 l = std::sqrt(pma::Dist2(trk2->front()->Point3D(), trk2->back()->Point3D()));
                 if (((c > cmax) && (d < dmin + 0.5 * lbest)) || (0.75 * l < dmin)) {
                   cmax = c;
                   dmin = d;
                   lbest = l;
                   best_trk2 = trk2;
                   best_tpc = tpc2;
                   best_idx = u;
                   reverse = r;
                 }
               }
             }
           }
         }
       }
 
       if (best_trk2) {
         mf::LogVerbatim("PMAlgTracker")
           << "Merge track (" << tpc1 << ":" << tracks1.size() << ":" << trk1->size()
           << ") with track (" << best_tpc << ":" << tracks[best_tpc].size() << ":"
           << best_trk2->size() << ")";
         auto const* geom = lar::providerFrom<geo::Geometry>();
         auto const* first_node_trk1 = trk1->Nodes().front();
         const geo::TPCGeo& tpc1 =
           geom->TPC(geo::TPCID(first_node_trk1->Cryo(), first_node_trk1->TPC()));
         auto const* first_node_trk2 = best_trk2->Nodes().front();
         const geo::TPCGeo& tpc2 =
           geom->TPC(geo::TPCID(first_node_trk2->Cryo(), first_node_trk2->TPC()));
         if (reverse) {
           fProjectionMatchingAlg.mergeTracks(detProp, *best_trk2, *trk1, true);
           // This track will have a shift in x equal to zero. This will
           // properly set the track T0
           if (tpc1.DetectDriftDirection() * tpc2.DetectDriftDirection() < 0) {
             best_trk2->ApplyDriftShiftInTree(clockData, detProp, 0.0);
           }
           tracks1[t].SetTrack(best_trk2);
         }
         else {
           fProjectionMatchingAlg.mergeTracks(detProp, *trk1, *best_trk2, true);
           // This track will have a shift in x equal to zero. This will
           // properly set the track T0
           if (tpc1.DetectDriftDirection() * tpc2.DetectDriftDirection() < 0) {
             trk1->ApplyDriftShiftInTree(clockData, detProp, 0.0);
           }
           tracks[best_tpc][best_idx].DeleteTrack();
         }
         tracks[best_tpc].erase_at(best_idx);
       }
       else
         t++;
     }
   }
 
   //for (auto & tpc_entry : tracks) releaseAllNodes(tpc_entry.second);
 }

bool pma::PMAlgTracker::reassignHits_1	(	detinfo::DetectorPropertiesData const &	detProp,
		const std::vector< art::Ptr< recob::Hit >> &	hits,
		pma::TrkCandidateColl &	tracks,
		size_t	trk_idx,
		double	dist2
	)

private

Definition at line 493 of file PMAlgTracking.cxx.

References pma::Track3D::CleanupTails(), pma::ProjectionMatchingAlg::extendTrack(), fMinSeedSize2ndPass, pma::PMAlgTrackingBase::fProjectionMatchingAlg, hits(), pma::ProjectionMatchingAlg::isContained(), pma::TrkCandidate::IsGood(), matchCluster(), n, pma::TrkCandidateColl::push_back(), pma::Track3D::RemoveHits(), pma::PMAlgTrackingBase::result(), pma::Track3D::ShiftEndsToHits(), pma::TrkCandidateColl::size(), pma::Track3D::SortHits(), and pma::ProjectionMatchingAlg::testHits().

Referenced by reassignSingleViewEnds_1().

 {
   pma::Track3D* trk1 = tracks[trk_idx].Track();
 
   bool result = false;
   if ((hits.size() > 1) || (dist2 > 1.0)) // min. 2 hits or single hit separated from the rest
   {
     pma::Track3D* best_trk = 0;
 
     size_t best_u = 0, n_max = 0;
     for (size_t u = 0; u < tracks.size(); u++)
       if (trk_idx != u) {
         pma::Track3D* trk2 = tracks[u].Track();
         size_t n = fProjectionMatchingAlg.testHits(detProp, *trk2, hits);
         if (n > n_max) {
           n_max = n;
           best_u = u;
           best_trk = trk2;
         }
       }
 
     if (best_trk && (n_max >= hits.size() / 3)) // /2
     {
       mf::LogVerbatim("PMAlgTrackMaker") << "  Reassign(v1) " << n_max << " hits." << std::endl;
 
       trk1->RemoveHits(hits);
       trk1->CleanupTails();
       trk1->ShiftEndsToHits();
 
       pma::Track3D* ext = fProjectionMatchingAlg.extendTrack(detProp, *best_trk, hits, false);
       ext->SortHits();
       ext->ShiftEndsToHits();
       if (fProjectionMatchingAlg.isContained(*ext)) {
         tracks[best_u].SetTrack(ext); // and this deletes best_trk stored at best_u
         result = true;
       }
       else
         delete ext;
     }
     else if (hits.size() >= fMinSeedSize2ndPass) {
       size_t minSizeCompl = hits.size() / 8; // much smaller minimum required in complementary views
       if (minSizeCompl < 3) minSizeCompl = 3; // but at least three hits!
 
       geo::View_t first_view = (geo::View_t)hits.front()->WireID().Plane;
       unsigned int tpc = hits.front()->WireID().TPC;
       unsigned int cryo = hits.front()->WireID().Cryostat;
 
       pma::TrkCandidate candidate =
         matchCluster(detProp, -1, hits, minSizeCompl, tpc, cryo, first_view);
 
       if (candidate.IsGood()) {
         mf::LogVerbatim("PMAlgTrackMaker")
           << "  Add new track, cut hits from source track." << std::endl;
         tracks.push_back(candidate);
 
         trk1->RemoveHits(hits);
         trk1->CleanupTails();
         trk1->ShiftEndsToHits();
       }
     }
   }
   else if ((hits.size() == 1) || (dist2 > 2.25)) // dist > 1.5cm
   {
     mf::LogVerbatim("PMAlgTrackMaker") << "  Cut single-view isolated hit." << std::endl;
     trk1->RemoveHits(hits);
     trk1->CleanupTails();
     trk1->ShiftEndsToHits();
   }
   return result;
 }

bool pma::PMAlgTracker::reassignSingleViewEnds_1	(	detinfo::DetectorPropertiesData const &	detProp,
		pma::TrkCandidateColl &	tracks
	)

private

Definition at line 608 of file PMAlgTracking.cxx.

References collectSingleViewEnd(), collectSingleViewFront(), pma::Track3D::DisableSingleViewEnds(), hits(), reassignHits_1(), pma::PMAlgTrackingBase::result(), pma::Track3D::SelectHits(), pma::TrkCandidateColl::size(), and pma::Track3D::size().

Referenced by build().

 {
   bool result = false;
   for (size_t t = 0; t < tracks.size(); t++) {
     pma::Track3D& trk = *(tracks[t].Track());
     if (trk.size() < 6) continue;
 
     trk.DisableSingleViewEnds();
 
     std::vector<art::Ptr<recob::Hit>> hits;
 
     double d2 = collectSingleViewEnd(trk, hits);
     result |= reassignHits_1(detProp, hits, tracks, t, d2);
 
     hits.clear();
 
     d2 = collectSingleViewFront(trk, hits);
     result |= reassignHits_1(detProp, hits, tracks, t, d2);
 
     trk.SelectHits();
   }
   return result;
 }

void pma::PMAlgTracker::releaseAllNodes ( pma::TrkCandidateColl & tracks ) const

private

Definition at line 827 of file PMAlgTracking.cxx.

References pma::TrkCandidateColl::tracks().

 {
   for (auto const& trk : tracks.tracks())
     for (auto node : trk.Track()->Nodes())
       node->SetFrozen(false);
 }

const pma::TrkCandidateColl& pma::PMAlgTrackingBase::result ( )

inlineinherited

Definition at line 66 of file PMAlgTracking.h.

Referenced by matchCluster(), reassignHits_1(), and reassignSingleViewEnds_1().

66 { return fResult; }

pma::PMAlgTrackingBase::fResult

pma::TrkCandidateColl fResult

Definition: PMAlgTracking.h:93

double pma::PMAlgTracker::validate	(	detinfo::DetectorPropertiesData const &	detProp,
		pma::Track3D &	trk,
		unsigned int	testView
	)

private

Definition at line 442 of file PMAlgTracking.cxx.

References fAdcImages, fAdcInPassingPoints, fAdcInRejectedPoints, fAdcValidationThr, pma::PMAlgTrackingBase::fHitMap, pma::Track3D::FirstElement(), pma::PMAlgTrackingBase::fProjectionMatchingAlg, pma::Track3D::FrontCryo(), pma::Track3D::FrontTPC(), fValidation, pma::Node3D::GetDistToWall(), kAdc, kCalib, kHits, geo::kUnknown, pma::Track3D::LastElement(), pma::ProjectionMatchingAlg::validate(), pma::ProjectionMatchingAlg::validate_on_adc(), and pma::ProjectionMatchingAlg::validate_on_adc_test().

Referenced by extendTrack(), and matchCluster().

 {
   if ((trk.FirstElement()->GetDistToWall() < -3.0) || (trk.LastElement()->GetDistToWall() < -3.0)) {
     mf::LogVerbatim("PMAlgTracker") << "first or last node too far out of its initial TPC";
     return 0.0;
   }
 
   if (testView != geo::kUnknown) {
     mf::LogVerbatim("PMAlgTracker") << "validation in plane: " << testView;
   }
   else {
     return 1.0;
   }
 
   double v = 0;
   auto const& channelStatus = art::ServiceHandle<lariov::ChannelStatusService const>
   {
     } -> GetProvider();
   switch (fValidation) {
   case pma::PMAlgTracker::kAdc:
     v = fProjectionMatchingAlg.validate_on_adc(
       detProp, channelStatus, trk, fAdcImages[testView], fAdcValidationThr[testView]);
     break;
 
   case pma::PMAlgTracker::kHits:
     v = fProjectionMatchingAlg.validate(
       detProp, channelStatus, trk, fHitMap[trk.FrontCryo()][trk.FrontTPC()][testView]);
     break;
 
   case pma::PMAlgTracker::kCalib:
     v = fProjectionMatchingAlg.validate_on_adc_test(
       detProp,
       channelStatus,
       trk,
       fAdcImages[testView],
       fHitMap[trk.FrontCryo()][trk.FrontTPC()][testView],
       fAdcInPassingPoints[testView],
       fAdcInRejectedPoints[testView]);
     break;
 
   default:
     throw cet::exception("pma::PMAlgTracker") << "validation mode not supported" << std::endl;
     break;
   }
 
   return v;
 }

Member Data Documentation

std::vector<img::DataProviderAlg> pma::PMAlgTracker::fAdcImages

private

Definition at line 411 of file PMAlgTracking.h.

Referenced by build(), PMAlgTracker(), and validate().

const std::vector<TH1F*>& pma::PMAlgTracker::fAdcInPassingPoints

private

Definition at line 415 of file PMAlgTracking.h.

Referenced by validate().

const std::vector<TH1F*>& pma::PMAlgTracker::fAdcInRejectedPoints

private

Definition at line 416 of file PMAlgTracking.h.

Referenced by validate().

std::vector<double> pma::PMAlgTracker::fAdcValidationThr

private

Definition at line 412 of file PMAlgTracking.h.

Referenced by PMAlgTracker(), and validate().

bool pma::PMAlgTracker::fAutoFlip_dQdx

private

Definition at line 382 of file PMAlgTracking.h.

Referenced by build().

std::vector<geo::View_t> pma::PMAlgTracker::fAvailableViews

private

Definition at line 370 of file PMAlgTracking.h.

Referenced by matchCluster(), and PMAlgTracker().

std::vector<std::vector<art::Ptr<recob::Hit> > > pma::PMAlgTracker::fCluHits

private

Definition at line 364 of file PMAlgTracking.h.

Referenced by fromMaxCluster_tpc(), init(), listUsedClusters(), matchCluster(), and maxCluster().

std::vector<float> pma::PMAlgTracker::fCluWeights

private

Definition at line 365 of file PMAlgTracking.h.

Referenced by init(), listUsedClusters(), and maxCluster().

pma::PMAlgCosmicTagger pma::PMAlgTracker::fCosmicTagger

private

Definition at line 390 of file PMAlgTracking.h.

Referenced by build().

bool pma::PMAlgTracker::fFlipDownward

private

Definition at line 380 of file PMAlgTracking.h.

Referenced by build().

bool pma::PMAlgTracker::fFlipToBeam

private

Definition at line 379 of file PMAlgTracking.h.

Referenced by build().

bool pma::PMAlgTracker::fFlipToX

private

Definition at line 381 of file PMAlgTracking.h.

Referenced by build().

geo::GeometryCore const* pma::PMAlgTracker::fGeom

private

Definition at line 419 of file PMAlgTracking.h.

Referenced by build(), matchCluster(), and PMAlgTracker().

pma::cryo_tpc_view_hitmap pma::PMAlgTrackingBase::fHitMap

protectedinherited

Definition at line 88 of file PMAlgTracking.h.

Referenced by pma::PMAlgTrackingBase::guideEndpoints(), pma::PMAlgTrackingBase::PMAlgTrackingBase(), and validate().

std::vector<size_t> pma::PMAlgTracker::fInitialClusters

private

Definition at line 368 of file PMAlgTracking.h.

Referenced by build(), fromMaxCluster_tpc(), matchCluster(), and maxCluster().

bool pma::PMAlgTracker::fMatchT0inAPACrossing

private

Definition at line 401 of file PMAlgTracking.h.

Referenced by build().

bool pma::PMAlgTracker::fMatchT0inCPACrossing

private

Definition at line 403 of file PMAlgTracking.h.

Referenced by build().

double pma::PMAlgTracker::fMergeAngle

private

Definition at line 388 of file PMAlgTracking.h.

Referenced by mergeCoLinear().

double pma::PMAlgTracker::fMergeTransverseShift

private

Definition at line 386 of file PMAlgTracking.h.

Referenced by mergeCoLinear().

bool pma::PMAlgTracker::fMergeWithinTPC

private

Definition at line 384 of file PMAlgTracking.h.

Referenced by build().

size_t pma::PMAlgTracker::fMinSeedSize1stPass

private

Definition at line 374 of file PMAlgTracking.h.

Referenced by build().

size_t pma::PMAlgTracker::fMinSeedSize2ndPass

private

Definition at line 375 of file PMAlgTracking.h.

Referenced by build(), and reassignHits_1().

double pma::PMAlgTracker::fMinTwoViewFraction

private

Definition at line 377 of file PMAlgTracking.h.

Referenced by matchCluster().

pma::PMAlgVertexing pma::PMAlgTrackingBase::fPMAlgVertexing

protectedinherited

Definition at line 91 of file PMAlgTracking.h.

Referenced by pma::PMAlgFitter::build(), and build().

pma::ProjectionMatchingAlg pma::PMAlgTrackingBase::fProjectionMatchingAlg

protectedinherited

Definition at line 90 of file PMAlgTracking.h.

Referenced by pma::PMAlgFitter::buildShowers(), pma::PMAlgFitter::buildTracks(), extendTrack(), pma::PMAlgTrackingBase::guideEndpoints(), matchCluster(), matchTrack(), mergeCoLinear(), reassignHits_1(), and validate().

pma::TrkCandidateColl pma::PMAlgTrackingBase::fResult

protectedinherited

Definition at line 93 of file PMAlgTracking.h.

Referenced by pma::PMAlgFitter::build(), build(), pma::PMAlgFitter::buildShowers(), pma::PMAlgFitter::buildTracks(), listUsedClusters(), and pma::PMAlgTrackingBase::~PMAlgTrackingBase().

bool pma::PMAlgTracker::fRunVertexing

private

Definition at line 408 of file PMAlgTracking.h.

Referenced by build().

double pma::PMAlgTracker::fStitchAngle

private

Definition at line 399 of file PMAlgTracking.h.

Referenced by mergeCoLinear().

bool pma::PMAlgTracker::fStitchBetweenTPCs

private

Definition at line 394 of file PMAlgTracking.h.

Referenced by build().

double pma::PMAlgTracker::fStitchDistToWall

private

Definition at line 396 of file PMAlgTracking.h.

Referenced by mergeCoLinear().

pma::PMAlgStitching pma::PMAlgTracker::fStitcher

private

Definition at line 406 of file PMAlgTracking.h.

Referenced by build().

double pma::PMAlgTracker::fStitchTransverseShift

private

Definition at line 397 of file PMAlgTracking.h.

Referenced by mergeCoLinear().

bool pma::PMAlgTracker::fTagCosmicTracks

private

Definition at line 391 of file PMAlgTracking.h.

Referenced by build().

float pma::PMAlgTracker::fTrackLikeThreshold

private

Definition at line 376 of file PMAlgTracking.h.

Referenced by maxCluster().

std::map<unsigned int, std::vector<size_t> > pma::PMAlgTracker::fTriedClusters

mutableprivate

Definition at line 369 of file PMAlgTracking.h.

Referenced by build(), matchCluster(), and maxCluster().

std::vector<size_t> pma::PMAlgTracker::fUsedClusters

private

Definition at line 368 of file PMAlgTracking.h.

Referenced by build(), listUsedClusters(), matchCluster(), and maxCluster().

EValidationMode pma::PMAlgTracker::fValidation

private

Definition at line 410 of file PMAlgTracking.h.

Referenced by build(), PMAlgTracker(), and validate().

const std::vector<recob::Wire>& pma::PMAlgTracker::fWires

private

Definition at line 363 of file PMAlgTracking.h.

Referenced by build().

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

larreco/v09_25_00/source/larreco/RecoAlg/PMAlgTracking.h
larreco/v09_25_00/source/larreco/RecoAlg/PMAlgTracking.cxx

Classes

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation