a link optimized in size for a GenParticle in a McEventCollection More...

#include <HepMcParticleLink.h>

Collaboration diagram for HepMcParticleLink:

Classes
class	ExtendedBarCode
	Persistent representation of a link. More...

Public Types
enum	PositionFlag { IS_EVENTNUM = 0, IS_POSITION = 1 }

enum	UniqueIDFlag { IS_ID = 0, IS_BARCODE = 1 }

typedef uint32_t	barcode_type

typedef uint32_t	index_type

Public Member Functions
	HepMcParticleLink (IProxyDict *sg=nullptr)
	Default constructor. More...

	HepMcParticleLink (const EventContext &ctx)
	Default constructor. More...

	HepMcParticleLink (barcode_type uid, uint32_t eventIndex, PositionFlag positionFlag, UniqueIDFlag uniqueIDFlag, IProxyDict *sg=SG::CurrentEventStore::store())
	Constructor. More...

	HepMcParticleLink (barcode_type uid, uint32_t eventIndex, PositionFlag positionFlag, UniqueIDFlag uniqueIDFlag, const EventContext &ctx)
	Constructor. More...

	HepMcParticleLink (const HepMC::ConstGenParticlePtr &p, uint32_t eventIndex, PositionFlag positionFlag, IProxyDict *sg=SG::CurrentEventStore::store())
	Constructor. More...

	HepMcParticleLink (const HepMC::ConstGenParticlePtr &part, uint32_t eventIndex, PositionFlag positionFlag, const EventContext &ctx)
	Constructor. More...

	HepMcParticleLink (const HepMcParticleLink &rhs)=default
	Copy constructor. More...

	HepMcParticleLink (HepMcParticleLink &&rhs) noexcept=default
	Move constructor. More...

HepMcParticleLink &	operator= (const HepMcParticleLink &rhs)=default
	Assignment. More...

HepMcParticleLink &	operator= (HepMcParticleLink &&rhs)=default
	Move Assignment. More...

pointer interface
const HepMC::GenParticle &	operator* () const
	Dereference. More...

HepMC::ConstGenParticlePtr	operator-> () const
	Dereference. More...

	operator HepMC::ConstGenParticlePtr () const
	Dereference. More...

HepMC::ConstGenParticlePtr	cptr () const
	Dereference. More...

HepMC::ConstGenParticlePtr	scptr () const
	Dereference/smart pointer. More...

bool	linkIsNull () const
	return true if neither barcode nor id are valid More...

bool	isValid () const
	Validity check. More...

bool	operator! () const
	Validity check. More...

	operator bool () const
	Validity check. More...

Comparison operators.
bool	operator== (const HepMcParticleLink &rhs) const
	Equality comparison. More...

bool	operator!= (const HepMcParticleLink &rhs) const
	Inequality comparison. More...

bool	operator< (const HepMcParticleLink &rhs) const
	Ordering comparison. More...

ParticleLink-specific methods.
IProxyDict *	m_store
	Pointer to the store containing the event. More...

ATH_NO_UNIQUE_ADDRESS CxxUtils::CachedValue< HepMC::ConstGenParticlePtr >	m_ptr
	Transient part. Pointer to the particle. More...

ExtendedBarCode	m_extBarcode
	Persistent part: barcode and location of target GenEvent. More...

int	barcode () const
	Return the barcode of the target particle. More...

int	id () const
	Return the id of the target particle. More...

index_type	eventIndex () const
	Return the event number of the referenced GenEvent. More...

index_type	getEventPositionInCollection (const IProxyDict *sg) const
	Return the position in the McEventCollection of the GenEvent pointed to by this HepMcParticleLink. More...

EBC_SUPPRESSED_TRUTH	getTruthSuppressionType () const
	Return whether the truth particle has been suppressed, as an enum. More...

void	setTruthSuppressionType (EBC_SUPPRESSED_TRUTH truthSupp)
	Return whether the truth particle has been suppressed. More...

char	getTruthSuppressionTypeAsChar () const
	Return whether the truth particle has been suppressed, as a char ('a'..'b'). More...

barcode_type	compress () const
	Hash the 32 bit barcode and 16 bit eventindex into a 32bit int. More...

void	setExtendedBarCode (const ExtendedBarCode &extBarcode)
	Alter the persistent part of the link. More...

static int	getEventNumberAtPosition (index_type position, const IProxyDict *sg)
	Return the event number of the GenEvent at the specified position in the McEventCollection. More...

static std::vector< index_type >	getEventPositionInCollection (index_type index, const IProxyDict *sg)
	Return a vector of the positions in the McEventCollection of the GenEvent(s) with a given event number. More...

static HepMcParticleLink	getRedirectedLink (const HepMcParticleLink &particleLink, uint32_t eventIndex, const EventContext &ctx)
	Return a HepMcParticleLink pointing at the same particle, but in a different GenEvent. More...

std::ostream &	operator<< (std::ostream &, const HepMcParticleLink &)
	Output operator. More...

MsgStream &	operator<< (MsgStream &, const HepMcParticleLink &)
	Output operator. More...

static const McEventCollection *	retrieveMcEventCollection (const IProxyDict *sg)
	Look up the event collection we're targeting. More...

static SG::DataProxy *	find_proxy (const IProxyDict *sg)
	Find the proxy for the target event collection. More...

static std::string	getLastEventCollectionName ()
	Return the most recent SG key used for a particular collection type. More...

Detailed Description

a link optimized in size for a GenParticle in a McEventCollection

A link is defined by three items:

A target McEventCollection;
A particular GenEvent within this collection; and
A particular particle within the GenEvent.

There is a list of StoreGate keys for the McEventCollection (see the initialization of s_keys). When we want to dereference the link, we try to look up each possible key in turn until we find one that works. (The position of that key in the list is then remembered as a hint for where to start searching next time.)

The particular GenEvent within the collection can be represented as either an event number (as returned by GenEvent::event_number()) or by a position within the collection. Which case is desired is indicated by the value of the isIndexEventPosition argument to the constructors (defaulting to the event number case). In order to convert between these, we need to retrieve the McEventCollection from the store, but we don't have the store pointer once the link has been dereferenced. Therefore, when a position-based link is dereferenced, it is automatically changed to be event-number-based. This also happens when a link is constructed with an explicit ConstGenParticlePtr and a position-based GenEvent.

As a special case, a GenEvent number of 0 is interpreted as the first GenEvent in the collection.

The particle within the GenEvent is represented by a unique ID. A unique ID of 0 implies a null link.

In order to dereference a link, we need to reference a particular event store. By default, the current store (as defined by SG::CurrentEventStore::store()) is stored when the link is constructed; however, an explicit IProxyDict* or EventContext may also be specified.

See also: McEventCollection, GenEvent, ElementLink

Author: Paolo Calafiura

Definition at line 71 of file HepMcParticleLink.h.

Member Typedef Documentation

◆ barcode_type

typedef uint32_t HepMcParticleLink::barcode_type

Definition at line 74 of file HepMcParticleLink.h.

◆ index_type

typedef uint32_t HepMcParticleLink::index_type

Definition at line 75 of file HepMcParticleLink.h.

Member Enumeration Documentation

◆ PositionFlag

enum HepMcParticleLink::PositionFlag

Enumerator
IS_EVENTNUM
IS_POSITION

Definition at line 78 of file HepMcParticleLink.h.

                     {
     IS_EVENTNUM = 0,
     IS_POSITION = 1,
   };

◆ UniqueIDFlag

enum HepMcParticleLink::UniqueIDFlag

Enumerator
IS_ID
IS_BARCODE

Definition at line 83 of file HepMcParticleLink.h.

                     {
     IS_ID = 0,
     IS_BARCODE = 1,
   };

Constructor & Destructor Documentation

◆ HepMcParticleLink() [1/8]

HepMcParticleLink::HepMcParticleLink ( IProxyDict * sg = nullptr )

Default constructor.

Makes a null link.

Parameters

sg	Optional specification of a specific store to reference.

◆ HepMcParticleLink() [2/8]

HepMcParticleLink::HepMcParticleLink ( const EventContext & ctx )

Default constructor.

Makes a null link.

Parameters

ctx	Context of the store to reference.

◆ HepMcParticleLink() [3/8]

HepMcParticleLink::HepMcParticleLink	(	barcode_type	uid,
		uint32_t	eventIndex,
		PositionFlag	positionFlag,
		UniqueIDFlag	uniqueIDFlag,
		IProxyDict *	sg = `SG::CurrentEventStore::store()`
	)

Constructor.

Parameters

uid	Unique ID of the target particle. 0 means a null link.
eventIndex	Identifies the target GenEvent in a McEventCollection, as either the event number if `isIndexEventPosition` is IS_EVENTNUM, or the position in the container if isIndexEventPosition is IS_POSITION. 0 always means the first event in the collection.
positionFlag	See `eventIndex`.
sg	Optional specification of a specific store to reference.

◆ HepMcParticleLink() [4/8]

HepMcParticleLink::HepMcParticleLink	(	barcode_type	uid,
		uint32_t	eventIndex,
		PositionFlag	positionFlag,
		UniqueIDFlag	uniqueIDFlag,
		const EventContext &	ctx
	)

Constructor.

Parameters

uid	Unique ID of the target particle. 0 means a null link.
eventIndex	Identifies the target GenEvent in a McEventCollection, as either the event number if `isIndexEventPosition` is IS_EVENTNUM, or the position in the container if isIndexEventPosition is IS_POSITION. 0 always means the first event in the collection.
positionFlag	See `eventIndex`.
ctx	Context of the store to reference.

◆ HepMcParticleLink() [5/8]

HepMcParticleLink::HepMcParticleLink	(	const HepMC::ConstGenParticlePtr &	part,
		uint32_t	eventIndex,
		PositionFlag	positionFlag,
		IProxyDict *	sg = `SG::CurrentEventStore::store()`
	)

Constructor.

Parameters

p	Particle to reference.
eventIndex	Identifies the target GenEvent in a McEventCollection, as either the event number if `isIndexEventPosition` is IS_EVENTNUM, or the position in the container if isIndexEventPosition is IS_POSITION. 0 always means the first event in the collection.
positionFlag	See `eventIndex`.
sg	Optional specification of a specific store to reference.

Definition at line 143 of file HepMcParticleLink.cxx.

   : m_store (sg),
     m_ptr (part),
     m_extBarcode((nullptr != part) ? HepMC::uniqueID(part) : 0, eventIndex, positionFlag, IS_ID)
 {
   assert(part);
  
   if (part != nullptr && positionFlag == IS_POSITION) {
     if (const McEventCollection* pEvtColl = retrieveMcEventCollection(sg)) {
       const HepMC::GenEvent *pEvt = pEvtColl->at (eventIndex);
       m_extBarcode.makeIndex (pEvt->event_number(), eventIndex);
     }
     else {
       MsgStream log (Athena::getMessageSvc(), "HepMcParticleLink");
       log << MSG::WARNING << "cptr: McEventCollection not found" << endmsg;
     }
   }
 }

◆ HepMcParticleLink() [6/8]

HepMcParticleLink::HepMcParticleLink	(	const HepMC::ConstGenParticlePtr &	part,
		uint32_t	eventIndex,
		PositionFlag	positionFlag,
		const EventContext &	ctx
	)

Constructor.

Parameters

p	Particle to reference.
eventIndex	Identifies the target GenEvent in a McEventCollection, as either the event number if `isIndexEventPosition` is IS_EVENTNUM, or the position in the container if isIndexEventPosition is IS_POSITION. 0 always means the first event in the collection.
positionFlag	See `eventIndex`.
ctx	Context of the store to reference.

◆ HepMcParticleLink() [7/8]

HepMcParticleLink::HepMcParticleLink ( const HepMcParticleLink & rhs )

default

Copy constructor.

◆ HepMcParticleLink() [8/8]

HepMcParticleLink::HepMcParticleLink ( HepMcParticleLink && rhs )

defaultnoexcept

Move constructor.

Member Function Documentation

◆ barcode()

int HepMcParticleLink::barcode ( ) const

Return the barcode of the target particle.

0 for a null link. FIXME: return type.

Definition at line 318 of file HepMcParticleLink.cxx.

 {
   // if m_BC is zero (delta rays), then just return that same for barcode and id
   if (m_extBarcode.uid()) {
     barcode_type particle_id, particle_barcode;
     m_extBarcode.uniqueID (particle_id, particle_barcode);
     if (particle_barcode != ExtendedBarCode::UNDEFINEDBC) {
       return int(particle_barcode);
     }
     // dummy link
     if (!m_ptr.isValid() && !m_store) {
       return 0; // TODO Decide if this is a good default - constant from MagicNumbers.h instead?
     }
     // we will need to look up the barcode from the GenParticle
     (void) eventIndex(); // FIXME be careful to avoid an infinite loop of calls here
     if (cptr()) {
       return HepMC::barcode(cptr());
     }
   }
   return 0;
 }

◆ compress()

barcode_type HepMcParticleLink::compress ( ) const

Hash the 32 bit barcode and 16 bit eventindex into a 32bit int.

◆ cptr()

HepMC::ConstGenParticlePtr HepMcParticleLink::cptr ( ) const

Dereference.

Definition at line 177 of file HepMcParticleLink.cxx.

 {
   // dummy link
   const bool is_valid = m_ptr.isValid();
   if (!is_valid && !m_store) {
     return nullptr;
   }
   if (is_valid) {
     return *m_ptr.ptr();
   }
   if (m_extBarcode.linkIsNull()) {
     #if 0
     MsgStream log (Athena::getMessageSvc(), "HepMcParticleLink");
     log << MSG::DEBUG
         << "cptr: no truth particle associated with this hit (barcode==0)."
         << " Probably this is a noise hit" << endmsg;
     #endif
     return nullptr;
   }
   IProxyDict* sg = m_store;
   if (!sg) {
     sg = SG::CurrentEventStore::store();
   }
   if (const McEventCollection* pEvtColl = retrieveMcEventCollection(sg)) {
     const HepMC::GenEvent *pEvt = nullptr;
     index_type event_number, position;
     m_extBarcode.eventIndex (event_number, position);
     if (event_number == 0) {
       pEvt = pEvtColl->at(0);
     }
     else if (position != ExtendedBarCode::UNDEFINED) {
       if (position < pEvtColl->size()) {
         pEvt = pEvtColl->at (position);
       }
       else {
         #if 0
         MsgStream log (Athena::getMessageSvc(), "HepMcParticleLink");
         log << MSG::WARNING << "cptr: position = " << position << ", McEventCollection size = "<< pEvtColl->size() << endmsg;
         #endif
         return nullptr;
       }
     }
     else {
       pEvt = pEvtColl->find (event_number);
     }
  
     if (nullptr != pEvt) {
       // Be sure to update m_extBarcode before m_ptrs;
       // otherwise, the logic in eventIndex() won't work correctly.
       if (position != ExtendedBarCode::UNDEFINED) {
         m_extBarcode.makeIndex (pEvt->event_number(), position);
       }
       if (event_number == 0) {
         m_extBarcode.makeIndex (pEvt->event_number(), position);
       }
       if ( !m_extBarcode.linkIsNull() ) { // Check that either the ID or Barcode is non-zero or undefined
         barcode_type particle_id, particle_barcode;
         m_extBarcode.uniqueID (particle_id, particle_barcode);
         if (particle_id == ExtendedBarCode::UNDEFINEDBC) {
           // barcode to GenParticle
           const HepMC::ConstGenParticlePtr p = HepMC::barcode_to_particle(pEvt,int(particle_barcode));
           if (p) {
             int genParticleID = HepMC::uniqueID(p);
             if (genParticleID > -1) {
               particle_id = static_cast<barcode_type>(genParticleID);
               m_extBarcode.makeID (particle_id, particle_barcode);
             }
             m_ptr.set (p);
             return p;
           }
         }
         else {
           // id to GenParticle
 #ifdef HEPMC3
           const auto &particles = pEvt->particles();
           if (particle_id-1 < particles.size()) {
             const HepMC::ConstGenParticlePtr p = particles[particle_id-1];
             if (p) {
               m_ptr.set (p);
               return p;
             }
           }
 #else
           const HepMC::ConstGenParticlePtr p = HepMC::barcode_to_particle(pEvt,int(particle_id)); // For HepMC2 "id" == barcode
           if (p) {
             m_ptr.set (p);
             return p;
           }
 #endif
         }
       }
     } else {
       MsgStream log (Athena::getMessageSvc(), "HepMcParticleLink");
       if (position != ExtendedBarCode::UNDEFINED) {
         log << MSG::WARNING
             << "cptr: Mc Truth not stored for event at " << position
             << endmsg;
       } else {
         log << MSG::WARNING
             << "cptr: Mc Truth not stored for event with event number " << event_number
             << endmsg;
       }
     }
   } else {
     MsgStream log (Athena::getMessageSvc(), "HepMcParticleLink");
     log << MSG::WARNING << "cptr: McEventCollection not found" << endmsg;
   }
   return nullptr;
 }

◆ eventIndex()

HepMcParticleLink::index_type HepMcParticleLink::eventIndex ( ) const

Return the event number of the referenced GenEvent.

0 means the first GenEvent in the collection.

Definition at line 345 of file HepMcParticleLink.cxx.

 {
   // dummy link
   if (!m_ptr.isValid() && !m_store) {
     return ExtendedBarCode::UNDEFINED;
   }
  
   index_type event_number, event_position;
   m_extBarcode.eventIndex (event_number, event_position);
   if (event_number == ExtendedBarCode::UNDEFINED) {
     const HepMC::GenEvent* pEvt{};
     if (const McEventCollection* coll = retrieveMcEventCollection (m_store)) {
       if (event_position < coll->size()) {
         pEvt = coll->at (event_position);
       }
       if (pEvt) {
         const int genEventNumber = pEvt->event_number();
         // Be sure to update m_extBarcode before m_ptr.
         // Otherwise, if two threads run this method simultaneously,
         // one thread could see event_number == UNDEFINED, but where m_ptr
         // is already updated so we get nullptr back for sg.
         if (genEventNumber > -1) {
           event_number = static_cast<index_type>(genEventNumber);
           m_extBarcode.makeIndex (event_number, event_position);
           return event_number;
         }
         if (barcode() != 0) {
           HepMC::ConstGenParticlePtr pp = HepMC::barcode_to_particle(pEvt, barcode());
           if (pp) {
             m_ptr.set (pp);
           }
         }
       }
     }
   }
   // Don't trip the assertion for a null link.
   if ( m_extBarcode.linkIsNull() )
     {
       return (event_number != ExtendedBarCode::UNDEFINED) ? event_number : 0;
     }
   // Attempt to find the GenParticle
   cptr();
   // Check if event_number is valid once more
   m_extBarcode.eventIndex (event_number, event_position);
   assert (event_number != ExtendedBarCode::UNDEFINED);
   return event_number;
 }

◆ find_proxy()

SG::DataProxy * HepMcParticleLink::find_proxy ( const IProxyDict * sg )

staticprivate

Find the proxy for the target event collection.

Parameters

sg	Target event store. May return nullptr if the collection is not found.

Definition at line 516 of file HepMcParticleLink.cxx.

 {
   const CLID clid = ClassID_traits<McEventCollection>::ID();
   unsigned int hint_orig = s_hint;
   if (hint_orig >= NKEYS) hint_orig = 0;
   unsigned int hint = hint_orig;
   do {
     SG::DataProxy* proxy = sg->proxy (clid, s_keys[hint]);
     if (proxy) {
       if (hint != s_hint) {
         s_hint = hint;
       }
       static std::atomic<unsigned> findCount {0};
       if(++findCount == 1) {
         MsgStream log (Athena::getMessageSvc(), "HepMcParticleLink");
         log << MSG::INFO << "find_proxy: Using " << s_keys[hint]
             <<" as McEventCollection key for this job " << endmsg;
       }
       return proxy;
     }
     ++hint;
     if (hint >= NKEYS) hint = 0;
   } while (hint != hint_orig);
  
   MsgStream log (Athena::getMessageSvc(), "HepMcParticleLink");
   static std::atomic<unsigned long> msgCount {0};
   unsigned int count = ++msgCount;
   if (count <= CPTRMAXMSGCOUNT) {
     log << MSG::WARNING << "find_proxy: No Valid MC event Collection found "
         <<   endmsg;
   }
   if (count == CPTRMAXMSGCOUNT) {
     log << MSG::WARNING <<"find_proxy: suppressing further messages about valid MC event Collection. Use \n"
         << "  msgSvc.setVerbose += [HepMcParticleLink]\n"
         << "to see all messages" << endmsg;
   }
   if (count > CPTRMAXMSGCOUNT) {
     log << MSG::VERBOSE << "find_proxy: No Valid MC event Collection found "
         << endmsg;
   }
   return nullptr;
 }

◆ getEventNumberAtPosition()

int HepMcParticleLink::getEventNumberAtPosition	(	index_type	position,
		const IProxyDict *	sg
	)

static

Return the event number of the GenEvent at the specified position in the McEventCollection.

Parameters

position	in the McEventCollection
sg	Target event store. Returns -999 when position is larger than the McEventCollection size

Definition at line 443 of file HepMcParticleLink.cxx.

 {
   if (const McEventCollection* coll = retrieveMcEventCollection (sg)) {
     if (position < coll->size()) {
       return coll->at (position)->event_number();
     }
   }
 #if 0
   MsgStream log (Athena::getMessageSvc(), "HepMcParticleLink");
   log << MSG::WARNING << "getEventNumberAtPosition: position = " << position << ", McEventCollection size = "<< coll->size() << endmsg;
 #endif
   return -999;
 }

◆ getEventPositionInCollection() [1/2]

HepMcParticleLink::index_type HepMcParticleLink::getEventPositionInCollection ( const IProxyDict * sg ) const

Return the position in the McEventCollection of the GenEvent pointed to by this HepMcParticleLink.

Return the position in the McEventCollection of the (first) GenEvent with a given event number.

Parameters

sg	Target event store. FIXME - need to be able to flag when no event with the appropriate event_number was found.

Definition at line 399 of file HepMcParticleLink.cxx.

 {
   index_type event_number, position;
   m_extBarcode.eventIndex (event_number, position);
   if (position != ExtendedBarCode::UNDEFINED) {
     return position;
   }
   if (event_number == 0) {
     return 0;
   }
  
   std::vector<index_type> positions = getEventPositionInCollection(event_number, sg);
   return positions[0];
 }

◆ getEventPositionInCollection() [2/2]

std::vector< HepMcParticleLink::index_type > HepMcParticleLink::getEventPositionInCollection	(	index_type	index,
		const IProxyDict *	sg
	)

static

Return a vector of the positions in the McEventCollection of the GenEvent(s) with a given event number.

Return the position in the McEventCollection of the (first) GenEvent with a given event number.

Parameters

index	the event number of the required GenEvent
sg	Target event store. Returns a vector containing only ExtendedBarCode::UNDEFINED FIXME when no event with the appropriate event_number was found. (Multiple entries in the vector is technically a bug, but can't be fixed until the HepMC3 migration.)

Definition at line 420 of file HepMcParticleLink.cxx.

 {
   std::vector<index_type> positions; positions.reserve(1);
   const int int_event_number = static_cast<int>(event_number);
   if (const McEventCollection* coll = retrieveMcEventCollection (sg)) {
     size_t sz = coll->size();
     for (size_t i = 0; i < sz; i++) {
       if ((*coll)[i]->event_number() == int_event_number) {
         positions.push_back(i);
       }
     }
   }
   if (positions.empty() ) {
     positions.push_back(ExtendedBarCode::UNDEFINED);
   }
   return positions;
 }

◆ getLastEventCollectionName()

std::string HepMcParticleLink::getLastEventCollectionName ( )

staticprivate

Return the most recent SG key used for a particular collection type.

Definition at line 563 of file HepMcParticleLink.cxx.

 {
   static const std::string unset =  "CollectionNotSet";
   unsigned idx = s_hint;
   if (idx < NKEYS) {
     return s_keys[idx];
   }
   return unset;
 }

◆ getRedirectedLink()

HepMcParticleLink HepMcParticleLink::getRedirectedLink	(	const HepMcParticleLink &	particleLink,
		uint32_t	eventIndex,
		const EventContext &	ctx
	)

static

Return a HepMcParticleLink pointing at the same particle, but in a different GenEvent.

Parameters

particleLink	the current HepMcParticleLink
eventIndex	the event number (unless zero) of the GenEvent which the redirected HepMcParticleLink should point at

Definition at line 465 of file HepMcParticleLink.cxx.

 {
   const HepMcParticleLink::PositionFlag idxFlag =
     (eventIndex==0) ? HepMcParticleLink::IS_POSITION: HepMcParticleLink::IS_EVENTNUM;
   // Support reading in legacy barcode-based persistent EDM for now
   const int uniqueID =
     (particleLink.barcode() != 0) ? particleLink.barcode() : particleLink.id();
   const HepMcParticleLink::UniqueIDFlag uidFlag =
     (particleLink.barcode() != 0) ? HepMcParticleLink::IS_BARCODE : HepMcParticleLink::IS_ID;
   HepMcParticleLink redirectedLink(uniqueID, eventIndex, idxFlag, uidFlag, ctx);
   redirectedLink.setTruthSuppressionType(particleLink.getTruthSuppressionType());
   return redirectedLink;
 }

◆ getTruthSuppressionType()

EBC_SUPPRESSED_TRUTH HepMcParticleLink::getTruthSuppressionType ( ) const

Return whether the truth particle has been suppressed, as an enum.

◆ getTruthSuppressionTypeAsChar()

char HepMcParticleLink::getTruthSuppressionTypeAsChar ( ) const

Return whether the truth particle has been suppressed, as a char ('a'..'b').

◆ id()

int HepMcParticleLink::id ( ) const

Return the id of the target particle.

Return the id of the referenced GenParticle.

0 for a null link.

Definition at line 291 of file HepMcParticleLink.cxx.

 {
   // if m_BC is zero (delta rays), then just return that same for barcode and id
   if (m_extBarcode.uid()) {
     // dummy link
     if (!m_ptr.isValid() && !m_store) {
       return 0; // TODO Decide if this is a good default - constant from MagicNumbers.h instead?
     }
  
     barcode_type particle_id, particle_barcode;
     m_extBarcode.uniqueID (particle_id, particle_barcode);
     if (particle_id == ExtendedBarCode::UNDEFINEDBC) {
       (void) cptr(); // FIXME be careful to avoid an infinite loop of calls here
       m_extBarcode.uniqueID (particle_id, particle_barcode);
     }
     if (particle_id != ExtendedBarCode::UNDEFINEDBC) {
       return particle_id;
     }
   }
   return 0;
 }

◆ isValid()

bool HepMcParticleLink::isValid ( ) const

Validity check.

Dereference and check for null.

◆ linkIsNull()

bool HepMcParticleLink::linkIsNull ( ) const

return true if neither barcode nor id are valid

Definition at line 169 of file HepMcParticleLink.cxx.

                                          {
   return m_extBarcode.linkIsNull();
 }

◆ operator bool()

HepMcParticleLink::operator bool ( ) const

Validity check.

Dereference and check for null.

◆ operator HepMC::ConstGenParticlePtr()

HepMcParticleLink::operator HepMC::ConstGenParticlePtr ( ) const

Dereference.

◆ operator!()

bool HepMcParticleLink::operator! ( ) const

Validity check.

Dereference and check for null.

◆ operator!=()

bool HepMcParticleLink::operator!= ( const HepMcParticleLink & rhs ) const

Inequality comparison.

◆ operator*()

const HepMC::GenParticle& HepMcParticleLink::operator* ( ) const

Dereference.

◆ operator->()

HepMC::ConstGenParticlePtr HepMcParticleLink::operator-> ( ) const

Dereference.

◆ operator<()

bool HepMcParticleLink::operator< ( const HepMcParticleLink & rhs ) const

Ordering comparison.

◆ operator=() [1/2]

HepMcParticleLink& HepMcParticleLink::operator= ( const HepMcParticleLink & rhs )

default

Assignment.

◆ operator=() [2/2]

HepMcParticleLink& HepMcParticleLink::operator= ( HepMcParticleLink && rhs )

default

Move Assignment.

◆ operator==()

bool HepMcParticleLink::operator== ( const HepMcParticleLink & rhs ) const

Equality comparison.

◆ retrieveMcEventCollection()

const McEventCollection * HepMcParticleLink::retrieveMcEventCollection ( const IProxyDict * sg )

staticprivate

Look up the event collection we're targeting.

Parameters

sg	Target event store. May return nullptr if the collection is not found.

Definition at line 497 of file HepMcParticleLink.cxx.

 {
   const McEventCollection* pEvtColl = nullptr;
   SG::DataProxy* proxy = find_proxy (sg);
   if (proxy) {
     pEvtColl = SG::DataProxy_cast<McEventCollection> (proxy);
     if (!pEvtColl) {
       MsgStream log (Athena::getMessageSvc(), "HepMcParticleLink");
       log << MSG::WARNING << "cptr: McEventCollection not found" << endmsg;
     }
   }
   return pEvtColl;
 }

◆ scptr()

HepMC::ConstGenParticlePtr HepMcParticleLink::scptr ( ) const

inline

Dereference/smart pointer.

Definition at line 491 of file HepMcParticleLink.h.

491 { return cptr(); }

◆ setExtendedBarCode()

void HepMcParticleLink::setExtendedBarCode ( const ExtendedBarCode & extBarcode )

Alter the persistent part of the link.

Definition at line 483 of file HepMcParticleLink.cxx.

 {
   m_extBarcode = extBarcode;
   m_store = SG::CurrentEventStore::store();
   m_ptr.reset();
 }

◆ setTruthSuppressionType()

void HepMcParticleLink::setTruthSuppressionType ( EBC_SUPPRESSED_TRUTH truthSupp )

Return whether the truth particle has been suppressed.

Friends And Related Function Documentation

◆ operator<< [1/2]

MsgStream& operator<<	(	MsgStream &	os,
		const HepMcParticleLink &	link
	)

friend

Output operator.

Parameters

os	MsgStream to which to output.
link	Link to dump.

Definition at line 592 of file HepMcParticleLink.cxx.

 {
   link.m_extBarcode.print(os);
   return os;
 }

◆ operator<< [2/2]

std::ostream& operator<<	(	std::ostream &	os,
		const HepMcParticleLink &	link
	)

friend

Output operator.

Parameters

os	Stream to which to output.
link	Link to dump.

Definition at line 579 of file HepMcParticleLink.cxx.

 {
   link.m_extBarcode.print(os);
   return os;
 }

Member Data Documentation

◆ m_extBarcode

ExtendedBarCode HepMcParticleLink::m_extBarcode

private

Persistent part: barcode and location of target GenEvent.

Definition at line 680 of file HepMcParticleLink.h.

◆ m_ptr

ATH_NO_UNIQUE_ADDRESS CxxUtils::CachedValue<HepMC::ConstGenParticlePtr> HepMcParticleLink::m_ptr

private

Transient part. Pointer to the particle.

Definition at line 676 of file HepMcParticleLink.h.

◆ m_store

IProxyDict* HepMcParticleLink::m_store

private

Pointer to the store containing the event.

Definition at line 668 of file HepMcParticleLink.h.

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

Classes

Public Types

Public Member Functions

ParticleLink-specific methods.

Detailed Description

Member Typedef Documentation

◆ barcode_type

◆ index_type

Member Enumeration Documentation

◆ PositionFlag

◆ UniqueIDFlag

Constructor & Destructor Documentation

◆ HepMcParticleLink() [1/8]

◆ HepMcParticleLink() [2/8]

◆ HepMcParticleLink() [3/8]

◆ HepMcParticleLink() [4/8]

◆ HepMcParticleLink() [5/8]

◆ HepMcParticleLink() [6/8]

◆ HepMcParticleLink() [7/8]

◆ HepMcParticleLink() [8/8]

Member Function Documentation

◆ barcode()

◆ compress()

◆ cptr()

◆ eventIndex()

◆ find_proxy()

◆ getEventNumberAtPosition()

◆ getEventPositionInCollection() [1/2]

◆ getEventPositionInCollection() [2/2]

◆ getLastEventCollectionName()

◆ getRedirectedLink()

◆ getTruthSuppressionType()

◆ getTruthSuppressionTypeAsChar()

◆ id()

◆ isValid()

◆ linkIsNull()

◆ operator bool()

◆ operator HepMC::ConstGenParticlePtr()

◆ operator!()

◆ operator!=()

◆ operator*()

◆ operator->()

◆ operator<()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==()

◆ retrieveMcEventCollection()

◆ scptr()

◆ setExtendedBarCode()

◆ setTruthSuppressionType()

Friends And Related Function Documentation

◆ operator<< [1/2]

◆ operator<< [2/2]

Member Data Documentation

◆ m_extBarcode

◆ m_ptr

◆ m_store