EventIDBase Class Reference

This class provides a unique identification for each event, in terms of run/event number and/or a time stamp. More...

#include <GaudiKernel/EventIDBase.h>

Classes
class	SortByLumiEvent
class	SortByRunEvent
class	SortByRunLumi
class	SortByTimeStamp

Public Types
typedef unsigned int	number_type
typedef uint64_t	event_number_t

Public Member Functions
number_type	run_number () const
	run number - 32 bit unsigned More...
event_number_t	event_number () const
	event number - 64 bit unsigned More...
number_type	time_stamp () const
	time stamp - posix time in seconds from 1970, 32 bit unsigned More...
number_type	time_stamp_ns_offset () const
	time stamp ns - ns time offset for time_stamp, 32 bit unsigned More...
number_type	lumi_block () const
	luminosity block identifier, 32 bit unsigned More...
number_type	bunch_crossing_id () const
	bunch crossing ID, 32 bit unsigned More...
void	set_run_number (number_type runNumber)
	set run number More...
void	set_event_number (event_number_t eventNumber)
	set event number More...
void	set_time_stamp (number_type timeStamp)
	set time stamp More...
void	set_time_stamp_ns_offset (number_type timeStampNs)
	set time stamp in ns More...
void	set_lumi_block (number_type lumiBlock)
	set luminosity block identifier More...
void	set_bunch_crossing_id (number_type bcid)
	set bunch crossing ID More...
bool	isRunEvent () const
bool	isTimeStamp () const
bool	isLumiEvent () const
bool	isRunLumi () const
bool	isValid () const
structors
	EventIDBase ()
	EventIDBase (number_type run_number, event_number_t event_number, number_type time_stamp=UNDEFNUM, number_type time_stamp_ns_offset=0, number_type lumi_block=UNDEFNUM, number_type bunch_crossing_id=0)
virtual	~EventIDBase ()

Static Public Attributes
static const number_type	UNDEFNUM = std::numeric_limits<EventIDBase::number_type>::max()
static const event_number_t	UNDEFEVT = std::numeric_limits<EventIDBase::event_number_t>::max()

Private Types
enum	Type {   Invalid = 0, RunEvent = 1 << 1, TimeStamp = 1 << 2, LumiEvent = 1 << 3,   RunLumi = 1 << 4 }

Private Member Functions
void	setRE ()
void	setTS ()
void	setLE ()
void	setRL ()

Private Attributes
unsigned	m_type {Invalid}
number_type	m_run_number {UNDEFNUM}
	run number More...
event_number_t	m_event_number {UNDEFEVT}
	event number More...
number_type	m_time_stamp {UNDEFNUM}
	posix time in seconds since 1970/01/01 More...
number_type	m_time_stamp_ns_offset {UNDEFNUM}
	time stamp ns - ns time offset for time_stamp, 32 bit unsigned More...
number_type	m_lumi_block {UNDEFNUM}
	luminosity block number: the number which uniquely tags a luminosity block within a run More...
number_type	m_bunch_crossing_id {UNDEFNUM}
	bunch crossing ID, 32 bit unsigned More...

Friends
bool	operator< (const EventIDBase &lhs, const EventIDBase &rhs)
	Comparison operators. More...
bool	operator> (const EventIDBase &lhs, const EventIDBase &rhs)
bool	operator== (const EventIDBase &lhs, const EventIDBase &rhs)
bool	operator!= (const EventIDBase &lhs, const EventIDBase &rhs)
bool	operator<= (const EventIDBase &lhs, const EventIDBase &rhs)
bool	operator>= (const EventIDBase &lhs, const EventIDBase &rhs)
std::ostream &	operator<< (std::ostream &os, const EventIDBase &rhs)
	Extraction operators. More...

Detailed Description

This class provides a unique identification for each event, in terms of run/event number and/or a time stamp.

Definition at line 29 of file EventIDBase.h.

Member Typedef Documentation

typedef uint64_t EventIDBase::event_number_t

Definition at line 33 of file EventIDBase.h.

typedef unsigned int EventIDBase::number_type

Definition at line 32 of file EventIDBase.h.

Member Enumeration Documentation

enum EventIDBase::Type

private

Enumerator
Invalid
RunEvent
TimeStamp
LumiEvent
RunLumi

Definition at line 178 of file EventIDBase.h.

{ Invalid = 0, RunEvent = 1 << 1, TimeStamp = 1 << 2, LumiEvent = 1 << 3, RunLumi = 1 << 4 };

Constructor & Destructor Documentation

EventIDBase::EventIDBase ( )

inline

Definition at line 41 of file EventIDBase.h.

{};

EventIDBase::EventIDBase	(	number_type	run_number,
		event_number_t	event_number,
		number_type	time_stamp = UNDEFNUM,
		number_type	time_stamp_ns_offset = 0,
		number_type	lumi_block = UNDEFNUM,
		number_type	bunch_crossing_id = 0
	)

Definition at line 17 of file EventIDBase.cpp.

    : m_run_number( run_number )
    , m_event_number( event_number )
    , m_time_stamp( time_stamp )
    , m_time_stamp_ns_offset( time_stamp_ns_offset )
    , m_lumi_block( lumi_block )
    , m_bunch_crossing_id( bunch_crossing_id )
{
  if ( m_run_number != UNDEFNUM && m_event_number != UNDEFEVT ) {
    setRE();
  }

  if ( m_time_stamp != UNDEFNUM ) {
    setTS();
    if ( m_time_stamp_ns_offset == UNDEFNUM ) {
      m_time_stamp_ns_offset = 0;
    }
  }

  if ( m_lumi_block != UNDEFNUM && m_event_number != UNDEFEVT ) {
    setLE();
  }

  if ( m_run_number != UNDEFNUM && m_lumi_block != UNDEFNUM ) {
    setRL();
  }
}

EventIDBase::~EventIDBase ( )

virtual

Definition at line 46 of file EventIDBase.cpp.

{}

Member Function Documentation

number_type EventIDBase::bunch_crossing_id ( ) const

inline

bunch crossing ID, 32 bit unsigned

Definition at line 65 of file EventIDBase.h.

{ return m_bunch_crossing_id; }

event_number_t EventIDBase::event_number ( ) const

inline

event number - 64 bit unsigned

Definition at line 53 of file EventIDBase.h.

{ return m_event_number; }

bool EventIDBase::isLumiEvent

(

)

const

Definition at line 52 of file EventIDBase.cpp.

{ return ( m_type & LumiEvent ); }

bool EventIDBase::isRunEvent

(

)

const

Definition at line 48 of file EventIDBase.cpp.

{ return ( m_type & RunEvent ); }

bool EventIDBase::isRunLumi

(

)

const

Definition at line 54 of file EventIDBase.cpp.

{ return ( m_type & RunLumi ); }

bool EventIDBase::isTimeStamp

(

)

const

Definition at line 50 of file EventIDBase.cpp.

{ return ( m_type & TimeStamp ); }

bool EventIDBase::isValid

(

)

const

Definition at line 56 of file EventIDBase.cpp.

{ return ( m_type != Invalid ); }

number_type EventIDBase::lumi_block ( ) const

inline

luminosity block identifier, 32 bit unsigned

Definition at line 62 of file EventIDBase.h.

{ return m_lumi_block; }

number_type EventIDBase::run_number ( ) const

inline

run number - 32 bit unsigned

Definition at line 50 of file EventIDBase.h.

{ return m_run_number; }

void EventIDBase::set_bunch_crossing_id ( number_type  bcid )

inline

set bunch crossing ID

Definition at line 102 of file EventIDBase.h.

{ m_bunch_crossing_id = bcid; }

void EventIDBase::set_event_number ( event_number_t  eventNumber )

inline

set event number

Definition at line 76 of file EventIDBase.h.

  {
    m_event_number = eventNumber;
    if ( m_run_number != UNDEFNUM ) setRE();
    if ( m_lumi_block != UNDEFNUM ) setLE();
  }

void EventIDBase::set_lumi_block ( number_type  lumiBlock )

inline

set luminosity block identifier

Definition at line 94 of file EventIDBase.h.

  {
    m_lumi_block = lumiBlock;
    if ( m_run_number != UNDEFNUM ) setRL();
    if ( m_event_number != UNDEFEVT ) setLE();
  }

void EventIDBase::set_run_number ( number_type  runNumber )

inline

set run number

Definition at line 68 of file EventIDBase.h.

  {
    m_run_number = runNumber;
    if ( m_event_number != UNDEFEVT ) setRE();
    if ( m_lumi_block != UNDEFNUM ) setRL();
  }

void EventIDBase::set_time_stamp ( number_type  timeStamp )

inline

set time stamp

Definition at line 84 of file EventIDBase.h.

  {
    m_time_stamp = timeStamp;
    setTS();
  }

void EventIDBase::set_time_stamp_ns_offset ( number_type  timeStampNs )

inline

set time stamp in ns

Definition at line 91 of file EventIDBase.h.

{ m_time_stamp_ns_offset = timeStampNs; }

void EventIDBase::setLE ( )

inlineprivate

Definition at line 184 of file EventIDBase.h.

{ m_type = m_type | LumiEvent; }

void EventIDBase::setRE ( )

inlineprivate

Definition at line 182 of file EventIDBase.h.

{ m_type = m_type | RunEvent; }

void EventIDBase::setRL ( )

inlineprivate

Definition at line 185 of file EventIDBase.h.

{ m_type = m_type | RunLumi; }

void EventIDBase::setTS ( )

inlineprivate

Definition at line 183 of file EventIDBase.h.

{ m_type = m_type | TimeStamp; }

number_type EventIDBase::time_stamp ( ) const

inline

time stamp - posix time in seconds from 1970, 32 bit unsigned

Definition at line 56 of file EventIDBase.h.

{ return m_time_stamp; }

number_type EventIDBase::time_stamp_ns_offset ( ) const

inline

time stamp ns - ns time offset for time_stamp, 32 bit unsigned

Definition at line 59 of file EventIDBase.h.

{ return m_time_stamp_ns_offset; }

Friends And Related Function Documentation

bool operator!= ( const EventIDBase &  lhs, const EventIDBase &  rhs  )

friend

Definition at line 241 of file EventIDBase.h.

{ return !( lhs == rhs ); }

bool operator< ( const EventIDBase &  lhs, const EventIDBase &  rhs  )

friend

Comparison operators.

Definition at line 207 of file EventIDBase.h.

{
  // first try ordering by timestamp if both are non-zero
  // then try ordering by run/lumi/event
  // this assumes that both EventIDBase have the same set of values defined.

  if ( lhs.isTimeStamp() && rhs.isTimeStamp() ) {
    return ( lhs.m_time_stamp < rhs.m_time_stamp );
  } else {
    return ( std::tie( lhs.m_run_number, lhs.m_lumi_block, lhs.m_event_number ) <
             std::tie( rhs.m_run_number, rhs.m_lumi_block, rhs.m_event_number ) );
  }
}

std::ostream& operator<< ( std::ostream &  os, const EventIDBase &  rhs  )

friend

Extraction operators.

Definition at line 245 of file EventIDBase.h.

{
  if ( rhs.m_type == EventIDBase::Invalid ) {
    os << "[INVALID]";
    return os;
  }

  os << "[" << rhs.m_run_number;

  if ( rhs.m_event_number != EventIDBase::UNDEFEVT ) {
    os << "," << rhs.m_event_number;
  }

  if ( rhs.isTimeStamp() ) {
    os << ",t:" << rhs.m_time_stamp;
    if ( rhs.m_time_stamp_ns_offset != 0 ) {
      os << "." << std::setfill( '0' ) << std::setw( 9 ) << rhs.m_time_stamp_ns_offset;
    }
  }

  if ( rhs.isLumiEvent() || rhs.isRunLumi() ) {
    os << ",l:" << rhs.m_lumi_block;
  }

  if ( rhs.m_bunch_crossing_id != 0 ) {
    os << ",b:" << rhs.m_bunch_crossing_id;
  }
  os << "]";
  return os;
}

bool operator<= ( const EventIDBase &  lhs, const EventIDBase &  rhs  )

friend

Definition at line 242 of file EventIDBase.h.

{ return !( lhs > rhs ); }

bool operator== ( const EventIDBase &  lhs, const EventIDBase &  rhs  )

friend

Definition at line 235 of file EventIDBase.h.

{
  // We assume that equality via run/event/lumi numbers is sufficient
  return ( lhs.m_run_number == rhs.m_run_number && lhs.m_event_number == rhs.m_event_number &&
           lhs.m_lumi_block == rhs.m_lumi_block );
}

bool operator> ( const EventIDBase &  lhs, const EventIDBase &  rhs  )

friend

Definition at line 221 of file EventIDBase.h.

{
  // first try ordering by timestamp if both are non-zero
  // then try ordering by run/lumi/event
  // this assumes that both EventIDBase have the same set of values defined.

  if ( lhs.isTimeStamp() && rhs.isTimeStamp() ) {
    return ( lhs.m_time_stamp > rhs.m_time_stamp );
  } else {
    return ( std::tie( lhs.m_run_number, lhs.m_lumi_block, lhs.m_event_number ) >
             std::tie( rhs.m_run_number, rhs.m_lumi_block, rhs.m_event_number ) );
  }
}

bool operator>= ( const EventIDBase &  lhs, const EventIDBase &  rhs  )

friend

Definition at line 243 of file EventIDBase.h.

{ return !( lhs < rhs ); }

Member Data Documentation

number_type EventIDBase::m_bunch_crossing_id {UNDEFNUM}

private

bunch crossing ID, 32 bit unsigned

Definition at line 204 of file EventIDBase.h.

event_number_t EventIDBase::m_event_number {UNDEFEVT}

private

event number

Definition at line 191 of file EventIDBase.h.

number_type EventIDBase::m_lumi_block {UNDEFNUM}

private

luminosity block number: the number which uniquely tags a luminosity block within a run

Definition at line 201 of file EventIDBase.h.

number_type EventIDBase::m_run_number {UNDEFNUM}

private

run number

Definition at line 188 of file EventIDBase.h.

number_type EventIDBase::m_time_stamp {UNDEFNUM}

private

posix time in seconds since 1970/01/01

Definition at line 194 of file EventIDBase.h.

number_type EventIDBase::m_time_stamp_ns_offset {UNDEFNUM}

private

time stamp ns - ns time offset for time_stamp, 32 bit unsigned

Definition at line 197 of file EventIDBase.h.

unsigned EventIDBase::m_type {Invalid}

private

Definition at line 180 of file EventIDBase.h.

const EventIDBase::event_number_t EventIDBase::UNDEFEVT = std::numeric_limits<EventIDBase::event_number_t>::max()

static

Definition at line 36 of file EventIDBase.h.

const EventIDBase::number_type EventIDBase::UNDEFNUM = std::numeric_limits<EventIDBase::number_type>::max()

static

Definition at line 35 of file EventIDBase.h.

---

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

• GaudiKernel/GaudiKernel/EventIDBase.h
• GaudiKernel/src/Lib/EventIDBase.cpp