PIDVariables.cc

/**************************************************************************
 * basf2 (Belle II Analysis Software Framework)                           *
 * Author: The Belle II Collaboration                                     *
 *                                                                        *
 * See git log for contributors and copyright holders.                    *
 * This file is licensed under LGPL-3.0, see LICENSE.md.                  *
 **************************************************************************/
 
// Own header.
#include <analysis/variables/PIDVariables.h>
 
#include <analysis/dataobjects/Particle.h>
#include <analysis/utility/ReferenceFrame.h>
#include <mdst/dataobjects/PIDLikelihood.h>
 
// framework aux
#include <framework/logging/Logger.h>
#include <framework/utilities/Conversion.h>
#include <framework/gearbox/Const.h>
 
// database
#include <analysis/utility/PIDCalibrationWeightUtil.h>
#include <analysis/utility/PIDNeuralNetwork.h>
 
#include <boost/algorithm/string.hpp>
 
#include <cmath>
 
using namespace std;
 
namespace Belle2 {
  namespace Variable {
 
    //*************
    // Utilities
    //*************
 
    // converts Belle numbering scheme for charged final state particles
    // to Belle II ChargedStable
    Const::ChargedStable hypothesisConversion(const int hypothesis)
    {
      switch (hypothesis) {
        case 0:
          return Const::electron;
        case 1:
          return Const::muon;
        case 2:
          return Const::pion;
        case 3:
          return Const::kaon;
        case 4:
          return Const::proton;
      }
 
      return Const::pion;
    }
 
 
    Const::PIDDetectorSet parseDetectors(const std::vector<std::string>& arguments)
    {
      Const::PIDDetectorSet result;
      for (std::string val : arguments) {
        boost::to_lower(val);
        if (val == "all") return Const::PIDDetectors::set();
        else if (val == "svd") result += Const::SVD;
        else if (val == "cdc") result += Const::CDC;
        else if (val == "top") result += Const::TOP;
        else if (val == "arich") result += Const::ARICH;
        else if (val == "ecl") result += Const::ECL;
        else if (val == "klm") result += Const::KLM;
        else B2ERROR("Unknown detector component: " << val);
      }
      return result;
    }
 
    // Specialisation of valid detectors parser for ChargedBDT.
    Const::PIDDetectorSet parseDetectorsChargedBDT(const std::vector<std::string>& arguments)
    {
      Const::PIDDetectorSet result;
      for (std::string val : arguments) {
        boost::to_lower(val);
        if (val == "all") return Const::PIDDetectors::set();
        else if (val == "ecl") result += Const::ECL;
        else B2ERROR("Invalid detector component: " << val << " for charged BDT.");
      }
      return result;
    }
 
    //*************
    // Belle II
    //*************
 
    // a "smart" variable:
    // finds the global probability based on the PDG code of the input particle
    double particleID(const Particle* p)
    {
      int pdg = abs(p->getPDGCode());
      if (pdg == Const::electron.getPDGCode())      return electronID(p);
      else if (pdg == Const::muon.getPDGCode())     return muonID(p);
      else if (pdg == Const::pion.getPDGCode())     return pionID(p);
      else if (pdg == Const::kaon.getPDGCode())     return kaonID(p);
      else if (pdg == Const::proton.getPDGCode())   return protonID(p);
      else if (pdg == Const::deuteron.getPDGCode()) return deuteronID(p);
      else return Const::doubleNaN;
    }
 
    bool isPIDAvailable(const Particle* part)
    {
      const auto* pid = part->getPIDLikelihood();
      if (not pid) return false;
      return pid->isAvailable();
    }
 
    Manager::FunctionPtr isPIDAvailableFrom(const std::vector<std::string>& arguments)
    {
      Const::PIDDetectorSet detectorSet = parseDetectors(arguments);
      auto func = [detectorSet](const Particle * part) -> bool {
        const auto* pid = part->getPIDLikelihood();
        if (not pid) return false;
        return pid->isAvailable(detectorSet);
      };
      return func;
    }
 
    Manager::FunctionPtr pidLogLikelihoodValueExpert(const std::vector<std::string>& arguments)
    {
      if (arguments.size() < 2) {
        B2ERROR("Need at least two arguments to pidLogLikelihoodValueExpert");
        return nullptr;
      }
      int pdgCode;
      try {
        pdgCode = Belle2::convertString<int>(arguments[0]);
      } catch (std::invalid_argument& e) {
        B2ERROR("First argument of pidLogLikelihoodValueExpert must be a PDG code");
        return nullptr;
      }
      std::vector<std::string> detectors(arguments.begin() + 1, arguments.end());
 
      Const::PIDDetectorSet detectorSet = parseDetectors(detectors);
      auto hypType = Const::ChargedStable(abs(pdgCode));
 
      auto func = [hypType, detectorSet](const Particle * part) -> double {
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (!pid)
          return Const::doubleNaN;
        // No information from any subdetector in the list
        if (not pid->isAvailable(detectorSet)) return Const::doubleNaN;
 
        return pid->getLogL(hypType, detectorSet);
      };
      return func;
    }
 
 
    Manager::FunctionPtr pidDeltaLogLikelihoodValueExpert(const std::vector<std::string>& arguments)
    {
      if (arguments.size() < 3) {
        B2ERROR("Need at least three arguments to pidDeltaLogLikelihoodValueExpert");
        return nullptr;
      }
      int pdgCodeHyp, pdgCodeTest;
      try {
        pdgCodeHyp = Belle2::convertString<int>(arguments[0]);
      } catch (std::invalid_argument& e) {
        B2ERROR("First argument of pidDeltaLogLikelihoodValueExpert must be a PDG code");
        return nullptr;
      }
      try {
        pdgCodeTest = Belle2::convertString<int>(arguments[1]);
      } catch (std::invalid_argument& e) {
        B2ERROR("Second argument of pidDeltaLogLikelihoodValueExpert must be a PDG code");
        return nullptr;
      }
 
      std::vector<std::string> detectors(arguments.begin() + 2, arguments.end());
      Const::PIDDetectorSet detectorSet = parseDetectors(detectors);
      auto hypType = Const::ChargedStable(abs(pdgCodeHyp));
      auto testType = Const::ChargedStable(abs(pdgCodeTest));
 
      auto func = [hypType, testType, detectorSet](const Particle * part) -> double {
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (!pid) return Const::doubleNaN;
        // No information from any subdetector in the list
        if (not pid->isAvailable(detectorSet)) return Const::doubleNaN;
 
        return pid->getDeltaLogL(hypType, testType, detectorSet);
      };
      return func;
    }
 
 
    Manager::FunctionPtr pidPairProbabilityExpert(const std::vector<std::string>& arguments)
    {
      if (arguments.size() < 3) {
        B2ERROR("Need at least three arguments to pidPairProbabilityExpert");
        return nullptr;
      }
      int pdgCodeHyp = 0, pdgCodeTest = 0;
      try {
        pdgCodeHyp = Belle2::convertString<int>(arguments[0]);
      } catch (std::invalid_argument& e) {
        B2ERROR("First argument of pidPairProbabilityExpert must be PDG code");
        return nullptr;
      }
      try {
        pdgCodeTest = Belle2::convertString<int>(arguments[1]);
      } catch (std::invalid_argument& e) {
        B2ERROR("Second argument of pidPairProbabilityExpert must be PDG code");
        return nullptr;
      }
 
      std::vector<std::string> detectors(arguments.begin() + 2, arguments.end());
 
      Const::PIDDetectorSet detectorSet = parseDetectors(detectors);
      auto hypType = Const::ChargedStable(abs(pdgCodeHyp));
      auto testType = Const::ChargedStable(abs(pdgCodeTest));
      auto func = [hypType, testType, detectorSet](const Particle * part) -> double {
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (!pid) return Const::doubleNaN;
        // No information from any subdetector in the list
        if (not pid->isAvailable(detectorSet)) return Const::doubleNaN;
 
        return pid->getProbability(hypType, testType, detectorSet);
      };
      return func;
    }
 
 
    Manager::FunctionPtr pidProbabilityExpert(const std::vector<std::string>& arguments)
    {
      if (arguments.size() < 2) {
        B2ERROR("Need at least two arguments for pidProbabilityExpert");
        return nullptr;
      }
      int pdgCodeHyp = 0;
      try {
        pdgCodeHyp = Belle2::convertString<int>(arguments[0]);
      } catch (std::invalid_argument& e) {
        B2ERROR("First argument of pidProbabilityExpert must be PDG code");
        return nullptr;
      }
 
      std::vector<std::string> detectors(arguments.begin() + 1, arguments.end());
      Const::PIDDetectorSet detectorSet = parseDetectors(detectors);
      auto hypType = Const::ChargedStable(abs(pdgCodeHyp));
 
      // Placeholder for the priors
      const unsigned int n = Const::ChargedStable::c_SetSize;
      double frac[n];
      for (double& i : frac) i = 1.0;  // flat priors
 
      auto func = [hypType, frac, detectorSet](const Particle * part) -> double {
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (!pid) return Const::doubleNaN;
        // No information from any subdetector in the list
        if (not pid->isAvailable(detectorSet)) return Const::doubleNaN;
 
        return pid->getProbability(hypType, frac, detectorSet);
      };
      return func;
    }
 
 
    Manager::FunctionPtr pidLogarithmicProbabilityExpert(const std::vector<std::string>& arguments)
    {
      if (arguments.size() < 2) {
        B2ERROR("Need at least two arguments for pidLogarithmicProbabilityExpert");
        return nullptr;
      }
      int pdgCodeHyp = 0;
      try {
        pdgCodeHyp = Belle2::convertString<int>(arguments[0]);
      } catch (std::invalid_argument& e) {
        B2ERROR("First argument of pidLogarithmicProbabilityExpert must be PDG code");
        return nullptr;
      }
 
      std::vector<std::string> detectors(arguments.begin() + 1, arguments.end());
      Const::PIDDetectorSet detectorSet = parseDetectors(detectors);
      auto hypType = Const::ChargedStable(abs(pdgCodeHyp));
 
      // Placeholder for the priors
      const unsigned int n = Const::ChargedStable::c_SetSize;
      double frac[n];
      for (double& i : frac) i = 1.0;  // flat priors
 
      auto func = [hypType, frac, detectorSet](const Particle * part) -> double {
        const auto* pid = part->getPIDLikelihood();
        if (not pid) return Const::doubleNaN;
        if (not pid->isAvailable(detectorSet)) return Const::doubleNaN;
        return pid->getLogarithmicProbability(hypType, frac, detectorSet);
      };
      return func;
    }
 
 
    Manager::FunctionPtr pidMissingProbabilityExpert(const std::vector<std::string>& arguments)
    {
      if (arguments.size() < 1) {
        B2ERROR("Need at least one argument to pidMissingProbabilityExpert");
        return nullptr;
      }
 
      std::vector<std::string> detectors(arguments.begin(), arguments.end());
      Const::PIDDetectorSet detectorSet = parseDetectors(detectors);
 
      auto func = [detectorSet](const Particle * part) -> double {
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (!pid) return Const::doubleNaN;
        if (not pid->areAllAvailable(detectorSet)) return 1; // to keep the same behaviour as in previous releases
        else return 0;
      };
      return func;
    }
 
    Manager::FunctionPtr pidWeightedLogLikelihoodValueExpert(const std::vector<std::string>& arguments)
    {
      if (arguments.size() < 3) {
        B2ERROR("Need at least three arguments to pidWeightedLogLikelihoodValueExpert");
        return nullptr;
      }
      std::string matrixName = arguments[0];
 
      int pdgCode;
      try {
        pdgCode = Belle2::convertString<int>(arguments[1]);
      } catch (std::invalid_argument& e) {
        B2ERROR("Second argument of pidWeightedLogLikelihoodValueExpert must be a PDG code");
        return nullptr;
      }
      std::vector<std::string> detectors(arguments.begin() + 2, arguments.end());
      Const::PIDDetectorSet detectorSet = parseDetectors(detectors);
      auto hypType = Const::ChargedStable(abs(pdgCode));
 
      auto func = [hypType, detectorSet, matrixName](const Particle * part) -> double {
        PIDCalibrationWeightUtil weightMatrix(matrixName);
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (!pid)
          return Const::doubleNaN;
        // No information from any subdetector in the list
        if (not pid->isAvailable(detectorSet)) return Const::doubleNaN;
 
        const auto& frame = ReferenceFrame::GetCurrent();
        auto mom = frame.getMomentum(part);
        auto p = mom.P();
        auto theta = mom.Theta();
 
        double LogL = 0;
        for (const Const::EDetector& detector : Const::PIDDetectorSet::set())
        {
          if (detectorSet.contains(detector))
            LogL += pid->getLogL(hypType, detector) * weightMatrix.getWeight(hypType.getPDGCode(), detector, p, theta);
        }
        return LogL;
      };
 
      return func;
    }
 
    Manager::FunctionPtr pidWeightedProbabilityExpert(const std::vector<std::string>& arguments)
    {
      if (arguments.size() < 3) {
        B2ERROR("Need at least three arguments for pidWeightedProbabilityExpert");
        return nullptr;
      }
      std::string matrixName = arguments[0];
 
      int pdgCodeHyp = 0;
      try {
        pdgCodeHyp = Belle2::convertString<int>(arguments[1]);
      } catch (std::invalid_argument& e) {
        B2ERROR("Second argument of pidWeightedProbabilityExpert must be PDG code");
        return nullptr;
      }
 
      std::vector<std::string> detectors(arguments.begin() + 2, arguments.end());
      Const::PIDDetectorSet detectorSet = parseDetectors(detectors);
      auto hypType = Const::ChargedStable(abs(pdgCodeHyp));
 
      auto func = [hypType, detectorSet, matrixName](const Particle * part) -> double {
        PIDCalibrationWeightUtil weightMatrix(matrixName);
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (!pid) return Const::doubleNaN;
        // No information from any subdetector in the list
        if (not pid->isAvailable(detectorSet)) return Const::doubleNaN;
 
        const auto& frame = ReferenceFrame::GetCurrent();
        auto mom = frame.getMomentum(part);
        auto p = mom.P();
        auto theta = mom.Theta();
 
        std::vector<double> LogL(Const::ChargedStable::c_SetSize);
        double LogL_max = 0;
        bool hasMax = false;
        for (const auto& pdgIter : Const::chargedStableSet)
        {
          const int index_pdg = pdgIter.getIndex();
 
          LogL[index_pdg] = 0;
          for (const Const::EDetector& detector : Const::PIDDetectorSet::set()) {
            if (detectorSet.contains(detector))
              LogL[index_pdg] += pid->getLogL(pdgIter, detector) * weightMatrix.getWeight(pdgIter.getPDGCode(), detector, p, theta);
          }
 
          if (!hasMax || (LogL[index_pdg] > LogL_max)) {
            LogL_max = LogL[index_pdg];
            hasMax = true;
          }
        }
 
        double norm = 0;
        for (auto LogL_i : LogL)
          norm += exp(LogL_i - LogL_max);
 
        if (norm > 0)
          return exp(LogL[hypType.getIndex()] - LogL_max) / norm;
        else
          return -1;
      };
      return func;
    }
 
 
    Manager::FunctionPtr pidNeuralNetworkValueExpert(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 0) {
        B2ERROR("Need pdg code for pidNeuralNetworkValueExpert");
        return nullptr;
      }
      if (arguments.size() > 2) {
        B2ERROR("pidNeuralNetworkValueExpert expects at most two arguments, i.e. the pdg code and the pidNeuralNetworkName");
        return nullptr;
      }
      int pdgCode;
      try {
        pdgCode = abs(Belle2::convertString<int>(arguments[0]));
      } catch (std::invalid_argument& e) {
        B2ERROR("First argument of pidNeuralNetworkValueExpert must be a PDG code");
        return nullptr;
      }
 
      std::shared_ptr<PIDNeuralNetwork> neuralNetworkPtr;
      if (arguments.size() == 2) {
        std::string parameterSetName = arguments[1];
        neuralNetworkPtr = std::make_shared<PIDNeuralNetwork>(parameterSetName);
      } else {
        neuralNetworkPtr = std::make_shared<PIDNeuralNetwork>();
      }
 
      neuralNetworkPtr->hasPdgCode(pdgCode, true); // raise exception if pdg code is not predicted
 
      auto func = [neuralNetworkPtr, pdgCode](const Particle * part) -> double {
        const auto& extraInfoName = neuralNetworkPtr->getExtraInfoName(pdgCode);
        if (part->hasExtraInfo(extraInfoName))
          return part->getExtraInfo(extraInfoName);
 
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (not pid) return Const::doubleNaN;
        if (not pid->isAvailable()) return Const::doubleNaN;
 
        // collect only those inputs needed for the neural network in the correct order
        std::vector<float> inputsNN;
        inputsNN.reserve(neuralNetworkPtr->getInputSize());
        for (const auto& inputName : neuralNetworkPtr->getInputBasf2Names())
          inputsNN.push_back(std::get<double>(Variable::Manager::Instance().getVariable(inputName)->function(part)));
 
        const auto probabilities = neuralNetworkPtr->predict(inputsNN);
 
        // store all probabilities for all hypotheses in extraInfo
        for (const auto element : probabilities)
        {
          const auto [pdgCodeElement, probability] = element;
          const_cast<Particle*>(part)->addExtraInfo(neuralNetworkPtr->getExtraInfoName(pdgCodeElement), probability);
        }
 
        return probabilities.at(pdgCode);
      };
 
      return func;
    }
 
 
    Manager::FunctionPtr pidWeightedPairProbabilityExpert(const std::vector<std::string>& arguments)
    {
      if (arguments.size() < 4) {
        B2ERROR("Need at least four arguments to pidWeightedPairProbabilityExpert");
        return nullptr;
      }
      std::string matrixName = arguments[0];
 
      int pdgCodeHyp = 0, pdgCodeTest = 0;
      try {
        pdgCodeHyp = Belle2::convertString<int>(arguments[1]);
      } catch (std::invalid_argument& e) {
        B2ERROR("Second argument of pidWeightedPairProbabilityExpert must be PDG code");
        return nullptr;
      }
      try {
        pdgCodeTest = Belle2::convertString<int>(arguments[2]);
      } catch (std::invalid_argument& e) {
        B2ERROR("Third argument of pidWeightedPairProbabilityExpert must be PDG code");
        return nullptr;
      }
 
      std::vector<std::string> detectors(arguments.begin() + 3, arguments.end());
 
      Const::PIDDetectorSet detectorSet = parseDetectors(detectors);
      auto hypType = Const::ChargedStable(abs(pdgCodeHyp));
      auto testType = Const::ChargedStable(abs(pdgCodeTest));
 
      auto func = [hypType, testType, detectorSet, matrixName](const Particle * part) -> double {
        PIDCalibrationWeightUtil weightMatrix(matrixName);
 
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (!pid) return Const::doubleNaN;
        // No information from any subdetector in the list
        if (not pid->isAvailable(detectorSet)) return Const::doubleNaN;
 
        const auto& frame = ReferenceFrame::GetCurrent();
        auto mom = frame.getMomentum(part);
        auto p = mom.P();
        auto theta = mom.Theta();
 
        double LogL_hypType(0), LogL_testType(0);
        for (const Const::EDetector& detector : Const::PIDDetectorSet::set())
        {
          if (detectorSet.contains(detector)) {
            LogL_hypType += pid->getLogL(hypType, detector) * weightMatrix.getWeight(hypType.getPDGCode(), detector, p, theta);
            LogL_testType += pid->getLogL(testType, detector) * weightMatrix.getWeight(testType.getPDGCode(), detector, p, theta);
          }
        }
 
        double deltaLogL = LogL_testType - LogL_hypType;
        double res;
        if (deltaLogL < 0)
        {
          double eLogL = exp(deltaLogL);
          res = 1. / (1. + eLogL);
        } else
        {
          double eLogL = exp(-deltaLogL);
          res = eLogL / (1.0 + eLogL);
        }
 
        if (std::isfinite(res))
          return res;
 
        return 0;
      };
      return func;
    }
 
    double electronID(const Particle* part)
    {
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"11", "ALL"});
      return std::get<double>(pidFunction(part));
    }
 
    double muonID(const Particle* part)
    {
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"13", "ALL"});
      return std::get<double>(pidFunction(part));
    }
 
    double pionID(const Particle* part)
    {
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"211", "ALL"});
      return std::get<double>(pidFunction(part));
    }
 
    double kaonID(const Particle* part)
    {
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"321", "ALL"});
      return std::get<double>(pidFunction(part));
    }
 
    double protonID(const Particle* part)
    {
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"2212", "ALL"});
      return std::get<double>(pidFunction(part));
    }
 
    double deuteronID(const Particle* part)
    {
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"1000010020", "ALL"});
      return std::get<double>(pidFunction(part));
    }
 
    double binaryPID(const Particle* part, const std::vector<double>& arguments)
    {
      if (arguments.size() != 2) {
        B2ERROR("The variable binaryPID needs exactly two arguments: the PDG codes of two hypotheses.");
        return Const::doubleNaN;;
      }
      int pdgCodeHyp = std::abs(int(std::lround(arguments[0])));
      int pdgCodeTest = std::abs(int(std::lround(arguments[1])));
      return std::get<double>(Manager::Instance().getVariable("pidPairProbabilityExpert(" + std::to_string(
                                                                pdgCodeHyp) + ", " + std::to_string(
                                                                pdgCodeTest) + ", ALL)")->function(part));
    }
 
    double electronID_noSVD(const Particle* part)
    {
      // Excluding SVD for electron ID. This variable is temporary. BII-8760
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"11", "CDC", "TOP", "ARICH", "ECL", "KLM"});
      return std::get<double>(pidFunction(part));
    }
 
    double muonID_noSVD(const Particle* part)
    {
      // Excluding SVD for muon ID. This variable is temporary. BII-8760
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"13", "CDC", "TOP", "ARICH", "ECL", "KLM"});
      return std::get<double>(pidFunction(part));
    }
 
    double pionID_noSVD(const Particle* part)
    {
      // Excluding SVD for pion ID. This variable is temporary. BII-8760
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"211", "CDC", "TOP", "ARICH", "ECL", "KLM"});
      return std::get<double>(pidFunction(part));
    }
 
    double kaonID_noSVD(const Particle* part)
    {
      // Excluding SVD for kaon ID. This variable is temporary. BII-8760
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"321", "CDC", "TOP", "ARICH", "ECL", "KLM"});
      return std::get<double>(pidFunction(part));
    }
 
    double protonID_noSVD(const Particle* part)
    {
      // Excluding SVD for proton ID. This variable is temporary. BII-8760
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"2212", "CDC", "TOP", "ARICH", "ECL", "KLM"});
      return std::get<double>(pidFunction(part));
    }
 
    double deuteronID_noSVD(const Particle* part)
    {
      // Excluding SVD for deuteron ID. This variable is temporary. BII-8760
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"1000010020", "CDC", "TOP", "ARICH", "ECL", "KLM"});
      return std::get<double>(pidFunction(part));
    }
 
    double binaryPID_noSVD(const Particle* part, const std::vector<double>& arguments)
    {
      // Excluding SVD for binary ID. This variable is temporary. BII-8760
      if (arguments.size() != 2) {
        B2ERROR("The variable binaryPID_noSVD needs exactly two arguments: the PDG codes of two hypotheses.");
        return Const::doubleNaN;;
      }
      int pdgCodeHyp = std::abs(int(std::lround(arguments[0])));
      int pdgCodeTest = std::abs(int(std::lround(arguments[1])));
      return std::get<double>(Manager::Instance().getVariable("pidPairProbabilityExpert(" + std::to_string(
                                                                pdgCodeHyp) + ", " + std::to_string(
                                                                pdgCodeTest) + ", CDC, TOP, ARICH, ECL, KLM)")->function(part));
    }
 
    double electronID_noTOP(const Particle* part)
    {
      // Excluding TOP for electron ID. This variable is temporary. BII-8444
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"11", "SVD", "CDC", "ARICH", "ECL", "KLM"});
      return std::get<double>(pidFunction(part));
    }
 
    double binaryElectronID_noTOP(const Particle* part, const std::vector<double>& arguments)
    {
      // Excluding TOP for electron ID. This is temporary. BII-8444
      if (arguments.size() != 1) {
        B2ERROR("The variable binaryElectronID_noTOP needs exactly one argument: the PDG code of the test hypothesis.");
        return Const::doubleNaN;;
      }
 
      int pdgCodeHyp = Const::electron.getPDGCode();
      int pdgCodeTest = std::abs(int(std::lround(arguments[0])));
 
      const auto var = "pidPairProbabilityExpert(" + std::to_string(pdgCodeHyp) + ", " +
                       std::to_string(pdgCodeTest) + ", SVD, CDC, ARICH, ECL, KLM)";
 
      return std::get<double>(Manager::Instance().getVariable(var)->function(part));
    }
 
    double electronID_noSVD_noTOP(const Particle* part)
    {
      // Excluding SVD and TOP for electron ID. This variable is temporary. BII-8444, BII-8760.
      static Manager::FunctionPtr pidFunction =
        pidProbabilityExpert({"11", "CDC", "ARICH", "ECL", "KLM"});
      return std::get<double>(pidFunction(part));
    }
 
    double binaryElectronID_noSVD_noTOP(const Particle* part, const std::vector<double>& arguments)
    {
      // Excluding SVD and TOP for electron ID. This is temporary. BII-8444, BII-8760.
      if (arguments.size() != 1) {
        B2ERROR("The variable binaryElectronID_noSVD_noTOP needs exactly one argument: the PDG code of the test hypothesis.");
        return Const::doubleNaN;;
      }
 
      int pdgCodeHyp = Const::electron.getPDGCode();
      int pdgCodeTest = std::abs(int(std::lround(arguments[0])));
 
      const auto var = "pidPairProbabilityExpert(" + std::to_string(pdgCodeHyp) + ", " +
                       std::to_string(pdgCodeTest) + ", CDC, ARICH, ECL, KLM)";
 
      return std::get<double>(Manager::Instance().getVariable(var)->function(part));
    }
 
 
    double pionID_noARICHwoECL(const Particle* part)
    {
      // remove arich if no ecl cluster + identified as kaon in arich
      const ECLCluster* cluster = part->getECLCluster();
      if (!cluster) {
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (!pid) return Const::doubleNaN;
        if (pid->getDeltaLogL(Const::kaon, Const::pion, Const::ARICH) > 0) {
          static Manager::FunctionPtr pidFunction =
            pidProbabilityExpert({"211", "SVD", "CDC", "TOP", "ECL", "KLM"});
          return std::get<double>(pidFunction(part));
        }
      }
      return pionID(part);
    }
 
 
    double kaonID_noARICHwoECL(const Particle* part)
    {
      // remove arich if no ecl cluster + identified as kaon in arich
      const ECLCluster* cluster = part->getECLCluster();
      if (!cluster) {
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (!pid) return Const::doubleNaN;
        if (pid->getDeltaLogL(Const::kaon, Const::pion, Const::ARICH) > 0) {
          static Manager::FunctionPtr pidFunction =
            pidProbabilityExpert({"321", "SVD", "CDC", "TOP", "ECL", "KLM"});
          return std::get<double>(pidFunction(part));
        }
      }
      return kaonID(part);
    }
 
 
    double binaryPID_noARICHwoECL(const Particle* part, const std::vector<double>& arguments)
    {
      // Excluding ARICH for tracks without ECL cluster and identified as heavier of the two hypotheses from binary ID.
      if (arguments.size() != 2) {
        B2ERROR("The variable binaryPID_noARICHwoECL needs exactly two arguments: the PDG codes of two hypotheses.");
        return Const::doubleNaN;;
      }
      int pdgCodeHyp = std::abs(int(std::lround(arguments[0])));
      int pdgCodeTest = std::abs(int(std::lround(arguments[1])));
      auto hypType = Const::ChargedStable(abs(pdgCodeHyp));
      auto testType = Const::ChargedStable(abs(pdgCodeTest));
 
      const ECLCluster* cluster = part->getECLCluster();
      if (!cluster) {
        const PIDLikelihood* pid = part->getPIDLikelihood();
        if (!pid) return Const::doubleNaN;
        double lkhdiff = pid->getDeltaLogL(hypType, testType, Const::ARICH);
        if ((lkhdiff > 0 && pdgCodeHyp > pdgCodeTest) || (lkhdiff < 0 && pdgCodeHyp < pdgCodeTest)) {
          std::string varName = "pidPairProbabilityExpert(" +
                                std::to_string(pdgCodeHyp) + ", " + std::to_string(pdgCodeTest) + ", SVD, CDC, TOP, ECL, KLM)";
          return std::get<double>(Manager::Instance().getVariable(varName)->function(part));
        }
      }
 
      return binaryPID(part, arguments);
 
    }
 
 
 
    double antineutronID(const Particle* particle)
    {
      if (particle->hasExtraInfo("nbarID")) {
        return particle->getExtraInfo("nbarID");
      } else {
        if (particle->getPDGCode() == -Const::neutron.getPDGCode()) {
          B2WARNING("The extraInfo nbarID is not registered! \n"
                    "Please use function getNbarIDMVA in modularAnalysis.");
        }
        return Const::doubleNaN;
      }
    }
 
    Manager::FunctionPtr pidChargedBDTScore(const std::vector<std::string>& arguments)
    {
      if (arguments.size() != 2) {
        B2ERROR("Need exactly two arguments for pidChargedBDTScore: pdgCodeHyp, detector");
        return nullptr;
      }
 
      int hypPdgId;
      try {
        hypPdgId = Belle2::convertString<int>(arguments.at(0));
      } catch (std::invalid_argument& e) {
        B2ERROR("First argument of pidChargedBDTScore must be an integer (PDG code).");
        return nullptr;
      }
      Const::ChargedStable hypType = Const::ChargedStable(hypPdgId);
 
      std::vector<std::string> detectors(arguments.begin() + 1, arguments.end());
      Const::PIDDetectorSet detectorSet = parseDetectorsChargedBDT(detectors);
 
      auto func = [hypType, detectorSet](const Particle * part) -> double {
        auto name = "pidChargedBDTScore_" + std::to_string(hypType.getPDGCode());
        for (const Const::EDetector& detector : detectorSet)
        {
          name += "_" + std::to_string(detector);
        }
        return (part->hasExtraInfo(name)) ? part->getExtraInfo(name) : Const::doubleNaN;
      };
      return func;
    }
 
    Manager::FunctionPtr pidPairChargedBDTScore(const std::vector<std::string>& arguments)
    {
      if (arguments.size() != 3) {
        B2ERROR("Need exactly three arguments for pidPairChargedBDTScore: pdgCodeHyp, pdgCodeTest, detector.");
        return nullptr;
      }
 
      int hypPdgId, testPdgId;
      try {
        hypPdgId = Belle2::convertString<int>(arguments.at(0));
      } catch (std::invalid_argument& e) {
        B2ERROR("First argument of pidPairChargedBDTScore must be an integer (PDG code).");
        return nullptr;
      }
      try {
        testPdgId = Belle2::convertString<int>(arguments.at(1));
      } catch (std::invalid_argument& e) {
        B2ERROR("First argument of pidPairChargedBDTScore must be an integer (PDG code).");
        return nullptr;
      }
      Const::ChargedStable hypType = Const::ChargedStable(hypPdgId);
      Const::ChargedStable testType = Const::ChargedStable(testPdgId);
 
      std::vector<std::string> detectors(arguments.begin() + 2, arguments.end());
      Const::PIDDetectorSet detectorSet = parseDetectorsChargedBDT(detectors);
 
      auto func = [hypType, testType, detectorSet](const Particle * part) -> double {
        auto name = "pidPairChargedBDTScore_" + std::to_string(hypType.getPDGCode()) + "_VS_" + std::to_string(testType.getPDGCode());
        for (const Const::EDetector& detector : detectorSet)
        {
          name += "_" + std::to_string(detector);
        }
        return (part->hasExtraInfo(name)) ? part->getExtraInfo(name) : Const::doubleNaN;
      };
      return func;
    }
 
    double mostLikelyPDG(const Particle* part, const std::vector<double>& arguments)
    {
      if (arguments.size() != 0 and arguments.size() != Const::ChargedStable::c_SetSize) {
        B2ERROR("Need zero or exactly " << Const::ChargedStable::c_SetSize << " arguments for pidMostLikelyPDG");
        return Const::doubleNaN;
      }
      double prob[Const::ChargedStable::c_SetSize];
      if (arguments.size() == 0) {
        for (unsigned int i = 0; i < Const::ChargedStable::c_SetSize; i++) prob[i] = 1. / Const::ChargedStable::c_SetSize;
      } else {
        copy(arguments.begin(), arguments.end(), prob);
      }
 
      auto* pid = part->getPIDLikelihood();
      if (!pid) return Const::doubleNaN;
      return pid->getMostLikely(prob).getPDGCode();
    }
 
    bool isMostLikely(const Particle* part, const std::vector<double>& arguments)
    {
      if (arguments.size() != 0 and arguments.size() != Const::ChargedStable::c_SetSize) {
        B2ERROR("Need zero or exactly " << Const::ChargedStable::c_SetSize << " arguments for pidIsMostLikely");
        return false;
      }
      return mostLikelyPDG(part, arguments) == abs(part->getPDGCode());
    }
 
    Manager::FunctionPtr weightedElectronID(const std::vector<std::string>& arguments)
    {
      std::string varName;
      if (arguments.size() == 0) {
        varName = "pidWeightedProbabilityExpert(PIDCalibrationWeightMatrix, 11, ALL)";
      } else if (arguments.size() == 1) {
        varName = "pidWeightedProbabilityExpert(" + arguments[0] + ", 11, ALL)";
      } else {
        B2ERROR("Need zero or one argument for weightedElectronID");
        return nullptr;
      }
 
      const Variable::Manager::Var* var = Manager::Instance().getVariable(varName);
      auto func = [var](const Particle * particle) -> double {
        return std::get<double>(var->function(particle));
      };
      return func;
    };
 
    Manager::FunctionPtr weightedMuonID(const std::vector<std::string>& arguments)
    {
      std::string varName;
      if (arguments.size() == 0) {
        varName = "pidWeightedProbabilityExpert(PIDCalibrationWeightMatrix, 13, ALL)";
      } else if (arguments.size() == 1) {
        varName = "pidWeightedProbabilityExpert(" + arguments[0] + ", 13, ALL)";
      } else {
        B2ERROR("Need zero or one argument for weightedMuonID");
        return nullptr;
      }
 
      const Variable::Manager::Var* var = Manager::Instance().getVariable(varName);
      auto func = [var](const Particle * particle) -> double {
        return std::get<double>(var->function(particle));
      };
      return func;
    };
 
    Manager::FunctionPtr weightedPionID(const std::vector<std::string>& arguments)
    {
      std::string varName;
      if (arguments.size() == 0) {
        varName = "pidWeightedProbabilityExpert(PIDCalibrationWeightMatrix, 211, ALL)";
      } else if (arguments.size() == 1) {
        varName = "pidWeightedProbabilityExpert(" + arguments[0] + ", 211, ALL)";
      } else {
        B2ERROR("Need zero or one argument for weightedPionID");
        return nullptr;
      }
 
      const Variable::Manager::Var* var = Manager::Instance().getVariable(varName);
      auto func = [var](const Particle * particle) -> double {
        return std::get<double>(var->function(particle));
      };
      return func;
    };
 
    Manager::FunctionPtr weightedKaonID(const std::vector<std::string>& arguments)
    {
      std::string varName;
      if (arguments.size() == 0) {
        varName = "pidWeightedProbabilityExpert(PIDCalibrationWeightMatrix, 321, ALL)";
      } else if (arguments.size() == 1) {
        varName = "pidWeightedProbabilityExpert(" + arguments[0] + ", 321, ALL)";
      } else {
        B2ERROR("Need zero or one argument for weightedKaonID");
        return nullptr;
      }
 
      const Variable::Manager::Var* var = Manager::Instance().getVariable(varName);
      auto func = [var](const Particle * particle) -> double {
        return std::get<double>(var->function(particle));
      };
      return func;
    };
 
    Manager::FunctionPtr weightedProtonID(const std::vector<std::string>& arguments)
    {
      std::string varName;
      if (arguments.size() == 0) {
        varName = "pidWeightedProbabilityExpert(PIDCalibrationWeightMatrix, 2212, ALL)";
      } else if (arguments.size() == 1) {
        varName = "pidWeightedProbabilityExpert(" + arguments[0] + ", 2212, ALL)";
      } else {
        B2ERROR("Need zero or one argument for weightedProtonID");
        return nullptr;
      }
 
      const Variable::Manager::Var* var = Manager::Instance().getVariable(varName);
      auto func = [var](const Particle * particle) -> double {
        return std::get<double>(var->function(particle));
      };
      return func;
    };
 
    Manager::FunctionPtr weightedDeuteronID(const std::vector<std::string>& arguments)
    {
      std::string varName;
      if (arguments.size() == 0) {
        varName = "pidWeightedProbabilityExpert(PIDCalibrationWeightMatrix, 1000010020, ALL)";
      } else if (arguments.size() == 1) {
        varName = "pidWeightedProbabilityExpert(" + arguments[0] + ", 1000010020, ALL)";
      } else {
        B2ERROR("Need zero or one argument for weightedDeuteronID");
        return nullptr;
      }
 
      const Variable::Manager::Var* var = Manager::Instance().getVariable(varName);
      auto func = [var](const Particle * particle) -> double {
        return std::get<double>(var->function(particle));
      };
      return func;
    };
 
 
    double electronIDNN(const Particle* particle)
    {
      if (particle->hasExtraInfo("pidNeuralNetworkValueExpert(11)"))
        return particle->getExtraInfo("pidNeuralNetworkValueExpert(11)");
      static auto func = pidNeuralNetworkValueExpert({"11"});
      return std::get<double>(func(particle));
    }
 
    double muonIDNN(const Particle* particle)
    {
      if (particle->hasExtraInfo("pidNeuralNetworkValueExpert(13)"))
        return particle->getExtraInfo("pidNeuralNetworkValueExpert(13)");
      static auto func = pidNeuralNetworkValueExpert({"13"});
      return std::get<double>(func(particle));
    }
 
    double pionIDNN(const Particle* particle)
    {
      if (particle->hasExtraInfo("pidNeuralNetworkValueExpert(211)"))
        return particle->getExtraInfo("pidNeuralNetworkValueExpert(211)");
      static auto func = pidNeuralNetworkValueExpert({"211"});
      return std::get<double>(func(particle));
    }
 
    double kaonIDNN(const Particle* particle)
    {
      if (particle->hasExtraInfo("pidNeuralNetworkValueExpert(321)"))
        return particle->getExtraInfo("pidNeuralNetworkValueExpert(321)");
      static auto func = pidNeuralNetworkValueExpert({"321"});
      return std::get<double>(func(particle));
    }
 
    double protonIDNN(const Particle* particle)
    {
      if (particle->hasExtraInfo("pidNeuralNetworkValueExpert(2212)"))
        return particle->getExtraInfo("pidNeuralNetworkValueExpert(2212)");
      static auto func = pidNeuralNetworkValueExpert({"2212"});
      return std::get<double>(func(particle));
    }
 
    double deuteronIDNN(const Particle* particle)
    {
      if (particle->hasExtraInfo("pidNeuralNetworkValueExpert(1000010020)"))
        return particle->getExtraInfo("pidNeuralNetworkValueExpert(1000010020)");
      static auto func = pidNeuralNetworkValueExpert({"1000010020"});
      return std::get<double>(func(particle));
    }
 
 
    double klmMuonIDDNN(const Particle* part)
    {
      const PIDLikelihood* pid = part->getPIDLikelihood();
      if (!pid) return Const::doubleNaN;
      double klmMuonIDDNNvalue = pid->getPreOfficialLikelihood("klmMuonIDDNN");
      // klmMuonIDDNNvalue == -1.0 means there is no valid output from KLMMuonIDDNNExpertModule
      if (klmMuonIDDNNvalue < 0.0) return Const::doubleNaN;
      return klmMuonIDDNNvalue;
    }
 
    //*************
    // B2BII
    //*************
 
    double muIDBelle(const Particle* particle)
    {
      const PIDLikelihood* pid = particle->getPIDLikelihood();
      if (!pid) return 0.5; // Belle standard
 
      if (pid->isAvailable(Const::KLM))
        return exp(pid->getLogL(Const::muon, Const::KLM));
      else
        return 0; // Belle standard
    }
 
    double muIDBelleQuality(const Particle* particle)
    {
      const PIDLikelihood* pid = particle->getPIDLikelihood();
      if (!pid) return 0;// Belle standard
 
      return pid->isAvailable(Const::KLM);
    }
 
    double atcPIDBelle(const Particle* particle,  const std::vector<double>& sigAndBkgHyp)
    {
      int sigHyp = int(std::lround(sigAndBkgHyp[0]));
      int bkgHyp = int(std::lround(sigAndBkgHyp[1]));
 
      const PIDLikelihood* pid = particle->getPIDLikelihood();
      if (!pid) return 0.5; // Belle standard
 
      // ACC = ARICH
      Const::PIDDetectorSet set = Const::ARICH;
      double acc_sig = exp(pid->getLogL(hypothesisConversion(sigHyp), set));
      double acc_bkg = exp(pid->getLogL(hypothesisConversion(bkgHyp), set));
      double acc = 0.5; // Belle standard
      if (acc_sig + acc_bkg  > 0.0)
        acc = acc_sig / (acc_sig + acc_bkg);
 
      // TOF = TOP
      set = Const::TOP;
      double tof_sig = exp(pid->getLogL(hypothesisConversion(sigHyp), set));
      double tof_bkg = exp(pid->getLogL(hypothesisConversion(bkgHyp), set));
      double tof = 0.5; // Belle standard
      double tof_all = tof_sig + tof_bkg;
      if (tof_all != 0) {
        tof = tof_sig / tof_all;
        if (tof < 0.001) tof = 0.001;
        if (tof > 0.999) tof = 0.999;
      }
 
      // dE/dx = CDC
      set = Const::CDC;
      double cdc_sig = exp(pid->getLogL(hypothesisConversion(sigHyp), set));
      double cdc_bkg = exp(pid->getLogL(hypothesisConversion(bkgHyp), set));
      double cdc = 0.5; // Belle standard
      double cdc_all = cdc_sig + cdc_bkg;
      if (cdc_all != 0) {
        cdc = cdc_sig / cdc_all;
        if (cdc < 0.001) cdc = 0.001;
        if (cdc > 0.999) cdc = 0.999;
      }
 
      // Combined
      double pid_sig = acc * tof * cdc;
      double pid_bkg = (1. - acc) * (1. - tof) * (1. - cdc);
 
      return pid_sig / (pid_sig + pid_bkg);
    }
 
 
    double eIDBelle(const Particle* part)
    {
      const PIDLikelihood* pid = part->getPIDLikelihood();
      if (!pid) return 0.5; // Belle standard
 
      Const::PIDDetectorSet set = Const::ECL;
      return pid->getProbability(Const::electron, Const::pion, set);
    }
 
 
    // PID variables to be used for analysis
    VARIABLE_GROUP("PID");
    REGISTER_VARIABLE("particleID", particleID,
                      "the particle identification probability under the particle's own hypothesis, using info from all available detectors");
    REGISTER_VARIABLE("isPIDAvailable", isPIDAvailable,
                      "True if PID is available (for at least one of the PID detectors");
    REGISTER_METAVARIABLE("isPIDAvailableFrom(detectorList)", isPIDAvailableFrom,
                          "True if PID is available for at least one of the detectors in the list)",
                          Manager::VariableDataType::c_bool);
    REGISTER_VARIABLE("electronID", electronID,
                      "electron identification probability defined as :math:`\\mathcal{L}_e/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors");
    REGISTER_VARIABLE("muonID", muonID,
                      "muon identification probability defined as :math:`\\mathcal{L}_\\mu/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors");
    REGISTER_VARIABLE("pionID", pionID,
                      "pion identification probability defined as :math:`\\mathcal{L}_\\pi/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors");
    REGISTER_VARIABLE("kaonID", kaonID,
                      "kaon identification probability defined as :math:`\\mathcal{L}_K/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors");
    REGISTER_VARIABLE("protonID", protonID,
                      "proton identification probability defined as :math:`\\mathcal{L}_p/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors");
    REGISTER_VARIABLE("deuteronID", deuteronID,
                      "deuteron identification probability defined as :math:`\\mathcal{L}_d/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors");
    REGISTER_METAVARIABLE("binaryPID(pdgCode1, pdgCode2)", binaryPID,
                          "Returns the binary probability for the first provided mass hypothesis with respect to the second mass hypothesis using all detector components",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pidChargedBDTScore(pdgCodeHyp, detector)", pidChargedBDTScore,
                          "Returns the charged Pid BDT score for a certain mass hypothesis with respect to all other charged stable particle hypotheses. The second argument specifies which BDT training to use: based on 'ALL' PID detectors (NB: 'SVD' is currently excluded), or 'ECL' only. The choice depends on the ChargedPidMVAMulticlassModule's configuration.",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pidPairChargedBDTScore(pdgCodeHyp, pdgCodeTest, detector)", pidPairChargedBDTScore,
                          "Returns the charged Pid BDT score for a certain mass hypothesis with respect to an alternative hypothesis. The second argument specifies which BDT training to use: based on 'ALL' PID detectors (NB: 'SVD' is currently excluded), or 'ECL' only. The choice depends on the ChargedPidMVAModule's configuration.",
                          Manager::VariableDataType::c_double);
    REGISTER_VARIABLE("nbarID", antineutronID, R"DOC(
Returns MVA classifier for antineutron PID.
 
- 1  signal(antineutron) like
- 0  background like
- -1 invalid using this PID due to some ECL variables used unavailable
 
This PID is only for antineutron. Neutron is also considered as background.
The variables used are `clusterPulseShapeDiscriminationMVA`, `clusterE`, `clusterLAT`, `clusterE1E9`, `clusterE9E21`,
`clusterAbsZernikeMoment40`, `clusterAbsZernikeMoment51`, `clusterZernikeMVA`.)DOC");
 
    // Special temporary variables defined for users' convenience.
    REGISTER_VARIABLE("electronID_noSVD", electronID_noSVD,
                      "**(SPECIAL (TEMP) variable)** electron identification probability defined as :math:`\\mathcal{L}_e/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors *excluding the SVD*");
    REGISTER_VARIABLE("muonID_noSVD", muonID_noSVD,
                      "**(SPECIAL (TEMP) variable)** muon identification probability defined as :math:`\\mathcal{L}_\\mu/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors *excluding the SVD*");
    REGISTER_VARIABLE("pionID_noSVD", pionID_noSVD,
                      "**(SPECIAL (TEMP) variable)** pion identification probability defined as :math:`\\mathcal{L}_\\pi/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors *excluding the SVD*");
    REGISTER_VARIABLE("kaonID_noSVD", kaonID_noSVD,
                      "**(SPECIAL (TEMP) variable)** kaon identification probability defined as :math:`\\mathcal{L}_K/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors *excluding the SVD*");
    REGISTER_VARIABLE("protonID_noSVD", protonID_noSVD,
                      "**(SPECIAL (TEMP) variable)** proton identification probability defined as :math:`\\mathcal{L}_p/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors *excluding the SVD*");
    REGISTER_VARIABLE("deuteronID_noSVD", deuteronID_noSVD,
                      "**(SPECIAL (TEMP) variable)** deuteron identification probability defined as :math:`\\mathcal{L}_d/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors *excluding the SVD*");
    REGISTER_METAVARIABLE("binaryPID_noSVD(pdgCode1, pdgCode2)", binaryPID_noSVD,
                          "Returns the binary probability for the first provided mass hypothesis with respect to the second mass hypothesis using all detector components, *excluding the SVD*.",
                          Manager::VariableDataType::c_double);
    REGISTER_VARIABLE("electronID_noTOP", electronID_noTOP,
                      "**(SPECIAL (TEMP) variable)** electron identification probability defined as :math:`\\mathcal{L}_e/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors *excluding the TOP*. *NB:* this variable must be used in place of `electronID` when analysing data (MC) processed (simulated) in *release 6*");
    REGISTER_METAVARIABLE("binaryElectronID_noTOP(pdgCodeTest)", binaryElectronID_noTOP,
                          "**(SPECIAL (TEMP) variable)** Returns the binary probability for the electron mass hypothesis with respect to another mass hypothesis using all detector components, *excluding the TOP*. *NB:* this variable must be used in place of `binaryPID` (``pdgCode1=11``) when analysing data (MC) processed (simulated) in **release 6**",
                          Manager::VariableDataType::c_double);
    REGISTER_VARIABLE("electronID_noSVD_noTOP", electronID_noSVD_noTOP,
                      "**(SPECIAL (TEMP) variable)** electron identification probability defined as :math:`\\mathcal{L}_e/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors *excluding the SVD and the TOP*. *NB:* this variable must be used in place of `electronID` when analysing data (MC) processed (simulated) in *release 5*");
    REGISTER_METAVARIABLE("binaryElectronID_noSVD_noTOP(pdgCodeTest)", binaryElectronID_noSVD_noTOP,
                          "**(SPECIAL (TEMP) variable)** Returns the binary probability for the electron mass hypothesis with respect to another mass hypothesis using all detector components, *excluding the SVD and the TOP*. *NB:* this variable must be used in place of `binaryPID` (``pdgCode1=11``) when analysing data (MC) processed (simulated) in **release 5**",
                          Manager::VariableDataType::c_double);
    REGISTER_VARIABLE("pionID_noARICHwoECL", pionID_noARICHwoECL,
                      "**(SPECIAL (TEMP) variable)** pion identification probability defined as :math:`\\mathcal{L}_\\pi/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors but ARICH info excluded for tracks without associated ECL cluster");
    REGISTER_VARIABLE("kaonID_noARICHwoECL", kaonID_noARICHwoECL,
                      "**(SPECIAL (TEMP) variable)** kaon identification probability defined as :math:`\\mathcal{L}_K/(\\mathcal{L}_e+\\mathcal{L}_\\mu+\\mathcal{L}_\\pi+\\mathcal{L}_K+\\mathcal{L}_p+\\mathcal{L}_d)`, using info from all available detectors but ARICH info excluded for tracks without associated ECL cluster");
    REGISTER_METAVARIABLE("binaryPID_noARICHwoECL(pdgCode1, pdgCode2)", binaryPID_noARICHwoECL,
                          "Returns the binary probability for the first provided mass hypothesis with respect to the second mass hypothesis using all detector components, but ARICH info excluded for tracks without associated ECL cluster",
                          Manager::VariableDataType::c_double);
 
 
    REGISTER_METAVARIABLE("weightedElectronID(weightMatrixName)", weightedElectronID,
                          R"DOC(
weighted electron identification probability defined as :math:`\frac{\mathcal{\tilde{L}}_e}{\sum_{i=e,\mu,\pi,K,p,d} \mathcal{\tilde{L}}_i}`,
where :math:`\mathcal{\tilde{L}}_i` is defined as :math:`\log\mathcal{\tilde{L}}_i = \sum_{j={\mathrm{SVD, CDC, TOP, ARICH, ECL, KLM}}} \mathcal{w}_{ij}\log\mathcal{L}_{ij}`.
The :math:`\mathcal{L}_{ij}` is the original likelihood and :math:`\mathcal{w}_{ij}` is the PID calibration weight of i-th particle type and j-th detector.
One can provide the name of the weight matrix as the argument.
)DOC",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("weightedMuonID(weightMatrixName)", weightedMuonID,
        R"DOC(
weighted muon identification probability defined as :math:`\frac{\mathcal{\tilde{L}}_\mu}{\sum_{i=e,\mu,\pi,K,p,d} \mathcal{\tilde{L}}_i}`,
where :math:`\mathcal{\tilde{L}}_i` is defined as :math:`\log\mathcal{\tilde{L}}_i = \sum_{j={\mathrm{SVD, CDC, TOP, ARICH, ECL, KLM}}} \mathcal{w}_{ij}\log\mathcal{L}_{ij}`.
The :math:`\mathcal{L}_{ij}` is the original likelihood and :math:`\mathcal{w}_{ij}` is the PID calibration weight of i-th particle type and j-th detector.
One can provide the name of the weight matrix as the argument.
)DOC",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("weightedPionID(weightMatrixName)", weightedPionID,
        R"DOC(
weighted pion identification probability defined as :math:`\frac{\mathcal{\tilde{L}}_\pi}{\sum_{i=e,\mu,\pi,K,p,d} \mathcal{\tilde{L}}_i}`,
where :math:`\mathcal{\tilde{L}}_i` is defined as :math:`\log\mathcal{\tilde{L}}_i = \sum_{j={\mathrm{SVD, CDC, TOP, ARICH, ECL, KLM}}} \mathcal{w}_{ij}\log\mathcal{L}_{ij}`.
The :math:`\mathcal{L}_{ij}` is the original likelihood and :math:`\mathcal{w}_{ij}` is the PID calibration weight of i-th particle type and j-th detector.
One can provide the name of the weight matrix as the argument.
)DOC",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("weightedKaonID(weightMatrixName)", weightedKaonID,
        R"DOC(
weighted kaon identification probability defined as :math:`\frac{\mathcal{\tilde{L}}_K}{\sum_{i=e,\mu,\pi,K,p,d} \mathcal{\tilde{L}}_i}`,
where :math:`\mathcal{\tilde{L}}_i` is defined as :math:`\log\mathcal{\tilde{L}}_i = \sum_{j={\mathrm{SVD, CDC, TOP, ARICH, ECL, KLM}}} \mathcal{w}_{ij}\log\mathcal{L}_{ij}`.
The :math:`\mathcal{L}_{ij}` is the original likelihood and :math:`\mathcal{w}_{ij}` is the PID calibration weight of i-th particle type and j-th detector.
One can provide the name of the weight matrix as the argument.
)DOC",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("weightedProtonID(weightMatrixName)", weightedProtonID,
        R"DOC(
weighted proton identification probability defined as :math:`\frac{\mathcal{\tilde{L}}_p}{\sum_{i=e,\mu,\pi,K,p,d} \mathcal{\tilde{L}}_i}`,
where :math:`\mathcal{\tilde{L}}_i` is defined as :math:`\log\mathcal{\tilde{L}}_i = \sum_{j={\mathrm{SVD, CDC, TOP, ARICH, ECL, KLM}}} \mathcal{w}_{ij}\log\mathcal{L}_{ij}`.
The :math:`\mathcal{L}_{ij}` is the original likelihood and :math:`\mathcal{w}_{ij}` is the PID calibration weight of i-th particle type and j-th detector.
One can provide the name of the weight matrix as the argument.
)DOC",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("weightedDeuteronID(weightMatrixName)", weightedDeuteronID,
        R"DOC(
weighted deuteron identification probability defined as :math:`\frac{\mathcal{\tilde{L}}_d}{\sum_{i=e,\mu,\pi,K,p,d} \mathcal{\tilde{L}}_i}`,
where :math:`\mathcal{\tilde{L}}_i` is defined as :math:`\log\mathcal{\tilde{L}}_i = \sum_{j={\mathrm{SVD, CDC, TOP, ARICH, ECL, KLM}}} \mathcal{w}_{ij}\log\mathcal{L}_{ij}`.
The :math:`\mathcal{L}_{ij}` is the original likelihood and :math:`\mathcal{w}_{ij}` is the PID calibration weight of i-th particle type and j-th detector.
One can provide the name of the weight matrix as the argument.
)DOC",
                          Manager::VariableDataType::c_double);
 
 
    REGISTER_VARIABLE("electronIDNN", electronIDNN,
        R"DOC(
electron identification probability as calculated from the PID neural network.
Requires global tag 'pid_nn_<release>' with the correct data <release>.
)DOC");
    REGISTER_VARIABLE("muonIDNN", muonIDNN,
        R"DOC(
muon identification probability as calculated from the PID neural network.
Requires global tag 'pid_nn_<release>' with the correct data <release>.
)DOC");
    REGISTER_VARIABLE("pionIDNN", pionIDNN,
        R"DOC(
pion identification probability as calculated from the PID neural network.
Requires global tag 'pid_nn_<release>' with the correct data <release>.
)DOC");
    REGISTER_VARIABLE("kaonIDNN", kaonIDNN,
        R"DOC(
kaon identification probability as calculated from the PID neural network.
Requires global tag 'pid_nn_<release>' with the correct data <release>.
)DOC");
    REGISTER_VARIABLE("protonIDNN", protonIDNN,
        R"DOC(
proton identification probability as calculated from the PID neural network.
Requires global tag 'pid_nn_<release>' with the correct data <release>.
)DOC");
    REGISTER_VARIABLE("deuteronIDNN", deuteronIDNN,
        R"DOC(
deuteron identification probability as calculated from the PID neural network.
Requires global tag 'pid_nn_<release>' with the correct data <release>.
)DOC");
 
 
    // Metafunctions for experts to access the basic PID quantities
    VARIABLE_GROUP("PID_expert");
    REGISTER_METAVARIABLE("pidLogLikelihoodValueExpert(pdgCode, detectorList)", pidLogLikelihoodValueExpert,
                          "returns the log likelihood value of for a specific mass hypothesis and  set of detectors.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pidDeltaLogLikelihoodValueExpert(pdgCode1, pdgCode2, detectorList)", pidDeltaLogLikelihoodValueExpert,
                          "returns LogL(hyp1) - LogL(hyp2) (aka DLL) for two mass hypotheses and a set of detectors.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pidPairProbabilityExpert(pdgCodeHyp, pdgCodeTest, detectorList)", pidPairProbabilityExpert,
                          "Pair (or binary) probability for the pdgCodeHyp mass hypothesis respect to the pdgCodeTest one, using an arbitrary set of detectors. :math:`\\mathcal{L}_{hyp}/(\\mathcal{L}_{test}+\\mathcal{L}_{hyp})`",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pidProbabilityExpert(pdgCodeHyp, detectorList)", pidProbabilityExpert,
                          "probability for the pdgCodeHyp mass hypothesis respect to all the other ones, using an arbitrary set of detectors :math:`\\mathcal{L}_{hyp}/(\\Sigma_{\\text{all~hyp}}\\mathcal{L}_{i})`. ",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pidLogarithmicProbabilityExpert(pdgCodeHyp, detectorList)", pidLogarithmicProbabilityExpert,
        "logarithmic equivalent of pidProbability (p) defined as log(p/(1-p)), which gives a smooth peak-like distribution",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pidMissingProbabilityExpert(detectorList)", pidMissingProbabilityExpert,
                          "returns 1 if PID is missing for at least one of the detectors in the list, otherwise 0. ",
        Manager::VariableDataType::c_double);
    REGISTER_VARIABLE("pidMostLikelyPDG(ePrior=1/6, muPrior=1/6, piPrior=1/6, KPrior=1/6, pPrior=1/6, dPrior=1/6)", mostLikelyPDG,
                      R"DOC(
Returns PDG code of the largest PID likelihood, or NaN if PID information is not available.
This function accepts either no arguments, or 6 floats as priors for the charged particle hypotheses
following the order shown in the metavariable's declaration. Flat priors are assumed as default.)DOC");
    REGISTER_VARIABLE("pidIsMostLikely(ePrior=1/6, muPrior=1/6, piPrior=1/6, KPrior=1/6, pPrior=1/6, dPrior=1/6)", isMostLikely, R"DOC(
Returns True if the largest PID likelihood of a given particle corresponds to its particle hypothesis.
This function accepts either no arguments, or 6 floats as priors for the charged particle hypotheses
following the order shown in the metavariable's declaration. Flat priors are assumed as default.)DOC");
 
    REGISTER_METAVARIABLE("pidWeightedLogLikelihoodValueExpert(weightMatrixName, pdgCode, detectorList)",
                          pidWeightedLogLikelihoodValueExpert,
                          "returns the weighted log likelihood value of for a specific mass hypothesis and set of detectors, "
                          ":math:`\\log\\mathcal{\\tilde{L}}_{hyp} = \\sum_{j\\in\\mathrm{detectorList}} \\mathcal{w}_{hyp,j}\\log\\mathcal{L}_{hyp,j}`. "
                          "The :math:`\\mathcal{L}_{ij}` is the original likelihood and :math:`\\mathcal{w}_{ij}` is the PID calibration weight of i-th particle type and j-th detector.",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pidWeightedPairProbabilityExpert(weightMatrixName, pdgCodeHyp, pdgCodeTest, detectorList)",
                          pidWeightedPairProbabilityExpert,
                          "Weighted pair (or binary) probability for the pdgCodeHyp mass hypothesis with respect to the pdgCodeTest one, using an arbitrary set of detectors, "
                          ":math:`\\mathcal{\\tilde{L}}_{hyp}/(\\mathcal{\\tilde{L}}_{test}+\\mathcal{\\tilde{L}}_{hyp})` where :math:`\\mathcal{\\tilde{L}}_{i}` is defined as "
                          ":math:`\\log\\mathcal{\\tilde{L}}_{i} = \\sum_{j\\in\\mathrm{detectorList}} \\mathcal{w}_{i,j}\\log\\mathcal{L}_{i,j}`. "
                          "The :math:`\\mathcal{L}_{ij}` is the original likelihood and :math:`\\mathcal{w}_{ij}` is the PID calibration weight of i-th particle type and j-th detector.",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pidWeightedProbabilityExpert(weightMatrixName, pdgCodeHyp, detectorList)",
                          pidWeightedProbabilityExpert,
                          "Weighted probability for the pdgCodeHyp mass hypothesis with respect to all the other ones, using an arbitrary set of detectors, "
                          ":math:`\\mathcal{\\tilde{L}}_{hyp}/\\sum_{i=e,\\mu,\\pi,K,p,d} \\mathcal{\\tilde{L}}_i` where :math:`\\mathcal{\\tilde{L}}_{i}` is defined as "
                          ":math:`\\log\\mathcal{\\tilde{L}}_{i} = \\sum_{j\\in\\mathrm{detectorList}} \\mathcal{w}_{i,j}\\log\\mathcal{L}_{i,j}`. "
                          "The :math:`\\mathcal{L}_{ij}` is the original likelihood and :math:`\\mathcal{w}_{ij}` is the PID calibration weight of i-th particle type and j-th detector.",
                          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pidNeuralNetworkValueExpert(pdgCodeHyp, PIDNeuralNetworkName)",
                          pidNeuralNetworkValueExpert,
                          "Probability for the particle hypothesis pdgCodeHype calculated from a neural network, which uses high-level information as inputs,  "
                          "such as the likelihood from the 6 subdetectors for PID for all 6 hypotheses, "
                          ":math:`\\mathcal{\\tilde{L}}_{hyp}^{det}`, or the track momentum and charge",
                          Manager::VariableDataType::c_double);
    REGISTER_VARIABLE("klmMuonIDDNN", klmMuonIDDNN,
                      "Muon probability calculated from Neural Network with KLM information (expert use only)");
 
    // B2BII PID
    VARIABLE_GROUP("Belle PID variables");
    REGISTER_METAVARIABLE("atcPIDBelle(i,j)", atcPIDBelle, R"DOC(
[Legacy] Returns Belle's PID atc variable: ``atc_pid(3,1,5,i,j).prob()``.
Parameters i,j are signal and background hypothesis: (0 = electron, 1 = muon, 2 = pion, 3 = kaon, 4 = proton)
Returns 0.5 in case there is no likelihood found and a factor of 0.5 will appear in the product if any of the subdetectors don't report a likelihood (Belle behaviour).
 
.. warning:: The behaviour is different from Belle II PID variables which typically return NaN in case of error.
    )DOC", Manager::VariableDataType::c_double);
    REGISTER_VARIABLE("muIDBelle", muIDBelle, R"DOC(
[Legacy] Returns Belle's PID ``Muon_likelihood()`` variable.
Returns 0.5 in case there is no likelihood found and returns zero if the muon likelihood is not usable (Belle behaviour).
 
.. warning:: The behaviour is different from Belle II PID variables which typically return NaN in case of error.
    )DOC");
    REGISTER_VARIABLE("muIDBelleQuality", muIDBelleQuality, R"DOC(
[Legacy] Returns true if Belle's PID ``Muon_likelihood()`` is usable (reliable).
Returns zero/false if not usable or if there is no PID found.
    )DOC");
    REGISTER_VARIABLE("eIDBelle", eIDBelle, R"DOC(
[Legacy] Returns Belle's electron ID ``eid(3,-1,5).prob()`` variable.
Returns 0.5 in case there is no likelihood found (Belle behaviour).
 
.. warning:: The behaviour is different from Belle II PID variables which typically return NaN in case of error.
    )DOC");
  }
}