FinalTriggerDecisionCalculator Class Reference

Helper class to give the getFinalTriggerDecision to python. More...

#include <FinalTriggerDecisionCalculator.h>

Static Public Member Functions
static bool	getFinalTriggerDecision (const SoftwareTriggerResult &result, bool forgetTotalResult=false)
	Calculate the final cut decision using all "total_results" of all sub triggers in the software trigger (filter and skim).
static SoftwareTriggerCutResult	getModuleResult (const SoftwareTriggerResult &result, const std::string &baseIdentifier, bool acceptOverridesReject)
	Calculate the "total_result" for a given base identifier by looping through all results with the given base identifier.

Detailed Description

Helper class to give the getFinalTriggerDecision to python.

Definition at line 18 of file FinalTriggerDecisionCalculator.h.

Member Function Documentation

getFinalTriggerDecision()

bool getFinalTriggerDecision ( const SoftwareTriggerResult &  result, bool  forgetTotalResult = false  )

static

Calculate the final cut decision using all "total_results" of all sub triggers in the software trigger (filter and skim).

The return value is a bool, which has the values accept (true) and reject (false):

• accept if and only if the filter stage has accepted the event. The event is also accepted if none of the triggers have run.
• reject if the filter stage rejected the event

If the final result is already stored to the result, it is returned immediately. Except for forgetTotalResult is st to true.

Deprecated: in an older version, the trigger stages were called "hlt", "fast_reco" and "skim". They are still supported by the function to read in old results, but should not be used anymore for new data. A warning will be issued.

Definition at line 15 of file FinalTriggerDecisionCalculator.cc.

{
  const auto& results = result.getResults();
 
  // Handle different revisions of the trigger menu
  // Revision 2: if there is a final decision already stored, just use it (if not forgetTotalResult is set)
  const std::string& allTotalResultName = SoftwareTriggerDBHandler::makeTotalResultName();
 
  auto allTotalResultIterator = results.find(allTotalResultName);
  if (allTotalResultIterator != results.end() and not forgetTotalResult) {
    auto allTotalResult = static_cast<SoftwareTriggerCutResult>(allTotalResultIterator->second);
    return allTotalResult == SoftwareTriggerCutResult::c_accept;
  }
 
  // Revision 2: filters are called "filter" and "skim". skim does not change the result.
  // if "filter" rejected the event, the event is rejected
  const std::string& filterTotalResultName = SoftwareTriggerDBHandler::makeTotalResultName("filter");
 
  auto filterTotalResultIterator = results.find(filterTotalResultName);
 
  if (filterTotalResultIterator != results.end()) {
    auto filterTotalResult = static_cast<SoftwareTriggerCutResult>(filterTotalResultIterator->second);
    if (filterTotalResult == SoftwareTriggerCutResult::c_reject) {
      return false;
    }
  }
 
  // Revision 1: filters are called "fast_reco", "hlt" and "calib". calib does not change result.
  // if any of fast_reco or hlt rejected the event, the event was rejected at all
  const std::string& fastRecoTotalResultName = SoftwareTriggerDBHandler::makeTotalResultName("fast_reco");
  const std::string& hltTotalResultName = SoftwareTriggerDBHandler::makeTotalResultName("hlt");
 
  auto fastRecoTotalResultIterator = results.find(fastRecoTotalResultName);
  auto hltTotalResultIterator = results.find(hltTotalResultName);
 
  if (fastRecoTotalResultIterator != results.end()) {
    B2WARNING("You are using an old trigger result with a newer version of the software. Make sure this is what you want.");
    auto fastRecoTotalResult = static_cast<SoftwareTriggerCutResult>(fastRecoTotalResultIterator->second);
    if (fastRecoTotalResult == SoftwareTriggerCutResult::c_reject) {
      return false;
    }
  }
  if (hltTotalResultIterator != results.end()) {
    B2WARNING("You are using an old trigger result with a newer version of the software. Make sure this is what you want.");
    auto hltTotalResult = static_cast<SoftwareTriggerCutResult>(hltTotalResultIterator->second);
    if (hltTotalResult == SoftwareTriggerCutResult::c_reject) {
      return false;
    }
  }
 
  // If there is no reject information (or no total information at all), accept the event :-)
  return true;
}

getModuleResult()

SoftwareTriggerCutResult getModuleResult ( const SoftwareTriggerResult &  result, const std::string &  baseIdentifier, bool  acceptOverridesReject  )

static

Calculate the "total_result" for a given base identifier by looping through all results with the given base identifier.

The result of the function then depends on the setting of accept overrides reject. Please see the SoftwareTriggerModule description, for more information.

Definition at line 70 of file FinalTriggerDecisionCalculator.cc.

{
  bool hasOneAcceptCut = false;
  bool hasOneRejectCut = false;
 
  for (const auto& resultWithName : result.getResults()) {
    const std::string& cutName = resultWithName.first;
 
    if (not SoftwareTriggerDBHandler::hasBaseIdentifier(cutName, baseIdentifier)) {
      continue;
    }
 
    if (cutName == SoftwareTriggerDBHandler::makeTotalResultName(baseIdentifier)) {
      B2WARNING("The store object already includes a result for this module. Will overwrite it.");
      continue;
    }
 
    const SoftwareTriggerCutResult cutResult = static_cast<SoftwareTriggerCutResult>(resultWithName.second);
 
    if (cutResult == SoftwareTriggerCutResult::c_accept) {
      hasOneAcceptCut = true;
    } else if (cutResult == SoftwareTriggerCutResult::c_reject) {
      hasOneRejectCut = true;
    }
  }
 
  if (acceptOverridesReject) {
    if (hasOneAcceptCut or (not hasOneRejectCut)) {
      return SoftwareTriggerCutResult::c_accept;
    } else {
      return SoftwareTriggerCutResult::c_reject;
    }
  } else {
    if (hasOneAcceptCut and (not hasOneRejectCut)) {
      return SoftwareTriggerCutResult::c_accept;
    } else {
      return SoftwareTriggerCutResult::c_reject;
    }
  }
}

---

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

• hlt/softwaretrigger/core/include/FinalTriggerDecisionCalculator.h
• hlt/softwaretrigger/core/src/FinalTriggerDecisionCalculator.cc