#ifndef HADRONS_Main_Hadron_Decay_Map_H #define HADRONS_Main_Hadron_Decay_Map_H #include #include #include "ATOOLS/Phys/Flavour.H" #include "HADRONS++/Main/Tools.H" #include "PHASIC++/Decays/Decay_Map.H" namespace HADRONS { class Hadron_Decay_Table; class Mixing_Handler; typedef std::multimap SDtMMap; typedef std::multimap::iterator SDtMMapIt; /** * Building on the general class Decay_Map this class implements the features * specific for hadron decay maps, e.g. reading decay tables from files. * Furthermore it manages the global constants defined in HadronConstants.dat. */ class Hadron_Decay_Map : public PHASIC::Decay_Map { private: /** * A model that is filled from HadronConstants.dat and used as starting * point for all decay channel specific models. */ GeneralModel m_startmd; std::multimap m_fixed_tables; std::vector m_fixed_next_tables; Mixing_Handler * p_mixinghandler; public: /** * @param mass selector */ Hadron_Decay_Map(const ATOOLS::Mass_Selector* ms); ~Hadron_Decay_Map(); /** * Reads all decay tables and create their decay channels, but does not * initialise (integrate) them. */ void Read(const std::string& path, const std::string& file, bool verify=false); /** * Reads fixed decay tables from FixedDecays.dat which can later be * programmatically set to be used for the next decay of a certain decayer, * typically some kind of signal decay * (useful within frameworks like LHCb) */ void ReadFixedTables(const std::string& path, const std::string& file); /** * Reads HadronConstants.dat & fills them into Hadron_Decay_Map::m_startmd. * Also checks for hadron specific properties like mixing parameters in * HadronConstants.dat and sets them to the flavour. */ void ReadInConstants(const std::string& path, const std::string& file); /** * Reads partonic decay data. */ void ReadInPartonicDecays(const ATOOLS::Flavour & decflav, const std::string& path,const std::string& file); /** * Reads a file with lines of the format "1234->111" and creates alias * particles 1234 with the properties of 111, which can be used in * decay tables and decay channels such that e.g. a signal decay chain * can be specified. */ void ReadHadronAliases(const std::string& path, const std::string& file); /** * Initialises and integrates all decay channels built up. */ void Initialise(); /** * * @return The global hadron decay parameter model. */ inline GeneralModel& StartModel() { return m_startmd; } /** * Creates a Latex booklet containing all decay tables and information * about available matrix elements and currents. * * @param f ostream the booklet is written to */ void CreateBooklet(std::string& name); /** * Activate a previously read fixed decay table */ void FixDecayTables(std::string table_id); /** * Deactivate the previously fixed decay table */ void ClearFixedDecayTables(); virtual PHASIC::Decay_Table* FindDecay(const ATOOLS::Flavour& decayer); //@{ /// Getter/setter method. inline const Mixing_Handler* MixingHandler() const {return p_mixinghandler;} inline void SetMixingHandler(Mixing_Handler* mix) { p_mixinghandler = mix; } //@} }; /** \mainpage The HADRONS package is Sherpa's native hadron and tau decay handler. \section decaydata Decaydata files All decaytables and information about decay channels is saved in plain text files located in SHERPA/Run/Decaydata. Three different levels of dat-files are used: - HadronDecays.dat: Stores a list of all available decay tables. (represented by the Hadron_Decay_Map class). - Decay table files: Each hadron has its own directory including a file called Decays.dat which is represented by the Hadron_Decay_Table class. - Decay channel files: In the same directory you can find individual files for each decay channel (represented by the Hadron_Decay_Channel class). */ } #endif