MetaVariables.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/MetaVariables.h>
#include <analysis/variables/MCTruthVariables.h>
 
#include <analysis/VariableManager/Utility.h>
#include <analysis/dataobjects/Particle.h>
#include <analysis/dataobjects/ParticleList.h>
#include <analysis/dataobjects/EventKinematics.h>
#include <analysis/utility/PCmsLabTransform.h>
#include <analysis/utility/ReferenceFrame.h>
#include <analysis/utility/EvtPDLUtil.h>
#include <analysis/utility/ParticleCopy.h>
#include <analysis/utility/ValueIndexPairSorting.h>
#include <analysis/ClusterUtility/ClusterUtils.h>
#include <analysis/variables/VariableFormulaConstructor.h>
 
#include <framework/logging/Logger.h>
#include <framework/datastore/StoreArray.h>
#include <framework/datastore/StoreObjPtr.h>
#include <framework/dataobjects/EventExtraInfo.h>
#include <framework/utilities/Conversion.h>
#include <framework/utilities/MakeROOTCompatible.h>
#include <framework/gearbox/Const.h>
 
#include <mdst/dataobjects/Track.h>
#include <mdst/dataobjects/MCParticle.h>
#include <mdst/dataobjects/ECLCluster.h>
#include <mdst/dataobjects/TrackFitResult.h>
 
#include <boost/algorithm/string.hpp>
#include <limits>
 
#include <cmath>
#include <stdexcept>
#include <regex>
#include <unordered_set>
 
#include <TDatabasePDG.h>
#include <Math/Vector4D.h>
#include <Math/VectorUtil.h>
 
namespace Belle2 {
  namespace Variable {
    double requireDoubleForFrameVariable(const Variable::Manager::Var* var,
                                         const Variable::Manager::VarVariant& value,
                                         const std::string& frameFunction)
    {
      if (std::holds_alternative<double>(value)) {
        return std::get<double>(value);
      }
 
      const char* returnedType = std::holds_alternative<int>(value) ? "int" : "bool";
      B2ERROR("Meta function " << frameFunction << " expects a double variable, but '" << var->name
              << "' returned " << returnedType << ". Returning NaN.");
      return Const::doubleNaN;
    }
 
    Manager::FunctionPtr useRestFrame(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          UseReferenceFrame<RestFrame> frame(particle);
          return requireDoubleForFrameVariable(var, var->function(particle), "useRestFrame");
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function useRestFrame");
      }
    }
 
    Manager::FunctionPtr useCMSFrame(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          UseReferenceFrame<CMSFrame> frame;
          return requireDoubleForFrameVariable(var, var->function(particle), "useCMSFrame");
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function useCMSFrame");
      }
    }
 
    Manager::FunctionPtr useLabFrame(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          UseReferenceFrame<LabFrame> frame;
          return requireDoubleForFrameVariable(var, var->function(particle), "useLabFrame");
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function useLabFrame");
      }
    }
 
    Manager::FunctionPtr useTagSideRecoilRestFrame(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto daughterFunction = convertToDaughterIndex({arguments[1]});
        auto func = [var, daughterFunction](const Particle * particle) -> double {
          int daughterIndexTagB = std::get<int>(daughterFunction(particle));
          if (daughterIndexTagB < 0)
            return Const::doubleNaN;
 
          if (particle->getPDGCode() != 300553)
          {
            B2ERROR("Variable should only be used on a Upsilon(4S) Particle List!");
            return Const::doubleNaN;
          }
 
          PCmsLabTransform T;
          ROOT::Math::PxPyPzEVector pSigB = T.getBeamFourMomentum() - particle->getDaughter(daughterIndexTagB)->get4Vector();
          Particle tmp(pSigB, -particle->getDaughter(daughterIndexTagB)->getPDGCode());
 
          UseReferenceFrame<RestFrame> frame(&tmp);
          return requireDoubleForFrameVariable(var, var->function(particle), "useTagSideRecoilRestFrame");
        };
 
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function useTagSideRecoilRestFrame");
      }
    }
 
    Manager::FunctionPtr useParticleRestFrame(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        std::string listName = arguments[1];
        auto func = [var, listName](const Particle * particle) -> double {
          StoreObjPtr<ParticleList> list(listName);
          unsigned listSize = list->getListSize();
          if (listSize == 0)
            return Const::doubleNaN;
          if (listSize > 1)
            B2WARNING("The selected ParticleList contains more than 1 Particles in this event. The variable useParticleRestFrame will use only the first candidate, and the result may not be the expected one."
                      << LogVar("ParticleList", listName)
                      << LogVar("Number of candidates in the list", listSize));
          const Particle* p = list->getParticle(0);
          UseReferenceFrame<RestFrame> frame(p);
          return requireDoubleForFrameVariable(var, var->function(particle), "useParticleRestFrame");
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function useParticleRestFrame.");
      }
    }
 
    Manager::FunctionPtr useRecoilParticleRestFrame(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        std::string listName = arguments[1];
        auto func = [var, listName](const Particle * particle) -> double {
          StoreObjPtr<ParticleList> list(listName);
          unsigned listSize = list->getListSize();
          if (listSize == 0)
            return Const::doubleNaN;
          if (listSize > 1)
            B2WARNING("The selected ParticleList contains more than 1 Particles in this event. The variable useParticleRestFrame will use only the first candidate, and the result may not be the expected one."
                      << LogVar("ParticleList", listName)
                      << LogVar("Number of candidates in the list", listSize));
          const Particle* p = list->getParticle(0);
          PCmsLabTransform T;
          ROOT::Math::PxPyPzEVector recoil = T.getBeamFourMomentum() - p->get4Vector();
          /* Let's use 0 as PDG code to avoid wrong assumptions. */
          Particle pRecoil(recoil, 0);
          pRecoil.setVertex(particle->getVertex());
          UseReferenceFrame<RestFrame> frame(&pRecoil);
          return requireDoubleForFrameVariable(var, var->function(particle), "useRecoilParticleRestFrame");
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function useParticleRestFrame.");
      }
    }
 
    Manager::FunctionPtr useDaughterRestFrame(const std::vector<std::string>& arguments)
    {
      if (arguments.size() >= 2) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var, arguments](const Particle * particle) -> double {
 
          // Sum of the 4-momenta of all the selected daughters
          ROOT::Math::PxPyPzEVector pSum(0, 0, 0, 0);
 
          for (unsigned int i = 1; i < arguments.size(); i++)
          {
            auto generalizedIndex = arguments[i];
            const Particle* dauPart = particle->getParticleFromGeneralizedIndexString(generalizedIndex);
            if (dauPart)
              pSum +=  dauPart->get4Vector();
            else
              return Const::doubleNaN;
          }
          Particle tmp(pSum, 0);
          UseReferenceFrame<RestFrame> frame(&tmp);
          return requireDoubleForFrameVariable(var, var->function(particle), "useDaughterRestFrame");
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function useDaughterRestFrame.");
      }
    }
 
    Manager::FunctionPtr useDaughterRecoilRestFrame(const std::vector<std::string>& arguments)
    {
      if (arguments.size() >= 2) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var, arguments](const Particle * particle) -> double {
 
          // Sum of the 4-momenta of all the selected daughters
          ROOT::Math::PxPyPzEVector pSum(0, 0, 0, 0);
 
          for (unsigned int i = 1; i < arguments.size(); i++)
          {
            auto generalizedIndex = arguments[i];
            const Particle* dauPart = particle->getParticleFromGeneralizedIndexString(generalizedIndex);
            if (dauPart)
              pSum +=  dauPart->get4Vector();
            else
              return Const::doubleNaN;
          }
          PCmsLabTransform T;
          ROOT::Math::PxPyPzEVector recoil = T.getBeamFourMomentum() - pSum;
          /* Let's use 0 as PDG code to avoid wrong assumptions. */
          Particle pRecoil(recoil, 0);
          UseReferenceFrame<RestFrame> frame(&pRecoil);
          return requireDoubleForFrameVariable(var, var->function(particle), "useDaughterRecoilRestFrame");
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function useDaughterRecoilRestFrame.");
      }
    }
 
    Manager::FunctionPtr useMCancestorBRestFrame(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          int index = ancestorBIndex(particle);
          if (index < 0) return Const::doubleNaN;
          StoreArray<MCParticle> mcparticles;
          Particle temp(mcparticles[index]);
          UseReferenceFrame<RestFrame> frame(&temp);
          return requireDoubleForFrameVariable(var, var->function(particle), "useMCancestorBRestFrame");
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function useMCancestorBRestFrame.");
      }
    }
 
    Manager::FunctionPtr extraInfo(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        auto extraInfoName = arguments[0];
        auto func = [extraInfoName](const Particle * particle) -> double {
          if (particle == nullptr)
          {
            B2WARNING("Returns NaN because the particle is nullptr! If you want EventExtraInfo variables, please use eventExtraInfo() instead");
            return Const::doubleNaN;
          }
          if (particle->hasExtraInfo(extraInfoName))
          {
            return particle->getExtraInfo(extraInfoName);
          } else
          {
            return Const::doubleNaN;
          }
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function extraInfo");
      }
    }
 
    Manager::FunctionPtr eventExtraInfo(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        auto extraInfoName = arguments[0];
        auto func = [extraInfoName](const Particle*) -> double {
          StoreObjPtr<EventExtraInfo> eventExtraInfo;
          if (not eventExtraInfo.isValid())
            return Const::doubleNaN;
          if (eventExtraInfo->hasExtraInfo(extraInfoName))
          {
            return eventExtraInfo->getExtraInfo(extraInfoName);
          } else
          {
            return Const::doubleNaN;
          }
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function extraInfo");
      }
    }
 
    Manager::FunctionPtr eventCached(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        std::string key = std::string("__") + MakeROOTCompatible::makeROOTCompatible(var->name);
        auto func = [var, key](const Particle*) -> double {
 
          StoreObjPtr<EventExtraInfo> eventExtraInfo;
          if (not eventExtraInfo.isValid())
            eventExtraInfo.create();
          if (eventExtraInfo->hasExtraInfo(key))
          {
            return eventExtraInfo->getExtraInfo(key);
          } else
          {
            double value = Const::doubleNaN;
            auto var_result = var->function(nullptr);
            if (std::holds_alternative<double>(var_result)) {
              value = std::get<double>(var_result);
            } else if (std::holds_alternative<int>(var_result)) {
              return std::get<int>(var_result);
            } else if (std::holds_alternative<bool>(var_result)) {
              return std::get<bool>(var_result);
            }
            eventExtraInfo->addExtraInfo(key, value);
            return value;
          }
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function eventCached");
      }
    }
 
    Manager::FunctionPtr particleCached(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        std::string key = std::string("__") + MakeROOTCompatible::makeROOTCompatible(var->name);
        auto func = [var, key](const Particle * particle) -> double {
 
          if (particle->hasExtraInfo(key))
          {
            return particle->getExtraInfo(key);
          } else
          {
            double value = std::get<double>(var->function(particle));
            // Remove constness from Particle pointer.
            // The extra-info is used as a cache in our case,
            // indicated by the double-underscore in front of the key.
            // One could implement the cache as a separate property of the particle object
            // and mark it as mutable, however, this would only lead to code duplication
            // and an increased size of the particle object.
            // Thus, we decided to use the extra-info field and cast away the const in this case.
            const_cast<Particle*>(particle)->addExtraInfo(key, value);
            return value;
          }
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function particleCached");
      }
    }
 
    // Formula of other variables, going to require a space between all operators and operations.
    // Later can add some check for : (colon) trailing + or - to distinguish between particle lists
    // and operations, but for now cbf.
    Manager::FunctionPtr formula(const std::vector<std::string>& arguments)
    {
      if (arguments.size() != 1) B2FATAL("Wrong number of arguments for meta function formula");
      FormulaParser<VariableFormulaConstructor> parser;
      try {
        return parser.parse(arguments[0]);
      } catch (std::runtime_error& e) {
        B2FATAL(e.what());
      }
    }
 
    Manager::FunctionPtr nCleanedTracks(const std::vector<std::string>& arguments)
    {
      if (arguments.size() <= 1) {
 
        std::string cutString;
        if (arguments.size() == 1)
          cutString = arguments[0];
        std::shared_ptr<Variable::Cut> cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(cutString));
        auto func = [cut](const Particle*) -> int {
 
          int number_of_tracks = 0;
          StoreArray<Track> tracks;
          for (const auto& track : tracks)
          {
            const TrackFitResult* trackFit = track.getTrackFitResultWithClosestMass(Const::pion);
            if (!trackFit) continue;
            if (trackFit->getChargeSign() == 0) {
              // Ignore track
            } else {
              Particle particle(&track, Const::pion);
              if (cut->check(&particle))
                number_of_tracks++;
            }
          }
 
          return number_of_tracks;
 
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function nCleanedTracks");
      }
    }
 
    Manager::FunctionPtr nCleanedECLClusters(const std::vector<std::string>& arguments)
    {
      if (arguments.size() <= 1) {
 
        std::string cutString;
        if (arguments.size() == 1)
          cutString = arguments[0];
        std::shared_ptr<Variable::Cut> cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(cutString));
        auto func = [cut](const Particle*) -> int {
 
          int number_of_clusters = 0;
          StoreArray<ECLCluster> clusters;
          for (const auto& cluster : clusters)
          {
            // look only at momentum of N1 (n photons) ECLClusters
            if (!cluster.hasHypothesis(ECLCluster::EHypothesisBit::c_nPhotons))
              continue;
 
            Particle particle(&cluster);
            if (cut->check(&particle))
              number_of_clusters++;
          }
 
          return number_of_clusters;
 
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function nCleanedECLClusters");
      }
    }
 
    Manager::FunctionPtr passesCut(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string cutString = arguments[0];
        std::shared_ptr<Variable::Cut> cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(cutString));
        auto func = [cut](const Particle * particle) -> bool {
          if (cut->check(particle))
            return 1;
          else
            return 0;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function passesCut");
      }
    }
 
    Manager::FunctionPtr passesEventCut(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string cutString = arguments[0];
        std::shared_ptr<Variable::Cut> cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(cutString));
        auto func = [cut](const Particle*) -> bool {
          if (cut->check(nullptr))
            return 1;
          else
            return 0;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function passesEventCut");
      }
    }
 
    Manager::FunctionPtr varFor(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        int pdgCode = 0;
        try {
          pdgCode = convertString<int>(arguments[0]);
        } catch (std::invalid_argument&) {
          B2FATAL("The first argument of varFor meta function must be a positive integer!");
        }
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
        auto func = [pdgCode, var](const Particle * particle) -> double {
          if (std::abs(particle->getPDGCode()) == std::abs(pdgCode))
          {
            auto var_result = var->function(particle);
            if (std::holds_alternative<double>(var_result)) {
              return std::get<double>(var_result);
            } else if (std::holds_alternative<int>(var_result)) {
              return std::get<int>(var_result);
            } else if (std::holds_alternative<bool>(var_result)) {
              return std::get<bool>(var_result);
            } else return Const::doubleNaN;
          } else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function varFor");
      }
    }
 
    Manager::FunctionPtr varForMCGen(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          if (particle->getMCParticle())
          {
            if (particle->getMCParticle()->getStatus(MCParticle::c_PrimaryParticle)
                && (! particle->getMCParticle()->getStatus(MCParticle::c_IsVirtual))
                && (! particle->getMCParticle()->getStatus(MCParticle::c_Initial))) {
              auto var_result = var->function(particle);
              if (std::holds_alternative<double>(var_result)) {
                return std::get<double>(var_result);
              } else if (std::holds_alternative<int>(var_result)) {
                return std::get<int>(var_result);
              } else if (std::holds_alternative<bool>(var_result)) {
                return std::get<bool>(var_result);
              } else return Const::doubleNaN;
            } else return Const::doubleNaN;
          } else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function varForMCGen");
      }
    }
 
    Manager::FunctionPtr nParticlesInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string listName = arguments[0];
        auto func = [listName](const Particle * particle) -> int {
 
          (void) particle;
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid Listname " << listName << " given to nParticlesInList");
 
          return listOfParticles->getListSize();
 
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function nParticlesInList");
      }
    }
 
    Manager::FunctionPtr nParticlesInCone(const std::vector<std::string>& arguments)
    {
      if (arguments.size() != 2 && arguments.size() != 3) {
        B2FATAL("nParticlesInCone requires a particle list, a cone half-angle in degrees, "
                "and optionally a particle cut");
      }
 
      const std::string listName = arguments[0];
 
      double angleDegrees = 0.;
      try {
        angleDegrees = Belle2::convertString<double>(arguments[1]);
      } catch (const std::exception&) {
        B2FATAL("Invalid cone half-angle: " << arguments[1]);
      }
      if (!std::isfinite(angleDegrees) || angleDegrees < 0. || angleDegrees > 180.) {
        B2FATAL("The cone half-angle must be between 0 and 180 degrees");
      }
      const double cosineThreshold = std::cos(angleDegrees * std::acos(-1.) / 180.);
 
      std::shared_ptr<Variable::Cut> cut;
      if (arguments.size() == 3 && !arguments[2].empty()) {
        cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(arguments[2]));
      }
 
      return [listName, cosineThreshold, cut](const Particle * particle) -> double {
        StoreObjPtr<ParticleList> particles(listName);
        if (!particles.isValid())
        {
          B2FATAL("Invalid particle list in nParticlesInCone: " << listName);
        }
 
        const auto isSupported = [](const Particle * candidate)
        {
          if (!candidate) return false;
          const auto source = candidate->getParticleSource();
          return source == Particle::c_Track ||
          source == Particle::c_ECLCluster ||
          source == Particle::c_KLMCluster;
        };
 
        if (!isSupported(particle)) return Const::doubleNaN;
 
        const auto labToCms = PCmsLabTransform().rotateLabToCms();
        const auto central = labToCms * particle->get4Vector();
        const double cx = central.Px();
        const double cy = central.Py();
        const double cz = central.Pz();
        const double c2 = cx * cx + cy * cy + cz * cz;
        if (!std::isfinite(c2) || c2 <= 0.) return Const::doubleNaN;
 
        const int ownSource = particle->getMdstSource();
        std::unordered_set<int> countedSources;
        int count = 0;
 
        for (unsigned i = 0; i < particles->getListSize(); ++i)
        {
          const Particle* other = particles->getParticle(i);
          if (!isSupported(other)) continue;
 
          const int source = other->getMdstSource();
          if (source == ownSource || countedSources.count(source)) continue;
          if (cut && !cut->check(other)) continue;
 
          const auto momentum = labToCms * other->get4Vector();
          const double px = momentum.Px();
          const double py = momentum.Py();
          const double pz = momentum.Pz();
          const double p2 = px * px + py * py + pz * pz;
          if (!std::isfinite(p2) || p2 <= 0.) continue;
 
          double cosine = (cx * px + cy * py + cz * pz) / std::sqrt(c2 * p2);
          if (cosine > 1.) cosine = 1.;
          if (cosine < -1.) cosine = -1.;
 
          if (cosine >= cosineThreshold && countedSources.insert(source).second) {
            ++count;
          }
        }
        return count;
      };
    }
 
    Manager::FunctionPtr isInList(const std::vector<std::string>& arguments)
    {
      // unpack arguments, there should be only one: the name of the list we're checking
      if (arguments.size() != 1) {
        B2FATAL("Wrong number of arguments for isInList");
      }
      auto listName = arguments[0];
 
      auto func = [listName](const Particle * particle) -> bool {
 
        // check the list exists
        StoreObjPtr<ParticleList> list(listName);
        if (!(list.isValid()))
        {
          B2FATAL("Invalid Listname " << listName << " given to isInList");
        }
 
        // is the particle in the list?
        return list->contains(particle);
 
      };
      return func;
    }
 
    Manager::FunctionPtr sourceObjectIsInList(const std::vector<std::string>& arguments)
    {
      // unpack arguments, there should be only one: the name of the list we're checking
      if (arguments.size() != 1) {
        B2FATAL("Wrong number of arguments for sourceObjectIsInList");
      }
      auto listName = arguments[0];
 
      auto func = [listName](const Particle * particle) -> int {
 
        // check the list exists
        StoreObjPtr<ParticleList> list(listName);
        if (!(list.isValid()))
        {
          B2FATAL("Invalid Listname " << listName << " given to sourceObjectIsInList");
        }
 
        // this only makes sense for particles that are *not* composite and come
        // from some mdst object (tracks, clusters..)
        Particle::EParticleSourceObject particlesource = particle->getParticleSource();
        if (particlesource == Particle::EParticleSourceObject::c_Composite
            or particlesource == Particle::EParticleSourceObject::c_Undefined)
          return -1;
 
        // it *is* possible to have a particle list from different sources (like
        // hadrons from the ECL and KLM) so we have to check each particle in
        // the list individually
        for (unsigned i = 0; i < list->getListSize(); ++i)
        {
          const Particle* iparticle = list->getParticle(i);
          if (particle->getMdstSource() == iparticle->getMdstSource())
            return 1;
        }
        return 0;
 
      };
      return func;
    }
 
    Manager::FunctionPtr mcParticleIsInMCList(const std::vector<std::string>& arguments)
    {
      // unpack arguments, there should be only one: the name of the list we're checking
      if (arguments.size() != 1) {
        B2FATAL("Wrong number of arguments for mcParticleIsInMCList");
      }
      auto listName = arguments[0];
 
      auto func = [listName](const Particle * particle) -> bool {
 
        // check the list exists
        StoreObjPtr<ParticleList> list(listName);
        if (!(list.isValid()))
          B2FATAL("Invalid Listname " << listName << " given to mcParticleIsInMCList");
 
        // this can only be true for mc-matched particles or particles are created from MCParticles
        const MCParticle* mcp = particle->getMCParticle();
        if (mcp == nullptr) return false;
 
        // check every particle in the input list is not matched to (or created from) the same MCParticle
        for (unsigned i = 0; i < list->getListSize(); ++i)
        {
          const MCParticle* imcp = list->getParticle(i)->getMCParticle();
          if ((imcp != nullptr) and (mcp->getArrayIndex() == imcp->getArrayIndex()))
            return true;
        }
        return false;
      };
      return func;
    }
 
    Manager::FunctionPtr isDaughterOfList(const std::vector<std::string>& arguments)
    {
      B2WARNING("isDaughterOfList is outdated and replaced by isDescendantOfList.");
      std::vector<std::string> new_arguments = arguments;
      new_arguments.push_back(std::string("1"));
      return isDescendantOfList(new_arguments);
    }
 
    Manager::FunctionPtr isGrandDaughterOfList(const std::vector<std::string>& arguments)
    {
      B2WARNING("isGrandDaughterOfList is outdated and replaced by isDescendantOfList.");
      std::vector<std::string> new_arguments = arguments;
      new_arguments.push_back(std::string("2"));
      return isDescendantOfList(new_arguments);
    }
 
    Manager::FunctionPtr isDescendantOfList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() > 0) {
        auto listNames = arguments;
        auto func = [listNames](const Particle * particle) -> bool {
          bool output = false;
          int generation_flag = -1;
          try
          {
            generation_flag = convertString<int>(listNames.back());
          } catch (const std::exception& e) {}
 
          for (const auto& iListName : listNames)
          {
            try {
              convertString<int>(iListName);
              continue;
            } catch (const std::exception& e) {}
 
            // Creating recursive lambda
            auto list_comparison  = [](auto&& self, const Particle * m, const Particle * p, int flag)-> bool {
              bool result = false;
              for (unsigned i = 0; i < m->getNDaughters(); ++i)
              {
                const Particle* daughter = m->getDaughter(i);
                if ((flag == 1.) or (flag < 0)) {
                  if (p->isCopyOf(daughter)) {
                    return true;
                  }
                }
 
                if (flag != 1.) {
                  if (daughter->getNDaughters() > 0) {
                    result = self(self, daughter, p, flag - 1);
                    if (result == 1) {
                      return true;
                    }
                  }
                }
              }
              return result;
            };
 
            StoreObjPtr<ParticleList> listOfParticles(iListName);
 
            if (!(listOfParticles.isValid())) B2FATAL("Invalid Listname " << iListName << " given to isDescendantOfList");
 
            for (unsigned i = 0; i < listOfParticles->getListSize(); ++i) {
              Particle* iParticle = listOfParticles->getParticle(i);
              output = list_comparison(list_comparison, iParticle, particle, generation_flag);
              if (output) {
                return output;
              }
            }
          }
          return output;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function isDescendantOfList");
      }
    }
 
    Manager::FunctionPtr isMCDescendantOfList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() > 0) {
        auto listNames = arguments;
        auto func = [listNames](const Particle * particle) -> bool {
          bool output = false;
          int generation_flag = -1;
          try
          {
            generation_flag = convertString<int>(listNames.back());
          } catch (const std::exception& e) {}
 
          if (particle->getMCParticle() == nullptr)
          {
            return false;
          }
 
          for (const auto& iListName : listNames)
          {
            try {
              // only used to test whether the name is a number
              // cppcheck-suppress ignoredReturnValue
              std::stod(iListName);
              continue;
            } catch (const std::exception& e) {}
            // Creating recursive lambda
            auto list_comparison  = [](auto&& self, const Particle * m, const Particle * p, int flag)-> bool {
              bool result = false;
              for (unsigned i = 0; i < m->getNDaughters(); ++i)
              {
                const Particle* daughter = m->getDaughter(i);
                if ((flag == 1.) or (flag < 0)) {
                  if (daughter->getMCParticle() != nullptr) {
                    if (p->getMCParticle()->getArrayIndex() == daughter->getMCParticle()->getArrayIndex()) {
                      return true;
                    }
                  }
                }
                if (flag != 1.) {
                  if (daughter->getNDaughters() > 0) {
                    result = self(self, daughter, p, flag - 1);
                    if (result) {
                      return true;
                    }
                  }
                }
              }
              return result;
            };
 
            StoreObjPtr<ParticleList> listOfParticles(iListName);
 
            if (!(listOfParticles.isValid())) B2FATAL("Invalid Listname " << iListName << " given to isMCDescendantOfList");
 
            for (unsigned i = 0; i < listOfParticles->getListSize(); ++i) {
              Particle* iParticle = listOfParticles->getParticle(i);
              output = list_comparison(list_comparison, iParticle, particle, generation_flag);
              if (output) {
                return output;
              }
            }
          }
          return output;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function isMCDescendantOfList");
      }
    }
 
    Manager::FunctionPtr daughterProductOf(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          double product = 1.0;
          if (particle->getNDaughters() == 0)
          {
            return Const::doubleNaN;
          }
          if (std::holds_alternative<double>(var->function(particle->getDaughter(0))))
          {
            for (unsigned j = 0; j < particle->getNDaughters(); ++j) {
              product *= std::get<double>(var->function(particle->getDaughter(j)));
            }
          } else if (std::holds_alternative<int>(var->function(particle->getDaughter(0))))
          {
            for (unsigned j = 0; j < particle->getNDaughters(); ++j) {
              product *= std::get<int>(var->function(particle->getDaughter(j)));
            }
          } else return Const::doubleNaN;
          return product;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughterProductOf");
      }
    }
 
    Manager::FunctionPtr daughterSumOf(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          double sum = 0.0;
          if (particle->getNDaughters() == 0)
          {
            return Const::doubleNaN;
          }
          if (std::holds_alternative<double>(var->function(particle->getDaughter(0))))
          {
            for (unsigned j = 0; j < particle->getNDaughters(); ++j) {
              sum += std::get<double>(var->function(particle->getDaughter(j)));
            }
          } else if (std::holds_alternative<int>(var->function(particle->getDaughter(0))))
          {
            for (unsigned j = 0; j < particle->getNDaughters(); ++j) {
              sum += std::get<int>(var->function(particle->getDaughter(j)));
            }
          } else return Const::doubleNaN;
          return sum;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughterSumOf");
      }
    }
 
    Manager::FunctionPtr daughterLowest(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          double min = Const::doubleNaN;
          if (particle->getNDaughters() == 0)
          {
            return Const::doubleNaN;
          }
          if (std::holds_alternative<double>(var->function(particle->getDaughter(0))))
          {
            for (unsigned j = 0; j < particle->getNDaughters(); ++j) {
              double iValue = std::get<double>(var->function(particle->getDaughter(j)));
              if (std::isnan(iValue)) continue;
              if (std::isnan(min)) min = iValue;
              if (iValue < min) min = iValue;
            }
          } else if (std::holds_alternative<int>(var->function(particle->getDaughter(0))))
          {
            for (unsigned j = 0; j < particle->getNDaughters(); ++j) {
              int iValue = std::get<int>(var->function(particle->getDaughter(j)));
              if (std::isnan(min)) min = iValue;
              if (iValue < min) min = iValue;
            }
          }
          return min;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughterLowest");
      }
    }
 
    Manager::FunctionPtr daughterHighest(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          double max = Const::doubleNaN;
          if (particle->getNDaughters() == 0)
          {
            return Const::doubleNaN;
          }
          if (std::holds_alternative<double>(var->function(particle->getDaughter(0))))
          {
            for (unsigned j = 0; j < particle->getNDaughters(); ++j) {
              double iValue = std::get<double>(var->function(particle->getDaughter(j)));
              if (std::isnan(iValue)) continue;
              if (std::isnan(max)) max = iValue;
              if (iValue > max) max = iValue;
            }
          } else if (std::holds_alternative<int>(var->function(particle->getDaughter(0))))
          {
            for (unsigned j = 0; j < particle->getNDaughters(); ++j) {
              int iValue = std::get<int>(var->function(particle->getDaughter(j)));
              if (std::isnan(max)) max = iValue;
              if (iValue > max) max = iValue;
            }
          }
          return max;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughterHighest");
      }
    }
 
    Manager::FunctionPtr daughterDiffOf(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 3) {
        auto func = [arguments](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
          const Particle* dau_i = particle->getParticleFromGeneralizedIndexString(arguments[0]);
          const Particle* dau_j = particle->getParticleFromGeneralizedIndexString(arguments[1]);
          auto variablename = arguments[2];
          if (dau_i == nullptr || dau_j == nullptr)
          {
            B2ERROR("One of the first two arguments doesn't specify a valid (grand-)daughter!");
            return Const::doubleNaN;
          }
          const Variable::Manager::Var* var = Manager::Instance().getVariable(variablename);
          auto result_j = var->function(dau_j);
          auto result_i = var->function(dau_i);
          double diff = Const::doubleNaN;
          if (std::holds_alternative<double>(result_j) && std::holds_alternative<double>(result_i))
          {
            diff = std::get<double>(result_j) - std::get<double>(result_i);
          } else if (std::holds_alternative<int>(result_j) && std::holds_alternative<int>(result_i))
          {
            diff = std::get<int>(result_j) - std::get<int>(result_i);
          } else
          {
            throw std::runtime_error("Bad variant access");
          }
          if (variablename == "phi" or variablename == "clusterPhi" or std::regex_match(variablename, std::regex("use.*Frame\\(phi\\)"))
              or std::regex_match(variablename, std::regex("use.*Frame\\(clusterPhi\\)")))
          {
            if (fabs(diff) > M_PI) {
              if (diff > M_PI) {
                diff = diff - 2 * M_PI;
              } else {
                diff = 2 * M_PI + diff;
              }
            }
          }
          return diff;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughterDiffOf");
      }
    }
 
    Manager::FunctionPtr mcDaughterDiffOf(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 3) {
        auto func = [arguments](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
          const Particle* dau_i = particle->getParticleFromGeneralizedIndexString(arguments[0]);
          const Particle* dau_j = particle->getParticleFromGeneralizedIndexString(arguments[1]);
          auto variablename = arguments[2];
          if (dau_i == nullptr || dau_j == nullptr)
          {
            B2ERROR("One of the first two arguments doesn't specify a valid (grand-)daughter!");
            return Const::doubleNaN;
          }
          const MCParticle* iMcDaughter = dau_i->getMCParticle();
          const MCParticle* jMcDaughter = dau_j->getMCParticle();
          if (iMcDaughter == nullptr || jMcDaughter == nullptr)
            return Const::doubleNaN;
          Particle iTmpPart(iMcDaughter);
          Particle jTmpPart(jMcDaughter);
          const Variable::Manager::Var* var = Manager::Instance().getVariable(variablename);
          auto result_j = var->function(&jTmpPart);
          auto result_i = var->function(&iTmpPart);
          double diff = Const::doubleNaN;
          if (std::holds_alternative<double>(result_j) && std::holds_alternative<double>(result_i))
          {
            diff = std::get<double>(result_j) - std::get<double>(result_i);
          } else if (std::holds_alternative<int>(result_j) && std::holds_alternative<int>(result_i))
          {
            diff = std::get<int>(result_j) - std::get<int>(result_i);
          } else
          {
            throw std::runtime_error("Bad variant access");
          }
          if (variablename == "phi" or std::regex_match(variablename, std::regex("use.*Frame\\(phi\\)")))
          {
            if (fabs(diff) > M_PI) {
              if (diff > M_PI) {
                diff = diff - 2 * M_PI;
              } else {
                diff = 2 * M_PI + diff;
              }
            }
          }
          return diff;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function mcDaughterDiffOf");
      }
    }
 
    Manager::FunctionPtr grandDaughterDiffOf(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 5) {
        try {
          convertString<int>(arguments[0]);
          convertString<int>(arguments[1]);
          convertString<int>(arguments[2]);
          convertString<int>(arguments[3]);
        } catch (std::invalid_argument&) {
          B2FATAL("First four arguments of grandDaughterDiffOf meta function must be integers!");
        }
        std::vector<std::string> new_arguments;
        new_arguments.push_back(std::string(arguments[0] + ":" + arguments[2]));
        new_arguments.push_back(std::string(arguments[1] + ":" + arguments[3]));
        new_arguments.push_back(arguments[4]);
        return daughterDiffOf(new_arguments);
      } else {
        B2FATAL("Wrong number of arguments for meta function grandDaughterDiffOf");
      }
    }
 
    Manager::FunctionPtr daughterNormDiffOf(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 3) {
        auto func = [arguments](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
          const Particle* dau_i = particle->getParticleFromGeneralizedIndexString(arguments[0]);
          const Particle* dau_j = particle->getParticleFromGeneralizedIndexString(arguments[1]);
          if (!(dau_i && dau_j))
          {
            B2ERROR("One of the first two arguments doesn't specify a valid (grand-)daughter!");
            return Const::doubleNaN;
          }
          const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[2]);
          double iValue, jValue;
          if (std::holds_alternative<double>(var->function(dau_j)))
          {
            iValue = std::get<double>(var->function(dau_i));
            jValue = std::get<double>(var->function(dau_j));
          } else if (std::holds_alternative<int>(var->function(dau_j)))
          {
            iValue = std::get<int>(var->function(dau_i));
            jValue = std::get<int>(var->function(dau_j));
          } else return Const::doubleNaN;
          return (jValue - iValue) / (jValue + iValue);
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughterNormDiffOf");
      }
    }
 
    Manager::FunctionPtr daughterMotherDiffOf(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        auto daughterFunction = convertToDaughterIndex({arguments[0]});
        std::string variableName = arguments[1];
        auto func = [daughterFunction, variableName](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
          int daughterNumber = std::get<int>(daughterFunction(particle));
          if (daughterNumber >= int(particle->getNDaughters()) or daughterNumber < 0)
            return Const::doubleNaN;
          const Variable::Manager::Var* var = Manager::Instance().getVariable(variableName);
          auto result_mother = var->function(particle);
          auto result_daughter = var->function(particle->getDaughter(daughterNumber));
          double diff = Const::doubleNaN;
          if (std::holds_alternative<double>(result_mother) && std::holds_alternative<double>(result_daughter))
          {
            diff = std::get<double>(result_mother) - std::get<double>(result_daughter);
          } else if (std::holds_alternative<int>(result_mother) && std::holds_alternative<int>(result_daughter))
          {
            diff = std::get<int>(result_mother) - std::get<int>(result_daughter);
          } else
          {
            throw std::runtime_error("Bad variant access");
          }
 
          if (variableName == "phi" or variableName == "useCMSFrame(phi)")
          {
            if (fabs(diff) > M_PI) {
              if (diff > M_PI) {
                diff = diff - 2 * M_PI;
              } else {
                diff = 2 * M_PI + diff;
              }
            }
          }
          return diff;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughterMotherDiffOf");
      }
    }
 
    Manager::FunctionPtr daughterMotherNormDiffOf(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        auto daughterFunction = convertToDaughterIndex({arguments[0]});
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
        auto func = [var, daughterFunction](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
          int daughterNumber = std::get<int>(daughterFunction(particle));
          if (daughterNumber >= int(particle->getNDaughters()) or daughterNumber < 0)
            return Const::doubleNaN;
          double daughterValue = 0.0, motherValue = 0.0;
          if (std::holds_alternative<double>(var->function(particle)))
          {
            daughterValue = std::get<double>(var->function(particle->getDaughter(daughterNumber)));
            motherValue = std::get<double>(var->function(particle));
          } else if (std::holds_alternative<int>(var->function(particle)))
          {
            daughterValue = std::get<int>(var->function(particle->getDaughter(daughterNumber)));
            motherValue = std::get<int>(var->function(particle));
          }
          return (motherValue - daughterValue) / (motherValue + daughterValue);
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughterMotherNormDiffOf");
      }
    }
 
    Manager::FunctionPtr angleBetweenDaughterAndRecoil(const std::vector<std::string>& arguments)
    {
      if (arguments.size() >= 1) {
 
        auto func = [arguments](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
 
          const auto& frame = ReferenceFrame::GetCurrent();
 
          ROOT::Math::PxPyPzEVector pSum(0, 0, 0, 0);
          for (const auto& generalizedIndex : arguments)
          {
            const Particle* dauPart = particle->getParticleFromGeneralizedIndexString(generalizedIndex);
            if (dauPart) pSum += frame.getMomentum(dauPart);
            else {
              B2WARNING("Trying to access a daughter that does not exist. Index = " << generalizedIndex);
              return Const::doubleNaN;
            }
          }
 
          PCmsLabTransform T;
          ROOT::Math::PxPyPzEVector pIN = T.getBeamFourMomentum(); // Initial state (e+e- momentum in LAB)
          ROOT::Math::PxPyPzEVector pRecoil = frame.getMomentum(pIN - particle->get4Vector());
 
          return ROOT::Math::VectorUtil::Angle(pRecoil, pSum);
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function angleBetweenDaughterAndRecoil");
      }
    }
 
    Manager::FunctionPtr angleBetweenDaughterAndMissingMomentum(const std::vector<std::string>& arguments)
    {
      if (arguments.size() >= 1) {
        auto func = [arguments](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
 
          StoreObjPtr<EventKinematics> evtShape;
          if (!evtShape)
          {
            B2WARNING("Cannot find missing momentum information, did you forget to run EventKinematicsModule?");
            return Const::doubleNaN;
          }
          ROOT::Math::XYZVector missingMomentumCMS = evtShape->getMissingMomentumCMS();
          ROOT::Math::PxPyPzEVector missingTotalMomentumCMS(missingMomentumCMS.X(),
                                                            missingMomentumCMS.Y(),
                                                            missingMomentumCMS.Z(),
                                                            evtShape->getMissingEnergyCMS());
          PCmsLabTransform T;
          ROOT::Math::PxPyPzEVector missingTotalMomentumLab = T.rotateCmsToLab() * missingTotalMomentumCMS;
 
          const auto& frame = ReferenceFrame::GetCurrent();
          ROOT::Math::PxPyPzEVector pMiss = frame.getMomentum(missingTotalMomentumLab); // transform from lab to reference frame
 
          ROOT::Math::PxPyPzEVector pSum(0, 0, 0, 0);
          for (const auto& generalizedIndex : arguments)
          {
            const Particle* dauPart = particle->getParticleFromGeneralizedIndexString(generalizedIndex);
            if (dauPart) pSum += frame.getMomentum(dauPart);
            else {
              B2WARNING("Trying to access a daughter that does not exist. Index = " << generalizedIndex);
              return Const::doubleNaN;
            }
          }
 
          return ROOT::Math::VectorUtil::Angle(pMiss, pSum);
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function angleBetweenDaughterAndMissingMomentum");
      }
    }
 
    Manager::FunctionPtr daughterAngle(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2 || arguments.size() == 3) {
 
        auto func = [arguments](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
 
          std::vector<ROOT::Math::PxPyPzEVector> pDaus;
          const auto& frame = ReferenceFrame::GetCurrent();
 
          // Parses the generalized indexes and fetches the 4-momenta of the particles of interest
          for (const auto& generalizedIndex : arguments)
          {
            const Particle* dauPart = particle->getParticleFromGeneralizedIndexString(generalizedIndex);
            if (dauPart)
              pDaus.push_back(frame.getMomentum(dauPart));
            else {
              B2WARNING("Trying to access a daughter that does not exist. Index = " << generalizedIndex);
              return Const::doubleNaN;
            }
          }
 
          // Calculates the angle between the selected particles
          if (pDaus.size() == 2)
            return ROOT::Math::VectorUtil::Angle(pDaus[0], pDaus[1]);
          else
            return ROOT::Math::VectorUtil::Angle(pDaus[2], pDaus[0] + pDaus[1]);
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughterAngle");
      }
    }
 
    double grandDaughterDecayAngle(const Particle* particle, const std::vector<double>& arguments)
    {
      if (arguments.size() == 2) {
 
        if (!particle)
          return Const::doubleNaN;
 
        int daughterIndex = std::lround(arguments[0]);
        if (daughterIndex >= int(particle->getNDaughters()))
          return Const::doubleNaN;
        const Particle* dau = particle->getDaughter(daughterIndex);
 
        int grandDaughterIndex = std::lround(arguments[1]);
        if (grandDaughterIndex >= int(dau->getNDaughters()))
          return Const::doubleNaN;
 
        ROOT::Math::XYZVector boost = dau->get4Vector().BoostToCM();
 
        ROOT::Math::PxPyPzEVector motherMomentum = - particle->get4Vector();
        motherMomentum = ROOT::Math::Boost(boost) * motherMomentum;
 
        ROOT::Math::PxPyPzEVector grandDaughterMomentum = dau->getDaughter(grandDaughterIndex)->get4Vector();
        grandDaughterMomentum = ROOT::Math::Boost(boost) * grandDaughterMomentum;
 
        return ROOT::Math::VectorUtil::Angle(motherMomentum, grandDaughterMomentum);
 
      } else {
        B2FATAL("The variable grandDaughterDecayAngle needs exactly two integers as arguments!");
      }
    }
 
    Manager::FunctionPtr mcDaughterAngle(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2 || arguments.size() == 3) {
 
        auto func = [arguments](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
 
          std::vector<ROOT::Math::PxPyPzEVector> pDaus;
          const auto& frame = ReferenceFrame::GetCurrent();
 
          // Parses the generalized indexes and fetches the 4-momenta of the particles of interest
          if (particle->getParticleSource() == Particle::EParticleSourceObject::c_MCParticle) // Check if MCParticle
          {
            for (const auto& generalizedIndex : arguments) {
              const MCParticle* mcPart = particle->getMCParticle();
              if (mcPart == nullptr)
                return Const::doubleNaN;
              const MCParticle* dauMcPart = mcPart->getParticleFromGeneralizedIndexString(generalizedIndex);
              if (dauMcPart == nullptr)
                return Const::doubleNaN;
 
              pDaus.push_back(frame.getMomentum(dauMcPart->get4Vector()));
            }
          } else
          {
            for (const auto& generalizedIndex : arguments) {
              const Particle* dauPart = particle->getParticleFromGeneralizedIndexString(generalizedIndex);
              if (dauPart == nullptr)
                return Const::doubleNaN;
 
              const MCParticle* dauMcPart = dauPart->getMCParticle();
              if (dauMcPart == nullptr)
                return Const::doubleNaN;
 
              pDaus.push_back(frame.getMomentum(dauMcPart->get4Vector()));
            }
          }
 
          // Calculates the angle between the selected particles
          if (pDaus.size() == 2)
            return ROOT::Math::VectorUtil::Angle(pDaus[0], pDaus[1]);
          else
            return ROOT::Math::VectorUtil::Angle(pDaus[2], pDaus[0] + pDaus[1]);
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function mcDaughterAngle");
      }
    }
 
    double daughterClusterAngleInBetween(const Particle* particle, const std::vector<double>& daughterIndices)
    {
      if (daughterIndices.size() == 2) {
        int daughterIndexi = std::lround(daughterIndices[0]);
        int daughterIndexj = std::lround(daughterIndices[1]);
        if (std::max(daughterIndexi, daughterIndexj) >= int(particle->getNDaughters())) {
          return Const::doubleNaN;
        } else {
          const ECLCluster* clusteri = particle->getDaughter(daughterIndexi)->getECLCluster();
          const ECLCluster* clusterj = particle->getDaughter(daughterIndexj)->getECLCluster();
          if (clusteri and clusterj) {
            const auto& frame = ReferenceFrame::GetCurrent();
            const ECLCluster::EHypothesisBit clusteriBit = (particle->getDaughter(daughterIndexi))->getECLClusterEHypothesisBit();
            const ECLCluster::EHypothesisBit clusterjBit = (particle->getDaughter(daughterIndexj))->getECLClusterEHypothesisBit();
            ClusterUtils clusutils;
            ROOT::Math::PxPyPzEVector pi = frame.getMomentum(clusutils.Get4MomentumFromCluster(clusteri, clusteriBit));
            ROOT::Math::PxPyPzEVector pj = frame.getMomentum(clusutils.Get4MomentumFromCluster(clusterj, clusterjBit));
            return ROOT::Math::VectorUtil::Angle(pi, pj);
          }
          return Const::doubleNaN;
        }
      } else if (daughterIndices.size() == 3) {
        int daughterIndexi = std::lround(daughterIndices[0]);
        int daughterIndexj = std::lround(daughterIndices[1]);
        int daughterIndexk = std::lround(daughterIndices[2]);
        if (std::max(std::max(daughterIndexi, daughterIndexj), daughterIndexk) >= int(particle->getNDaughters())) {
          return Const::doubleNaN;
        } else {
          const ECLCluster* clusteri = (particle->getDaughter(daughterIndices[0]))->getECLCluster();
          const ECLCluster* clusterj = (particle->getDaughter(daughterIndices[1]))->getECLCluster();
          const ECLCluster* clusterk = (particle->getDaughter(daughterIndices[2]))->getECLCluster();
          if (clusteri and clusterj and clusterk) {
            const auto& frame = ReferenceFrame::GetCurrent();
            const ECLCluster::EHypothesisBit clusteriBit = (particle->getDaughter(daughterIndices[0]))->getECLClusterEHypothesisBit();
            const ECLCluster::EHypothesisBit clusterjBit = (particle->getDaughter(daughterIndices[1]))->getECLClusterEHypothesisBit();
            const ECLCluster::EHypothesisBit clusterkBit = (particle->getDaughter(daughterIndices[2]))->getECLClusterEHypothesisBit();
            ClusterUtils clusutils;
            ROOT::Math::PxPyPzEVector pi = frame.getMomentum(clusutils.Get4MomentumFromCluster(clusteri, clusteriBit));
            ROOT::Math::PxPyPzEVector pj = frame.getMomentum(clusutils.Get4MomentumFromCluster(clusterj, clusterjBit));
            ROOT::Math::PxPyPzEVector pk = frame.getMomentum(clusutils.Get4MomentumFromCluster(clusterk, clusterkBit));
            return ROOT::Math::VectorUtil::Angle(pk, pi + pj);
          }
          return Const::doubleNaN;
        }
      } else {
        B2FATAL("Wrong number of arguments for daughterClusterAngleInBetween!");
      }
    }
 
    Manager::FunctionPtr daughterInvM(const std::vector<std::string>& arguments)
    {
      if (arguments.size() > 1) {
        auto func = [arguments](const Particle * particle) -> double {
          const auto& frame = ReferenceFrame::GetCurrent();
          ROOT::Math::PxPyPzEVector pSum;
 
          for (const auto& generalizedIndex : arguments)
          {
            const Particle* dauPart = particle->getParticleFromGeneralizedIndexString(generalizedIndex);
            if (dauPart)
              pSum += frame.getMomentum(dauPart);
            else {
              return Const::doubleNaN;
            }
          }
          return pSum.M();
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughterInvM. At least two integers are needed.");
      }
    }
 
    Manager::FunctionPtr modulo(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        int divideBy = 1;
        try {
          divideBy = convertString<int>(arguments[1]);
        } catch (std::invalid_argument&) {
          B2FATAL("Second argument of modulo meta function must be integer!");
        }
        auto func = [var, divideBy](const Particle * particle) -> int {
          auto var_result = var->function(particle);
          if (std::holds_alternative<double>(var_result))
          {
            return int(std::get<double>(var_result)) % divideBy;
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::get<int>(var_result) % divideBy;
          } else if (std::holds_alternative<bool>(var_result))
          {
            return int(std::get<bool>(var_result)) % divideBy;
          } else return 0;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function modulo");
      }
    }
 
    Manager::FunctionPtr isNAN(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
 
        auto func = [var](const Particle * particle) -> bool { return std::isnan(std::get<double>(var->function(particle))); };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function isNAN");
      }
    }
 
    Manager::FunctionPtr ifNANgiveX(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        double defaultOutput;
        try {
          defaultOutput = convertString<double>(arguments[1]);
        } catch (std::invalid_argument&) {
          B2FATAL("The second argument of ifNANgiveX meta function must be a number!");
        }
        auto func = [var, defaultOutput](const Particle * particle) -> double {
          double output = std::get<double>(var->function(particle));
          if (std::isnan(output)) return defaultOutput;
          else return output;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function ifNANgiveX");
      }
    }
 
    Manager::FunctionPtr isInfinity(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
 
        auto func = [var](const Particle * particle) -> bool { return std::isinf(std::get<double>(var->function(particle))); };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function isInfinity");
      }
    }
 
    Manager::FunctionPtr unmask(const std::vector<std::string>& arguments)
    {
      if (arguments.size() >= 2) {
        // get the function pointer of variable to be unmasked
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
 
        // get the final mask which summarize all the input masks
        int finalMask = 0;
        for (size_t i = 1; i < arguments.size(); ++i) {
          try {
            finalMask |= convertString<int>(arguments[i]);
          } catch (std::invalid_argument&) {
            B2FATAL("The input flags to meta function unmask() should be integer!");
            return nullptr;
          }
        }
 
        // unmask the variable
        auto func = [var, finalMask](const Particle * particle) -> double {
          int value = 0;
          auto var_result = var->function(particle);
          if (std::holds_alternative<double>(var_result))
          {
            // judge if the value is nan before unmasking
            if (std::isnan(std::get<double>(var_result))) {
              return Const::doubleNaN;
            }
            value = int(std::get<double>(var_result));
          } else if (std::holds_alternative<int>(var_result))
          {
            value = std::get<int>(var_result);
          }
 
          // apply the final mask
          value &= (~finalMask);
 
          return value;
        };
        return func;
 
      } else {
        B2FATAL("Meta function unmask needs at least two arguments!");
      }
    }
 
    Manager::FunctionPtr conditionalVariableSelector(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 3) {
 
        std::string cutString = arguments[0];
        std::shared_ptr<Variable::Cut> cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(cutString));
 
        const Variable::Manager::Var* variableIfTrue = Manager::Instance().getVariable(arguments[1]);
        const Variable::Manager::Var* variableIfFalse = Manager::Instance().getVariable(arguments[2]);
 
        auto func = [cut, variableIfTrue, variableIfFalse](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
          if (cut->check(particle))
          {
            auto var_result = variableIfTrue->function(particle);
            if (std::holds_alternative<double>(var_result)) {
              return std::get<double>(var_result);
            } else if (std::holds_alternative<int>(var_result)) {
              return std::get<int>(var_result);
            } else if (std::holds_alternative<bool>(var_result)) {
              return std::get<bool>(var_result);
            } else return Const::doubleNaN;
          } else
          {
            auto var_result = variableIfFalse->function(particle);
            if (std::holds_alternative<double>(var_result)) {
              return std::get<double>(var_result);
            } else if (std::holds_alternative<int>(var_result)) {
              return std::get<int>(var_result);
            } else if (std::holds_alternative<bool>(var_result)) {
              return std::get<bool>(var_result);
            } else return Const::doubleNaN;
          }
        };
        return func;
 
      } else {
        B2FATAL("Wrong number of arguments for meta function conditionalVariableSelector");
      }
    }
 
    Manager::FunctionPtr pValueCombination(const std::vector<std::string>& arguments)
    {
      if (arguments.size() > 0) {
        std::vector<const Variable::Manager::Var*> variables;
        for (const auto& argument : arguments)
          variables.push_back(Manager::Instance().getVariable(argument));
 
        auto func = [variables, arguments](const Particle * particle) -> double {
          double pValueProduct = 1.;
          for (auto variable : variables)
          {
            double pValue = std::get<double>(variable->function(particle));
            if (pValue < 0)
              return -1;
            else
              pValueProduct *= pValue;
          }
          double pValueSum = 1.;
          double factorial = 1.;
          for (unsigned int i = 1; i < arguments.size(); ++i)
          {
            factorial *= i;
            pValueSum += pow(-std::log(pValueProduct), i) / factorial;
          }
          return pValueProduct * pValueSum;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function pValueCombination");
      }
    }
 
    Manager::FunctionPtr pValueCombinationOfDaughters(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          double pValueProduct = 1.;
          if (particle->getNDaughters() == 0)
          {
            return Const::doubleNaN;
          }
 
          for (unsigned j = 0; j < particle->getNDaughters(); ++j)
          {
            double pValue = std::get<double>(var->function(particle->getDaughter(j)));
            if (pValue < 0) return -1;
            else pValueProduct *= pValue;
          }
 
          double pValueSum = 1.;
          double factorial = 1.;
          for (unsigned int i = 1; i < particle->getNDaughters(); ++i)
          {
            factorial *= i;
            pValueSum += pow(-std::log(pValueProduct), i) / factorial;
          }
          return pValueProduct * pValueSum;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function pValueCombinationOfDaughters");
      }
    }
 
    Manager::FunctionPtr abs(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          auto var_result = var->function(particle);
          if (std::holds_alternative<double>(var_result))
          {
            return std::abs(std::get<double>(var_result));
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::abs(std::get<int>(var_result));
          } else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function abs");
      }
    }
 
    Manager::FunctionPtr max(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        const Variable::Manager::Var* var1 = Manager::Instance().getVariable(arguments[0]);
        const Variable::Manager::Var* var2 = Manager::Instance().getVariable(arguments[1]);
 
        if (!var1 or !var2)
          B2FATAL("One or both of the used variables doesn't exist!");
 
        auto func = [var1, var2](const Particle * particle) -> double {
          double val1 = 0.0, val2 = 0.0;
          auto var_result1 = var1->function(particle);
          auto var_result2 = var2->function(particle);
          if (std::holds_alternative<double>(var_result1))
          {
            val1 = std::get<double>(var_result1);
          } else if (std::holds_alternative<int>(var_result1))
          {
            val1 = std::get<int>(var_result1);
          } else if (std::holds_alternative<bool>(var_result1))
          {
            val1 = std::get<bool>(var_result1);
          } else
          {
            B2FATAL("A variable in meta function max holds no double, int or bool values");
          }
          if (std::holds_alternative<double>(var_result2))
          {
            val2 = std::get<double>(var_result2);
          } else if (std::holds_alternative<int>(var_result2))
          {
            val2 = std::get<int>(var_result2);
          } else if (std::holds_alternative<bool>(var_result2))
          {
            val2 = std::get<bool>(var_result2);
          } else
          {
            B2FATAL("A variable in meta function max holds no double, int or bool values");
          }
          return std::max(val1, val2);
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function max");
      }
    }
 
    Manager::FunctionPtr min(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        const Variable::Manager::Var* var1 = Manager::Instance().getVariable(arguments[0]);
        const Variable::Manager::Var* var2 = Manager::Instance().getVariable(arguments[1]);
 
        if (!var1 or !var2)
          B2FATAL("One or both of the used variables doesn't exist!");
 
        auto func = [var1, var2](const Particle * particle) -> double {
          double val1 = 0.0, val2 = 0.0;
          auto var_result1 = var1->function(particle);
          auto var_result2 = var2->function(particle);
          if (std::holds_alternative<double>(var_result1))
          {
            val1 = std::get<double>(var_result1);
          } else if (std::holds_alternative<int>(var_result1))
          {
            val1 = std::get<int>(var_result1);
          } else if (std::holds_alternative<bool>(var_result1))
          {
            val1 = std::get<bool>(var_result1);
          } else
          {
            B2FATAL("A variable in meta function min holds no double, int or bool values");
          }
          if (std::holds_alternative<double>(var_result2))
          {
            val2 = std::get<double>(var_result2);
          } else if (std::holds_alternative<int>(var_result2))
          {
            val2 = std::get<int>(var_result2);
          } else if (std::holds_alternative<bool>(var_result2))
          {
            val2 = std::get<bool>(var_result2);
          } else
          {
            B2FATAL("A variable in meta function min holds no double, int or bool values");
          }
          return std::min(val1, val2);
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function min");
      }
    }
 
    Manager::FunctionPtr sin(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          auto var_result = var->function(particle);
          if (std::holds_alternative<double>(var_result))
            return std::sin(std::get<double>(var_result));
          else if (std::holds_alternative<int>(var_result))
            return std::sin(std::get<int>(var_result));
          else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function sin");
      }
    }
 
    Manager::FunctionPtr asin(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          auto var_result = var->function(particle);
          if (std::holds_alternative<double>(var_result))
            return std::asin(std::get<double>(var_result));
          else if (std::holds_alternative<int>(var_result))
            return std::asin(std::get<int>(var_result));
          else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function asin");
      }
    }
 
    Manager::FunctionPtr cos(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          auto var_result = var->function(particle);
          if (std::holds_alternative<double>(var_result))
            return std::cos(std::get<double>(var_result));
          else if (std::holds_alternative<int>(var_result))
            return std::cos(std::get<int>(var_result));
          else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function cos");
      }
    }
 
    Manager::FunctionPtr acos(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          auto var_result = var->function(particle);
          if (std::holds_alternative<double>(var_result))
            return std::acos(std::get<double>(var_result));
          else if (std::holds_alternative<int>(var_result))
            return std::acos(std::get<int>(var_result));
          else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function acos");
      }
    }
 
    Manager::FunctionPtr tan(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double { return std::tan(std::get<double>(var->function(particle))); };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function tan");
      }
    }
 
    Manager::FunctionPtr atan(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double { return std::atan(std::get<double>(var->function(particle))); };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function atan");
      }
    }
 
    Manager::FunctionPtr atan2(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        const Variable::Manager::Var* varY = Manager::Instance().getVariable(arguments[0]);
        const Variable::Manager::Var* varX = Manager::Instance().getVariable(arguments[1]);
        auto func = [varY, varX](const Particle * particle) -> double {
          double y = std::get<double>(varY->function(particle));
          double x = std::get<double>(varX->function(particle));
          return std::atan2(y, x);
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function atan2");
      }
    }
 
    Manager::FunctionPtr exp(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          auto var_result = var->function(particle);
          if (std::holds_alternative<double>(var_result))
            return std::exp(std::get<double>(var_result));
          else if (std::holds_alternative<int>(var_result))
            return std::exp(std::get<int>(var_result));
          else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function exp");
      }
    }
 
    Manager::FunctionPtr log(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          auto var_result = var->function(particle);
          if (std::holds_alternative<double>(var_result))
            return std::log(std::get<double>(var_result));
          else if (std::holds_alternative<int>(var_result))
            return std::log(std::get<int>(var_result));
          else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function log");
      }
    }
 
    Manager::FunctionPtr log10(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          auto var_result = var->function(particle);
          if (std::holds_alternative<double>(var_result))
            return std::log10(std::get<double>(var_result));
          else if (std::holds_alternative<int>(var_result))
            return std::log10(std::get<int>(var_result));
          else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function log10");
      }
    }
 
    Manager::FunctionPtr originalParticle(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
 
          StoreArray<Particle> particles;
          if (!particle->hasExtraInfo("original_index"))
            return Const::doubleNaN;
 
          auto originalParticle = particles[particle->getExtraInfo("original_index")];
          if (!originalParticle)
            return Const::doubleNaN;
          auto var_result = var->function(originalParticle);
          if (std::holds_alternative<double>(var_result))
          {
            return std::get<double>(var_result);
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::get<int>(var_result);
          } else if (std::holds_alternative<bool>(var_result))
          {
            return std::get<bool>(var_result);
          } else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function originalParticle");
      }
    }
 
    Manager::FunctionPtr daughter(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        auto daughterFunction = convertToDaughterIndex({arguments[0]});
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
        auto func = [var, daughterFunction](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
          int daughterNumber = std::get<int>(daughterFunction(particle));
          if (daughterNumber >= int(particle->getNDaughters()) or daughterNumber < 0)
            return Const::doubleNaN;
          auto var_result = var->function(particle->getDaughter(daughterNumber));
          if (std::holds_alternative<double>(var_result))
          {
            return std::get<double>(var_result);
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::get<int>(var_result);
          } else if (std::holds_alternative<bool>(var_result))
          {
            return std::get<bool>(var_result);
          } else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughter");
      }
    }
 
    Manager::FunctionPtr originalDaughter(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        auto daughterFunction = convertToDaughterIndex({arguments[0]});
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
        auto func = [var, daughterFunction](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
          int daughterNumber = std::get<int>(daughterFunction(particle));
          if (daughterNumber >= int(particle->getNDaughters()) or daughterNumber < 0)
            return Const::doubleNaN;
          else
          {
            StoreArray<Particle> particles;
            if (!particle->getDaughter(daughterNumber)->hasExtraInfo("original_index"))
              return Const::doubleNaN;
            auto originalDaughter = particles[particle->getDaughter(daughterNumber)->getExtraInfo("original_index")];
            if (!originalDaughter)
              return Const::doubleNaN;
 
            auto var_result = var->function(originalDaughter);
            if (std::holds_alternative<double>(var_result)) {
              return std::get<double>(var_result);
            } else if (std::holds_alternative<int>(var_result)) {
              return std::get<int>(var_result);
            } else if (std::holds_alternative<bool>(var_result)) {
              return std::get<bool>(var_result);
            } else return Const::doubleNaN;
          }
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function daughter");
      }
    }
 
    Manager::FunctionPtr convertToDaughterIndex(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string daughterString = arguments[0];
        auto func = [daughterString](const Particle * particle) -> int {
          if (particle == nullptr)
            return -1;
          int daughterNumber = 0;
          try
          {
            daughterNumber = convertString<int>(daughterString);
          } catch (std::invalid_argument&)
          {
            auto daughterFunction = convertToInt({daughterString, "-1"});
            auto daughterVarResult = daughterFunction(particle);
            daughterNumber = std::get<int>(daughterVarResult);
          }
          return daughterNumber;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function convertToDaughterIndex");
      }
    }
 
    Manager::FunctionPtr mcDaughter(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        auto daughterFunction = convertToDaughterIndex({arguments[0]});
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
        auto func = [var, daughterFunction](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
          if (particle->getMCParticle()) // has MC match or is MCParticle
          {
            int daughterNumber = std::get<int>(daughterFunction(particle));
            if (daughterNumber >= int(particle->getMCParticle()->getNDaughters()) or daughterNumber < 0)
              return Const::doubleNaN;
            Particle tempParticle = Particle(particle->getMCParticle()->getDaughters().at(daughterNumber));
            auto var_result = var->function(&tempParticle);
            if (std::holds_alternative<double>(var_result)) {
              return std::get<double>(var_result);
            } else if (std::holds_alternative<int>(var_result)) {
              return std::get<int>(var_result);
            } else if (std::holds_alternative<bool>(var_result)) {
              return std::get<bool>(var_result);
            } else {
              return Const::doubleNaN;
            }
          } else
          {
            return Const::doubleNaN;
          }
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function mcDaughter");
      }
    }
 
    Manager::FunctionPtr mcMother(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          if (particle == nullptr)
            return Const::doubleNaN;
          if (particle->getMCParticle()) // has MC match or is MCParticle
          {
            if (particle->getMCParticle()->getMother() == nullptr) {
              return Const::doubleNaN;
            }
            Particle tempParticle = Particle(particle->getMCParticle()->getMother());
            auto var_result = var->function(&tempParticle);
            if (std::holds_alternative<double>(var_result)) {
              return std::get<double>(var_result);
            } else if (std::holds_alternative<int>(var_result)) {
              return std::get<int>(var_result);
            } else if (std::holds_alternative<bool>(var_result)) {
              return std::get<bool>(var_result);
            } else return Const::doubleNaN;
          } else
          {
            return Const::doubleNaN;
          }
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function mcMother");
      }
    }
 
    Manager::FunctionPtr genParticle(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        std::string indexString = arguments[0];
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
 
        auto func = [var, indexString](const Particle * particle) -> double {
          // First get the particle index. If not int, evaluate the variable
          int particleNumber = 0;
          try
          {
            particleNumber = convertString<int>(indexString);
          } catch (std::invalid_argument&)
          {
            auto indexFunction = convertToInt({indexString, "-1"});
            auto indexVarResult = indexFunction(particle);
            particleNumber = std::get<int>(indexVarResult);
          }
 
          StoreArray<MCParticle> mcParticles("MCParticles");
          if (particleNumber < 0 or particleNumber >= mcParticles.getEntries())
          {
            return Const::doubleNaN;
          }
 
          const MCParticle* mcParticle = mcParticles[particleNumber];
          Particle part = Particle(mcParticle);
          auto var_result = var->function(&part);
          if (std::holds_alternative<double>(var_result))
          {
            return std::get<double>(var_result);
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::get<int>(var_result);
          } else if (std::holds_alternative<bool>(var_result))
          {
            return std::get<bool>(var_result);
          } else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function genParticle");
      }
    }
 
    Manager::FunctionPtr genUpsilon4S(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
 
        auto func = [var](const Particle*) -> double {
          StoreArray<MCParticle> mcParticles("MCParticles");
          if (mcParticles.getEntries() == 0)
          {
            return Const::doubleNaN;
          }
 
          const MCParticle* mcUpsilon4S = mcParticles[0];
          if (mcUpsilon4S->isInitial()) mcUpsilon4S = mcParticles[2];
          if (mcUpsilon4S->getPDG() != 300553)
          {
            return Const::doubleNaN;
          }
 
          Particle upsilon4S = Particle(mcUpsilon4S);
          auto var_result = var->function(&upsilon4S);
          if (std::holds_alternative<double>(var_result))
          {
            return std::get<double>(var_result);
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::get<int>(var_result);
          } else if (std::holds_alternative<bool>(var_result))
          {
            return std::get<bool>(var_result);
          } else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function genUpsilon4S");
      }
    }
 
    Manager::FunctionPtr getVariableByRank(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 4) {
        std::string listName = arguments[0];
        std::string rankedVariableName = arguments[1];
        std::string returnVariableName = arguments[2];
        std::string extraInfoName = rankedVariableName + "_rank";
        int rank = 1;
        try {
          rank = convertString<int>(arguments[3]);
        } catch (std::invalid_argument&)  {
          B2ERROR("3rd argument of getVariableByRank meta function (Rank) must be an integer!");
          return nullptr;
        }
 
        const Variable::Manager::Var* var = Manager::Instance().getVariable(returnVariableName);
        auto func = [var, rank, extraInfoName, listName](const Particle*)-> double {
          StoreObjPtr<ParticleList> list(listName);
 
          const unsigned int numParticles = list->getListSize();
          for (unsigned int i = 0; i < numParticles; i++)
          {
            const Particle* p = list->getParticle(i);
            if (p->getExtraInfo(extraInfoName) == rank) {
              auto var_result = var->function(p);
              if (std::holds_alternative<double>(var_result)) {
                return std::get<double>(var_result);
              } else if (std::holds_alternative<int>(var_result)) {
                return std::get<int>(var_result);
              } else if (std::holds_alternative<bool>(var_result)) {
                return std::get<bool>(var_result);
              } else return Const::doubleNaN;
            }
          }
          // return 0;
          return std::numeric_limits<double>::signaling_NaN();
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function getVariableByRank");
      }
    }
 
    Manager::FunctionPtr countInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1 or arguments.size() == 2) {
 
        std::string listName = arguments[0];
        std::string cutString = "";
 
        if (arguments.size() == 2) {
          cutString = arguments[1];
        }
 
        std::shared_ptr<Variable::Cut> cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(cutString));
 
        auto func = [listName, cut](const Particle*) -> int {
 
          StoreObjPtr<ParticleList> list(listName);
          int sum = 0;
          for (unsigned int i = 0; i < list->getListSize(); i++)
          {
            const Particle* particle = list->getParticle(i);
            if (cut->check(particle)) {
              sum++;
            }
          }
          return sum;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function countInList");
      }
    }
 
    Manager::FunctionPtr veto(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2 or arguments.size() == 3) {
 
        std::string roeListName = arguments[0];
        std::string cutString = arguments[1];
        int pdgCode = Const::electron.getPDGCode();
        if (arguments.size() == 2) {
          B2INFO("Use pdgCode of electron as default in meta variable veto, other arguments: " << roeListName << ", " << cutString);
        } else {
          try {
            pdgCode = convertString<int>(arguments[2]);;
          } catch (std::invalid_argument&) {
            B2FATAL("Third argument of veto meta function must be integer!");
          }
        }
 
        auto flavourType = (EvtPDLUtil::hasAntiParticle(pdgCode)) ? Particle::c_Flavored : Particle::c_Unflavored;
        std::shared_ptr<Variable::Cut> cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(cutString));
 
        auto func = [roeListName, cut, pdgCode, flavourType](const Particle * particle) -> bool {
          StoreObjPtr<ParticleList> roeList(roeListName);
          ROOT::Math::PxPyPzEVector vec = particle->get4Vector();
          for (unsigned int i = 0; i < roeList->getListSize(); i++)
          {
            const Particle* roeParticle = roeList->getParticle(i);
            if (not particle->overlapsWith(roeParticle)) {
              ROOT::Math::PxPyPzEVector tempCombination = roeParticle->get4Vector() + vec;
              std::vector<int> indices = { particle->getArrayIndex(), roeParticle->getArrayIndex() };
              Particle tempParticle = Particle(tempCombination, pdgCode, flavourType, indices, particle->getArrayPointer());
              if (cut->check(&tempParticle)) {
                return 1;
              }
            }
          }
          return 0;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function veto");
      }
    }
 
    Manager::FunctionPtr countDaughters(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string cutString = arguments[0];
        std::shared_ptr<Variable::Cut> cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(cutString));
        auto func = [cut](const Particle * particle) -> int {
          int n = 0;
          for (auto& daughter : particle->getDaughters())
          {
            if (cut->check(daughter))
              ++n;
          }
          return n;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function countDaughters");
      }
    }
 
    Manager::FunctionPtr countFSPDaughters(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string cutString = arguments[0];
        std::shared_ptr<Variable::Cut> cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(cutString));
        auto func = [cut](const Particle * particle) -> int {
 
          std::vector<const Particle*> fspDaughters;
          particle->fillFSPDaughters(fspDaughters);
 
          int n = 0;
          for (auto& daughter : fspDaughters)
          {
            if (cut->check(daughter))
              ++n;
          }
          return n;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function countFSPDaughters");
      }
    }
 
    Manager::FunctionPtr countDescendants(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string cutString = arguments[0];
        std::shared_ptr<Variable::Cut> cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(cutString));
        auto func = [cut](const Particle * particle) -> int {
 
          std::vector<const Particle*> allDaughters;
          particle->fillAllDaughters(allDaughters);
 
          int n = 0;
          for (auto& daughter : allDaughters)
          {
            if (cut->check(daughter))
              ++n;
          }
          return n;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function countDescendants");
      }
    }
 
    Manager::FunctionPtr numberOfNonOverlappingParticles(const std::vector<std::string>& arguments)
    {
 
      auto func = [arguments](const Particle * particle) -> int {
 
        int _numberOfNonOverlappingParticles = 0;
        for (const auto& listName : arguments)
        {
          StoreObjPtr<ParticleList> list(listName);
          if (not list.isValid()) {
            B2FATAL("Invalid list named " << listName << " encountered in numberOfNonOverlappingParticles.");
          }
          for (unsigned int i = 0; i < list->getListSize(); i++) {
            const Particle* p = list->getParticle(i);
            if (not particle->overlapsWith(p)) {
              _numberOfNonOverlappingParticles++;
            }
          }
        }
        return _numberOfNonOverlappingParticles;
      };
 
      return func;
 
    }
 
    void appendDaughtersRecursive(Particle* mother, StoreArray<Particle>& container)
    {
 
      auto* mcmother = mother->getRelated<MCParticle>();
 
      if (!mcmother)
        return;
 
      for (auto* mcdaughter : mcmother->getDaughters()) {
        if (!mcdaughter->hasStatus(MCParticle::c_PrimaryParticle)) continue;
        Particle tmp_daughter(mcdaughter);
        Particle* new_daughter = container.appendNew(tmp_daughter);
        new_daughter->addRelationTo(mcdaughter);
        mother->appendDaughter(new_daughter, false);
 
        if (mcdaughter->getNDaughters() > 0)
          appendDaughtersRecursive(new_daughter, container);
      }
    }
 
    Manager::FunctionPtr matchedMC(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        auto func = [var](const Particle * particle) -> double {
          const MCParticle* mcp = particle->getMCParticle();
          if (!mcp)   // Has no MC match and is no MCParticle
          {
            return Const::doubleNaN;
          }
          StoreArray<Particle> tempParticles("tempParticles");
          tempParticles.clear();
          Particle tmpPart(mcp);
          Particle* newPart = tempParticles.appendNew(tmpPart);
          newPart->addRelationTo(mcp);
 
          appendDaughtersRecursive(newPart, tempParticles);
 
          auto var_result = var->function(newPart);
          if (std::holds_alternative<double>(var_result))
          {
            return std::get<double>(var_result);
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::get<int>(var_result);
          } else if (std::holds_alternative<bool>(var_result))
          {
            return std::get<bool>(var_result);
          } else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function matchedMC");
      }
    }
 
    Manager::FunctionPtr clusterBestMatchedMCParticle(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
 
        auto func = [var](const Particle * particle) -> double {
 
          const ECLCluster* cluster = particle->getECLCluster();
          if (!cluster) return Const::doubleNaN;
 
          auto mcps = cluster->getRelationsTo<MCParticle>();
          if (mcps.size() == 0) return Const::doubleNaN;
 
          std::vector<std::pair<double, int>> weightsAndIndices;
          for (unsigned int i = 0; i < mcps.size(); ++i)
            weightsAndIndices.emplace_back(mcps.weight(i), i);
 
          // sort descending by weight
          std::sort(weightsAndIndices.begin(), weightsAndIndices.end(),
                    ValueIndexPairSorting::higherPair<decltype(weightsAndIndices)::value_type>);
 
          const MCParticle* mcp = mcps.object(weightsAndIndices[0].second);
 
          StoreArray<Particle> tempParticles("tempParticles");
          tempParticles.clear();
          Particle tmpPart(mcp);
          Particle* newPart = tempParticles.appendNew(tmpPart);
          newPart->addRelationTo(mcp);
 
          appendDaughtersRecursive(newPart, tempParticles);
 
          auto var_result = var->function(newPart);
          if (std::holds_alternative<double>(var_result))
          {
            return std::get<double>(var_result);
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::get<int>(var_result);
          } else if (std::holds_alternative<bool>(var_result))
          {
            return std::get<bool>(var_result);
          } else
          {
            return Const::doubleNaN;
          }
        };
 
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function clusterBestMatchedMCParticle");
      }
    }
 
    Manager::FunctionPtr clusterBestMatchedMCKlong(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
 
        auto func = [var](const Particle * particle) -> double {
 
          const ECLCluster* cluster = particle->getECLCluster();
          if (!cluster) return Const::doubleNaN;
 
          auto mcps = cluster->getRelationsTo<MCParticle>();
          if (mcps.size() == 0) return Const::doubleNaN;
 
          std::map<int, double> mapMCParticleIndxAndWeight;
          getKlongWeightMap(particle, mapMCParticleIndxAndWeight);
 
          // Klong is not found
          if (mapMCParticleIndxAndWeight.size() == 0)
            return Const::doubleNaN;
 
          // find max totalWeight
          auto maxMap = std::max_element(mapMCParticleIndxAndWeight.begin(), mapMCParticleIndxAndWeight.end(),
          [](const auto & x, const auto & y) { return x.second < y.second; }
                                        );
 
          StoreArray<MCParticle> mcparticles;
          const MCParticle* mcKlong = mcparticles[maxMap->first];
 
          Particle tmpPart(mcKlong);
          auto var_result = var->function(&tmpPart);
          if (std::holds_alternative<double>(var_result))
          {
            return std::get<double>(var_result);
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::get<int>(var_result);
          } else if (std::holds_alternative<bool>(var_result))
          {
            return std::get<bool>(var_result);
          } else
          {
            return Const::doubleNaN;
          }
        };
 
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function clusterBestMatchedMCKlong");
      }
    }
 
    double matchedMCHasPDG(const Particle* particle, const std::vector<double>& pdgCode)
    {
      if (pdgCode.size() != 1) {
        B2FATAL("Too many arguments provided to matchedMCHasPDG!");
      }
      int inputPDG = std::lround(pdgCode[0]);
 
      const MCParticle* mcp = particle->getMCParticle();
      if (!mcp)
        return Const::doubleNaN;
 
      return std::abs(mcp->getPDG()) == inputPDG;
    }
 
    Manager::FunctionPtr totalEnergyOfParticlesInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string listName = arguments[0];
        auto func = [listName](const Particle * particle) -> double {
 
          (void) particle;
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid Listname " << listName << " given to totalEnergyOfParticlesInList");
          double totalEnergy = 0;
          int nParticles = listOfParticles->getListSize();
          for (int i = 0; i < nParticles; i++)
          {
            const Particle* part = listOfParticles->getParticle(i);
            const auto& frame = ReferenceFrame::GetCurrent();
            totalEnergy += frame.getMomentum(part).E();
          }
          return totalEnergy;
 
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function totalEnergyOfParticlesInList");
      }
    }
 
    Manager::FunctionPtr totalPxOfParticlesInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string listName = arguments[0];
        auto func = [listName](const Particle*) -> double {
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid Listname " << listName << " given to totalPxOfParticlesInList");
          double totalPx = 0;
          int nParticles = listOfParticles->getListSize();
          const auto& frame = ReferenceFrame::GetCurrent();
          for (int i = 0; i < nParticles; i++)
          {
            const Particle* part = listOfParticles->getParticle(i);
            totalPx += frame.getMomentum(part).Px();
          }
          return totalPx;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function totalPxOfParticlesInList");
      }
    }
 
    Manager::FunctionPtr totalPyOfParticlesInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string listName = arguments[0];
        auto func = [listName](const Particle*) -> double {
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid Listname " << listName << " given to totalPyOfParticlesInList");
          double totalPy = 0;
          int nParticles = listOfParticles->getListSize();
          const auto& frame = ReferenceFrame::GetCurrent();
          for (int i = 0; i < nParticles; i++)
          {
            const Particle* part = listOfParticles->getParticle(i);
            totalPy += frame.getMomentum(part).Py();
          }
          return totalPy;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function totalPyOfParticlesInList");
      }
    }
 
    Manager::FunctionPtr totalPzOfParticlesInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string listName = arguments[0];
        auto func = [listName](const Particle*) -> double {
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid Listname " << listName << " given to totalPzOfParticlesInList");
          double totalPz = 0;
          int nParticles = listOfParticles->getListSize();
          const auto& frame = ReferenceFrame::GetCurrent();
          for (int i = 0; i < nParticles; i++)
          {
            const Particle* part = listOfParticles->getParticle(i);
            totalPz += frame.getMomentum(part).Pz();
          }
          return totalPz;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function totalPzOfParticlesInList");
      }
    }
 
    Manager::FunctionPtr invMassInLists(const std::vector<std::string>& arguments)
    {
      if (arguments.size() > 0) {
 
        auto func = [arguments](const Particle * particle) -> double {
 
          ROOT::Math::PxPyPzEVector total4Vector;
          // To make sure particles in particlesList don't overlap.
          std::vector<Particle*> particlePool;
 
          (void) particle;
          for (const auto& argument : arguments)
          {
            StoreObjPtr <ParticleList> listOfParticles(argument);
 
            if (!(listOfParticles.isValid())) B2FATAL("Invalid Listname " << argument << " given to invMassInLists");
            int nParticles = listOfParticles->getListSize();
            for (int i = 0; i < nParticles; i++) {
              bool overlaps = false;
              Particle* part = listOfParticles->getParticle(i);
              for (const auto* poolPart : particlePool) {
                if (part->overlapsWith(poolPart)) {
                  overlaps = true;
                  break;
                }
              }
              if (!overlaps) {
                total4Vector += part->get4Vector();
                particlePool.push_back(part);
              }
            }
          }
          double invariantMass = total4Vector.M();
          return invariantMass;
 
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function invMassInLists");
      }
    }
 
    Manager::FunctionPtr totalECLEnergyOfParticlesInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string listName = arguments[0];
        auto func = [listName](const Particle * particle) -> double {
 
          (void) particle;
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid Listname " << listName << " given to totalEnergyOfParticlesInList");
          double totalEnergy = 0;
          int nParticles = listOfParticles->getListSize();
          for (int i = 0; i < nParticles; i++)
          {
            const Particle* part = listOfParticles->getParticle(i);
            const ECLCluster* cluster = part->getECLCluster();
            const ECLCluster::EHypothesisBit clusterHypothesis = part->getECLClusterEHypothesisBit();
            if (cluster != nullptr) {
              totalEnergy += cluster->getEnergy(clusterHypothesis);
            }
          }
          return totalEnergy;
 
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function totalECLEnergyOfParticlesInList");
      }
    }
 
    Manager::FunctionPtr maxPtInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string listName = arguments[0];
        auto func = [listName](const Particle*) -> double {
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid Listname " << listName << " given to maxPtInList");
          int nParticles = listOfParticles->getListSize();
          const auto& frame = ReferenceFrame::GetCurrent();
          double maxPt = 0;
          for (int i = 0; i < nParticles; i++)
          {
            const Particle* part = listOfParticles->getParticle(i);
            const double Pt = frame.getMomentum(part).Pt();
            if (Pt > maxPt) maxPt = Pt;
          }
          return maxPt;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function maxPtInList");
      }
    }
 
    Manager::FunctionPtr eclClusterTrackMatchedWithCondition(const std::vector<std::string>& arguments)
    {
      if (arguments.size() <= 1) {
 
        std::string cutString;
        if (arguments.size() == 1)
          cutString = arguments[0];
        std::shared_ptr<Variable::Cut> cut = std::shared_ptr<Variable::Cut>(Variable::Cut::compile(cutString));
        auto func = [cut](const Particle * particle) -> double {
 
          if (particle == nullptr)
            return Const::doubleNaN;
 
          const ECLCluster* cluster = particle->getECLCluster();
 
          if (cluster)
          {
            auto tracks = cluster->getRelationsFrom<Track>();
 
            for (const auto& track : tracks) {
              Particle trackParticle(&track, Const::pion);
 
              if (cut->check(&trackParticle))
                return 1;
            }
            return 0;
          }
          return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function eclClusterSpecialTrackMatched");
      }
    }
 
    Manager::FunctionPtr averageValueInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        std::string listName = arguments[0];
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
 
        auto func = [listName, var](const Particle*) -> double {
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid list name " << listName << " given to averageValueInList");
          int nParticles = listOfParticles->getListSize();
          if (nParticles == 0)
          {
            return Const::doubleNaN;
          }
          double average = 0;
          if (std::holds_alternative<double>(var->function(listOfParticles->getParticle(0))))
          {
            for (int i = 0; i < nParticles; i++) {
              average += std::get<double>(var->function(listOfParticles->getParticle(i))) / nParticles;
            }
          } else if (std::holds_alternative<int>(var->function(listOfParticles->getParticle(0))))
          {
            for (int i = 0; i < nParticles; i++) {
              average += std::get<int>(var->function(listOfParticles->getParticle(i))) / nParticles;
            }
          } else return Const::doubleNaN;
          return average;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function averageValueInList");
      }
    }
 
    Manager::FunctionPtr medianValueInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        std::string listName = arguments[0];
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
 
        auto func = [listName, var](const Particle*) -> double {
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid list name " << listName << " given to medianValueInList");
          int nParticles = listOfParticles->getListSize();
          if (nParticles == 0)
          {
            return Const::doubleNaN;
          }
          std::vector<double> valuesInList;
          if (std::holds_alternative<double>(var->function(listOfParticles->getParticle(0))))
          {
            for (int i = 0; i < nParticles; i++) {
              valuesInList.push_back(std::get<double>(var->function(listOfParticles->getParticle(i))));
            }
          } else if (std::holds_alternative<int>(var->function(listOfParticles->getParticle(0))))
          {
            for (int i = 0; i < nParticles; i++) {
              valuesInList.push_back(std::get<int>(var->function(listOfParticles->getParticle(i))));
            }
          } else return Const::doubleNaN;
          std::sort(valuesInList.begin(), valuesInList.end());
          if (nParticles % 2 != 0)
          {
            return valuesInList[nParticles / 2];
          } else
          {
            return 0.5 * (valuesInList[nParticles / 2] + valuesInList[nParticles / 2 - 1]);
          }
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function medianValueInList");
      }
    }
 
    Manager::FunctionPtr sumValueInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        std::string listName = arguments[0];
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
 
        auto func = [listName, var](const Particle*) -> double {
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid list name " << listName << " given to sumValueInList");
          int nParticles = listOfParticles->getListSize();
          if (nParticles == 0)
          {
            return Const::doubleNaN;
          }
          double sum = 0;
          if (std::holds_alternative<double>(var->function(listOfParticles->getParticle(0))))
          {
            for (int i = 0; i < nParticles; i++) {
              sum += std::get<double>(var->function(listOfParticles->getParticle(i)));
            }
          } else if (std::holds_alternative<int>(var->function(listOfParticles->getParticle(0))))
          {
            for (int i = 0; i < nParticles; i++) {
              sum += std::get<int>(var->function(listOfParticles->getParticle(i)));
            }
          } else return Const::doubleNaN;
          return sum;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function sumValueInList");
      }
    }
 
    Manager::FunctionPtr productValueInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        std::string listName = arguments[0];
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
 
        auto func = [listName, var](const Particle*) -> double {
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid list name " << listName << " given to productValueInList");
          int nParticles = listOfParticles->getListSize();
          if (nParticles == 0)
          {
            return Const::doubleNaN;
          }
          double product = 1;
          if (std::holds_alternative<double>(var->function(listOfParticles->getParticle(0))))
          {
            for (int i = 0; i < nParticles; i++) {
              product *= std::get<double>(var->function(listOfParticles->getParticle(i)));
            }
          } else if (std::holds_alternative<int>(var->function(listOfParticles->getParticle(0))))
          {
            for (int i = 0; i < nParticles; i++) {
              product *= std::get<int>(var->function(listOfParticles->getParticle(i)));
            }
          } else return Const::doubleNaN;
          return product;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function productValueInList");
      }
    }
 
    Manager::FunctionPtr angleToClosestInList(const std::vector<std::string>& arguments)
    {
      // expecting the list name
      if (arguments.size() != 1)
        B2FATAL("Wrong number of arguments for meta function angleToClosestInList");
 
      std::string listname = arguments[0];
 
      auto func = [listname](const Particle * particle) -> double {
        // get the list and check it's valid
        StoreObjPtr<ParticleList> list(listname);
        if (not list.isValid())
          B2FATAL("Invalid particle list name " << listname << " given to angleToClosestInList");
 
        // check the list isn't empty
        if (list->getListSize() == 0)
          return Const::doubleNaN;
 
        // respect the current frame and get the momentum of our input
        const auto& frame = ReferenceFrame::GetCurrent();
        const auto p_this = frame.getMomentum(particle);
 
        // find the particle index with the smallest opening angle
        double minAngle = 2 * M_PI;
        for (unsigned int i = 0; i < list->getListSize(); ++i)
        {
          const Particle* compareme = list->getParticle(i);
          const auto p_compare = frame.getMomentum(compareme);
          double angle = ROOT::Math::VectorUtil::Angle(p_compare, p_this);
          if (minAngle > angle) minAngle = angle;
        }
        return minAngle;
      };
      return func;
    }
 
    Manager::FunctionPtr closestInList(const std::vector<std::string>& arguments)
    {
      // expecting the list name and a variable name
      if (arguments.size() != 2)
        B2FATAL("Wrong number of arguments for meta function closestInList");
 
      std::string listname = arguments[0];
 
      // the requested variable and check it exists
      const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
 
      auto func = [listname, var](const Particle * particle) -> double {
        // get the list and check it's valid
        StoreObjPtr<ParticleList> list(listname);
        if (not list.isValid())
          B2FATAL("Invalid particle list name " << listname << " given to closestInList");
 
        // respect the current frame and get the momentum of our input
        const auto& frame = ReferenceFrame::GetCurrent();
        const auto p_this = frame.getMomentum(particle);
 
        // find the particle index with the smallest opening angle
        double minAngle = 2 * M_PI;
        int iClosest = -1;
        for (unsigned int i = 0; i < list->getListSize(); ++i)
        {
          const Particle* compareme = list->getParticle(i);
          const auto p_compare = frame.getMomentum(compareme);
          double angle = ROOT::Math::VectorUtil::Angle(p_compare, p_this);
          if (minAngle > angle) {
            minAngle = angle;
            iClosest = i;
          }
        }
 
        // final check that the list wasn't empty (or some other problem)
        if (iClosest == -1) return Const::doubleNaN;
        auto var_result = var->function(list->getParticle(iClosest));
        if (std::holds_alternative<double>(var_result))
        {
          return std::get<double>(var_result);
        } else if (std::holds_alternative<int>(var_result))
        {
          return std::get<int>(var_result);
        } else if (std::holds_alternative<bool>(var_result))
        {
          return std::get<bool>(var_result);
        } else return Const::doubleNaN;
      };
      return func;
    }
 
    Manager::FunctionPtr angleToMostB2BInList(const std::vector<std::string>& arguments)
    {
      // expecting the list name
      if (arguments.size() != 1)
        B2FATAL("Wrong number of arguments for meta function angleToMostB2BInList");
 
      std::string listname = arguments[0];
 
      auto func = [listname](const Particle * particle) -> double {
        // get the list and check it's valid
        StoreObjPtr<ParticleList> list(listname);
        if (not list.isValid())
          B2FATAL("Invalid particle list name " << listname << " given to angleToMostB2BInList");
 
        // check the list isn't empty
        if (list->getListSize() == 0)
          return Const::doubleNaN;
 
        // respect the current frame and get the momentum of our input
        const auto& frame = ReferenceFrame::GetCurrent();
        const auto p_this = frame.getMomentum(particle);
 
        // find the most back-to-back (the largest opening angle before they
        // start getting smaller again!)
        double maxAngle = 0;
        for (unsigned int i = 0; i < list->getListSize(); ++i)
        {
          const Particle* compareme = list->getParticle(i);
          const auto p_compare = frame.getMomentum(compareme);
          double angle = ROOT::Math::VectorUtil::Angle(p_compare, p_this);
          if (maxAngle < angle) maxAngle = angle;
        }
        return maxAngle;
      };
      return func;
    }
 
    Manager::FunctionPtr deltaPhiToMostB2BPhiInList(const std::vector<std::string>& arguments)
    {
      // expecting the list name
      if (arguments.size() != 1)
        B2FATAL("Wrong number of arguments for meta function deltaPhiToMostB2BPhiInList");
 
      std::string listname = arguments[0];
 
      auto func = [listname](const Particle * particle) -> double {
        // get the list and check it's valid
        StoreObjPtr<ParticleList> list(listname);
        if (not list.isValid())
          B2FATAL("Invalid particle list name " << listname << " given to deltaPhiToMostB2BPhiInList");
 
        // check the list isn't empty
        if (list->getListSize() == 0)
          return Const::doubleNaN;
 
        // respect the current frame and get the momentum of our input
        const auto& frame = ReferenceFrame::GetCurrent();
        const auto phi_this = frame.getMomentum(particle).Phi();
 
        // find the most back-to-back in phi (largest absolute value of delta phi)
        double maxAngle = 0;
        for (unsigned int i = 0; i < list->getListSize(); ++i)
        {
          const Particle* compareme = list->getParticle(i);
          const auto phi_compare = frame.getMomentum(compareme).Phi();
          double angle = std::abs(phi_compare - phi_this);
          if (angle > M_PI) {angle = 2 * M_PI - angle;}
          if (maxAngle < angle) maxAngle = angle;
        }
        return maxAngle;
      };
      return func;
    }
 
    Manager::FunctionPtr mostB2BInList(const std::vector<std::string>& arguments)
    {
      // expecting the list name and a variable name
      if (arguments.size() != 2)
        B2FATAL("Wrong number of arguments for meta function mostB2BInList");
 
      std::string listname = arguments[0];
 
      // the requested variable and check it exists
      const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
 
      auto func = [listname, var](const Particle * particle) -> double {
        // get the list and check it's valid
        StoreObjPtr<ParticleList> list(listname);
        if (not list.isValid())
          B2FATAL("Invalid particle list name " << listname << " given to mostB2BInList");
 
        // respect the current frame and get the momentum of our input
        const auto& frame = ReferenceFrame::GetCurrent();
        const auto p_this = frame.getMomentum(particle);
 
        // find the most back-to-back (the largest opening angle before they
        // start getting smaller again!)
        double maxAngle = -1.0;
        int iMostB2B = -1;
        for (unsigned int i = 0; i < list->getListSize(); ++i)
        {
          const Particle* compareme = list->getParticle(i);
          const auto p_compare = frame.getMomentum(compareme);
          double angle = ROOT::Math::VectorUtil::Angle(p_compare, p_this);
          if (maxAngle < angle) {
            maxAngle = angle;
            iMostB2B = i;
          }
        }
 
        // final check that the list wasn't empty (or some other problem)
        if (iMostB2B == -1) return Const::doubleNaN;
        auto var_result = var->function(list->getParticle(iMostB2B));
        if (std::holds_alternative<double>(var_result))
        {
          return std::get<double>(var_result);
        } else if (std::holds_alternative<int>(var_result))
        {
          return std::get<int>(var_result);
        } else if (std::holds_alternative<bool>(var_result))
        {
          return std::get<bool>(var_result);
        } else return Const::doubleNaN;
      };
      return func;
    }
 
    Manager::FunctionPtr maxOpeningAngleInList(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 1) {
        std::string listName = arguments[0];
        auto func = [listName](const Particle*) -> double {
          StoreObjPtr<ParticleList> listOfParticles(listName);
 
          if (!(listOfParticles.isValid())) B2FATAL("Invalid Listname " << listName << " given to maxOpeningAngleInList");
          int nParticles = listOfParticles->getListSize();
          // return NaN if number of particles is less than 2
          if (nParticles < 2) return Const::doubleNaN;
 
          const auto& frame = ReferenceFrame::GetCurrent();
          double maxOpeningAngle = -1;
          for (int i = 0; i < nParticles; i++)
          {
            ROOT::Math::PxPyPzEVector v1 = frame.getMomentum(listOfParticles->getParticle(i));
            for (int j = i + 1; j < nParticles; j++) {
              ROOT::Math::PxPyPzEVector v2 = frame.getMomentum(listOfParticles->getParticle(j));
              const double angle = ROOT::Math::VectorUtil::Angle(v1, v2);
              if (angle > maxOpeningAngle) maxOpeningAngle = angle;
            }
          }
          return maxOpeningAngle;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function maxOpeningAngleInList");
      }
    }
 
    Manager::FunctionPtr daughterCombination(const std::vector<std::string>& arguments)
    {
      // Expect 2 or more arguments.
      if (arguments.size() >= 2) {
        // First argument is the variable name
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
 
        // Core function: calculates a variable combining an arbitrary number of particles
        auto func = [var, arguments](const Particle * particle) -> double {
          if (particle == nullptr)
          {
            B2WARNING("Trying to access a daughter that does not exist. Skipping");
            return Const::doubleNaN;
          }
          const auto& frame = ReferenceFrame::GetCurrent();
 
          // Sum of the 4-momenta of all the selected daughters
          ROOT::Math::PxPyPzEVector pSum(0, 0, 0, 0);
 
          // Loop over the arguments. Each one of them is a generalizedIndex,
          // pointing to a particle in the decay tree.
          for (unsigned int iCoord = 1; iCoord < arguments.size(); iCoord++)
          {
            auto generalizedIndex = arguments[iCoord];
            const Particle* dauPart = particle->getParticleFromGeneralizedIndexString(generalizedIndex);
            if (dauPart)
              pSum +=  frame.getMomentum(dauPart);
            else {
              B2WARNING("Trying to access a daughter that does not exist. Index = " << generalizedIndex);
              return Const::doubleNaN;
            }
          }
 
          // Make a dummy particle out of the sum of the 4-momenta of the selected daughters
          Particle sumOfDaughters(pSum, 100); // 100 is one of the special numbers
 
          auto var_result = var->function(&sumOfDaughters);
          // Calculate the variable on the dummy particle
          if (std::holds_alternative<double>(var_result))
          {
            return std::get<double>(var_result);
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::get<int>(var_result);
          } else if (std::holds_alternative<bool>(var_result))
          {
            return std::get<bool>(var_result);
          } else return Const::doubleNaN;
        };
        return func;
      } else
        B2FATAL("Wrong number of arguments for meta function daughterCombination");
    }
 
    Manager::FunctionPtr useAlternativeDaughterHypothesis(const std::vector<std::string>& arguments)
    {
      /*
       `arguments` contains the variable to calculate and a list of colon-separated index-particle pairs.
       Overall, it looks like {"M", "0:K+", "1:p+", "3:e-"}.
       The code is thus divided in two parts:
       1) Parsing. A loop over the elements of `arguments` that first separates the variable from the rest, and then splits all the index:particle
          pairs, filling a std::vector with the indexes and another one with the new mass values.
       2) Replacing: A loop over the particle's daughters. We take the 4-momentum of each of them, recalculating it with a new mass if needed, and then we calculate
          the variable value using the sum of all the 4-momenta, both updated and non-updated ones.
      */
 
      // Expect 2 or more arguments.
      if (arguments.size() >= 2) {
 
        //----
        // 1) parsing
        //----
 
        // First argument is the variable name
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
 
        // Parses the other arguments, which are in the form of index:particleName pairs,
        // and stores indexes and pdgs in std::unordered_map
        std::unordered_map<unsigned int, int> mapOfReplacedDaughters;
 
        // Loop over the arguments to parse them
        for (unsigned int iCoord = 1; iCoord < arguments.size(); iCoord++) {
          auto replacedDauString = arguments[iCoord];
          // Split the string in index and new mass
          std::vector<std::string> indexAndMass;
          boost::split(indexAndMass, replacedDauString, boost::is_any_of(":"));
 
          // Checks that the index:particleName pair is properly formatted.
          if (indexAndMass.size() > 2) {
            B2WARNING("The string indicating which daughter's mass should be replaced contains more than two elements separated by a colon. Perhaps you tried to pass a generalized index, which is not supported yet for this variable. The offending string is "
                      << replacedDauString << ", while a correct syntax looks like 0:K+.");
            return nullptr;
          }
 
          if (indexAndMass.size() < 2) {
            B2WARNING("The string indicating which daughter's mass should be replaced contains only one colon-separated element instead of two. The offending string is "
                      << replacedDauString << ", while a correct syntax looks like 0:K+.");
            return nullptr;
          }
 
          // indexAndMass[0] is the daughter index as string. Try to convert it
          int dauIndex = 0;
          try {
            dauIndex = convertString<int>(indexAndMass[0]);
          } catch (std::invalid_argument&) {
            B2FATAL("Found the string " << indexAndMass[0] << "instead of a daughter index.");
          }
 
          // Determine PDG code  corresponding to indexAndMass[1] using the particle names defined in evt.pdl
          TParticlePDG* particlePDG = TDatabasePDG::Instance()->GetParticle(indexAndMass[1].c_str());
          if (!particlePDG) {
            B2WARNING("Particle not in evt.pdl file! " << indexAndMass[1]);
            return nullptr;
          }
 
          // Stores the indexes and the pdgs in the map that will be passed to the lambda function
          int pdgCode = particlePDG->PdgCode();
          mapOfReplacedDaughters[dauIndex] = pdgCode;
        } // End of parsing
 
        // Check the size of mapOfReplacedDaughters
        if (mapOfReplacedDaughters.size() != arguments.size() - 1)
          B2FATAL("Overlapped daughter's index is detected in the meta-variable useAlternativeDaughterHypothesis");
 
        //----
        // 2) replacing
        //----
 
        // Core function: creates a new particle from the original one changing
        // some of the daughters' masses
        auto func = [var, mapOfReplacedDaughters](const Particle * particle) -> double {
          if (particle == nullptr)
          {
            B2WARNING("Trying to access a particle that does not exist. Skipping");
            return Const::doubleNaN;
          }
 
          const auto& frame = ReferenceFrame::GetCurrent();
 
          // Create a dummy particle from the given particle to overwrite its kinematics
          Particle* dummy = ParticleCopy::copyParticle(particle);
 
          // Sum of the 4-momenta of all the daughters with the new mass assumptions
          ROOT::Math::PxPyPzMVector pSum(0, 0, 0, 0);
 
          for (unsigned int iDau = 0; iDau < particle->getNDaughters(); iDau++)
          {
            const Particle* dauPart = particle->getDaughter(iDau);
            if (not dauPart) {
              B2WARNING("Trying to access a daughter that does not exist. Index = " << iDau);
              return Const::doubleNaN;
            }
 
            ROOT::Math::PxPyPzMVector dauMom = ROOT::Math::PxPyPzMVector(frame.getMomentum(dauPart));
 
            int pdgCode;
            try {
              pdgCode = mapOfReplacedDaughters.at(iDau);
            } catch (std::out_of_range&) {
              // iDau is not in mapOfReplacedDaughters
              pSum += dauMom;
              continue;
            }
 
            // overwrite the daughter's kinematics
            double p_x = dauMom.Px();
            double p_y = dauMom.Py();
            double p_z = dauMom.Pz();
            dauMom.SetCoordinates(p_x, p_y, p_z, TDatabasePDG::Instance()->GetParticle(pdgCode)->Mass());
            const_cast<Particle*>(dummy->getDaughter(iDau))->set4VectorDividingByMomentumScaling(ROOT::Math::PxPyPzEVector(dauMom));
 
            // overwrite the daughter's pdg
            const int charge = dummy->getDaughter(iDau)->getCharge();
            if (TDatabasePDG::Instance()->GetParticle(pdgCode)->Charge() / 3.0 == charge)
              const_cast<Particle*>(dummy->getDaughter(iDau))->setPDGCode(pdgCode);
            else
              const_cast<Particle*>(dummy->getDaughter(iDau))->setPDGCode(-1 * pdgCode);
 
            pSum += dauMom;
          } // End of loop over number of daughter
 
          // overwrite the particle's kinematics
          dummy->set4Vector(ROOT::Math::PxPyPzEVector(pSum));
 
          auto var_result = var->function(dummy);
 
          // Calculate the variable on the dummy particle
          if (std::holds_alternative<double>(var_result))
          {
            return std::get<double>(var_result);
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::get<int>(var_result);
          } else if (std::holds_alternative<bool>(var_result))
          {
            return std::get<bool>(var_result);
          } else return Const::doubleNaN;
        }; // end of lambda function
        return func;
      }// end of check on number of arguments
      else
        B2FATAL("Wrong number of arguments for meta function useAlternativeDaughterHypothesis");
    }
 
    Manager::FunctionPtr varForFirstMCAncestorOfType(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        int pdg_code = -1;
        std::string arg = arguments[0];
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[1]);
        TParticlePDG* part = TDatabasePDG::Instance()->GetParticle(arg.c_str());
 
        if (part != nullptr) {
          pdg_code = std::abs(part->PdgCode());
        } else {
          try {
            pdg_code = convertString<int>(arg);
          } catch (const std::exception& e) {}
        }
 
        if (pdg_code == -1) {
          B2FATAL("Ancestor " + arg + " is not recognised. Please provide valid PDG code or particle name.");
        }
 
        auto func = [pdg_code, var](const Particle * particle) -> double {
          const Particle* p = particle;
 
          int ancestor_level = std::get<double>(Manager::Instance().getVariable("hasAncestor(" + std::to_string(pdg_code) + ", 0)")->function(p));
          if ((ancestor_level <= 0) or (std::isnan(ancestor_level)))
          {
            return Const::doubleNaN;
          }
 
          const MCParticle* i_p = p->getMCParticle();
 
          for (int a = 0; a < ancestor_level ; a = a + 1)
          {
            i_p = i_p->getMother();
          }
 
          StoreArray<Particle> tempParticles("tempParticles");
          tempParticles.clear();
          Particle m_p(i_p);
          Particle* newPart = tempParticles.appendNew(m_p);
          newPart->addRelationTo(i_p);
 
          appendDaughtersRecursive(newPart, tempParticles);
 
          auto var_result = var->function(newPart);
          if (std::holds_alternative<double>(var_result))
          {
            return std::get<double>(var_result);
          } else if (std::holds_alternative<int>(var_result))
          {
            return std::get<int>(var_result);
          } else if (std::holds_alternative<bool>(var_result))
          {
            return std::get<bool>(var_result);
          } else return Const::doubleNaN;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function varForFirstMCAncestorOfType (expected 2: type and variable of interest)");
      }
    }
 
    Manager::FunctionPtr varForNthDaughterOfType(const std::vector<std::string>& arguments)
    {
      if (arguments.size() > 4 || arguments.size() < 3) {
        B2FATAL("Number of arguments for varForNthDaughterOfType must be 3 or 4");
      }
      // Get abs pdg id
      std::string argPtype = arguments[0];
      TDatabasePDG* pdgDatabase = TDatabasePDG::Instance();
      TParticlePDG* part = pdgDatabase->GetParticle(argPtype.c_str());
      int absPdg = -1;
      if (part != nullptr) {
        absPdg = std::abs(part->PdgCode());
      } else {
        try {
          absPdg = std::abs(convertString<int>(argPtype));
        } catch (const std::exception&) { }
      }
      if (absPdg == -1 || pdgDatabase->GetParticle(absPdg) == nullptr) {
        B2FATAL("varForNthDaughterOfType: argument '" << argPtype << "' is neither a valid particle name nor a PDG code");
      }
      // Get particle index
      std::string argIndex = arguments[1];
      int index = 0;
      try {
        index = convertString<int>(argIndex);
      } catch (const std::exception&) { }
      if (index <= 0) {
        B2FATAL("varForNthDaughterOfType: argument '" << argIndex << "' is not a valid positive integer");
      }
      // Get variable
      const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[2]);
      // Get depth
      int depth = 1;
      if (arguments.size() == 4) {
        std::string argDepth = arguments[3];
        try {
          depth = convertString<int>(argDepth);
        } catch (const std::exception&) {
          depth = -1;
        }
        if (depth <= 0) {
          B2FATAL("varForNthDaughterOfType: argument '" << argDepth << "' is not a valid positive integer");
        }
      }
 
      auto func = [absPdg, index, var, depth](const Particle * particle) -> double {
        int nFound = 0;
        std::vector<Particle*> currentLevel = particle->getDaughters();
        std::vector<Particle*> nextLevel;
        for (int d = 0; d < depth; d++)
        {
          if (currentLevel.size() == 0) return Const::doubleNaN;
          for (unsigned i = 0; i < currentLevel.size(); i++) {
            Particle* p = currentLevel[i];
            if (std::abs(p->getPDGCode()) == absPdg) {
              nFound++;
              if (nFound == index) {
                auto result = var->function(p);
                if (std::holds_alternative<double>(result)) {
                  return std::get<double>(result);
                } else if (std::holds_alternative<int>(result)) {
                  return std::get<int>(result);
                } else if (std::holds_alternative<bool>(result)) {
                  return std::get<bool>(result);
                } else return Const::doubleNaN;
              }
            }
            std::vector<Particle*> newParticles = p->getDaughters();
            nextLevel.insert(nextLevel.end(), newParticles.begin(), newParticles.end());
          }
          currentLevel.clear();
          std::swap(currentLevel, nextLevel);
        }
        return Const::doubleNaN;
      };
 
      return func;
    }
 
    Manager::FunctionPtr nTrackFitResults(const std::vector<std::string>& arguments)
    {
      if (arguments.size() != 1) {
        B2FATAL("Number of arguments for nTrackFitResults must be 1, particleType or PDGcode");
      }
 
      std::string arg = arguments[0];
      TDatabasePDG* pdgDatabase = TDatabasePDG::Instance();
      TParticlePDG* part = pdgDatabase->GetParticle(arg.c_str());
      int absPdg = 0;
      if (part != nullptr) {
        absPdg = std::abs(part->PdgCode());
      } else {
        try {
          absPdg = std::abs(convertString<int>(arg));
        } catch (const std::exception&) {
          absPdg = 0;
        }
 
        if (absPdg == 0 || pdgDatabase->GetParticle(absPdg) == nullptr) {
          B2FATAL("nTrackFitResults: argument '" << arg << "' is neither a valid particle name nor a PDG code");
        }
      }
 
      auto func = [absPdg](const Particle*) -> int {
 
        Const::ChargedStable type(absPdg);
        StoreArray<Track> tracks;
 
        int nTrackFitResults = 0;
 
        for (const auto& track : tracks)
        {
          const TrackFitResult* trackFit = track.getTrackFitResultWithClosestMass(type);
 
          if (!trackFit) continue;
          if (trackFit->getChargeSign() == 0) continue;
 
          nTrackFitResults++;
        }
 
        return nTrackFitResults;
 
      };
      return func;
    }
 
 
    Manager::FunctionPtr convertToInt(const std::vector<std::string>& arguments)
    {
      if (arguments.size() == 2) {
        const Variable::Manager::Var* var = Manager::Instance().getVariable(arguments[0]);
        int default_val = convertString<int>(arguments[1]);
        auto func = [var, default_val](const Particle * particle) -> int {
          auto var_result = var->function(particle);
          if (std::holds_alternative<double>(var_result))
          {
            double value = std::get<double>(var_result);
            if (value > std::numeric_limits<int>::max())
              value = std::numeric_limits<int>::max();
            if (value < std::numeric_limits<int>::min())
              value = std::numeric_limits<int>::min();
            if (std::isnan(value))
              value = default_val;
            return static_cast<int>(value);
          } else if (std::holds_alternative<int>(var_result))
            return std::get<int>(var_result);
          else if (std::holds_alternative<bool>(var_result))
            return static_cast<int>(std::get<bool>(var_result));
          else return default_val;
        };
        return func;
      } else {
        B2FATAL("Wrong number of arguments for meta function int, please provide variable name and replacement value for NaN!");
      }
    }
 
    VARIABLE_GROUP("MetaFunctions");
    REGISTER_METAVARIABLE("nCleanedECLClusters(cut)", nCleanedECLClusters,
                          "[Eventbased] Returns the number of clean Clusters in the event\n"
                          "Clean clusters are defined by the clusters which pass the given cut assuming a photon hypothesis.",
                          Manager::VariableDataType::c_int);
    REGISTER_METAVARIABLE("nCleanedTracks(cut)", nCleanedTracks,
                          "[Eventbased] Returns the number of clean Tracks in the event\n"
                          "Clean tracks are defined by the tracks which pass the given cut assuming a pion hypothesis.", Manager::VariableDataType::c_int);
    REGISTER_METAVARIABLE("formula(v1 + v2 * [v3 - v4] / v5^v6)", formula, R"DOCSTRING(
Returns the result of the given formula, where v1 to vN are variables or floating
point numbers. Currently the only supported operations are addition (``+``),
subtraction (``-``), multiplication (``*``), division (``/``) and power (``^``
or ``**``). Parenthesis can be in the form of square brackets ``[v1 * v2]``
or normal brackets ``(v1 * v2)``. It will work also with variables taking
arguments. Operator precedence is taken into account. For example ::
 
    (daughter(0, E) + daughter(1, E))**2 - p**2 + 0.138
 
.. versionchanged:: release-03-00-00
   now both, ``[]`` and ``()`` can be used for grouping operations, ``**`` can
   be used for exponent and float literals are possible directly in the
   formula.
)DOCSTRING", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("useRestFrame(variable)", useRestFrame,
                      "Returns the value of the variable using the rest frame of the given particle as current reference frame.\n"
                      "E.g. ``useRestFrame(daughter(0, p))`` returns the total momentum of the first daughter in its mother's rest-frame", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("useCMSFrame(variable)", useCMSFrame,
                      "Returns the value of the variable using the CMS frame as current reference frame.\n"
                      "E.g. ``useCMSFrame(E)`` returns the energy of a particle in the CMS frame.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("useLabFrame(variable)", useLabFrame, R"DOC(
Returns the value of ``variable`` in the *lab* frame.
 
.. tip::
    The lab frame is the default reference frame, usually you don't need to use this meta-variable.
    E.g. ``useLabFrame(E)`` returns the energy of a particle in the Lab frame, same as just ``E``.
 
Specifying the lab frame is useful in some corner-cases. For example:
``useRestFrame(daughter(0, formula(E - useLabFrame(E))))`` which is the difference of the first daughter's energy in the rest frame of the mother (current particle) with the same daughter's lab-frame energy.
)DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("useTagSideRecoilRestFrame(variable, daughterIndexTagB)", useTagSideRecoilRestFrame,
                      "Returns the value of the variable in the rest frame of the recoiling particle to the tag side B meson.\n"
                      "The variable should only be applied to an Upsilon(4S) list.\n"
                      "E.g. ``useTagSideRecoilRestFrame(daughter(1, daughter(1, p)), 0)`` applied on a Upsilon(4S) list (``Upsilon(4S)->B+:tag B-:sig``) returns the momentum of the second daughter of the signal B meson in the signal B meson rest frame.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("useParticleRestFrame(variable, particleList)", useParticleRestFrame,
                      "Returns the value of the variable in the rest frame of the first Particle contained in the given ParticleList.\n"
          "It is strongly recommended to pass a ParticleList that contains at most only one Particle in each event. "
          "When more than one Particle is present in the ParticleList, only the first Particle in the list is used for "
          "computing the rest frame and a warning is thrown. If the given ParticleList is empty in an event, it returns NaN.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("useRecoilParticleRestFrame(variable, particleList)", useRecoilParticleRestFrame,
                      "Returns the value of the variable in the rest frame of recoil system against the first Particle contained in the given ParticleList.\n"
          "It is strongly recommended to pass a ParticleList that contains at most only one Particle in each event. "
          "When more than one Particle is present in the ParticleList, only the first Particle in the list is used for "
          "computing the rest frame and a warning is thrown. If the given ParticleList is empty in an event, it returns NaN.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("useDaughterRestFrame(variable, daughterIndex_1[, daughterIndex_2, ... daughterIndex_3])", useDaughterRestFrame,
                      "Returns the value of the variable in the rest frame of the selected daughter particle.\n"
          "The daughter is identified via generalized daughter index, e.g. ``0:1`` identifies the second daughter (1) "
          "of the first daughter (0). If the daughter index is invalid, it returns NaN.\n"
          "If two or more indices are given, the rest frame of the sum of the daughters is used. "
          "By default only ``daughterIndex_1`` is given, in which case the rest frame of that single daughter is used.",
          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("useDaughterRecoilRestFrame(variable, daughterIndex_1[, daughterIndex_2, ... daughterIndex_3])", useDaughterRecoilRestFrame,
                      "Returns the value of the variable in the rest frame of the recoil of the selected daughter particle.\n"
          "The daughter is identified via generalized daughter index, e.g. ``0:1`` identifies the second daughter (1) "
          "of the first daughter (0). If the daughter index is invalid, it returns NaN.\n"
          "If two or more indices are given, the rest frame of the sum of the daughters is used. "
          "By default only ``daughterIndex_1`` is given, in which case the recoil rest frame of that single daughter is used.",
          Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("useMCancestorBRestFrame(variable)", useMCancestorBRestFrame,
                      "Returns the value of the variable in the rest frame of the ancestor B MC particle.\n"
                      "If no B or no MC-matching is found, it returns NaN.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("passesCut(cut)", passesCut,
                      "Returns 1 if particle passes the cut otherwise 0.\n"
                      "Useful if you want to write out if a particle would have passed a cut or not.", Manager::VariableDataType::c_bool);
    REGISTER_METAVARIABLE("passesEventCut(cut)", passesEventCut,
                      "[Eventbased] Returns 1 if event passes the cut otherwise 0.\n"
                      "Useful if you want to select events passing a cut without looping into particles, such as for skimming.\n", Manager::VariableDataType::c_bool);
    REGISTER_METAVARIABLE("countDaughters(cut)", countDaughters,
                      "Returns number of direct daughters which satisfy the cut.\n"
                      "Used by the skimming package (for what exactly?)", Manager::VariableDataType::c_int);
    REGISTER_METAVARIABLE("countFSPDaughters(cut)", countDescendants,
        "Returns number of final-state daughters which satisfy the cut.",
        Manager::VariableDataType::c_int);
    REGISTER_METAVARIABLE("countDescendants(cut)", countDescendants,
        "Returns number of descendants for all generations which satisfy the cut.",
        Manager::VariableDataType::c_int);
    REGISTER_METAVARIABLE("varFor(pdgCode, variable)", varFor,
                      "Returns the value of the variable for the given particle if its abs(pdgCode) agrees with the given one.\n"
                      "E.g. ``varFor(11, p)`` returns the momentum if the particle is an electron or a positron.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("varForMCGen(variable)", varForMCGen,
                      "Returns the value of the variable for the given particle if the MC particle related to it is primary, not virtual, and not initial.\n"
                      "If no MC particle is related to the given particle, or the MC particle is not primary, virtual, or initial, NaN will be returned.\n"
                      "E.g. ``varForMCGen(PDG)`` returns the PDG code of the MC particle related to the given particle if it is primary, not virtual, and not initial.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("nParticlesInList(particleListName)", nParticlesInList,
                      "[Eventbased] Returns number of particles in the given particle List.", Manager::VariableDataType::c_int);
    REGISTER_METAVARIABLE(
      "nParticlesInCone(particleListName, halfAngleDegrees, cut='')",
      nParticlesInCone,
      R"DOC(
Counts distinct reconstructed final-state particles from Tracks, ECLClusters,
or KLMClusters within a cone around this particle in the e+e- centre-of-mass
frame. The half-angle is in degrees (0 to 180). The optional cut applies to
particles in particleListName. A particle sharing the central particle's MDST
source is excluded; each MDST source is counted at most once. An empty list
gives zero. Returns NaN if the central particle has an unsupported source or
invalid momentum.
)DOC",
      Manager::VariableDataType::c_double);
 
    REGISTER_METAVARIABLE("isInList(particleListName)", isInList,
                      "Returns 1 if the particle is in the list provided, 0 if not. Note that this only checks the particle given. For daughters of composite particles, please see :b2:var:`isDaughterOfList`.", Manager::VariableDataType::c_bool);
    REGISTER_METAVARIABLE("isDaughterOfList(particleListNames)", isDaughterOfList,
                      "Returns 1 if the given particle is a daughter of at least one of the particles in the given particle Lists.", Manager::VariableDataType::c_bool);
    REGISTER_METAVARIABLE("isDescendantOfList(particleListName[, anotherParticleListName, ..., generationFlag])", isDescendantOfList, R"DOC(
                      Returns 1 if the given particle appears in the decay chain of the particles in the given ParticleLists.
 
                      Passing an integer as the last argument, allows to check if the particle belongs to the specific generation:
 
                      * ``isDescendantOfList(<particle_list>,1)`` returns 1 if particle is a daughter of the list,
                      * ``isDescendantOfList(<particle_list>,2)`` returns 1 if particle is a granddaughter of the list,
                      * ``isDescendantOfList(<particle_list>,3)`` returns 1 if particle is a great-granddaughter of the list, etc.
                      * Default value is ``-1`` that is inclusive for all generations.
                      )DOC", Manager::VariableDataType::c_bool);
    REGISTER_METAVARIABLE("isMCDescendantOfList(particleListName[, anotherParticleListName, ..., generationFlag])", isMCDescendantOfList, R"DOC(
                      Returns 1 if the given particle is linked to the same MC particle as any reconstructed daughter of the decay lists.
 
                      Passing an integer as the last argument, allows to check if the particle belongs to the specific generation:
 
                      * ``isMCDescendantOfList(<particle_list>,1)`` returns 1 if particle is matched to the same particle as any daughter of the list,
                      * ``isMCDescendantOfList(<particle_list>,2)`` returns 1 if particle is matched to the same particle as any granddaughter of the list,
                      * ``isMCDescendantOfList(<particle_list>,3)`` returns 1 if particle is matched to the same particle as any great-granddaughter of the list, etc.
                      * Default value is ``-1`` that is inclusive for all generations.
 
                      It makes only sense for lists created with `fillParticleListFromMC` function with ``addDaughters=True`` argument.
                      )DOC", Manager::VariableDataType::c_bool);
 
    REGISTER_METAVARIABLE("sourceObjectIsInList(particleListName)", sourceObjectIsInList, R"DOC(
Returns 1 if the underlying mdst object (e.g. track, or cluster) was used to create a particle in ``particleListName``, 0 if not. 
 
.. note::
  This only makes sense for particles that are not composite. Returns -1 for composite particles.
)DOC", Manager::VariableDataType::c_int);
 
    REGISTER_METAVARIABLE("mcParticleIsInMCList(particleListName)", mcParticleIsInMCList, R"DOC(
Returns 1 if the particle's matched MC particle is also matched to a particle in ``particleListName`` 
(or if either of the lists were filled from generator level `modularAnalysis.fillParticleListFromMC`.)
 
.. seealso:: :b2:var:`isMCDescendantOfList` to check daughters.
)DOC", Manager::VariableDataType::c_bool);
 
    REGISTER_METAVARIABLE("isGrandDaughterOfList(particleListNames)", isGrandDaughterOfList,
                      "Returns 1 if the given particle is a grand daughter of at least one of the particles in the given particle Lists.", Manager::VariableDataType::c_bool);
    REGISTER_METAVARIABLE("originalParticle(variable)", originalParticle, R"DOC(
                      Returns value of variable for the original particle from which the given particle is copied.
 
                      The copy of particle is created, for example, when the vertex fit updates the daughters and `modularAnalysis.copyParticles` is called.
                      Returns NaN if the given particle is not copied and so there is no original particle.
                      )DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("daughter(i, variable)", daughter, R"DOC(
                      Returns value of variable for the i-th daughter. E.g.
 
                      * ``daughter(0, p)`` returns the total momentum of the first daughter.
                      * ``daughter(0, daughter(1, p)`` returns the total momentum of the second daughter of the first daughter.
 
                      Returns NaN if particle is nullptr or if the given daughter-index is out of bound (>= amount of daughters).
                      )DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("originalDaughter(i, variable)", originalDaughter, R"DOC(
                      Returns value of variable for the original particle from which the i-th daughter is copied.
 
                      The copy of particle is created, for example,  when the vertex fit updates the daughters and `modularAnalysis.copyParticles` is called.
                      Returns NaN if the daughter is not copied and so there is no original daughter.
 
                      Returns NaN if particle is nullptr or if the given daughter-index is out of bound (>= amount of daughters).
                      )DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("mcDaughter(i, variable)", mcDaughter, R"DOC(
                      Returns the value of the requested variable for the i-th Monte Carlo daughter of the particle.
 
                      Returns NaN if the particle is nullptr, if the particle is not matched to an MC particle,
                      or if the i-th MC daughter does not exist.
 
                      E.g. ``mcDaughter(0, PDG)`` will return the PDG code of the first MC daughter of the matched MC
                      particle of the reconstructed particle the function is applied to.
 
                      The meta variable can also be nested: ``mcDaughter(0, mcDaughter(1, PDG))``.
                      )DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("mcMother(variable)", mcMother, R"DOC(
                      Returns the value of the requested variable for the Monte Carlo mother of the particle.
 
                      Returns NaN if the particle is nullptr, if the particle is not matched to an MC particle,
                      or if the MC mother does not exist.
 
                      E.g. ``mcMother(PDG)`` will return the PDG code of the MC mother of the matched MC
                      particle of the reconstructed particle the function is applied to.
 
                      The meta variable can also be nested: ``mcMother(mcMother(PDG))``.
                      )DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("genParticle(index, variable)", genParticle,  R"DOC(
[Eventbased] Returns the ``variable`` for the ith generator particle.
The arguments of the function must be the ``index`` of the particle in the MCParticle Array,
and ``variable``, the name of the function or variable for that generator particle.
If ``index`` goes beyond the length of the MCParticles array, NaN will be returned.
 
E.g. ``genParticle(0, p)`` returns the total momentum of the first MCParticle, which in a generic decay up to MC15 is
the Upsilon(4S) and for MC16 and beyond the initial electron.
)DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("genUpsilon4S(variable)", genUpsilon4S, R"DOC(
[Eventbased] Returns the ``variable`` evaluated for the generator-level :math:`\Upsilon(4S)`.
If no generator level :math:`\Upsilon(4S)` exists for the event, NaN will be returned.
 
E.g. ``genUpsilon4S(p)`` returns the total momentum of the :math:`\Upsilon(4S)` in a generic decay.
``genUpsilon4S(mcDaughter(1, p))`` returns the total momentum of the second daughter of the
generator-level :math:`\Upsilon(4S)` (i.e. the momentum of the second B meson in a generic decay).
)DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("daughterProductOf(variable)", daughterProductOf,
                      "Returns product of a variable over all daughters.\n"
                      "E.g. ``daughterProductOf(extraInfo(SignalProbability))`` returns the product of the SignalProbabilitys of all daughters.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("daughterSumOf(variable)", daughterSumOf,
                      "Returns sum of a variable over all daughters.\n"
                      "E.g. ``daughterSumOf(nDaughters)`` returns the number of grand-daughters.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("daughterLowest(variable)", daughterLowest,
                      "Returns the lowest value of the given variable among all daughters.\n"
                      "E.g. ``useCMSFrame(daughterLowest(p))`` returns the lowest momentum in CMS frame.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("daughterHighest(variable)", daughterHighest,
                      "Returns the highest value of the given variable among all daughters.\n"
                      "E.g. ``useCMSFrame(daughterHighest(p))`` returns the highest momentum in CMS frame.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("daughterDiffOf(daughterIndex_i, daughterIndex_j, variable)", daughterDiffOf, R"DOC(
                       Returns the difference of a variable between the two given daughters.
                       E.g. ``useRestFrame(daughterDiffOf(0, 1, p))`` returns the momentum difference between first and second daughter in the rest frame of the given particle.
                       (That means that it returns :math:`p_j - p_i`)
 
                       The daughters can be provided as generalized daughter indexes, which are simply colon-separated
                       lists of daughter indexes, ordered starting from the root particle. For example, ``0:1``
                       identifies the second daughter (1) of the first daughter (0) of the mother particle.
 
                       )DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("mcDaughterDiffOf(i, j, variable)", mcDaughterDiffOf,
                      "MC matched version of the `daughterDiffOf` function.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("grandDaughterDiffOf(i, j, variable)", grandDaughterDiffOf,
                      "Returns the difference of a variable between the first daughters of the two given daughters.\n"
                      "E.g. ``useRestFrame(grandDaughterDiffOf(0, 1, p))`` returns the momentum difference between the first daughters of the first and second daughter in the rest frame of the given particle.\n"
                      "(That means that it returns :math:`p_j - p_i`)", Manager::VariableDataType::c_double);
    MAKE_DEPRECATED("grandDaughterDiffOf", false, "light-2402-ocicat", R"DOC(
                     The difference between any combination of (grand-)daughters can be calculated with the more general variable :b2:var:`daughterDiffOf`
                     by using generalized daughter indexes.)DOC");
    REGISTER_METAVARIABLE("daughterNormDiffOf(i, j, variable)", daughterNormDiffOf,
                      "Returns the normalized difference of a variable between the two given daughters.\n"
                      "E.g. ``daughterNormDiffOf(0, 1, p)`` returns the normalized momentum difference between first and second daughter in the lab frame.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("daughterMotherDiffOf(i, variable)", daughterMotherDiffOf,
                      "Returns the difference of a variable between the given daughter and the mother particle itself.\n"
                      "E.g. ``useRestFrame(daughterMotherDiffOf(0, p))`` returns the momentum difference between the given particle and its first daughter in the rest frame of the mother.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("daughterMotherNormDiffOf(i, variable)", daughterMotherNormDiffOf,
                      "Returns the normalized difference of a variable between the given daughter and the mother particle itself.\n"
                      "E.g. ``daughterMotherNormDiffOf(1, p)`` returns the normalized momentum difference between the given particle and its second daughter in the lab frame.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("angleBetweenDaughterAndRecoil(daughterIndex_1, daughterIndex_2, ... )", angleBetweenDaughterAndRecoil, R"DOC(
                       Returns the angle between the momentum recoiling against the particle and the sum of the momenta of the given daughters.
                       The unit of the angle is ``rad``.
 
                       The particles are identified via generalized daughter indexes, which are simply colon-separated lists of
                       daughter indexes, ordered starting from the root particle. For example, ``0:1:3``  identifies the fourth
                       daughter (3) of the second daughter (1) of the first daughter (0) of the mother particle. ``1`` simply
                       identifies the second daughter of the root particle.
 
                       At least one generalized index has to be given to ``angleBetweenDaughterAndRecoil``. 
 
                       .. tip::
                           ``angleBetweenDaughterAndRecoil(0)`` will return the angle between pRecoil and the momentum of the first daughter.
 
                           ``angleBetweenDaughterAndRecoil(0, 1)`` will return the angle between pRecoil and the sum of the momenta of the first and second daughter.
 
                           ``angleBetweenDaughterAndRecoil(0:0, 3:0)`` will return the angle between pRecoil and the sum of the momenta of the: first daughter of the first daughter, and
                           the first daughter of the fourth daughter.)DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("angleBetweenDaughterAndMissingMomentum(daughterIndex_1, daughterIndex_2, ... )", angleBetweenDaughterAndMissingMomentum, R"DOC(
                      Returns the angle between the missing momentum in the event and the sum of the momenta of the given daughters.
                      The unit of the angle is ``rad``. EventKinematics module has to be called to use this.
 
                      The particles are identified via generalized daughter indexes, which are simply colon-separated lists of
                      daughter indexes, ordered starting from the root particle. For example, ``0:1:3``  identifies the fourth
                      daughter (3) of the second daughter (1) of the first daughter (0) of the mother particle. ``1`` simply
                      identifies the second daughter of the root particle.
 
                      At least one generalized index has to be given to ``angleBetweenDaughterAndMissingMomentum``. 
 
                      .. tip::
                          ``angleBetweenDaughterAndMissingMomentum(0)`` will return the angle between missMom and the momentum of the first daughter.
 
                          ``angleBetweenDaughterAndMissingMomentum(0, 1)`` will return the angle between missMom and the sum of the momenta of the first and second daughter.
 
                          ``angleBetweenDaughterAndMissingMomentum(0:0, 3:0)`` will return the angle between missMom and the sum of the momenta of the: first daughter of the first daughter, and
                          the first daughter of the fourth daughter.)DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("daughterAngle(daughterIndex_1, daughterIndex_2[, daughterIndex_3])", daughterAngle, R"DOC(
                       Returns the angle in between any pair of particles belonging to the same decay tree.
                       The unit of the angle is ``rad``.
 
                       The particles are identified via generalized daughter indexes, which are simply colon-separated lists of
                       daughter indexes, ordered starting from the root particle. For example, ``0:1:3``  identifies the fourth
                       daughter (3) of the second daughter (1) of the first daughter (0) of the mother particle. ``1`` simply
                       identifies the second daughter of the root particle.
 
                       Both two and three generalized indexes can be given to ``daughterAngle``. By default two indices are given, in
                       which case the variable returns the angle between the momenta of the two given particles. If three indices are given, the
                       variable returns the angle between the momentum of the third particle and a vector which is the sum of the
                       first two daughter momenta.
 
                       .. tip::
                           ``daughterAngle(0, 3)`` will return the angle between the first and fourth daughter.
                           ``daughterAngle(0, 1, 3)`` will return the angle between the fourth daughter and the sum of the first and
                           second daughter.
                           ``daughterAngle(0:0, 3:0)`` will return the angle between the first daughter of the first daughter, and
                           the first daughter of the fourth daughter.
 
                      )DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("mcDaughterAngle(daughterIndex_1, daughterIndex_2[, daughterIndex_3])", mcDaughterAngle,
                      "MC matched version of the `daughterAngle` function. Also works if applied directly to MC particles. "
                      "As for `daughterAngle`, by default two indices are given and the angle between the momenta of the two given particles is returned; "
                      "if a third index is given, the angle between the momentum of the third particle and the sum of the first two daughter momenta is returned. "
                      "The unit of the angle is ``rad``", Manager::VariableDataType::c_double);
    REGISTER_VARIABLE("grandDaughterDecayAngle(i, j)", grandDaughterDecayAngle,
                      "Returns the decay angle of the granddaughter in the daughter particle's rest frame.\n"
                      "It is calculated with respect to the reverted momentum vector of the particle.\n"
                      "Two arguments representing the daughter and granddaughter indices have to be provided as arguments.\n\n", "rad");
    REGISTER_VARIABLE("daughterClusterAngleInBetween(i, j)", daughterClusterAngleInBetween,
                      "Returns the angle between clusters associated to the two daughters."
                      "If two indices given: returns the angle between the momenta of the clusters associated to the two given daughters."
                      "If three indices given: returns the angle between the momentum of the third particle's cluster and a vector "
                      "which is the sum of the first two daughter's cluster momenta."
                      "Returns nan if any of the daughters specified don't have an associated cluster."
                      "The arguments in the argument vector must be integers corresponding to the ith and jth (and kth) daughters.\n\n", "rad");
    REGISTER_METAVARIABLE("daughterInvM(i[, j, ...])", daughterInvM, R"DOC(
                       Returns the invariant mass adding the Lorentz vectors of the given daughters. The unit of the invariant mass is GeV/:math:`\text{c}^2`
                       E.g. ``daughterInvM(0, 1, 2)`` returns the invariant Mass :math:`m = \sqrt{(p_0 + p_1 + p_2)^2}` of the first, second and third daughter.
                       At least the first index ``i`` is required; by default no further indices are given, in which case the mass of the single given daughter is returned.
 
                       Daughters from different generations of the decay tree can be combined using generalized daughter indexes,
                       which are simply colon-separated daughter indexes for each generation, starting from the root particle. For
                       example, ``0:1:3`` identifies the fourth daughter (3) of the second daughter (1) of the first daughter(0) of
                       the mother particle.
 
                       Returns NaN if the given daughter-index is out of bound (>= number of daughters))DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("extraInfo(name)", extraInfo,
                      "Returns extra info stored under the given name.\n"
                      "The extraInfo has to be set by a module first.\n"
                      "E.g. ``extraInfo(SignalProbability)`` returns the SignalProbability calculated by the ``MVAExpert`` module.\n"
                      "If nothing is set under the given name or if the particle is a nullptr, NaN is returned.\n"
                      "In the latter case please use `eventExtraInfo` if you want to access an EventExtraInfo variable.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("eventExtraInfo(name)", eventExtraInfo,
                      "[Eventbased] Returns extra info stored under the given name in the event extra info.\n"
                      "The extraInfo has to be set first by another module like MVAExpert in event mode.\n"
                      "If nothing is set under this name, NaN is returned.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("eventCached(variable)", eventCached,
                      "[Eventbased] Returns value of event-based variable and caches this value in the EventExtraInfo.\n"
                      "The result of second call to this variable in the same event will be provided from the cache.\n"
                      "It is recommended to use this variable in order to declare custom aliases as event-based. This is "
                      "necessary if using the eventwise mode of variablesToNtuple).", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("particleCached(variable)", particleCached,
                      "Returns value of given variable and caches this value in the ParticleExtraInfo of the provided particle.\n"
                      "The result of second call to this variable on the same particle will be provided from the cache.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("modulo(variable, n)", modulo,
                      "Returns rest of division of variable by n.", Manager::VariableDataType::c_int);
    REGISTER_METAVARIABLE("abs(variable)", abs,
                      "Returns absolute value of the given variable.\n"
                      "E.g. abs(mcPDG) returns the absolute value of the mcPDG, which is often useful for cuts.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("max(var1,var2)", max, "Returns max value of two variables.\n", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("min(var1,var2)", min, "Returns min value of two variables.\n", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("sin(variable)", sin, "Returns sine value of the given variable.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("asin(variable)", asin, "Returns arcsine of the given variable. The unit of the asin() is ``rad``", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("cos(variable)", cos, "Returns cosine value of the given variable.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("acos(variable)", acos, "Returns arccosine value of the given variable. The unit of the acos() is ``rad``", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("tan(variable)", tan, "Returns tangent value of the given variable.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("atan(variable)", atan, "Returns arctangent value of the given variable. The unit of the atan() is ``rad``", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("atan2(variableY, variableX)", atan2, "Returns the atan2 value (arctangent of y/x). The result is in ``rad``, and the correct quadrant is determined by the signs of the two arguments. Both arguments must not be zero at the same time.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("exp(variable)", exp, "Returns exponential evaluated for the given variable.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("log(variable)", log, "Returns natural logarithm evaluated for the given variable.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("log10(variable)", log10, "Returns base-10 logarithm evaluated for the given variable.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("int(variable, nan_replacement)", convertToInt, R"DOC(
                      Casts the output of the variable to an integer value. 
 
                      .. note::
                        Overflow and underflow are clipped at maximum and minimum values, respectively. NaN values are replaced with the value of the 2nd argument.
 
                      )DOC",  Manager::VariableDataType::c_int);
    REGISTER_METAVARIABLE("isNAN(variable)", isNAN,
                      "Returns true if variable value evaluates to nan (determined via std::isnan(double)).\n"
                      "Useful for debugging.", Manager::VariableDataType::c_bool);
    REGISTER_METAVARIABLE("ifNANgiveX(variable, x)", ifNANgiveX,
                      "Returns x (has to be a number) if variable value is nan (determined via std::isnan(double)).\n"
                      "Useful for technical purposes while training MVAs.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("isInfinity(variable)", isInfinity,
                      "Returns true if variable value evaluates to infinity (determined via std::isinf(double)).\n"
                      "Useful for debugging.", Manager::VariableDataType::c_bool);
    REGISTER_METAVARIABLE("unmask(variable, flag1, flag2, ...)", unmask,
                      "unmask(variable, flag1, flag2, ...) or unmask(variable, mask) sets certain bits in the variable to zero.\n"
                      "For example, if you want to set the second, fourth and fifth bits to zero, you could call \n"
                      "``unmask(variable, 2, 8, 16)`` or ``unmask(variable, 26)``.\n"
                      "", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("conditionalVariableSelector(cut, variableIfTrue, variableIfFalse)", conditionalVariableSelector,
                      "Returns one of the two supplied variables, depending on whether the particle passes the supplied cut.\n"
                      "The first variable is returned if the particle passes the cut, and the second variable is returned otherwise.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pValueCombination(p1, p2, ...)", pValueCombination,
                      "Returns the combined p-value of the provided p-values according to the formula given in `Nucl. Instr. and Meth. A 411 (1998) 449 <https://doi.org/10.1016/S0168-9002(98)00293-9>`_ .\n"
                      "If any of the p-values is invalid, i.e. smaller than zero, -1 is returned.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("pValueCombinationOfDaughters(variable)", pValueCombinationOfDaughters,
                      "Returns the combined p-value of the daughter p-values according to the formula given in `Nucl. Instr. and Meth. A 411 (1998) 449 <https://doi.org/10.1016/S0168-9002(98)00293-9>`_ .\n"
                      "If any of the p-values is invalid, i.e. smaller than zero, -1 is returned.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("veto(particleList, cut[, pdgCode])", veto,
                      "Combines current particle with particles from the given particle list and returns 1 if the combination passes the provided cut. \n"
                      "For instance one can apply this function on a signal Photon and provide a list of all photons in the rest of event and a cut \n"
                      "around the neutral Pion mass (e.g. ``0.130 < M < 0.140``). \n"
                      "If a combination of the signal Photon with a ROE photon fits this criteria, hence looks like a neutral pion, the veto-Metavariable will return 1 \n"
                      "The default value of ``pdgCode`` is 11 (electron).", Manager::VariableDataType::c_bool);
    REGISTER_METAVARIABLE("matchedMC(variable)", matchedMC,
                      "Returns variable output for the matched MCParticle by constructing a temporary Particle from it.\n"
                      "This may not work too well if your variable requires accessing daughters of the particle.\n"
                      "E.g. ``matchedMC(p)`` returns the total momentum of the related MCParticle.\n"
                      "Returns NaN if no matched MCParticle exists.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("clusterBestMatchedMCParticle(variable)", clusterBestMatchedMCParticle,
                      "Returns variable output for the MCParticle that is best-matched with the ECLCluster of the given Particle.\n"
                      "E.g. To get the energy of the MCParticle that matches best with an ECLCluster, one could use ``clusterBestMatchedMCParticle(E)``\n"
                      "When the variable is called for ``gamma`` and if the ``gamma`` is matched with MCParticle, it works same as `matchedMC`.\n"
                      "If the variable is called for ``gamma`` that fails to match with an MCParticle, it provides the mdst-level MCMatching information abouth the ECLCluster.\n"
                      "Returns NaN if the particle is not matched to an ECLCluster, or if the ECLCluster has no matching MCParticles", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("varForBestMatchedMCKlong(variable)", clusterBestMatchedMCKlong,
                      "Returns variable output for the Klong MCParticle which has the best match with the ECLCluster of the given Particle.\n"
                      "Returns NaN if the particle is not matched to an ECLCluster, or if the ECLCluster has no matching Klong MCParticle", Manager::VariableDataType::c_double);
 
    REGISTER_METAVARIABLE("countInList(particleList[, cut])", countInList, "[Eventbased] "
                      "Returns number of particle which pass given in cut in the specified particle list.\n"
                      "Useful for creating statistics about the number of particles in a list.\n"
                      "E.g. ``countInList(e+, isSignal == 1)`` returns the number of correctly reconstructed electrons in the event.\n"
                      "The default value of ``cut`` is an empty string, so all particles in the list are counted.\n"
                      "The variable is event-based and does not need a valid particle pointer as input.", Manager::VariableDataType::c_int);
    REGISTER_METAVARIABLE("getVariableByRank(particleList, rankedVariableName, variableName, rank)", getVariableByRank, R"DOC(
                      [Eventbased] Returns the value of ``variableName`` for the candidate in the ``particleList`` with the requested ``rank``.
 
                      .. note::
                        The `BestCandidateSelection` module available via `rankByHighest` / `rankByLowest` has to be used before.
 
                      .. warning::
                        The first candidate matching the given rank is used.
                        Thus, it is not recommended to use this variable in conjunction with ``allowMultiRank`` in the `BestCandidateSelection` module.
 
                      The suffix ``_rank`` is automatically added to the argument ``rankedVariableName``,
                      which either has to be the name of the variable used to order the candidates or the selected outputVariable name without the ending ``_rank``.
                      This means that your selected name for the rank variable has to end with ``_rank``.
 
                      An example of this variable's usage is given in the tutorial `B2A602-BestCandidateSelection <https://gitlab.desy.de/belle2/software/basf2/-/tree/main/analysis/examples/tutorials/B2A602-BestCandidateSelection.py>`_
                      )DOC", Manager::VariableDataType::c_double);
    REGISTER_VARIABLE("matchedMCHasPDG(PDGCode)", matchedMCHasPDG,
                      "Returns if the absolute value of the PDGCode of the MCParticle related to the Particle matches a given PDGCode."
                      "Returns 0/NAN/1 if PDGCode does not match/is not available/ matches");
    REGISTER_METAVARIABLE("numberOfNonOverlappingParticles(pList1, pList2, ...)", numberOfNonOverlappingParticles,
                      "Returns the number of non-overlapping particles in the given particle lists"
                      "Useful to check if there is additional physics going on in the detector if one reconstructed the Y4S", Manager::VariableDataType::c_int);
    REGISTER_METAVARIABLE("totalEnergyOfParticlesInList(particleListName)", totalEnergyOfParticlesInList,
                      "[Eventbased] Returns the total energy of particles in the given particle List. The unit of the energy is ``GeV``", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("totalPxOfParticlesInList(particleListName)", totalPxOfParticlesInList,
                      "[Eventbased] Returns the total momentum Px of particles in the given particle List. The unit of the momentum is ``GeV/c``", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("totalPyOfParticlesInList(particleListName)", totalPyOfParticlesInList,
                      "[Eventbased] Returns the total momentum Py of particles in the given particle List. The unit of the momentum is ``GeV/c``", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("totalPzOfParticlesInList(particleListName)", totalPzOfParticlesInList,
                      "[Eventbased] Returns the total momentum Pz of particles in the given particle List. The unit of the momentum is ``GeV/c``", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("invMassInLists(pList1, pList2, ...)", invMassInLists,
                      "[Eventbased] Returns the invariant mass of the combination of particles in the given particle lists. The unit of the invariant mass is GeV/:math:`\\text{c}^2` ", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("totalECLEnergyOfParticlesInList(particleListName)", totalECLEnergyOfParticlesInList,
                      "[Eventbased] Returns the total ECL energy of particles in the given particle List. The unit of the energy is ``GeV``", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("maxPtInList(particleListName)", maxPtInList,
                      "[Eventbased] Returns maximum transverse momentum Pt in the given particle List. The unit of the transverse momentum is ``GeV/c``", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("eclClusterSpecialTrackMatched(cut)", eclClusterTrackMatchedWithCondition,
                      "Returns if at least one Track that satisfies the given condition is related to the ECLCluster of the Particle.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("averageValueInList(particleListName, variable)", averageValueInList,
                      "[Eventbased] Returns the arithmetic mean of the given variable of the particles in the given particle list.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("medianValueInList(particleListName, variable)", medianValueInList,
                      "[Eventbased] Returns the median value of the given variable of the particles in the given particle list.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("sumValueInList(particleListName, variable)", sumValueInList,
                      "[Eventbased] Returns the sum of the given variable of the particles in the given particle list.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("productValueInList(particleListName, variable)", productValueInList,
                      "[Eventbased] Returns the product of the given variable of the particles in the given particle list.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("angleToClosestInList(particleListName)", angleToClosestInList,
                      "Returns the angle between this particle and the closest particle (smallest opening angle) in the list provided. The unit of the angle is ``rad`` ", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("closestInList(particleListName, variable)", closestInList,
                      "Returns `variable` for the closest particle (smallest opening angle) in the list provided.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("angleToMostB2BInList(particleListName)", angleToMostB2BInList,
                      "Returns the angle between this particle and the most back-to-back particle (closest opening angle to 180) in the list provided. The unit of the angle is ``rad`` ", Manager::VariableDataType::c_double);
  REGISTER_METAVARIABLE("deltaPhiToMostB2BPhiInList(particleListName)", deltaPhiToMostB2BPhiInList,
                    "Returns the abs(delta phi) between this particle and the most back-to-back particle in phi (closest opening angle to 180) in the list provided. The unit of the angle is ``rad`` ", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("mostB2BInList(particleListName, variable)", mostB2BInList,
                      "Returns `variable` for the most back-to-back particle (closest opening angle to 180) in the list provided.", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("maxOpeningAngleInList(particleListName)", maxOpeningAngleInList,
                      "[Eventbased] Returns maximum opening angle in the given particle List. The unit of the angle is ``rad`` ", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("daughterCombination(variable, daughterIndex_1, daughterIndex_2 ... daughterIndex_n)", daughterCombination,R"DOC(
Returns a ``variable`` function only of the 4-momentum calculated on an arbitrary set of (grand)daughters.
 
.. warning::
    ``variable`` can only be a function of the daughters' 4-momenta.
 
Daughters from different generations of the decay tree can be combined using generalized daughter indexes, which are simply colon-separated
the list of daughter indexes, starting from the root particle: for example, ``0:1:3``  identifies the fourth
daughter (3) of the second daughter (1) of the first daughter (0) of the mother particle.
 
.. tip::
    ``daughterCombination(M, 0, 3, 4)`` will return the invariant mass of the system made of the first, fourth and fifth daughter of particle.
    ``daughterCombination(M, 0:0, 3:0)`` will return the invariant mass of the system made of the first daughter of the first daughter and the first daughter of the fourth daughter.
 
)DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("useAlternativeDaughterHypothesis(variable, daughterIndex_1:newMassHyp_1, ..., daughterIndex_n:newMassHyp_n)", useAlternativeDaughterHypothesis,R"DOC(
Returns a ``variable`` calculated using new mass hypotheses for (some of) the particle's daughters.
 
.. warning::
    ``variable`` can only be a function of the particle 4-momentum, which is re-calculated as the sum of the daughters' 4-momenta, and the daughters' 4-momentum.
    This means that if you made a kinematic fit without updating the daughters' momenta, the result of this variable will not reflect the effect of the kinematic fit.
    Also, the track fit is not performed again: the variable only re-calculates the 4-vectors using different mass assumptions.
    In the variable, a copy of the given particle is created with daughters' alternative mass assumption (i.e. the original particle and daughters are not changed).
 
.. warning::
    Generalized daughter indexes are not supported (yet!): this variable can be used only on first-generation daughters.
 
.. tip::
    ``useAlternativeDaughterHypothesis(M, 0:K+, 2:pi-)`` will return the invariant mass of the particle assuming that the first daughter is a kaon and the third is a pion, instead of whatever was used in reconstructing the decay.
    ``useAlternativeDaughterHypothesis(mRecoil, 1:p+)`` will return the recoil mass of the particle assuming that the second daughter is a proton instead of whatever was used in reconstructing the decay.
 
)DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("varForFirstMCAncestorOfType(type, variable)",varForFirstMCAncestorOfType,R"DOC(Returns requested variable of the first ancestor of the given type.
Ancestor type can be set up by PDG code or by particle name (check evt.pdl for valid particle names))DOC", Manager::VariableDataType::c_double);
    REGISTER_METAVARIABLE("varForNthDaughterOfType(type, n, variable[, maxDepth])",varForNthDaughterOfType,R"DOC(Returns requested variable for nth daughter (``n`` starting at 1) of the given type.
Particle type can be given as pdg code or by particle name (particles and antiparticles are treated the same, so e.g. ``211``, ``-211``, ``pi+`` and ``pi-`` will all match all charged pions). 
Maximal depth controls how many generations of daughters are searched (``maxDepth=1`` only direct daughters, ``maxDepth=2`` also granddaughters, ...). The default value of ``maxDepth`` is 1.
As an example, when reconstructing ``B0:my_list -> [K_S0:pipi -> pi+:all pi-:all] [pi0:gg -> gamma:all gamma:all]`` then ``varForNthDaughterOfType(pi+, 1, E, 2)`` will return the energy of the first charged pion found searching all daughters and then granddaughters of the given particle, so in this case the pi+, and ``varForNthDaughterOfType(22, 2, E, 2)`` will return the energy of the second daughter of the pi0. (Note that the kinematic distributions of the two pi0 daughters are not the same, unless the ``gamma:all`` list was shuffled beforehand!)
If no nth daughter of the given type can be found at given maximal depth, returns NaN.)DOC", Manager::VariableDataType::c_double);
 
    REGISTER_METAVARIABLE("nTrackFitResults(particleType)", nTrackFitResults,
        "[Eventbased] Returns the total number of TrackFitResults for a given particleType. The argument can be the name of particle (e.g. pi+) or PDG code (e.g. 211).",
        Manager::VariableDataType::c_int);
 
    REGISTER_METAVARIABLE("convertToDaughterIndex(variable)", convertToDaughterIndex, R"DOC(Converts the variable of the given particle into integer and returns it if it is a valid daughter index, else returns -1.)DOC", Manager::VariableDataType::c_int);
 
  }
}