Config Struct Reference

Collaboration diagram for Config:

Public Member Functions
bool	initialize (int argc, char *argv[])
	Config (const char *name)
Config &	setTriggers (const std::string &t)
Config &	setLeptonPDF (unsigned nmin, unsigned nmax, std::initializer_list< float > ptvalues)
Config &	setEfficiency (const std::string &leg, double eff)
Config &	setEfficiency (const std::string &leg, std::function< double(float)> &&eff)
Config &	setEventSelection (const decltype(eventSelection)&sel)
Config &	setDebug ()
Config &	setExpectedEfficiency (double eff, double tolerance)
Config &	setUnavailable (const std::string &leg)
void	parseProgramOptions (int argc, char *argv[])
void	usage ()

Public Attributes
asg::AnaToolHandle< IAsgElectronEfficiencyCorrectionTool >	tool
std::vector< std::tuple< CP::SystematicSet, NP > >	systematics {}
std::vector< Domain >	domains {}
int	run_number {0}
bool	analysis_mode {false}
std::string	testName
std::string	triggers = ""
unsigned	minLeptons = 1
unsigned	maxLeptons = 5
std::vector< float >	leptonPtValues
std::map< std::string, std::function< double(float)> >	efficiencies
std::function< bool(const std::vector< const xAOD::Electron * > &, const std::vector< const xAOD::Muon * > &, const std::vector< const xAOD::Photon * > &)>	eventSelection = nullptr
std::string	unavailable
double	expectedEfficiency = -1.
double	expectedEfficiencyTolerance = 1e-6
bool	generateElectrons = false
bool	generateMuons = false
bool	generatePhotons = false
bool	debug = false
std::vector< std::string >	knownParameters
std::vector< std::string >	inputFiles {}
unsigned int	smk { 0 }
unsigned int	l1psk { 0 }
unsigned int	hltpsk { 0 }
unsigned int	bgsk { 0 }
std::string	dbalias { "TRIGGERDB_RUN3" }
std::string	crestDb { "" }
const std::string	crestServerDefault { "http://crest-04.cern.ch/" }
std::string	crestServer { crestServerDefault }
std::string	crestApi { "" }
bool	doCtp { false }
bool	write { false }
bool	writeFromDataStructure { false }
std::string	base { "" }
bool	help { false }
bool	detail { false }
vector< string >	error

Private Member Functions
void	updateFlavours (const std::string &leg)

Detailed Description

Definition at line 46 of file dumpNPs.cxx.

Constructor & Destructor Documentation

Config()

Config::Config ( const char *  name )

inline

Definition at line 142 of file TrigGlobEffCorrValidation.cxx.

: testName(name), leptonPtValues {30e4f} { }

Member Function Documentation

initialize()

bool Config::initialize	(	int	argc,
		char *	argv[]
	)

Definition at line 159 of file dumpNPs.cxx.

{
  using namespace asg::msgUserCode;
 
  auto help = [&]() {
    Info(MSGSOURCE, "Usage (1): EgEfficiencyCorr_dumpNPs Year=<value> IdKey=<value> <property1=value1> ... <property N=value N>");
    Info(MSGSOURCE, "   ++ prints eta x pt region of influence of each nuisance parameter for the chosen year");
    Info(MSGSOURCE, "Usage (2): EgEfficiencyCorr_dumpNPs AnalysisEta=<list> AnalysisPt=<list> IdKey=<value> <property1=value1> ... <property N=value N>");
    Info(MSGSOURCE, "   ++ prints a short list of all NPs relevant in the selected eta x pt (in MeV) region");
    Info(MSGSOURCE, "   ++ e.g. EgEfficiencyCorr_dumpNPs AnalysisEta=-2.0..2.0,nocrack AnalysisPt=20e3..150e3");
    Info(MSGSOURCE, "   ++ one of the Analysis* arguments can be omitted, in which case the full range is scanned");
    Info(MSGSOURCE, "   ++ several intervals can be specified, separated by commas, e.g. AnalysisEta=0..0.6,0.8..1.37");
    Info(MSGSOURCE, "   ++ recognized aliases: 'nocrack' (crack veto), 'sym' (duplicates for eta<0), 'barrel', 'endcap'");
    Info(MSGSOURCE, "Common details:");
    Info(MSGSOURCE, "   ++ for other SFs, IdKey can be replaced by RecoKey/IsoKey/TriggerKey");
    Info(MSGSOURCE, "   ++ CorrectionFileNameList can also be used instead of keys");
    Info(MSGSOURCE, "   ++ optional arguments are other configurable properties of the AsgElectronEfficiencyCorrectionTool.");
    Info(MSGSOURCE, "   ++ e.g. EgEfficiencyCorr_dumpNPs Year=2015 IdKey=Tight CorrelationModel=SIMPLIFIED UncorrEtaBinsUser=0,1.37,2.47");
    std::abort();
  };
 
  if (argc < 2) help();
 
  const std::set<std::string> string_properties{
    "MapFilePath", "RecoKey", "IdKey", "IsoKey", "TriggerKey", 
    "CorrelationModel"};
  const std::set<std::string> int_properties{"ForceDataType"};
  const std::set<std::string> vector_properties{
    "UncorrEtaBinsUser", "UncorrEtBinsUser"};
  
  // Set default values.
  const int mc_type{static_cast<int>(PATCore::ParticleDataType::Full)};
  ANA_CHECK( tool.setProperty("ForceDataType", mc_type) );
  ANA_CHECK( tool.setProperty("CorrelationModel", "FULL") );
  ANA_CHECK( tool.setProperty("UseRandomRunNumber", true) );
 
  run_number = 0;
  std::vector<int8_t> eta_flags(eta_edges.size()-1, 0);
  std::vector<int8_t> pt_flags(pt_edges.size()-1, 0);
 
  for (int i=1; i<argc; ++i) {
    std::string key{argv[i]};
    const std::size_t pos{key.find('=')};
    if (pos == std::string::npos) help();
    std::string val(key.substr(pos + 1));
    key.resize(pos);
    if (!key.length() || !val.length()) help();
    if (key == "CorrectionFileNameList") {
      std::vector<std::string> files{val};
      ANA_CHECK( tool.setProperty(key, files) );
    } else if (key == "Year") {
      run_number = get_run_number(std::stoi(val));
    } else if (string_properties.count(key)) {
      ANA_CHECK( tool.setProperty(key, val) );
    } else if (int_properties.count(key)) {
      ANA_CHECK( tool.setProperty(key, std::stoi(val)) );
    } else if (vector_properties.count(key)) {
      std::vector<float> bins;
      ANA_CHECK( parse_csv_list(val, bins) );
      ANA_CHECK( tool.setProperty(key, bins) );
    } else if (key == "AnalysisEta") {
      ANA_CHECK( parse_csv_list(val, eta_flags, eta_edges) );
      analysis_mode = true;
    } else if (key == "AnalysisPt") {
      ANA_CHECK( parse_csv_list(val, pt_flags, pt_edges) );
      analysis_mode = true;
    } else {
      Error(MSGSOURCE, "Unrecognized property %s", key.c_str());
      help();
    }
  }
 
  if (analysis_mode) {
    if (run_number) {
      Warning(MSGSOURCE, 
              "When Analysis* arguments are provided, "
              "Year is ignored.");
    }
  } else if (!run_number) {
    Error(MSGSOURCE, "Command-line arguments must include Year");
    help();
  }
 
  // Enable negative-eta bins, when the 'sym' alias was specified:
  for (std::size_t i{0}; i<eta_flags.size(); ++i) {
    if (eta_flags[i] != 2) continue;
    float z{0.5f * (eta_edges[i] + eta_edges[i+1])};
    auto eeb{eta_edges.cbegin()}, eee{eta_edges.cend()};
    const auto j = static_cast<std::size_t>(
      std::upper_bound(eeb, eee, -z) - eeb - 1);
    if (i == j) continue;
    if (j >= eta_edges.size()) return false;
    eta_flags[i] = eta_flags[j];
  }
 
  // By default, scan whole ranges (except crack if vetoed)
  auto efb{eta_flags.begin()}, efe{eta_flags.end()};
  if (!std::count(efb, efe, 1)) {
    std::replace(efb, efe, 0, 1);
  }
  auto pfb{pt_flags.begin()}, pfe{pt_flags.end()};
  if (!std::count(pfb, pfe, 1)) {
    std::fill(pfb, pfe, 1);
  }
 
  domains.clear();
  for (std::size_t i{0}; i<eta_flags.size(); ++i) {
    if (eta_flags[i] < 1) continue;
    for (std::size_t j{0}; j<pt_flags.size(); ++j) {
      if (pt_flags[j] < 1) continue;
      domains.emplace_back(Domain{
        eta_edges[i], eta_edges[i+1],
        pt_edges[j], pt_edges[j+1]
      });
    }
  }
  return true;
}

parseProgramOptions()

void Config::parseProgramOptions	(	int	argc,
		char *	argv[]
	)

Definition at line 103 of file TriggerMenuRW.cxx.

                                                  {
 
   std::string currentParameter("");
   std::string listofUnknownParameters = "";
 
   for(int i=1; i<argc; i++) {
 
      std::string currentWord(argv[i]);
      bool isParam = currentWord[0]=='-'; // string starts with a '-', so it is a parameter name
 
      // get the parameter name
      int firstChar = currentWord.find_first_not_of('-');
      string paramName = currentWord.substr(firstChar);
 
      // check if the parameter is known
      if ( isParam && std::find(knownParameters.begin(), knownParameters.end(), paramName) == knownParameters.end() ) {
         listofUnknownParameters += " " + currentWord;
         continue;
      }
 
      if(isParam) {
         currentParameter = "";
         // check the boolean parameters
         if(paramName == "h" || paramName == "help" ) { help = true; continue; }
         if(paramName == "d" || paramName == "detail" ) { detail = true; continue; }
         if(paramName == "w" || paramName == "write" ) { write = true; }
         if(paramName == "W" || paramName == "Write" ) { writeFromDataStructure = true; }
         if(paramName == "c" || paramName == "ctp" ) { doCtp = true; }
         currentParameter = std::move(paramName);
         continue;
      }
 
      // now treat the parameter values
 
      // inputs
      if(currentParameter == "file" || currentParameter == "f") {
         inputFiles.push_back(std::move(currentWord));
         continue; 
      }
      if(currentParameter == "smk") { 
         smk = stoul(currentWord);
         continue; 
      }
      if(currentParameter == "l1psk") { 
         l1psk = stoul(currentWord);
         continue; 
      }
      if(currentParameter == "hltpsk") { 
         hltpsk = stoul(currentWord);
         continue; 
      }
      if(currentParameter == "bgsk") {
         bgsk = stoul(currentWord);
         continue;
      }
      if(currentParameter == "db") { 
         dbalias = std::move(currentWord);
         continue; 
      }
      if(currentParameter == "crest-db") { 
         crestDb = std::move(currentWord);
         continue; 
      }
      if(currentParameter == "crest-server") { 
         crestServer = std::move(currentWord);
         continue; 
      }
      if(currentParameter == "crest-api") { 
         crestApi = std::move(currentWord);
         continue; 
      }
      // output
      if(currentParameter == "write" || currentParameter == "w" || currentParameter == "Write" || currentParameter == "W") {
         base = std::move(currentWord);
         continue; 
      }
 
   }
 
   // some sanity checks
   if ( inputFiles.size() == 0 and smk == 0 and l1psk == 0 and hltpsk == 0 and bgsk == 0 ) {
      error.push_back("No input specified! Please provide either one of the following: input file(s), smk, l1psk, hltpsk, or bgsk");
   }
 
   if ( listofUnknownParameters.size() > 0 ) {
      error.push_back( string("Unknown parameter(s):") + listofUnknownParameters);
   }
 
}

setDebug()

Config& Config::setDebug ( )

inline

Definition at line 164 of file TrigGlobEffCorrValidation.cxx.

{ debug = true; return *this; };

setEfficiency() [1/2]

Config& Config::setEfficiency ( const std::string &  leg, double  eff  )

inline

Definition at line 151 of file TrigGlobEffCorrValidation.cxx.

    {
        efficiencies.emplace(leg, [=](float){return eff;});
        updateFlavours(leg);
        return *this;
    }

setEfficiency() [2/2]

Config& Config::setEfficiency ( const std::string &  leg, std::function< double(float)> &&  eff  )

inline

Definition at line 157 of file TrigGlobEffCorrValidation.cxx.

    {
        efficiencies.emplace(leg, eff);
        updateFlavours(leg);
        return *this;
    }

setEventSelection()

Config& Config::setEventSelection ( const decltype(eventSelection)&  sel )

inline

Definition at line 163 of file TrigGlobEffCorrValidation.cxx.

{ eventSelection = sel; return *this; }

setExpectedEfficiency()

Config& Config::setExpectedEfficiency ( double  eff, double  tolerance  )

inline

Definition at line 165 of file TrigGlobEffCorrValidation.cxx.

    {
        expectedEfficiency = eff;
        expectedEfficiencyTolerance = tolerance;
        return *this;
    }

setLeptonPDF()

Config& Config::setLeptonPDF ( unsigned  nmin, unsigned  nmax, std::initializer_list< float >  ptvalues  )

inline

Definition at line 144 of file TrigGlobEffCorrValidation.cxx.

    {
        minLeptons = nmin;
        maxLeptons = nmax;
        leptonPtValues = ptvalues;
        return *this;
    }

setTriggers()

Config& Config::setTriggers ( const std::string &  t )

inline

Definition at line 143 of file TrigGlobEffCorrValidation.cxx.

{ triggers = t; return *this; }

setUnavailable()

Config& Config::setUnavailable ( const std::string &  leg )

inline

Definition at line 171 of file TrigGlobEffCorrValidation.cxx.

    {
        if (!unavailable.empty()) unavailable += ',';
        unavailable += leg;
        updateFlavours(leg);
        return *this;
    }

updateFlavours()

void Config::updateFlavours ( const std::string &  leg )

inlineprivate

Definition at line 179 of file TrigGlobEffCorrValidation.cxx.

    {
        if (leg[0] == 'e') generateElectrons = true;
        else if (leg[0] == 'm') generateMuons = true;
        else if (leg[0] == 'g') generatePhotons = true;
    }

usage()

void Config::usage

(

)

Definition at line 72 of file TriggerMenuRW.cxx.

                   {
 
   cout << "The program needs to be run with the following specifications:\n\n";
   cout << "TriggerMenuRW <options>\n";
   cout << "\n";
   cout << "[Input options]\n";
   cout << "  -f|--file             file1 [file2 [file3 ...]]     ... one or multiple json files\n";
   cout << "  --smk                 smk                           ... smk \n";
   cout << "  --l1psk               l1psk                         ... the L1 prescale key \n";
   cout << "  --hltpsk              hltpsk                        ... the HLT prescale key \n";
   cout << "  --bgsk                bgsk                          ... the bunchgroup key \n";
   cout << "  --db                  dbalias                       ... dbalias for oracle/frontier access (default " << dbalias << ") \n";
   cout << "  --crest-db            crestdb                       ... crest_db for Crest access, if specified Crest will be used (default '') \n";
   cout << "                                                          possible values: CONF_DATA_RUN3, CONF_MC_RUN3, CONF_REPR_RUN3\n";
   cout << "  --crest-server        server                        ... crest server (default " << crestServerDefault << ")\n";
   cout << "  --crest-api           version                       ... crest api version (default taken from CrestApi)";
   cout << "  -c|--ctp                                            ... if provided together with the SMK and DB then will read only CTP files from the DB and not the rest of the menu\n";
   cout << "[Output options]\n";
   cout << "  -w|--write            [base]                        ... to write out json files, e.g. L1menu[_<base>].json. base is optional.\n";
   cout << "  -W|--Write            [base]                        ... to write out json files from the internal structure (only for L1Menu), e.g. L1menu[_<base>].json. base is optional.\n";
   cout << "[Other options]\n";
   cout << "  -h|--help                                           ... this help\n";
   cout << "  -d|--detail                                         ... prints detailed job options\n";
   cout << "\n\n";
   cout << "Examples\n";
   cout << "  --file L1menu.json HLTMenu.json                     ... read L1Menu.json and HLTMenu.json and show some basic statistics\n";
   cout << "  --db TRIGGERDB_RUN3 --smk 3205                      ... read the L1 menu, HLT menu, HLT job options, and HLT monitoring groups for SMK 3205\n";
   cout << "  --db TRIGGERDB_RUN3 --smk 3205 -w                   ... read the information and write DB content directly as json files\n";
}

Member Data Documentation

analysis_mode

bool Config::analysis_mode {false}

Definition at line 53 of file dumpNPs.cxx.

base

std::string Config::base { "" }

Definition at line 54 of file TriggerMenuRW.cxx.

bgsk

unsigned int Config::bgsk { 0 }

Definition at line 43 of file TriggerMenuRW.cxx.

crestApi

std::string Config::crestApi { "" }

Definition at line 48 of file TriggerMenuRW.cxx.

crestDb

std::string Config::crestDb { "" }

Definition at line 45 of file TriggerMenuRW.cxx.

crestServer

std::string Config::crestServer { crestServerDefault }

Definition at line 47 of file TriggerMenuRW.cxx.

crestServerDefault

const std::string Config::crestServerDefault { "http://crest-04.cern.ch/" }

Definition at line 46 of file TriggerMenuRW.cxx.

dbalias

std::string Config::dbalias { "TRIGGERDB_RUN3" }

Definition at line 44 of file TriggerMenuRW.cxx.

debug

bool Config::debug = false

Definition at line 140 of file TrigGlobEffCorrValidation.cxx.

detail

bool Config::detail { false }

Definition at line 58 of file TriggerMenuRW.cxx.

doCtp

bool Config::doCtp { false }

Definition at line 49 of file TriggerMenuRW.cxx.

domains

std::vector<Domain> Config::domains {}

Definition at line 51 of file dumpNPs.cxx.

efficiencies

std::map<std::string, std::function<double(float)> > Config::efficiencies

Definition at line 132 of file TrigGlobEffCorrValidation.cxx.

error

vector<string> Config::error

Definition at line 61 of file TriggerMenuRW.cxx.

eventSelection

std::function<bool(const std::vector<const xAOD::Electron*>&,const std::vector<const xAOD::Muon*>&,const std::vector<const xAOD::Photon*>&)> Config::eventSelection = nullptr

Definition at line 133 of file TrigGlobEffCorrValidation.cxx.

expectedEfficiency

double Config::expectedEfficiency = -1.

Definition at line 135 of file TrigGlobEffCorrValidation.cxx.

expectedEfficiencyTolerance

double Config::expectedEfficiencyTolerance = 1e-6

Definition at line 136 of file TrigGlobEffCorrValidation.cxx.

generateElectrons

bool Config::generateElectrons = false

Definition at line 137 of file TrigGlobEffCorrValidation.cxx.

generateMuons

bool Config::generateMuons = false

Definition at line 138 of file TrigGlobEffCorrValidation.cxx.

generatePhotons

bool Config::generatePhotons = false

Definition at line 139 of file TrigGlobEffCorrValidation.cxx.

help

bool Config::help { false }

Definition at line 57 of file TriggerMenuRW.cxx.

hltpsk

unsigned int Config::hltpsk { 0 }

Definition at line 42 of file TriggerMenuRW.cxx.

inputFiles

std::vector<std::string> Config::inputFiles {}

Definition at line 39 of file TriggerMenuRW.cxx.

knownParameters

std::vector<std::string> Config::knownParameters

Initial value:

{ 
      "file", "f", "smk", "l1psk", "hltpsk", "bgsk", "db", "crest-db", "crest-server", "crest-api", "write", "w", 
      "Write", "W", "help", "h", "detail", "d", "ctp", "c"
      }

Definition at line 32 of file TriggerMenuRW.cxx.

l1psk

unsigned int Config::l1psk { 0 }

Definition at line 41 of file TriggerMenuRW.cxx.

leptonPtValues

std::vector<float> Config::leptonPtValues

Definition at line 131 of file TrigGlobEffCorrValidation.cxx.

maxLeptons

unsigned Config::maxLeptons = 5

Definition at line 130 of file TrigGlobEffCorrValidation.cxx.

minLeptons

unsigned Config::minLeptons = 1

Definition at line 129 of file TrigGlobEffCorrValidation.cxx.

run_number

int Config::run_number {0}

Definition at line 52 of file dumpNPs.cxx.

smk

unsigned int Config::smk { 0 }

Definition at line 40 of file TriggerMenuRW.cxx.

systematics

std::vector<std::tuple<CP::SystematicSet, NP> > Config::systematics {}

Definition at line 50 of file dumpNPs.cxx.

testName

std::string Config::testName

Definition at line 127 of file TrigGlobEffCorrValidation.cxx.

tool

asg::AnaToolHandle<IAsgElectronEfficiencyCorrectionTool> Config::tool

Initial value:

{
    "AsgElectronEfficiencyCorrectionTool/tool"}

Definition at line 48 of file dumpNPs.cxx.

triggers

std::string Config::triggers = ""

Definition at line 128 of file TrigGlobEffCorrValidation.cxx.

unavailable

std::string Config::unavailable

Definition at line 134 of file TrigGlobEffCorrValidation.cxx.

write

bool Config::write { false }

Definition at line 52 of file TriggerMenuRW.cxx.

writeFromDataStructure

bool Config::writeFromDataStructure { false }

Definition at line 53 of file TriggerMenuRW.cxx.

---

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

• dumpNPs.cxx
• TrigGlobEffCorrValidation.cxx
• TriggerMenuRW.cxx