CalcPartonHistory.h

Go to the documentation of this file.

/*
  Copyright (C) 2002-2026 CERN for the benefit of the ATLAS collaboration
*/

 
#ifndef PARTONS_CALCPARTONHISTORY_H
#define PARTONS_CALCPARTONHISTORY_H
 
// system include(s):
#include <vector>
 
// Framework include(s):
#include <xAODEventInfo/EventInfo.h>
 
#include "AsgTools/AsgTool.h"
#include "PartonHistory/PartonHistoryUtils.h"
#include "PartonHistory/PartonSchemeConfig.h"
#include "VectorHelpers/DecoratorHelpers.h"
#include "xAODTruth/TruthParticleContainer.h"
 
namespace CP {
using ROOT::Math::PtEtaPhiMVector;
 
class CalcPartonHistory : public asg::AsgTool {
 
 public:
  explicit CalcPartonHistory(
      const std::string& name,
      const std::vector<std::string>& truthCollections = {"TruthTop"});
  virtual ~CalcPartonHistory() {};
 
  CalcPartonHistory(const CalcPartonHistory& rhs) = delete;
  CalcPartonHistory(CalcPartonHistory&& rhs) = delete;
  CalcPartonHistory& operator=(const CalcPartonHistory& rhs) = delete;
 
  void AddToParticleMap(const xAOD::TruthParticle* particle,
                        const std::string& key);
  bool ExistsInMap(const std::string& key) const;
  bool ExistsInKey(const std::string& key,
                   const xAOD::TruthParticle* particle) const;
  bool Retrievep4(const std::string& key, PtEtaPhiMVector& p4);
  bool Retrievep4(const std::string& key, PtEtaPhiMVector& p4, const int& idx);
  bool Retrievep4Gamma(PtEtaPhiMVector& p4, int& parentpdgId);
  bool RetrievepdgId(const std::string& key, std::vector<int>& pdgIds);
  bool RetrievepdgId(const std::string& key, int& pdgId);
  bool RetrievepdgId(const std::string& key, int& pdgId, const int& idx);
  bool RetrieveParticleInfo(const std::string& prefix,
                            std::vector<const xAOD::TruthParticle*>& particles);
  bool RetrieveParticleInfo(const std::string& prefix,
                            PtEtaPhiMVector& particle, int& pdgId);
  bool RetrieveParticleInfo(const std::string& prefix,
                            PtEtaPhiMVector& particle, int& pdgId,
                            const int& idx);
  bool RetrieveParticleInfo(const std::string& prefix,
                            const std::string& alt_prefix,
                            PtEtaPhiMVector& particle, int& pdgId);
  bool RetrieveParticleInfo(const std::string& prefix,
                            std::vector<PtEtaPhiMVector>& particles,
                            std::vector<int>& pdgIds);
 
  void Initialize4TopDecorators();
  void InitializeTopDecorators();
  void InitializeAntiTopDecorators();
  void InitializeBottomDecorators();
  void InitializeVectorBottomDecorators();
  void InitializeAntiBottomDecorators();
  void InitializeVectorAntiBottomDecorators();
  void InitializeCharmDecorators();
  void InitializeVectorCharmDecorators();
  void InitializeAntiCharmDecorators();
  void InitializeVectorAntiCharmDecorators();
  void InitializeTtbarDecorators();
  void InitializeHiggsDecorators();
  void InitializePhotonDecorators();
  void InitializeZDecorators(int nZs = 1, bool extend = false);
  void InitializeWDecorators(int nWs = 1);
 
  std::string GetParticleType(const xAOD::TruthParticle* particle);
 
  void TraceParticle(
      const xAOD::TruthParticle* particle,
      std::vector<const xAOD::TruthParticle*>& currentPath,
      std::vector<std::vector<const xAOD::TruthParticle*>>& allPaths);
  void TraceParticles(const xAOD::TruthParticleContainer* truthParticles);
 
  bool handleFSR(const xAOD::TruthParticle* particle, const std::string& newKey,
                 std::string& key);
  bool handleDecay(const xAOD::TruthParticle* particle, std::string& key,
                   int decayID);
  void handleSameAsParent(const xAOD::TruthParticle* particle,
                          std::string& key);
  void handleDefault(const xAOD::TruthParticle* particle,
                     const std::string& newKey, std::string& key);
 
  void FillParticleMap(
      std::vector<std::vector<const xAOD::TruthParticle*>>& allPaths);
 
  // Generic history fillers
  void FillGenericPartonHistory(const std::string& retrievalstring,
                                const std::string& decorationstring,
                                const int idx);
  void FillGenericPartonHistory(
      const std::vector<std::string>& retrievalStrings,
      const std::string& decorationstring, const int idx);
  void FillGenericPartonHistory(
      const std::vector<std::string>& retrievalStrings,
      const std::string& decorationstring);
  void FillGenericVectorPartonHistory(const std::string& retrievalstring,
                                      const std::string& decorationstring);
 
  // Specialised history fillers
  void FillGammaPartonHistory(const std::string& parent);
  void FillZPartonHistory(const std::string& parent, int nZs = 1,
                          const std::string& mode = "resonant");
  void FillZtautauPartonHistory(const std::string& parent, int nZs = 1,
                                const std::string& mode = "resonant");
  void FillWPartonHistory(const std::string& parent, int nWs = 1,
                          const std::string& mode = "resonant");
  void FillTopPartonHistory();
  void FillAntiTopPartonHistory();
  void FillHiggsPartonHistory(const std::string& mode);
  void FillTtbarPartonHistory();
 
  // Helpers for non-resonant / off-shell reconstruction.
  void setHiggs(const std::string& fsr);
  void setW(const std::string& fsr, int nWs);
  bool getW(const std::string& str_lep, const std::string& str_nu,
            PtEtaPhiMVector& p1, int& pdgId1, PtEtaPhiMVector& p2, int& pdgId2);
  void setZ(const std::string& fsr, int nZs);
  void setZtautau(const std::string& fsr, int nZs);
  bool getZ(const std::string& str_lep1, const std::string& str_lep2,
            PtEtaPhiMVector& p1, int& pdgId1, PtEtaPhiMVector& p2, int& pdgId2);
  bool getZFromTaus(const std::string& fsr, PtEtaPhiMVector& Zdecay1,
                    int& Zdecay1_pdgId, PtEtaPhiMVector& Zdecay2,
                    int& Zdecay2_pdgId, PtEtaPhiMVector& Zdecay1_decay1,
                    int& Zdecay1_decay1_pdgId, PtEtaPhiMVector& Zdecay1_decay2,
                    int& Zdecay1_decay2_pdgId, PtEtaPhiMVector& Zdecay1_decay3,
                    int& Zdecay1_decay3_pdgId, PtEtaPhiMVector& Zdecay2_decay1,
                    int& Zdecay2_decay1_pdgId, PtEtaPhiMVector& Zdecay2_decay2,
                    int& Zdecay2_decay2_pdgId, PtEtaPhiMVector& Zdecay2_decay3,
                    int& Zdecay2_decay3_pdgId);

#ifndef XAOD_STANDALONE
  using AsgTool::configure;
#endif
  void configure(const PartonSchemeConfig& config);
 
  virtual StatusCode initialize() override;
  virtual StatusCode execute();
 
 protected:
  std::map<std::string, std::vector<const xAOD::TruthParticle*>> m_particleMap;
  PartonDecorator m_dec;
 
  const std::vector<std::string> m_truthCollections;
  std::string
      m_prefix;  
 
  // this method is used to perform the linking of various TRUTH3 particle
  // containers for Partons to work
  virtual StatusCode linkTruthContainers(
      const xAOD::TruthParticleContainer*& tp);
 
  // this is the method that runs the actual parton history reconstruction
  virtual StatusCode runHistorySaver(
      const xAOD::TruthParticleContainer* truthParticles,
      const xAOD::EventInfo* ttbarPartonHistory);
 
  virtual void initializeDecorators();
 
  PartonSchemeConfig m_config;  
  bool m_configured = false;    

  StatusCode buildContainerFromMultipleCollections(
      const std::vector<std::string>& collections,
      const std::string& out_contName);

  StatusCode linkBosonCollections();

  const xAOD::TruthParticle* getTruthParticleLinkedFromDecoration(
      const xAOD::TruthParticle* part, const std::string& decorationName);
 
 private:
  StatusCode decorateCollectionWithLinksToAnotherCollection(
      const std::string& collectionToDecorate,
      const std::string& collectionToLink, const std::string& nameOfDecoration);
};
 
}  // namespace CP
 
#endif