Belle II Software  release-05-01-25
EventMetaData Class Reference

Store event, run, and experiment numbers. More...

#include <EventMetaData.h>

Inheritance diagram for EventMetaData:
Collaboration diagram for EventMetaData:

Public Types

enum  EventErrorFlag {
  c_B2LinkPacketCRCError = 0x1,
  c_B2LinkEventCRCError = 0x2,
  c_HLTCrash = 0x4,
  c_ReconstructionAbort = 0x8,
  c_HLTDiscard = 0x10
}
 bit-flag format of m_error_flag
More...
 

Public Member Functions

 EventMetaData (unsigned int event=1, int run=0, int experiment=0)
 Constructor.
 
 ~EventMetaData ()
 Destructor.
 
void setEvent (unsigned int event)
 Event Setter. More...
 
void setRun (int run)
 Run Setter. More...
 
void setSubrun (int subrun)
 Sub run Setter. More...
 
void setExperiment (int experiment)
 Experiment Setter. More...
 
void setProduction (int production)
 Production Setter. More...
 
void setTime (unsigned long long int time)
 Time Setter. More...
 
void setEndOfData ()
 Marks the end of the data processing. More...
 
void setEndOfRun (unsigned int experimentNumber, unsigned int runNumber)
 Marks the end of the current run. More...
 
bool isEndOfData () const
 is end-of-data set? (see setEndOfData()).
 
bool isEndOfRun () const
 is end-of-run set? (see setEndOfRun()).
 
void setParentLfn (const std::string &parent)
 Parent LFN Setter. More...
 
void setGeneratedWeight (double weight)
 Generated Weight Setter. More...
 
void setErrorFlag (unsigned int errorFlag)
 Set Error Flag. More...
 
void addErrorFlag (EventErrorFlag errorFlag)
 Add Error Flag. More...
 
unsigned int getErrorFlag () const
 Get error flag. More...
 
unsigned int getEvent () const
 Event Getter. More...
 
int getRun () const
 Run Getter. More...
 
int getSubrun () const
 Sub run Getter. More...
 
int getExperiment () const
 Experiment Getter. More...
 
int getProduction () const
 Production Getter. More...
 
unsigned long long int getTime () const
 Time Getter. More...
 
const std::string & getParentLfn () const
 Return LFN of the current parent file, or an empty string if not set.
 
double getGeneratedWeight () const
 Generated Weight Getter. More...
 
bool operator== (const EventMetaData &eventMetaData) const
 Comparison Operator. More...
 
bool operator!= (const EventMetaData &eventMetaData) const
 Comparison Operator. More...
 

Private Member Functions

 ClassDef (EventMetaData, 4)
 Store event number, run number, and experiment number.
 

Private Attributes

unsigned int m_event
 Event number ('normal' data has values > 0). More...
 
int m_run
 Run number (usually > 0, run-independent MC has run == 0). More...
 
int m_subrun
 Sub-run number, increases indicate recovery from DAQ-internal trouble without change to detector constants. More...
 
int m_experiment
 Experiment number. More...
 
int m_production
 Unique identifier of the production of the event. More...
 
unsigned long long int m_time
 Time in ns since epoch (1970-01-01). More...
 
std::string m_parentLfn
 LFN of the parent file.
 
double m_generatedWeight
 Generated weight. More...
 
unsigned int m_errorFlag
 Indicator of error conditions during data taking, ORed combination of EventErrorFlag values. More...
 

Detailed Description

Store event, run, and experiment numbers.

(see member variable doc for detailed description)

An object of this type is registered by e.g. EventInfoSetter for newly generated data, and updated with proper values for each event. Alternatively it can also be read from file.

This object is used for controlling the event-flow, e.g. via changing run-numbers or setEndOfData() (see also EventProcessor).

See BELLE2-NOTE-TE-2015-028: Event, File, and Dataset Metadata for a detailed definition. Available at: https://docs.belle2.org/record/287?ln=en

See also
EventInfoSetterModule, EventInfoPrinterModule

Definition at line 43 of file EventMetaData.h.

Member Enumeration Documentation

◆ EventErrorFlag

bit-flag format of m_error_flag

Enumerator
c_B2LinkPacketCRCError 

Belle2link CRC error is detected in the event.

c_B2LinkEventCRCError 

HSLB_COPPER CRC error is detected in the event.

c_HLTCrash 

The HLT reconstruction crashed in this event or the event before.

c_ReconstructionAbort 

The event was not reconstructed, e.g.

because of too high occupancy.

c_HLTDiscard 

The HLT discarded the event and only metadata is kept.

Definition at line 53 of file EventMetaData.h.

57  { m_event = event; }
58 

Member Function Documentation

◆ addErrorFlag()

void addErrorFlag ( EventErrorFlag  errorFlag)
inline

Add Error Flag.

Parameters
errorFlaga bit flag for an error event.

Definition at line 143 of file EventMetaData.h.

◆ getErrorFlag()

unsigned int getErrorFlag ( ) const
inline

Get error flag.

Returns
Error flag for this event.

Definition at line 149 of file EventMetaData.h.

◆ getEvent()

unsigned int getEvent ( ) const
inline

Event Getter.

Returns
The number of the current event.

Definition at line 155 of file EventMetaData.h.

◆ getExperiment()

int getExperiment ( ) const
inline

Experiment Getter.

Returns
The number of the current experiment.

Definition at line 174 of file EventMetaData.h.

◆ getGeneratedWeight()

double getGeneratedWeight ( ) const
inline

Generated Weight Getter.

Returns
The weight produced by the event generator

Definition at line 196 of file EventMetaData.h.

◆ getProduction()

int getProduction ( ) const
inline

Production Getter.

Returns
The number of the current production.

Definition at line 180 of file EventMetaData.h.

◆ getRun()

int getRun ( ) const
inline

Run Getter.

Returns
The number of the current run.

Definition at line 161 of file EventMetaData.h.

◆ getSubrun()

int getSubrun ( ) const
inline

Sub run Getter.

Returns
Sub-run number, increases indicate recovery from DAQ-internal trouble without change to detector constants. Not supposed to be used by offline analysis.

Definition at line 168 of file EventMetaData.h.

◆ getTime()

unsigned long long int getTime ( ) const
inline

Time Getter.

Returns
The time when the event was recorded.

Definition at line 186 of file EventMetaData.h.

◆ operator!=()

bool operator!= ( const EventMetaData eventMetaData) const
inline

Comparison Operator.

Parameters
eventMetaDataThe event meta data to compare with.
Returns
True if event, run, or experiment numbers are different

Definition at line 210 of file EventMetaData.h.

◆ operator==()

bool operator== ( const EventMetaData eventMetaData) const

Comparison Operator.

Parameters
eventMetaDataThe event meta data to compare with.
Returns
True if event, run, and experiment numbers are the same

Definition at line 53 of file EventMetaData.cc.

54 {
55  return ((m_event == eventMetaData.getEvent()) &&
56  (m_run == eventMetaData.getRun()) &&
57  (m_experiment == eventMetaData.getExperiment()));
58 }

◆ setEndOfData()

void setEndOfData ( )

Marks the end of the data processing.

Can be used by any module to safely halt event processing. After this is set on StoreObjPtr<EventMetaData> and your event() function returns, no further modules in the path will be called and normal cleanup will be done (i.e. endRun(), terminate()).

Using this will produce a warning that your module stopped execution early, so you might want to add an explanatory message of your own.

Definition at line 29 of file EventMetaData.cc.

◆ setEndOfRun()

void setEndOfRun ( unsigned int  experimentNumber,
unsigned int  runNumber 
)

Marks the end of the current run.

Is only used and understood in special HLT processing.

Can only be used by the first ZMQ input module.

Definition at line 41 of file EventMetaData.cc.

◆ setErrorFlag()

void setErrorFlag ( unsigned int  errorFlag)
inline

Set Error Flag.

Parameters
errorFlaga bit flag for an error event.

Definition at line 137 of file EventMetaData.h.

◆ setEvent()

void setEvent ( unsigned int  event)
inline

Event Setter.

Parameters
eventThe current event number.

Definition at line 65 of file EventMetaData.h.

◆ setExperiment()

void setExperiment ( int  experiment)
inline

Experiment Setter.

Parameters
experimentThe number of the current experiment.

Definition at line 83 of file EventMetaData.h.

◆ setGeneratedWeight()

void setGeneratedWeight ( double  weight)
inline

Generated Weight Setter.

Parameters
weightThe weight produced by the event generator

Definition at line 131 of file EventMetaData.h.

◆ setParentLfn()

void setParentLfn ( const std::string &  parent)
inline

Parent LFN Setter.

Parameters
parentThe LFN of the current parent file.

Definition at line 125 of file EventMetaData.h.

◆ setProduction()

void setProduction ( int  production)
inline

Production Setter.

Parameters
productionThe integer identifier of the production.

Definition at line 89 of file EventMetaData.h.

◆ setRun()

void setRun ( int  run)
inline

Run Setter.

Parameters
runThe number of the current run.

Definition at line 71 of file EventMetaData.h.

◆ setSubrun()

void setSubrun ( int  subrun)
inline

Sub run Setter.

Parameters
subrunThe number of the current sub run.

Definition at line 77 of file EventMetaData.h.

◆ setTime()

void setTime ( unsigned long long int  time)
inline

Time Setter.

Parameters
timeThe time when the event was recorded.

Definition at line 95 of file EventMetaData.h.

Member Data Documentation

◆ m_errorFlag

unsigned int m_errorFlag
private

Indicator of error conditions during data taking, ORed combination of EventErrorFlag values.


Definition at line 223 of file EventMetaData.h.

◆ m_event

unsigned int m_event
private

Event number ('normal' data has values > 0).


Definition at line 214 of file EventMetaData.h.

◆ m_experiment

int m_experiment
private

Experiment number.

(valid values: [0, 1023], run-independent MC has exp == 0)

Definition at line 217 of file EventMetaData.h.

◆ m_generatedWeight

double m_generatedWeight
private

Generated weight.


Definition at line 222 of file EventMetaData.h.

◆ m_production

int m_production
private

Unique identifier of the production of the event.


Definition at line 219 of file EventMetaData.h.

◆ m_run

int m_run
private

Run number (usually > 0, run-independent MC has run == 0).


Definition at line 215 of file EventMetaData.h.

◆ m_subrun

int m_subrun
private

Sub-run number, increases indicate recovery from DAQ-internal trouble without change to detector constants.

Not supposed to be used by offline analysis.

Definition at line 216 of file EventMetaData.h.

◆ m_time

unsigned long long int m_time
private

Time in ns since epoch (1970-01-01).


Definition at line 220 of file EventMetaData.h.


The documentation for this class was generated from the following files:
Belle2::EventMetaData::getEvent
unsigned int getEvent() const
Event Getter.
Definition: EventMetaData.h:155
Belle2::EventMetaData::m_run
int m_run
Run number (usually > 0, run-independent MC has run == 0).
Definition: EventMetaData.h:215
Belle2::EventMetaData::m_experiment
int m_experiment
Experiment number.
Definition: EventMetaData.h:217
Belle2::EventMetaData::getExperiment
int getExperiment() const
Experiment Getter.
Definition: EventMetaData.h:174
Belle2::EventMetaData::m_event
unsigned int m_event
Event number ('normal' data has values > 0).
Definition: EventMetaData.h:214
Belle2::EventMetaData::getRun
int getRun() const
Run Getter.
Definition: EventMetaData.h:161