Root::TGoodRunsList Class Reference

#include <TGoodRunsList.h>

Inheritance diagram for Root::TGoodRunsList:

Collaboration diagram for Root::TGoodRunsList:

Public Member Functions
	TGoodRunsList ()
	TGoodRunsList (const char *name)
virtual	~TGoodRunsList ()
	TGoodRunsList (const TGoodRunsList &)=default
	TGoodRunsList (TGoodRunsList &&)=default
TGoodRunsList &	operator= (const TGoodRunsList &)=default
TGoodRunsList &	operator= (TGoodRunsList &&)=default
void	AddGRL (const TGoodRunsList &other)
const Root::TGoodRunsList	GetOverlapWith (const TGoodRunsList &other) const
const Root::TGoodRunsList	GetSumWith (const TGoodRunsList &other) const
const Root::TGoodRunsList	GetPartOnlyIn (const TGoodRunsList &other) const
const Root::TGoodRunsList	GetPartNotIn (const TGoodRunsList &other) const
Bool_t	HasTriggerInfo () const
Bool_t	HasRun (Int_t runnr) const
Bool_t	HasRunLumiBlock (Int_t runnr, Int_t lumiblocknr) const
Bool_t	HasSameGRLInfo (const TGoodRunsList &other) const
Bool_t	HasOverlapWith (const TGoodRunsList &other, bool verb=false) const
void	AddRunLumiBlock (Int_t runnr, Int_t lumiblocknr)
void	SetVersion (const TString &version)
void	AddMetaData (const TString &key, const TString &value)
void	SetMetaData (const std::map< TString, TString > &metadata)
void	SetCheckGRLInfo (Bool_t check=kTRUE)
const Bool_t &	GetCheckGRLInfo () const
const TString &	GetVersion () const
const std::map< TString, TString > &	GetMetaData () const
unsigned int	GetMetaDataSize () const
void	Summary (Bool_t verbose=kFALSE) const
Bool_t	IsEmpty () const
std::vector< int >	GetRunlist () const
std::vector< Root::TGoodRun >	GetGoodRuns () const
std::vector< std::string >	GetTriggerList () const
std::vector< std::string >	GetStreamList () const
TString	GetSuggestedName () const
void	Compress ()

Public Attributes
K	keys
	STL member.
T	elements
	STL member.

Private Attributes
TString	m_version
std::map< TString, TString >	m_metadata
bool	m_checkGRLInfo {false}

Detailed Description

Definition at line 26 of file TGoodRunsList.h.

Constructor & Destructor Documentation

TGoodRunsList() [1/4]

Root::TGoodRunsList::TGoodRunsList

(

)

TGoodRunsList() [2/4]

Root::TGoodRunsList::TGoodRunsList

(

const char *

name

)

Definition at line 20 of file TGoodRunsList.cxx.

  : std::map<Int_t,TGoodRun>()
  , TNamed(name,"notitle")
{
}

~TGoodRunsList()

Root::TGoodRunsList::~TGoodRunsList ( )

virtual

Definition at line 27 of file TGoodRunsList.cxx.

{
}

TGoodRunsList() [3/4]

Root::TGoodRunsList::TGoodRunsList ( const TGoodRunsList & )

default

TGoodRunsList() [4/4]

Root::TGoodRunsList::TGoodRunsList ( TGoodRunsList && )

default

Member Function Documentation

AddGRL()

void Root::TGoodRunsList::AddGRL

(

const TGoodRunsList &

other

)

Definition at line 32 of file TGoodRunsList.cxx.

{
  // ensure version and name are identical
  Bool_t same = this->HasSameGRLInfo(other);
  if (m_checkGRLInfo || other.GetCheckGRLInfo()) {
    if (!same) {
      TMsgLogger m_logger("TGoodRunsList");
      m_logger << kWARNING << "Incompatible NamedLumiRanges: " << GEndl;
      this->Summary(kFALSE);
      other.Summary(kFALSE);
      m_logger << kWARNING << "Not adding GoodRunsList." << GEndl;
      return;
    }
  }
 
  // merge metadata
  for (const auto& othermditem : other.GetMetaData()) {
    auto thismditem = m_metadata.find(othermditem.first);
    if (thismditem == m_metadata.end()) {
      m_metadata.insert(othermditem);
    } else {
      auto& nameStr = othermditem.first;
      auto& thisvaluestr = thismditem->second;
      if (thisvaluestr != othermditem.second) {
    if (nameStr == "RunList") {
      thisvaluestr += ",";
    } else {
      thisvaluestr += " | ";
    }
    thisvaluestr += othermditem.second;
      }
    }
  }
 
  const TGoodRunsList& diffgrl = this->GetPartOnlyIn(other);
 
  std::map<Int_t,Root::TGoodRun>::const_iterator itr;
  // Store diffgrl goodrunslist
  for (itr = diffgrl.begin(); itr!=diffgrl.end(); ++itr) {
    if (this->find(itr->first)!=this->end()) { // overlapping runnumbers
      Root::TGoodRun grun = itr->second.GetSumWith( this->find(itr->first)->second ) ;
      if (!grun.IsEmpty()) (*this)[itr->first] = grun;
    } else if (!itr->second.IsEmpty()) { // store rest directly
      (*this)[itr->first] = itr->second;
    }
  }
 
  return;
}

AddMetaData()

void Root::TGoodRunsList::AddMetaData ( const TString & key, const TString & value )

inline

Definition at line 53 of file TGoodRunsList.h.

{ m_metadata[key] = value; }

AddRunLumiBlock()

void Root::TGoodRunsList::AddRunLumiBlock	(	Int_t	runnr,
		Int_t	lumiblocknr )

Definition at line 413 of file TGoodRunsList.cxx.

{
  if (runnr<0 || lumiblocknr<0) return;
  if (this->HasRunLumiBlock(runnr,lumiblocknr)) return;
 
  std::map< Int_t, TGoodRun >::iterator itr = this->find(runnr);
  if (itr==this->end()) {
    this->insert( std::pair< Int_t, TGoodRun >(runnr,Root::TGoodRun(runnr)) );
    itr = this->find(runnr);
  }
 
  itr->second.AddLB(lumiblocknr);
}

Compress()

void Root::TGoodRunsList::Compress

(

)

Definition at line 429 of file TGoodRunsList.cxx.

{
  for (auto& [runno, run] : *this) run.Compress();
}

GetCheckGRLInfo()

const Bool_t & Root::TGoodRunsList::GetCheckGRLInfo ( ) const

inline

Definition at line 57 of file TGoodRunsList.h.

{ return m_checkGRLInfo; }

GetGoodRuns()

std::vector< Root::TGoodRun > Root::TGoodRunsList::GetGoodRuns

(

)

const

Definition at line 287 of file TGoodRunsList.cxx.

{
  std::vector<Root::TGoodRun> runlist;
  for (const auto& [runno, run] : *this) runlist.push_back(run);
 
  return runlist;
}

GetMetaData()

const std::map< TString, TString > & Root::TGoodRunsList::GetMetaData ( ) const

inline

Definition at line 59 of file TGoodRunsList.h.

{ return m_metadata; }

GetMetaDataSize()

unsigned int Root::TGoodRunsList::GetMetaDataSize ( ) const

inline

Definition at line 60 of file TGoodRunsList.h.

{ return m_metadata.size(); }

GetOverlapWith()

const Root::TGoodRunsList Root::TGoodRunsList::GetOverlapWith

(

const TGoodRunsList &

other

)

const

Definition at line 83 of file TGoodRunsList.cxx.

{
  Root::TGoodRunsList overlapgrl;
  overlapgrl.SetName("Overlap of GRLs");
 
  // ensure version and metadata are identical
  Bool_t same = this->HasSameGRLInfo(other);
  if (m_checkGRLInfo || other.GetCheckGRLInfo()) { 
    if (!same) {
      TMsgLogger m_logger("TGoodRunsList");
      m_logger << kWARNING << "Incompatible NamedLumiRanges: " << GEndl; 
      this->Summary(kFALSE);
      other.Summary(kFALSE);
      m_logger << kWARNING << "Returning empty GoodRunsList." << GEndl;
      return overlapgrl;
    }
  }
  if (same) {
    overlapgrl.SetName(this->GetName());
    overlapgrl.SetVersion(this->GetVersion());
    overlapgrl.SetMetaData(this->GetMetaData());
  }
 
  // Store goodruns
  std::map<Int_t,Root::TGoodRun>::const_iterator itr = this->begin();
  for (; itr!=this->end(); ++itr) {
    if (other.find(itr->first)!=other.end()) { // check runnumbers
      Root::TGoodRun grun = itr->second.GetOverlapWith( other.find(itr->first)->second ) ;
      if (!grun.IsEmpty()) {
        grun.Sort(); // sort lumiblock ranges before storage
        overlapgrl[itr->first] = grun;
      }
    }
  }
  
  return overlapgrl;
}

GetPartNotIn()

const Root::TGoodRunsList Root::TGoodRunsList::GetPartNotIn

(

const TGoodRunsList &

other

)

const

Definition at line 175 of file TGoodRunsList.cxx.

{
  Root::TGoodRunsList notinother;
  notinother.SetName("Difference of GRLs");  
 
  // ensure version and metadata are identical
  Bool_t same = this->HasSameGRLInfo(other);
  if (m_checkGRLInfo || other.GetCheckGRLInfo()) { 
    if (!same) {
      TMsgLogger m_logger("TGoodRunsList");
      m_logger << kWARNING << "Incompatible NamedLumiRanges: " << GEndl;
      this->Summary(kFALSE);
      other.Summary(kFALSE);
      m_logger << kWARNING << "Returning empty GoodRunsList." << GEndl;
      return notinother;
    }
  }
  if (same) {
    notinother.SetName(this->GetName());
    notinother.SetVersion(this->GetVersion());
    notinother.SetMetaData(this->GetMetaData());
  }
 
  std::map<Int_t,Root::TGoodRun>::const_iterator itr;
  // How to store this goodrun ?
  for (itr = this->begin(); itr!=this->end(); ++itr) {
    if (other.find(itr->first)!=other.end()) { // check runnumbers
      Root::TGoodRun notinrun = itr->second.GetPartNotIn( other.find(itr->first)->second ) ;
      if (!notinrun.IsEmpty()) notinother[itr->first] = notinrun;
    } else if (!itr->second.IsEmpty()) { // store difference
      notinother[itr->first] = itr->second;
    }
  }
 
  return notinother;
}

GetPartOnlyIn()

const Root::TGoodRunsList Root::TGoodRunsList::GetPartOnlyIn

(

const TGoodRunsList &

other

)

const

Definition at line 168 of file TGoodRunsList.cxx.

{
  return other.GetPartNotIn(*this);
}

GetRunlist()

std::vector< int > Root::TGoodRunsList::GetRunlist

(

)

const

Definition at line 277 of file TGoodRunsList.cxx.

{
  std::vector<int> runlist;
  for (const auto& [runno, run] : *this) runlist.push_back(runno);
 
  return runlist;
}

GetStreamList()

std::vector< std::string > Root::TGoodRunsList::GetStreamList

(

)

const

Definition at line 311 of file TGoodRunsList.cxx.

{
  std::vector<std::string> streamlist;
  
  for (const auto& [key, value] : m_metadata) {
    TString streamname = key;
    streamname.ToLower(); 
    if (streamname.BeginsWith("stream") && value.Length()>0) streamlist.push_back(value.Data());
  }   
  return streamlist;
}     

GetSuggestedName()

TString Root::TGoodRunsList::GetSuggestedName

(

)

const

Definition at line 390 of file TGoodRunsList.cxx.

{
  if (this->IsEmpty()) return "grl_empty";
 
  Int_t beginrun(-1), endrun(-1), beginlb(-1), endlb(-1);
 
  Root::TGoodRun begingr = this->begin()->second;
  Root::TGoodRun endgr   = this->rbegin()->second;
 
  if (!begingr.IsEmpty()) {
    beginrun = begingr.GetRunNumber();
    beginlb = begingr.begin()->Begin();
  }
  if (!endgr.IsEmpty()) {
    endrun = endgr.GetRunNumber();
    endlb = endgr.rbegin()->End(); 
  } 
 
  return Form("grl_%d.%d-%d.%d",beginrun,beginlb,endrun,endlb);
}

GetSumWith()

const Root::TGoodRunsList Root::TGoodRunsList::GetSumWith

(

const TGoodRunsList &

other

)

const

Definition at line 123 of file TGoodRunsList.cxx.

{
  Root::TGoodRunsList sumgrl;
  sumgrl.SetName("Sum of GRLs"/*this->GetName()*/);
 
  // ensure version and metadata are identical
  Bool_t same = this->HasSameGRLInfo(other);
  if (m_checkGRLInfo || other.GetCheckGRLInfo()) { 
    if (!same) { 
      TMsgLogger m_logger("TGoodRunsList");
      m_logger << kWARNING << "Incompatible NamedLumiRanges: " << GEndl; 
      this->Summary(kFALSE);
      other.Summary(kFALSE);
      m_logger << kWARNING << "Returning empty GoodRunsList." << GEndl;
      return sumgrl;
    }
  }
  if (same) {
    sumgrl.SetName(this->GetName());
    sumgrl.SetVersion(this->GetVersion());
    sumgrl.SetMetaData(this->GetMetaData());
  }
 
  std::map<Int_t,Root::TGoodRun>::const_iterator itr;
  // Store this goodruns
  for (itr = this->begin(); itr!=this->end(); ++itr) {
    if (other.find(itr->first)!=other.end()) { // check runnumbers
      Root::TGoodRun grun = itr->second.GetSumWith( other.find(itr->first)->second ) ;
      if (!grun.IsEmpty()) sumgrl[itr->first] = grun;
    } else if (!itr->second.IsEmpty()) { // store difference
      sumgrl[itr->first] = itr->second;
    }
  }
  // Store remaining other goodruns
  for (itr = other.begin(); itr!=other.end(); ++itr) {
    if (sumgrl.find(itr->first)==sumgrl.end() && !itr->second.IsEmpty()) { // check for remaining runnumbers
      sumgrl[itr->first] = itr->second;
    }
  }
 
  return sumgrl;
}

GetTriggerList()

std::vector< std::string > Root::TGoodRunsList::GetTriggerList

(

)

const

Definition at line 297 of file TGoodRunsList.cxx.

{
  std::vector<std::string> triggerchains;
 
  for (const auto& [key, value] : m_metadata) {
    TString triggername = key;
    triggername.ToLower();
    if (triggername.BeginsWith("trigger") && value.Length()>0) triggerchains.push_back(value.Data());
  }
  return triggerchains;
}

GetVersion()

const TString & Root::TGoodRunsList::GetVersion ( ) const

inline

Definition at line 58 of file TGoodRunsList.h.

{ return m_version; }

HasOverlapWith()

Bool_t Root::TGoodRunsList::HasOverlapWith	(	const TGoodRunsList &	other,
		bool	verb = false ) const

Definition at line 242 of file TGoodRunsList.cxx.

{ 
  const Root::TGoodRunsList overlapgrl = this->GetOverlapWith(other);
  bool isEmpty = overlapgrl.IsEmpty();
  if (!isEmpty && verb) overlapgrl.Summary(true);
 
  return !isEmpty; 
}

HasRun()

Bool_t Root::TGoodRunsList::HasRun

(

Int_t

runnr

)

const

Definition at line 214 of file TGoodRunsList.cxx.

{
  return ( this->find(runnr)!=this->end() );
}

HasRunLumiBlock()

Bool_t Root::TGoodRunsList::HasRunLumiBlock	(	Int_t	runnr,
		Int_t	lumiblocknr ) const

Definition at line 221 of file TGoodRunsList.cxx.

{
  const auto run = this->find(runnr);
  return ( run!=this->end() && run->second.HasLB( lumiblocknr ) );
}

HasSameGRLInfo()

Bool_t Root::TGoodRunsList::HasSameGRLInfo

(

const TGoodRunsList &

other

)

const

check names

check versions

check RQ version <Metadata Name="RQTSVNVersion">CoolRunQuery-unknown</Metadata>

Definition at line 325 of file TGoodRunsList.cxx.

{
  TMsgLogger m_logger("TGoodRunsList");
  Bool_t same(kTRUE);

  same = same && (TString(this->GetName())==TString(other.GetName())) ;
  if (!same) {
    m_logger << kDEBUG << "Incompatible names: <" << this->GetName() << "> <" << other.GetName() << ">" << GEndl;
    return kFALSE;
  }
  same = same && (this->GetVersion()==other.GetVersion()) ;
  if (!same) { 
    m_logger << kDEBUG << "Incompatible versions: <" << this->GetVersion() << "> <" << other.GetVersion() << ">" << GEndl; 
    return kFALSE;
  } 
  std::map<TString,TString>::const_iterator mitr = this->GetMetaData().find("RQTSVNVersion");
  std::map<TString,TString>::const_iterator oitr = other.GetMetaData().find("RQTSVNVersion");
  if ( mitr==this->GetMetaData().end() && oitr==other.GetMetaData().end() ) {
    ; // ok, RQ version missing from both grls
  } else if ( mitr!=this->GetMetaData().end() && oitr!=other.GetMetaData().end() ) {
    same = same && ( mitr->second==oitr->second );
    if (!same) { m_logger << kDEBUG << "Incompatible run query versions: " << mitr->first
                          << " : <" << mitr->second << "> <" << oitr->second << ">" << GEndl; }
  } else { same=kFALSE; } // version is missing from one grl
 
/*
  same = same && (this->GetMetaData().size()==other.GetMetaData().size()) ;
  if (!same) { 
    m_logger << kDEBUG << "Incompatible metadata sizes: <" << this->GetMetaData().size() << "> <" << other.GetMetaData().size() << ">" << GEndl; 
    return kFALSE;
  }
  std::map<TString,TString>::const_iterator mitr = this->GetMetaData().begin();
  for(; mitr!=this->GetMetaData().end() && same; ++mitr) {
    if (other.GetMetaData().find(mitr->first)!=other.GetMetaData().end()) {
      same = same && ( mitr->second==(other.GetMetaData().find(mitr->first))->second );
      if (!same) { m_logger << kDEBUG << "Incompatible metadata: " << mitr->first 
                            << " : <" << mitr->second << "> <" << (other.GetMetaData().find(mitr->first))->second << ">" << GEndl; }
    } else same=kFALSE; 
  }
*/
  return same;
}

HasTriggerInfo()

Bool_t Root::TGoodRunsList::HasTriggerInfo

(

)

const

Definition at line 229 of file TGoodRunsList.cxx.

{
  std::map<TString,TString>::const_iterator itr = m_metadata.begin(); 
  for (; itr!=m_metadata.end(); ++itr) {
    TString triggername = itr->first;
    triggername.ToLower();
    if (triggername.BeginsWith("trigger") && itr->second.Length()>0) return kTRUE;
  }
  return kFALSE;
}

IsEmpty()

Bool_t Root::TGoodRunsList::IsEmpty

(

)

const

Definition at line 376 of file TGoodRunsList.cxx.

{
  if (this->empty()) return kTRUE;
 
  Bool_t isEmpty(kTRUE);
  std::map< Int_t, TGoodRun >::const_iterator litr = this->begin();
  for (; litr!=this->end() && isEmpty; ++litr)
    isEmpty = isEmpty && litr->second.IsEmpty();
 
  return isEmpty;
}

operator=() [1/2]

TGoodRunsList & Root::TGoodRunsList::operator= ( const TGoodRunsList & )

default

operator=() [2/2]

TGoodRunsList & Root::TGoodRunsList::operator= ( TGoodRunsList && )

default

SetCheckGRLInfo()

void Root::TGoodRunsList::SetCheckGRLInfo ( Bool_t check = kTRUE )

inline

Definition at line 55 of file TGoodRunsList.h.

{ m_checkGRLInfo=check; }

SetMetaData()

void Root::TGoodRunsList::SetMetaData ( const std::map< TString, TString > & metadata )

inline

Definition at line 54 of file TGoodRunsList.h.

{ m_metadata = metadata; }

SetVersion()

void Root::TGoodRunsList::SetVersion ( const TString & version )

inline

Definition at line 52 of file TGoodRunsList.h.

{ m_version = version; }

Summary()

void Root::TGoodRunsList::Summary

(

Bool_t

verbose = kFALSE

)

const

Definition at line 253 of file TGoodRunsList.cxx.

{
  // TNamed print
  Print();
 
  TMsgLogger m_logger("TGoodRunsList");
  // Versioning and metadata info
  m_logger << kINFO << "Version: " << m_version << GEndl;
  std::map<TString,TString>::const_iterator titr = m_metadata.begin();
  for (titr = m_metadata.begin(); titr!=m_metadata.end(); ++titr) 
    m_logger << kINFO << "Metadata: " << (titr->first) << " : " << (titr->second) << GEndl;
 
  m_logger << kINFO << "Number of runs: " << this->size() << GEndl;
 
  // Info about runs
  if (verbose) {
    std::map<Int_t,Root::TGoodRun>::const_iterator itr = this->begin();
    std::map<Int_t,Root::TGoodRun>::const_iterator end = this->end();
    for (; itr!=end; ++itr) itr->second.Summary();
  }
}

Member Data Documentation

elements

T std::map< K, T >::elements

inherited

STL member.

keys

K std::map< K, T >::keys

inherited

STL member.

m_checkGRLInfo

bool Root::TGoodRunsList::m_checkGRLInfo {false}

private

Definition at line 77 of file TGoodRunsList.h.

{false};

m_metadata

std::map<TString,TString> Root::TGoodRunsList::m_metadata

private

Definition at line 76 of file TGoodRunsList.h.

m_version

TString Root::TGoodRunsList::m_version

private

Definition at line 75 of file TGoodRunsList.h.

---

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

• TGoodRunsList.h
• TGoodRunsList.cxx