TTTrackAssociationMap< T > Class Template Reference

Stores association of Truth Particles (TP) to L1 Track-Trigger Tracks. More...

#include <TTTrackAssociationMap.h>

Public Member Functions
template<>
const TrackingParticlePtr &	findTrackingParticlePtr (TTTrackPtr aTrack) const
	Implementation of methods. More...
const TrackingParticlePtr &	findTrackingParticlePtr (TTTrackPtrT< T > aTrack) const
template<>
const TrackingParticlePtr &	findTrackingParticlePtr (TTTrackPtr aTrack) const
	Operations. More...
template<>
const std::vector< TTTrackPtr > &	findTTTrackPtrs (TrackingParticlePtr aTrackingParticle) const
const std::vector< TTTrackPtrT< T > > &	findTTTrackPtrs (TrackingParticlePtr aTrackingParticle) const
template<>
const std::vector< TTTrackPtr > &	findTTTrackPtrs (TrackingParticlePtr aTrackingParticle) const
bool	getAllowOneFalse2SStub ()
template<>
bool	getAllowOneFalse2SStub ()
const MapTPToVecL1Track< T > &	getTrackingParticleToTTTracksMap () const
const MapL1TrackToTP< T > &	getTTTrackToTrackingParticleMap () const
	Get/set stub <-> truth association maps. More...
template<>
bool	isCombinatoric (TTTrackPtr aTrack) const
bool	isCombinatoric (TTTrackPtrT< T > aTrack) const
	Both isLooselyGenuine() & isUnknown() are false. More...
template<>
bool	isCombinatoric (TTTrackPtr aTrack) const
template<>
bool	isGenuine (TTTrackPtr aTrack) const
	MC truth. More...
bool	isGenuine (TTTrackPtrT< T > aTrack) const
template<>
bool	isGenuine (TTTrackPtr aTrack) const
	MC truth. More...
template<>
bool	isLooselyGenuine (TTTrackPtr aTrack) const
	MC truth. More...
bool	isLooselyGenuine (TTTrackPtrT< T > aTrack) const
template<>
bool	isLooselyGenuine (TTTrackPtr aTrack) const
	MC truth. More...
template<>
bool	isUnknown (TTTrackPtr aTrack) const
bool	isUnknown (TTTrackPtrT< T > aTrack) const
	More than one stub on track is "unknown". More...
template<>
bool	isUnknown (TTTrackPtr aTrack) const
void	setAllowOneFalse2SStub (bool allowFalse2SStub)
template<>
void	setAllowOneFalse2SStub (bool allowFalse2SStub)
void	setTrackingParticleToTTTracksMap (const MapTPToVecL1Track< T > &aMap)
void	setTTStubAssociationMap (edm::RefProd< TTStubAssociationMap< T >> aStubAssoMap)
	Set stub <-> truth association object. More...
void	setTTTrackToTrackingParticleMap (const MapL1TrackToTP< T > &aMap)
	TTTrackAssociationMap ()
	Constructors. More...
	~TTTrackAssociationMap ()
	Destructor. More...

Private Attributes
bool	AllowOneFalse2SStub
edm::RefProd< TTStubAssociationMap< T > >	theStubAssociationMap_
MapTPToVecL1Track< T >	trackingParticleToTrackVectorMap_
MapL1TrackToTP< T >	trackToTrackingParticleMap_
	Data members. More...

Static Private Attributes
static const TrackingParticlePtr	nullTrackingParticlePtr_
	Close class. More...
static const std::vector< TTTrackPtr >	nullVecTTTrackPtr_

Detailed Description

template<typename T>
class TTTrackAssociationMap< T >

Stores association of Truth Particles (TP) to L1 Track-Trigger Tracks.

Contains two maps. One associates each L1 track its principle TP. (i.e. Not to all TP that contributed to it). The other associates each TP to a vector of all L1 tracks it contributed to. The two maps are therefore not forward-backward symmetric.

(The template structure is used to accomodate types other than PixelDigis, in case they are needed in future).

Author

Nicola Pozzobon

Date

2013, Jul 19 (tidy up: Ian Tomalin, 2020)

Definition at line 45 of file TTTrackAssociationMap.h.

Constructor & Destructor Documentation

TTTrackAssociationMap()

template<typename T >

TTTrackAssociationMap< T >::TTTrackAssociationMap

(

)

Constructors.

Default Constructor NOTE: to be used with setSomething(...) methods

Set default data members

Definition at line 129 of file TTTrackAssociationMap.h.

                                                {
}

~TTTrackAssociationMap()

template<typename T >

TTTrackAssociationMap< T >::~TTTrackAssociationMap

(

)

Destructor.

Definition at line 135 of file TTTrackAssociationMap.h.

{}

Member Function Documentation

findTrackingParticlePtr() [1/3]

template<>

const TrackingParticlePtr & TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::findTrackingParticlePtr

(

TTTrackPtr

aTrack

)

const

Implementation of methods.

Here, in the header file, the methods which do not depend on the specific type <T> that can fit the template. Other methods, with type-specific features, are implemented in the source file.Operations

Definition at line 12 of file TTTrackAssociationMap.cc.

                             {
  if (trackToTrackingParticleMap_.find(aTrack) != trackToTrackingParticleMap_.end()) {
    return trackToTrackingParticleMap_.find(aTrack)->second;
  } else {
    return nullTrackingParticlePtr_;
  }
}

findTrackingParticlePtr() [2/3]

template<typename T>

const TrackingParticlePtr& TTTrackAssociationMap< T >::findTrackingParticlePtr

(

TTTrackPtrT< T >

aTrack

)

const

Get principle TP associated to a L1 track. (Non-NULL if isLooselyGenuine() below is true). (N.B. There is no function returning all TP associated to a L1 track).

Referenced by l1tVertexFinder::VertexNTupler::analyze(), and l1tVertexFinder::L1TrackTruthMatched::L1TrackTruthMatched().

findTrackingParticlePtr() [3/3]

template<>

const TrackingParticlePtr & TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::findTrackingParticlePtr

(

TTTrackPtr

aTrack

)

const

Operations.

findTTTrackPtrs() [1/3]

template<>

const std::vector< TTTrackPtr > & TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::findTTTrackPtrs

(

TrackingParticlePtr

aTrackingParticle

)

const

Definition at line 22 of file TTTrackAssociationMap.cc.

                                                 {
  if (trackingParticleToTrackVectorMap_.find(aTrackingParticle) != trackingParticleToTrackVectorMap_.end()) {
    return trackingParticleToTrackVectorMap_.find(aTrackingParticle)->second;
  } else {
    return nullVecTTTrackPtr_;
  }
}

findTTTrackPtrs() [2/3]

template<typename T>

const std::vector<TTTrackPtrT<T> >& TTTrackAssociationMap< T >::findTTTrackPtrs

(

TrackingParticlePtr

aTrackingParticle

)

const

Get all L1 tracks associated to a TP. (Even if the TP just contributes to one cluster in one stub, and even if their are other such TP, it is still listed here).

findTTTrackPtrs() [3/3]

template<>

const std::vector< TTTrackPtr > & TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::findTTTrackPtrs

(

TrackingParticlePtr

aTrackingParticle

)

const

getAllowOneFalse2SStub() [1/2]

template<typename T>

bool TTTrackAssociationMap< T >::getAllowOneFalse2SStub

(

)

getAllowOneFalse2SStub() [2/2]

template<>

bool TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::getAllowOneFalse2SStub

(

)

Definition at line 108 of file TTTrackAssociationMap.cc.

                                                                           {
  return AllowOneFalse2SStub;
}

getTrackingParticleToTTTracksMap()

template<typename T>

const MapTPToVecL1Track<T>& TTTrackAssociationMap< T >::getTrackingParticleToTTTracksMap ( ) const

inline

Definition at line 56 of file TTTrackAssociationMap.h.

References TTTrackAssociationMap< T >::trackingParticleToTrackVectorMap_.

{ return trackingParticleToTrackVectorMap_; }

getTTTrackToTrackingParticleMap()

template<typename T>

const MapL1TrackToTP<T>& TTTrackAssociationMap< T >::getTTTrackToTrackingParticleMap ( ) const

inline

Get/set stub <-> truth association maps.

Definition at line 55 of file TTTrackAssociationMap.h.

References TTTrackAssociationMap< T >::trackToTrackingParticleMap_.

{ return trackToTrackingParticleMap_; }

isCombinatoric() [1/3]

template<>

bool TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::isCombinatoric

(

TTTrackPtr

aTrack

)

const

Defined by exclusion

Definition at line 74 of file TTTrackAssociationMap.cc.

                                                                                          {
  if (this->isLooselyGenuine(aTrack))
    return false;

  if (this->isUnknown(aTrack))
    return false;

  return true;
}

isCombinatoric() [2/3]

template<typename T>

bool TTTrackAssociationMap< T >::isCombinatoric

(

TTTrackPtrT< T >

aTrack

)

const

Both isLooselyGenuine() & isUnknown() are false.

Referenced by l1tVertexFinder::VertexNTupler::analyze().

isCombinatoric() [3/3]

template<>

bool TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::isCombinatoric

(

TTTrackPtr

aTrack

)

const

isGenuine() [1/3]

template<>

bool TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::isGenuine

(

TTTrackPtr

aTrack

)

const

MC truth.

Check if there is an associated TrackingParticle

Get all the stubs from this track & associated TrackingParticle

We want that all the stubs of the track are included in the container of all the stubs produced by this particular TrackingParticle which we already know is one of the TrackingParticles that released hits in this track we are evaluating right now Now modifying to allow one and only one false 2S stub in the track idr 06/19

Definition at line 43 of file TTTrackAssociationMap.cc.

References spr::find().

                                                                                     {
  if ((this->findTrackingParticlePtr(aTrack)).isNull())
    return false;

  const std::vector<TTStubRef>& TRK_Stubs = aTrack->getStubRefs();
  const std::vector<TTStubRef>& TP_Stubs =
      theStubAssociationMap_->findTTStubRefs(this->findTrackingParticlePtr(aTrack));

  bool one2SStub = false;
  for (unsigned int js = 0; js < TRK_Stubs.size(); js++) {
    if (std::find(TP_Stubs.begin(), TP_Stubs.end(), TRK_Stubs.at(js)) == TP_Stubs.end()) {
      if (!AllowOneFalse2SStub || TRK_Stubs.at(js)->moduleTypePS() || one2SStub)  // Has to be first false 2S stub
      {
        return false;
      } else {
        one2SStub = true;
      }
    }
  }

  return true;
}

isGenuine() [2/3]

template<typename T>

bool TTTrackAssociationMap< T >::isGenuine

(

TTTrackPtrT< T >

aTrack

)

const

— Get quality of L1 track based on truth info. (N.B. "genuine" tracks are used for official L1 track efficiency measurements). Exactly one (i.e. not 0 or >= 2) unique TP contributes to every stub on the track. (even if it is not the principle TP in a stub, or contributes to only one cluster in the stub, it still counts). N.B. If cfg param getAllowOneFalse2SStub() is true, then one incorrect stub in a 2S module is alowed ISSUE: a track with 4 stubs can be accepted if only 3 of its stubs are correct! ISSUE: isLooselyGenuine() must also be true. So if 2 TPs match track, one with an incorrect PS stub, both isGenuine() & isLooselyGenuine() will be false!

Referenced by l1tVertexFinder::VertexNTupler::analyze().

isGenuine() [3/3]

template<>

bool TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::isGenuine

(

TTTrackPtr

aTrack

)

const

MC truth.

isLooselyGenuine() [1/3]

template<>

bool TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::isLooselyGenuine

(

TTTrackPtr

aTrack

)

const

MC truth.

Check if there is a TrackingParticle

Definition at line 33 of file TTTrackAssociationMap.cc.

                                                                                            {
  if ((this->findTrackingParticlePtr(aTrack)).isNull())
    return false;

  return true;
}

isLooselyGenuine() [2/3]

template<typename T>

bool TTTrackAssociationMap< T >::isLooselyGenuine

(

TTTrackPtrT< T >

aTrack

)

const

Same criteria as for "genuine" track, except that one incorrect stub in either PS or 2S module is allowed, irrespective of value of cfg param getAllowOneFalse2SStub().

Referenced by l1tVertexFinder::VertexNTupler::analyze().

isLooselyGenuine() [3/3]

template<>

bool TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::isLooselyGenuine

(

TTTrackPtr

aTrack

)

const

MC truth.

isUnknown() [1/3]

template<>

bool TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::isUnknown

(

TTTrackPtr

aTrack

)

const

UNKNOWN means that >= 2 stubs are unknown

Definition at line 86 of file TTTrackAssociationMap.cc.

References mps_fire::i.

                                                                                     {
  int unknownstubs = 0;

  const std::vector<TTStubRef>& theseStubs = aTrack->getStubRefs();
  for (unsigned int i = 0; i < theseStubs.size(); i++) {
    if (theStubAssociationMap_->isUnknown(theseStubs.at(i)) == false) {
      ++unknownstubs;
      if (unknownstubs >= 2)
        return false;
    }
  }

  return true;
}

isUnknown() [2/3]

template<typename T>

bool TTTrackAssociationMap< T >::isUnknown

(

TTTrackPtrT< T >

aTrack

)

const

More than one stub on track is "unknown".

Referenced by l1tVertexFinder::VertexNTupler::analyze().

isUnknown() [3/3]

template<>

bool TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::isUnknown

(

TTTrackPtr

aTrack

)

const

setAllowOneFalse2SStub() [1/2]

template<typename T>

void TTTrackAssociationMap< T >::setAllowOneFalse2SStub

(

bool

allowFalse2SStub

)

setAllowOneFalse2SStub() [2/2]

template<>

void TTTrackAssociationMap< Ref_Phase2TrackerDigi_ >::setAllowOneFalse2SStub

(

bool

allowFalse2SStub

)

Definition at line 103 of file TTTrackAssociationMap.cc.

                                                                                                {
  AllowOneFalse2SStub = allowFalse2SStub;
}

setTrackingParticleToTTTracksMap()

template<typename T>

void TTTrackAssociationMap< T >::setTrackingParticleToTTTracksMap ( const MapTPToVecL1Track< T > &  aMap )

inline

Definition at line 59 of file TTTrackAssociationMap.h.

References TTTrackAssociationMap< T >::trackingParticleToTrackVectorMap_.

{ trackingParticleToTrackVectorMap_ = aMap; }

setTTStubAssociationMap()

template<typename T>

void TTTrackAssociationMap< T >::setTTStubAssociationMap ( edm::RefProd< TTStubAssociationMap< T >>  aStubAssoMap )

inline

Set stub <-> truth association object.

Definition at line 62 of file TTTrackAssociationMap.h.

References TTTrackAssociationMap< T >::theStubAssociationMap_.

                                                                                 {
    theStubAssociationMap_ = aStubAssoMap;
  }

setTTTrackToTrackingParticleMap()

template<typename T>

void TTTrackAssociationMap< T >::setTTTrackToTrackingParticleMap ( const MapL1TrackToTP< T > &  aMap )

inline

Definition at line 58 of file TTTrackAssociationMap.h.

References TTTrackAssociationMap< T >::trackToTrackingParticleMap_.

{ trackToTrackingParticleMap_ = aMap; }

Member Data Documentation

AllowOneFalse2SStub

template<typename T>

bool TTTrackAssociationMap< T >::AllowOneFalse2SStub

private

Definition at line 105 of file TTTrackAssociationMap.h.

nullTrackingParticlePtr_

template<typename T>

const TrackingParticlePtr TTTrackAssociationMap< T >::nullTrackingParticlePtr_

staticprivate

Close class.

Implementation of methods

Here, in the header file, the methods which do not depend on the specific type <T> that can fit the template. Other methods, with type-specific features, are implemented in the source file.

Definition at line 108 of file TTTrackAssociationMap.h.

nullVecTTTrackPtr_

template<typename T>

const std::vector< TTTrackPtr > TTTrackAssociationMap< T >::nullVecTTTrackPtr_

staticprivate

Definition at line 109 of file TTTrackAssociationMap.h.

theStubAssociationMap_

template<typename T>

edm::RefProd<TTStubAssociationMap<T> > TTTrackAssociationMap< T >::theStubAssociationMap_

private

Definition at line 103 of file TTTrackAssociationMap.h.

Referenced by TTTrackAssociationMap< T >::setTTStubAssociationMap().

trackingParticleToTrackVectorMap_

template<typename T>

MapTPToVecL1Track<T> TTTrackAssociationMap< T >::trackingParticleToTrackVectorMap_

private

Definition at line 102 of file TTTrackAssociationMap.h.

Referenced by TTTrackAssociationMap< T >::getTrackingParticleToTTTracksMap(), and TTTrackAssociationMap< T >::setTrackingParticleToTTTracksMap().

trackToTrackingParticleMap_

template<typename T>

MapL1TrackToTP<T> TTTrackAssociationMap< T >::trackToTrackingParticleMap_

private

Data members.

Definition at line 101 of file TTTrackAssociationMap.h.

Referenced by TTTrackAssociationMap< T >::getTTTrackToTrackingParticleMap(), and TTTrackAssociationMap< T >::setTTTrackToTrackingParticleMap().