// // ******************************************************************** // * License and Disclaimer * // * * // * The Geant4 software is copyright of the Copyright Holders of * // * the Geant4 Collaboration. It is provided under the terms and * // * conditions of the Geant4 Software License, included in the file * // * LICENSE and available at http://cern.ch/geant4/license . These * // * include a list of copyright holders. * // * * // * Neither the authors of this software system, nor their employing * // * institutes,nor the agencies providing financial support for this * // * work make any representation or warranty, express or implied, * // * regarding this software system or assume any liability for its * // * use. Please see the license in the file LICENSE and URL above * // * for the full disclaimer and the limitation of liability. * // * * // * This code implementation is the result of the scientific and * // * technical work of the GEANT4 collaboration. * // * By using, copying, modifying or distributing the software (or * // * any work based on the software) you agree to acknowledge its * // * use in resulting scientific publications, and indicate your * // * acceptance of all terms of the Geant4 Software license. * // ******************************************************************** // // $Id: G4VAnalysisManager.hh 71635 2013-06-19 13:48:28Z ihrivnac $ // The nonvirtual public interface class to g4tools based analysis. // It is defined as a composite of object manager base classes. // Individual use of the component managers is disabled // (except for file manager and Hn manager which are also used from // other object managers). // The functions which has to be implemented in concrete managers // are declared as virtual protected. // Author: Ivana Hrivnacova, 09/07/2013 (ivana@ipno.in2P2.fr) #ifndef G4VAnalysisManager_h #define G4VAnalysisManager_h 1 #include "G4AnalysisManagerState.hh" #include "globals.hh" #include #include #include class G4AnalysisMessenger; class G4HnManager; class G4VH1Manager; class G4VH2Manager; class G4VH3Manager; class G4VP1Manager; class G4VP2Manager; class G4VNtupleManager; class G4VFileManager; namespace tools { namespace histo{ class hmpi; } } class G4VAnalysisManager { public: G4VAnalysisManager(const G4String& type, G4bool isMaster); virtual ~G4VAnalysisManager(); // Methods for handling files G4bool OpenFile(const G4String& fileName = ""); G4bool Write(); G4bool CloseFile(); G4bool Merge(tools::histo::hmpi* hmpi); G4bool Plot(); G4bool IsOpenFile() const; // Methods for handling files and directories names G4bool SetFileName(const G4String& fileName); G4bool SetHistoDirectoryName(const G4String& dirName); G4bool SetNtupleDirectoryName(const G4String& dirName); void SetCompressionLevel(G4int level); G4String GetFileName() const; G4String GetHistoDirectoryName() const; G4String GetNtupleDirectoryName() const; G4int GetCompressionLevel() const; // Methods for handling histograms // G4int CreateH1(const G4String& name, const G4String& title, G4int nbins, G4double xmin, G4double xmax, const G4String& unitName = "none", const G4String& fcnName = "none", const G4String& binSchemeName = "linear"); G4int CreateH1(const G4String& name, const G4String& title, const std::vector& edges, const G4String& unitName = "none", const G4String& fcnName = "none"); G4int CreateH2(const G4String& name, const G4String& title, G4int nxbins, G4double xmin, G4double xmax, G4int nybins, G4double ymin, G4double ymax, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& xbinSchemeName = "linear", const G4String& ybinSchemeName = "linear"); G4int CreateH2(const G4String& name, const G4String& title, const std::vector& xedges, const std::vector& yedges, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none"); G4int CreateH3(const G4String& name, const G4String& title, G4int nxbins, G4double xmin, G4double xmax, G4int nybins, G4double ymin, G4double ymax, G4int nzbins, G4double zmin, G4double zmax, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& zunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& zfcnName = "none", const G4String& xbinSchemeName = "linear", const G4String& ybinSchemeName = "linear", const G4String& zbinSchemeName = "linear"); G4int CreateH3(const G4String& name, const G4String& title, const std::vector& xedges, const std::vector& yedges, const std::vector& zedges, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& zunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& zfcnName = "none"); G4bool SetH1(G4int id, G4int nbins, G4double xmin, G4double xmax, const G4String& unitName = "none", const G4String& fcnName = "none", const G4String& binSchemeName = "linear"); G4bool SetH1(G4int id, const std::vector& edges, const G4String& unitName = "none", const G4String& fcnName = "none"); G4bool SetH2(G4int id, G4int nxbins, G4double xmin, G4double xmax, G4int nybins, G4double ymin, G4double ymax, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& xbinSchemeName = "linear", const G4String& ybinSchemeName = "linear"); G4bool SetH2(G4int id, const std::vector& xedges, const std::vector& yedges, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none"); G4bool SetH3(G4int id, G4int nxbins, G4double xmin, G4double xmax, G4int nzbins, G4double zmin, G4double zmax, G4int nybins, G4double ymin, G4double ymax, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& zunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& zfcnName = "none", const G4String& xbinSchemeName = "linear", const G4String& ybinSchemeName = "linear", const G4String& zbinSchemeName = "linear"); G4bool SetH3(G4int id, const std::vector& xedges, const std::vector& yedges, const std::vector& zedges, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& zunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& zfcnName = "none"); G4bool ScaleH1(G4int id, G4double factor); G4bool ScaleH2(G4int id, G4double factor); G4bool ScaleH3(G4int id, G4double factor); // Methods for handling profiles // G4int CreateP1(const G4String& name, const G4String& title, G4int nbins, G4double xmin, G4double xmax, G4double ymin = 0, G4double ymax = 0, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& xbinSchemeName = "linear"); G4int CreateP1(const G4String& name, const G4String& title, const std::vector& edges, G4double ymin = 0, G4double ymax = 0, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none"); G4int CreateP2(const G4String& name, const G4String& title, G4int nxbins, G4double xmin, G4double xmax, G4int nybins, G4double ymin, G4double ymax, G4double zmin = 0, G4double zmax = 0, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& zunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& zfcnName = "none", const G4String& xbinSchemeName = "linear", const G4String& ybinSchemeName = "linear"); G4int CreateP2(const G4String& name, const G4String& title, const std::vector& xedges, const std::vector& yedges, G4double zmin = 0, G4double zmax = 0, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& zunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& zfcnName = "none"); G4bool SetP1(G4int id, G4int nbins, G4double xmin, G4double xmax, G4double ymin = 0, G4double ymax = 0, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& xbinSchemeName = "linear"); G4bool SetP1(G4int id, const std::vector& edges, G4double ymin = 0, G4double ymax = 0, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none"); G4bool SetP2(G4int id, G4int nxbins, G4double xmin, G4double xmax, G4int nybins, G4double ymin, G4double ymax, G4double zmin = 0, G4double zmax = 0, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& zunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& zfcnName = "none", const G4String& xbinSchemeName = "linear", const G4String& ybinSchemeName = "linear"); G4bool SetP2(G4int id, const std::vector& xedges, const std::vector& yedges, G4double zmin = 0, G4double zmax = 0, const G4String& xunitName = "none", const G4String& yunitName = "none", const G4String& zunitName = "none", const G4String& xfcnName = "none", const G4String& yfcnName = "none", const G4String& zfcnName = "none"); G4bool ScaleP1(G4int id, G4double factor); G4bool ScaleP2(G4int id, G4double factor); // Methods for handling ntuples // G4int CreateNtuple(const G4String& name, const G4String& title); // Create columns in the last created ntuple G4int CreateNtupleIColumn(const G4String& name); G4int CreateNtupleFColumn(const G4String& name); G4int CreateNtupleDColumn(const G4String& name); G4int CreateNtupleSColumn(const G4String& name); // Create columns of vector in the last created ntuple G4int CreateNtupleIColumn( const G4String& name, std::vector& vector); G4int CreateNtupleFColumn( const G4String& name, std::vector& vector); G4int CreateNtupleDColumn( const G4String& name, std::vector& vector); void FinishNtuple(); // Create columns in the ntuple with given id G4int CreateNtupleIColumn(G4int ntupleId, const G4String& name); G4int CreateNtupleFColumn(G4int ntupleId, const G4String& name); G4int CreateNtupleDColumn(G4int ntupleId, const G4String& name); G4int CreateNtupleSColumn(G4int ntupleId, const G4String& name); // Create columns of vector in the ntuple with given id G4int CreateNtupleIColumn(G4int ntupleId, const G4String& name, std::vector& vector); G4int CreateNtupleFColumn(G4int ntupleId, const G4String& name, std::vector& vector); G4int CreateNtupleDColumn(G4int ntupleId, const G4String& name, std::vector& vector); void FinishNtuple(G4int ntupleId); // The ids of histograms and ntuples are generated automatically // starting from 0; with following functions it is possible to // change the first Id to start from other value G4bool SetFirstHistoId(G4int firstId); G4bool SetFirstH1Id(G4int firstId); G4bool SetFirstH2Id(G4int firstId); G4bool SetFirstH3Id(G4int firstId); G4bool SetFirstProfileId(G4int firstId); G4bool SetFirstP1Id(G4int firstId); G4bool SetFirstP2Id(G4int firstId); G4bool SetFirstNtupleId(G4int firstId); G4bool SetFirstNtupleColumnId(G4int firstId); // Methods to fill histograms G4bool FillH1(G4int id, G4double value, G4double weight = 1.0); G4bool FillH2(G4int id, G4double xvalue, G4double yvalue, G4double weight = 1.0); G4bool FillH3(G4int id, G4double xvalue, G4double yvalue, G4double zvalue, G4double weight = 1.0); // Methods to fill profiles G4bool FillP1(G4int id, G4double xvalue, G4double yvalue, G4double weight = 1.0); G4bool FillP2(G4int id, G4double xvalue, G4double yvalue, G4double zvalue, G4double weight = 1.0); // Methods to fill ntuples // Methods for ntuple with id = FirstNtupleId G4bool FillNtupleIColumn(G4int id, G4int value); G4bool FillNtupleFColumn(G4int id, G4float value); G4bool FillNtupleDColumn(G4int id, G4double value); G4bool FillNtupleSColumn(G4int id, const G4String& value); G4bool AddNtupleRow(); // Methods for ntuple with id > FirstNtupleId (when more ntuples exist) G4bool FillNtupleIColumn(G4int ntupleId, G4int columnId, G4int value); G4bool FillNtupleFColumn(G4int ntupleId, G4int columnId, G4float value); G4bool FillNtupleDColumn(G4int ntupleId, G4int columnId, G4double value); G4bool FillNtupleSColumn(G4int ntupleId, G4int id, const G4String& value); G4bool AddNtupleRow(G4int ntupleId); // Activation option // When this option is enabled, only the histograms/profiles marked as activated // are returned, filled or saved on file. // No warning is issued when Get or Fill is called on inactive histogram. void SetActivation(G4bool activation); G4bool GetActivation() const; // Return false if activation is enabled and there is no object activated, // return true otherwise G4bool IsActive() const; // ASCII option // Return false if there is no object selected for ASCII output, // return true otherwise G4bool IsAscii() const; // Plotting option // Return false if there is no object selected for plottng, // return true otherwise G4bool IsPlotting() const; // Access methods G4int GetFirstH1Id() const; G4int GetFirstH2Id() const; G4int GetFirstH3Id() const; G4int GetFirstP1Id() const; G4int GetFirstP2Id() const; G4int GetFirstNtupleId() const; G4int GetFirstNtupleColumnId() const; G4int GetNofH1s() const; G4int GetNofH2s() const; G4int GetNofH3s() const; G4int GetNofP1s() const; G4int GetNofP2s() const; G4int GetNofNtuples() const; // Access methods via names G4int GetH1Id(const G4String& name, G4bool warn = true) const; G4int GetH2Id(const G4String& name, G4bool warn = true) const; G4int GetH3Id(const G4String& name, G4bool warn = true) const; G4int GetP1Id(const G4String& name, G4bool warn = true) const; G4int GetP2Id(const G4String& name, G4bool warn = true) const; // Methods to manipulate histogram, profiles & ntuples additional information // void SetH1Activation(G4bool activation); void SetH1Activation(G4int id, G4bool activation); void SetH1Ascii(G4int id, G4bool ascii); void SetH1Plotting(G4int id, G4bool plotting); // void SetH2Activation(G4bool activation); void SetH2Activation(G4int id, G4bool activation); void SetH2Ascii(G4int id, G4bool ascii); void SetH2Plotting(G4int id, G4bool plotting); // void SetH3Activation(G4bool activation); void SetH3Activation(G4int id, G4bool activation); void SetH3Ascii(G4int id, G4bool ascii); void SetH3Plotting(G4int id, G4bool plotting); // void SetP1Activation(G4bool activation); void SetP1Activation(G4int id, G4bool activation); void SetP1Ascii(G4int id, G4bool ascii); void SetP1Plotting(G4int id, G4bool plotting); // void SetP2Activation(G4bool activation); void SetP2Activation(G4int id, G4bool activation); void SetP2Ascii(G4int id, G4bool ascii); void SetP2Plotting(G4int id, G4bool plotting); // void SetNtupleActivation(G4bool activation); void SetNtupleActivation(G4int id, G4bool activation); // Access to histogram & profiles parameters // G4int GetH1Nbins(G4int id) const; G4double GetH1Xmin(G4int id) const; G4double GetH1Xmax(G4int id) const; G4double GetH1Width(G4int id) const; // G4int GetH2Nxbins(G4int id) const; G4double GetH2Xmin(G4int id) const; G4double GetH2Xmax(G4int id) const; G4double GetH2XWidth(G4int id) const; G4int GetH2Nybins(G4int id) const; G4double GetH2Ymin(G4int id) const; G4double GetH2Ymax(G4int id) const; G4double GetH2YWidth(G4int id) const; // G4int GetH3Nxbins(G4int id) const; G4double GetH3Xmin(G4int id) const; G4double GetH3Xmax(G4int id) const; G4double GetH3XWidth(G4int id) const; G4int GetH3Nybins(G4int id) const; G4double GetH3Ymin(G4int id) const; G4double GetH3Ymax(G4int id) const; G4double GetH3YWidth(G4int id) const; G4int GetH3Nzbins(G4int id) const; G4double GetH3Zmin(G4int id) const; G4double GetH3Zmax(G4int id) const; G4double GetH3ZWidth(G4int id) const; // G4int GetP1Nbins(G4int id) const; G4double GetP1Xmin(G4int id) const; G4double GetP1Xmax(G4int id) const; G4double GetP1XWidth(G4int id) const; G4double GetP1Ymin(G4int id) const; G4double GetP1Ymax(G4int id) const; // G4int GetP2Nxbins(G4int id) const; G4double GetP2Xmin(G4int id) const; G4double GetP2Xmax(G4int id) const; G4double GetP2XWidth(G4int id) const; G4int GetP2Nybins(G4int id) const; G4double GetP2Ymin(G4int id) const; G4double GetP2Ymax(G4int id) const; G4double GetP2YWidth(G4int id) const; G4double GetP2Zmin(G4int id) const; G4double GetP2Zmax(G4int id) const; // Access to histogram & profiles additional information // G4String GetH1Name(G4int id) const; G4double GetH1Unit(G4int id) const; G4bool GetH1Activation(G4int id) const; G4bool GetH1Ascii(G4int id) const; G4bool GetH1Plotting(G4int id) const; // G4String GetH2Name(G4int id) const; G4double GetH2XUnit(G4int id) const; G4double GetH2YUnit(G4int id) const; G4bool GetH2Activation(G4int id) const; G4bool GetH2Ascii(G4int id) const; G4bool GetH2Plotting(G4int id) const; // G4String GetH3Name(G4int id) const; G4double GetH3XUnit(G4int id) const; G4double GetH3YUnit(G4int id) const; G4double GetH3ZUnit(G4int id) const; G4bool GetH3Activation(G4int id) const; G4bool GetH3Ascii(G4int id) const; G4bool GetH3Plotting(G4int id) const; // G4String GetP1Name(G4int id) const; G4double GetP1XUnit(G4int id) const; G4double GetP1YUnit(G4int id) const; G4bool GetP1Activation(G4int id) const; G4bool GetP1Ascii(G4int id) const; G4bool GetP1Plotting(G4int id) const; // G4String GetP2Name(G4int id) const; G4double GetP2XUnit(G4int id) const; G4double GetP2YUnit(G4int id) const; G4double GetP2ZUnit(G4int id) const; G4bool GetP2Activation(G4int id) const; G4bool GetP2Ascii(G4int id) const; G4bool GetP2Plotting(G4int id) const; // G4bool GetNtupleActivation(G4int id) const; // Setters for histogram & profiles attributes for plotting // G4bool SetH1Title(G4int id, const G4String& title); G4bool SetH1XAxisTitle(G4int id, const G4String& title); G4bool SetH1YAxisTitle(G4int id, const G4String& title); // G4bool SetH2Title(G4int id, const G4String& title); G4bool SetH2XAxisTitle(G4int id, const G4String& title); G4bool SetH2YAxisTitle(G4int id, const G4String& title); G4bool SetH2ZAxisTitle(G4int id, const G4String& title); // G4bool SetH3Title(G4int id, const G4String& title); G4bool SetH3XAxisTitle(G4int id, const G4String& title); G4bool SetH3YAxisTitle(G4int id, const G4String& title); G4bool SetH3ZAxisTitle(G4int id, const G4String& title); // G4bool SetP1Title(G4int id, const G4String& title); G4bool SetP1XAxisTitle(G4int id, const G4String& title); G4bool SetP1YAxisTitle(G4int id, const G4String& title); // G4bool SetP2Title(G4int id, const G4String& title); G4bool SetP2XAxisTitle(G4int id, const G4String& title); G4bool SetP2YAxisTitle(G4int id, const G4String& title); G4bool SetP2ZAxisTitle(G4int id, const G4String& title); // Access histogram & profiles attributes for plotting // G4String GetH1Title(G4int id) const; G4String GetH1XAxisTitle(G4int id) const; G4String GetH1YAxisTitle(G4int id) const; // G4String GetH2Title(G4int id) const; G4String GetH2XAxisTitle(G4int id) const; G4String GetH2YAxisTitle(G4int id) const; G4String GetH2ZAxisTitle(G4int id) const; // G4String GetH3Title(G4int id) const; G4String GetH3XAxisTitle(G4int id) const; G4String GetH3YAxisTitle(G4int id) const; G4String GetH3ZAxisTitle(G4int id) const; // G4String GetP1Title(G4int id) const; G4String GetP1XAxisTitle(G4int id) const; G4String GetP1YAxisTitle(G4int id) const; G4String GetP1ZAxisTitle(G4int id) const; // G4String GetP2Title(G4int id) const; G4String GetP2XAxisTitle(G4int id) const; G4String GetP2YAxisTitle(G4int id) const; G4String GetP2ZAxisTitle(G4int id) const; // Verbosity void SetVerboseLevel(G4int verboseLevel); G4int GetVerboseLevel() const; // The manager type (starts with an uppercase letter) G4String GetType() const; // The manager file type (starts with a lowercase letter) G4String GetFileType() const; protected: // virtual methods virtual G4bool OpenFileImpl(const G4String& fileName) = 0; virtual G4bool WriteImpl() = 0; virtual G4bool CloseFileImpl() = 0; virtual G4bool PlotImpl() = 0; virtual G4bool MergeImpl(tools::histo::hmpi* hmpi) = 0; virtual G4bool IsOpenFileImpl() const = 0; // methods void SetH1Manager(G4VH1Manager* h1Manager); void SetH2Manager(G4VH2Manager* h2Manager); void SetH3Manager(G4VH3Manager* h3Manager); void SetP1Manager(G4VP1Manager* p1Manager); void SetP2Manager(G4VP2Manager* p2Manager); void SetNtupleManager(G4VNtupleManager* ntupleManager); void SetFileManager(std::shared_ptr fileManager); // Methods to manipulate additional information G4bool WriteAscii(const G4String& fileName); // data members G4AnalysisManagerState fState; std::shared_ptr fVFileManager; private: // data members std::unique_ptr fMessenger; std::shared_ptr fH1HnManager; std::shared_ptr fH2HnManager; std::shared_ptr fH3HnManager; std::shared_ptr fP1HnManager; std::shared_ptr fP2HnManager; std::unique_ptr fVH1Manager; std::unique_ptr fVH2Manager; std::unique_ptr fVH3Manager; std::unique_ptr fVP1Manager; std::unique_ptr fVP2Manager; // std::shared_ptr fVNtupleManager; G4VNtupleManager* fVNtupleManager; }; // inline functions #include "G4VAnalysisManager.icc" #endif