ldmx::RunHeader Class Reference

Run-specific configuration and data stored in its own output TTree alongside the event TTree in the output file. More...

#include <RunHeader.h>

Public Member Functions
	RunHeader (int runNumber)
	Constructor.
	RunHeader ()=default
	Default constructor.
virtual	~RunHeader ()
	Destructor.
int	getRunNumber () const
const std::string &	getDetectorName () const
void	setDetectorName (const std::string &det)
	Set the name of the detector that was used in this run.
const std::string &	getSoftwareTag () const
const std::string &	getLdmxswVersion () const
const std::string &	getDescription () const
void	setDescription (const std::string &des)
	Set the description of this run.
int	getRunStart () const
	Get the start time of the run in seconds since epoch.
void	setRunStart (const int runStart)
	Set the run start time in seconds since epoch.
int	getRunEnd () const
	Get the end time of the run in seconds since epoch.
void	setRunEnd (const int runEnd)
	Set the end time of the run in seconds since epoch.
int	getNumTries () const
	Get the total number of tries that were done during the production of this run.
void	setNumTries (const int numTries)
	Set the total number of tries that were done during the production of this run.
int	getIntParameter (const std::string &name) const
	Get an int parameter value.
const std::map< std::string, int > &	getIntParameters () const
	Get a const reference to all int parameters.
void	setIntParameter (const std::string &name, int value)
	Set an int parameter value.
float	getFloatParameter (const std::string &name) const
	Get a float parameter value.
const std::map< std::string, float > &	getFloatParameters () const
	Get a const reference to all float parameters.
void	setFloatParameter (const std::string &name, float value)
	Set a float parameter value.
std::string	getStringParameter (const std::string &name) const
	Get a string parameter value.
const std::map< std::string, std::string > &	getStringParameters () const
	Get a const reference to all string parameters.
void	setStringParameter (const std::string &name, std::string value)
	Set a string parameter value.
void	stream (std::ostream &s) const
	Stream this object into the input ostream.
void	Print () const
	Print a string desciption of this object.

Private Member Functions
	ClassDef (RunHeader, 5)

Private Attributes
int	runNumber_ {0}
	Run number.
std::string	detectorName_ {""}
	Detector name.
std::string	description_ {""}
	Run description.
int	runStart_ {0}
	Run start in seconds since epoch.
int	runEnd_ {0}
	Run end in seconds since epoch.
int	numTries_ {0}
	Total number of events that were begun during the production of this run.
std::string	softwareTag_ {GIT_SHA1}
	git SHA-1 hash associated with the software tag used to generate this file.
std::string	ldmxsw_version_ {LDMXSW_VERSION}
	ldmx-sw software version
std::map< std::string, int >	intParameters_
	Map of int parameters.
std::map< std::string, float >	floatParameters_
	Map of float parameters.
std::map< std::string, std::string >	stringParameters_
	Map of string parameters.

Friends
std::ostream &	operator<< (std::ostream &s, const ldmx::RunHeader &h)
	Stream this object to an output stream.

Detailed Description

Run-specific configuration and data stored in its own output TTree alongside the event TTree in the output file.

Similar to the EventHeader, the evolution of this object has been pretty slow since the *Parameter* members have been used to hold most of the additional information (for example, a lot of the simulation configuration information). The versions of the RunHeader as defined by ROOT's serialization infrastructure are documented here.

v1

An initial beta version now lost to the sands of time.

v2 and v3

There are no material (serialized data) changes that are different between v2 and v3, but this version was increased because we moved the Framework repo (and thus the RunHeader source) from being within ldmx-sw to its own stand-alone repo. With an abundance of caution (and lack of understanding of what ROOT's dictionary cares about), we increased the version number.

v4

Add the numTries_ member variable in order to store exactly how many events were started during the production of the run.

Interop with v3

When reading a file written with v3 RunHeader using software with v4 RunHeader, the numTries_ member will keep its default value of 0. This is a nice signal value since it conveys to the user the lack of information. If the user somehow gets into the situation of reading a v4 RunHeader with v3 software, the numTries_ member is quietly ignored, maintaining the format of the v3 RunHeader in the resulting output file.

v5

Include a member to track the ldmx-sw version

Definition at line 57 of file RunHeader.h.

Constructor & Destructor Documentation

RunHeader() [1/2]

ldmx::RunHeader::RunHeader

(

int

runNumber

)

Constructor.

Parameters

runNumber

The run number uniquely identifying this run

Definition at line 13 of file RunHeader.cxx.

: runNumber_(runNumber) {}

RunHeader() [2/2]

ldmx::RunHeader::RunHeader ( )

default

Default constructor.

Note

This exists for filling the object from a ROOT branch.

~RunHeader()

virtual ldmx::RunHeader::~RunHeader ( )

inlinevirtual

Destructor.

Definition at line 74 of file RunHeader.h.

{}

Member Function Documentation

getDescription()

const std::string & ldmx::RunHeader::getDescription ( ) const

inline

Returns

A short description of the run.

Definition at line 97 of file RunHeader.h.

{ return description_; }

References description_.

Referenced by stream().

getDetectorName()

const std::string & ldmx::RunHeader::getDetectorName ( ) const

inline

Returns

The name of the detector used to create the events.

Definition at line 80 of file RunHeader.h.

{ return detectorName_; }

References detectorName_.

Referenced by ecal::EcalGeometryProvider::onNewRun(), hcal::HcalGeometryProvider::onNewRun(), and stream().

getFloatParameter()

float ldmx::RunHeader::getFloatParameter ( const std::string & name ) const

inline

Get a float parameter value.

Parameters

name	The name of the parameter.

Returns

value The parameter value.

Definition at line 182 of file RunHeader.h.

                                                       {
    return floatParameters_.at(name);
  }

References floatParameters_.

getFloatParameters()

const std::map< std::string, float > & ldmx::RunHeader::getFloatParameters ( ) const

inline

Get a const reference to all float parameters.

Definition at line 187 of file RunHeader.h.

                                                             {
    return floatParameters_;
  }

References floatParameters_.

getIntParameter()

int ldmx::RunHeader::getIntParameter ( const std::string & name ) const

inline

Get an int parameter value.

Parameters

name	The name of the parameter.

Returns

The parameter value.

Definition at line 157 of file RunHeader.h.

                                                   {
    return intParameters_.at(name);
  }

References intParameters_.

getIntParameters()

const std::map< std::string, int > & ldmx::RunHeader::getIntParameters ( ) const

inline

Get a const reference to all int parameters.

Definition at line 162 of file RunHeader.h.

                                                         {
    return intParameters_;
  }

References intParameters_.

getLdmxswVersion()

const std::string & ldmx::RunHeader::getLdmxswVersion ( ) const

inline

Returns

The ldmx-sw version used to generate this file

Definition at line 94 of file RunHeader.h.

{ return ldmxsw_version_; }

References ldmxsw_version_.

getNumTries()

int ldmx::RunHeader::getNumTries ( ) const

inline

Get the total number of tries that were done during the production of this run.

Returns

the number of tries

Definition at line 137 of file RunHeader.h.

{ return numTries_; }

References numTries_.

Referenced by stream().

getRunEnd()

int ldmx::RunHeader::getRunEnd ( ) const

inline

Get the end time of the run in seconds since epoch.

Returns

The end time of the run.

Definition at line 122 of file RunHeader.h.

{ return runEnd_; }

References runEnd_.

getRunNumber()

int ldmx::RunHeader::getRunNumber ( ) const

inline

Returns

The run number.

Definition at line 77 of file RunHeader.h.

{ return runNumber_; }

References runNumber_.

Referenced by framework::RandomNumberSeedService::onNewRun(), simcore::Simulator::onNewRun(), stream(), framework::EventFile::writeRunHeader(), and packing::rawdatafile::File::writeRunHeader().

getRunStart()

int ldmx::RunHeader::getRunStart ( ) const

inline

Get the start time of the run in seconds since epoch.

Returns

The start time of the run.

Definition at line 108 of file RunHeader.h.

{ return runStart_; }

References runStart_.

getSoftwareTag()

const std::string & ldmx::RunHeader::getSoftwareTag ( ) const

inline

Returns

The git SHA-1 associated with the software tag used to generate this file.

Definition at line 89 of file RunHeader.h.

{ return softwareTag_; }

References softwareTag_.

getStringParameter()

std::string ldmx::RunHeader::getStringParameter ( const std::string & name ) const

inline

Get a string parameter value.

Parameters

name	The name of the parameter.

Returns

value The parameter value.

Definition at line 207 of file RunHeader.h.

                                                            {
    return stringParameters_.at(name);
  }

References stringParameters_.

getStringParameters()

const std::map< std::string, std::string > & ldmx::RunHeader::getStringParameters ( ) const

inline

Get a const reference to all string parameters.

Definition at line 212 of file RunHeader.h.

                                                                  {
    return stringParameters_;
  }

References stringParameters_.

Print()

void ldmx::RunHeader::Print

(

)

const

Print a string desciption of this object.

Definition at line 34 of file RunHeader.cxx.

{ stream(std::cout); }

References stream().

Referenced by framework::RunHeaderAnalyzer::onNewRun().

setDescription()

void ldmx::RunHeader::setDescription ( const std::string & des )

inline

Set the description of this run.

Definition at line 100 of file RunHeader.h.

{ description_ = des; }

References description_.

Referenced by simcore::Simulator::beforeNewRun().

setDetectorName()

void ldmx::RunHeader::setDetectorName ( const std::string & det )

inline

Set the name of the detector that was used in this run.

Definition at line 83 of file RunHeader.h.

{ detectorName_ = det; }

References detectorName_.

Referenced by hcal::HcalRawDecoder::beforeNewRun(), packing::SingleSubsystemUnpacker::beforeNewRun(), and simcore::Simulator::beforeNewRun().

setFloatParameter()

void ldmx::RunHeader::setFloatParameter ( const std::string & name, float value )

inline

Set a float parameter value.

Parameters

name	The name of the parameter.
value	The parameter value.

Definition at line 197 of file RunHeader.h.

                                                             {
    floatParameters_[name] = value;
  }

References floatParameters_.

Referenced by simcore::Simulator::beforeNewRun(), simcore::biasoperators::DarkBrem::RecordConfig(), simcore::biasoperators::ElectroNuclear::RecordConfig(), simcore::biasoperators::GammaToMuPair::RecordConfig(), simcore::biasoperators::K0LongInelastic::RecordConfig(), simcore::biasoperators::NeutronInelastic::RecordConfig(), simcore::biasoperators::PhotoNuclear::RecordConfig(), simcore::generators::MultiParticleGunPrimaryGenerator::RecordConfig(), and simcore::generators::ParticleGun::RecordConfig().

setIntParameter()

void ldmx::RunHeader::setIntParameter ( const std::string & name, int value )

inline

Set an int parameter value.

Parameters

name	The name of the parameter.
value	The value of the parameter.

Definition at line 172 of file RunHeader.h.

                                                         {
    intParameters_[name] = value;
  }

References intParameters_.

Referenced by simcore::Simulator::beforeNewRun(), framework::RandomNumberSeedService::onNewRun(), simcore::biasoperators::DarkBrem::RecordConfig(), simcore::biasoperators::PhotoNuclear::RecordConfig(), simcore::generators::MultiParticleGunPrimaryGenerator::RecordConfig(), and packing::rawdatafile::File::writeRunHeader().

setNumTries()

void ldmx::RunHeader::setNumTries ( const int numTries )

inline

Set the total number of tries that were done during the production of this run.

Note

This function is called within framework::Process::run and so it should not be used elsewhere. Changing the number of tries during processing is undefined behavior.

Parameters

[in]

numTries

the number of tries in this run

Definition at line 149 of file RunHeader.h.

{ numTries_ = numTries; }

References numTries_.

Referenced by framework::Process::run().

setRunEnd()

void ldmx::RunHeader::setRunEnd ( const int runEnd )

inline

Set the end time of the run in seconds since epoch.

Parameters

[in]

runEnd

the end time of the run.

Definition at line 129 of file RunHeader.h.

{ runEnd_ = runEnd; }

References runEnd_.

Referenced by framework::Process::run().

setRunStart()

void ldmx::RunHeader::setRunStart ( const int runStart )

inline

Set the run start time in seconds since epoch.

Parameters

[in]

runStart

the start time of the run.

Definition at line 115 of file RunHeader.h.

{ runStart_ = runStart; }

References runStart_.

Referenced by framework::Process::run().

setStringParameter()

void ldmx::RunHeader::setStringParameter ( const std::string & name, std::string value )

inline

Set a string parameter value.

Parameters

name	The name of the parameter.
value	The parameter value.

Definition at line 222 of file RunHeader.h.

                                                                  {
    stringParameters_[name] = value;
  }

References stringParameters_.

Referenced by simcore::Simulator::beforeNewRun(), framework::Process::newRun(), simcore::biasoperators::DarkBrem::RecordConfig(), simcore::biasoperators::ElectroNuclear::RecordConfig(), simcore::biasoperators::GammaToMuPair::RecordConfig(), simcore::biasoperators::K0LongInelastic::RecordConfig(), simcore::biasoperators::NeutronInelastic::RecordConfig(), simcore::biasoperators::PhotoNuclear::RecordConfig(), simcore::generators::GeneralParticleSource::RecordConfig(), simcore::generators::LHEPrimaryGenerator::RecordConfig(), simcore::generators::MultiParticleGunPrimaryGenerator::RecordConfig(), and simcore::generators::ParticleGun::RecordConfig().

stream()

void ldmx::RunHeader::stream

(

std::ostream &

s

)

const

Stream this object into the input ostream.

Includes new-line characters to separate out the different parameter maps

Parameters

[in]

s

ostream to write to

Definition at line 15 of file RunHeader.cxx.

                                          {
  s << "RunHeader { run: " << getRunNumber() << ", numTries: " << getNumTries()
    << ", detectorName: " << getDetectorName()
    << ", description: " << getDescription() << "\n";
  s << "  intParameters: "
    << "\n";
  for (const auto &[key, val] : intParameters_)
    s << "    " << key << " = " << val << "\n";
  s << "  floatParameters: "
    << "\n";
  for (const auto &[key, val] : floatParameters_)
    s << "    " << key << " = " << val << "\n";
  s << "  stringParameters: "
    << "\n";
  for (const auto &[key, val] : stringParameters_)
    s << "    " << key << " = " << val << "\n";
  s << "}";
}

References floatParameters_, getDescription(), getDetectorName(), getNumTries(), getRunNumber(), intParameters_, and stringParameters_.

Referenced by Print().

Friends And Related Symbol Documentation

operator<<

std::ostream & operator<< ( std::ostream & s, const ldmx::RunHeader & h )

friend

Stream this object to an output stream.

Needs to be here and labeled as friend for it to be compatible with Boost logging.

See also

ldmx::RunHeader::stream

Parameters

[in]	s	ostream to write to
[in]	h	RunHeader to write out

Returns

modified ostream

Definition at line 249 of file RunHeader.h.

                                                                       {
    h.stream(s);
    return s;
  }

Member Data Documentation

description_

std::string ldmx::RunHeader::description_ {""}

private

Run description.

Definition at line 262 of file RunHeader.h.

{""};

Referenced by getDescription(), and setDescription().

detectorName_

std::string ldmx::RunHeader::detectorName_ {""}

private

Detector name.

Definition at line 259 of file RunHeader.h.

{""};

Referenced by getDetectorName(), and setDetectorName().

floatParameters_

std::map<std::string, float> ldmx::RunHeader::floatParameters_

private

Map of float parameters.

Definition at line 301 of file RunHeader.h.

Referenced by getFloatParameter(), getFloatParameters(), setFloatParameter(), and stream().

intParameters_

std::map<std::string, int> ldmx::RunHeader::intParameters_

private

Map of int parameters.

Definition at line 298 of file RunHeader.h.

Referenced by getIntParameter(), getIntParameters(), setIntParameter(), and stream().

ldmxsw_version_

std::string ldmx::RunHeader::ldmxsw_version_ {LDMXSW_VERSION}

private

ldmx-sw software version

Definition at line 295 of file RunHeader.h.

{LDMXSW_VERSION};

Referenced by getLdmxswVersion().

numTries_

int ldmx::RunHeader::numTries_ {0}

private

Total number of events that were begun during the production of this run.

This value is only set at the end of processing so we can faithfully store the total number of events that were started. In the case where maxTriesPerEvent is set to 1, this will be the same as the configured maxEvents during Production Mode. If more than one try per event is allowed, this will not necessarily be maxEvents since processors could abort an event causing more than maxEvents to be started. This can be summarized by the following inequality

maxEvents <= numTries <= maxEvents*maxTriesPerEvent

Definition at line 284 of file RunHeader.h.

{0};

Referenced by getNumTries(), and setNumTries().

runEnd_

int ldmx::RunHeader::runEnd_ {0}

private

Run end in seconds since epoch.

Definition at line 268 of file RunHeader.h.

{0};

Referenced by getRunEnd(), and setRunEnd().

runNumber_

int ldmx::RunHeader::runNumber_ {0}

private

Run number.

Definition at line 256 of file RunHeader.h.

{0};

Referenced by getRunNumber().

runStart_

int ldmx::RunHeader::runStart_ {0}

private

Run start in seconds since epoch.

Definition at line 265 of file RunHeader.h.

{0};

Referenced by getRunStart(), and setRunStart().

softwareTag_

std::string ldmx::RunHeader::softwareTag_ {GIT_SHA1}

private

git SHA-1 hash associated with the software tag used to generate this file.

Definition at line 290 of file RunHeader.h.

{GIT_SHA1};

Referenced by getSoftwareTag().

stringParameters_

std::map<std::string, std::string> ldmx::RunHeader::stringParameters_

private

Map of string parameters.

Definition at line 304 of file RunHeader.h.

Referenced by getStringParameter(), getStringParameters(), setStringParameter(), and stream().

---

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

• Framework/include/Framework/RunHeader.h
• Framework/src/Framework/RunHeader.cxx