Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/analysis/management/include/G4BaseFileManager.hh

Version: [ ReleaseNotes ] [ 1.0 ] [ 1.1 ] [ 2.0 ] [ 3.0 ] [ 3.1 ] [ 3.2 ] [ 4.0 ] [ 4.0.p1 ] [ 4.0.p2 ] [ 4.1 ] [ 4.1.p1 ] [ 5.0 ] [ 5.0.p1 ] [ 5.1 ] [ 5.1.p1 ] [ 5.2 ] [ 5.2.p1 ] [ 5.2.p2 ] [ 6.0 ] [ 6.0.p1 ] [ 6.1 ] [ 6.2 ] [ 6.2.p1 ] [ 6.2.p2 ] [ 7.0 ] [ 7.0.p1 ] [ 7.1 ] [ 7.1.p1 ] [ 8.0 ] [ 8.0.p1 ] [ 8.1 ] [ 8.1.p1 ] [ 8.1.p2 ] [ 8.2 ] [ 8.2.p1 ] [ 8.3 ] [ 8.3.p1 ] [ 8.3.p2 ] [ 9.0 ] [ 9.0.p1 ] [ 9.0.p2 ] [ 9.1 ] [ 9.1.p1 ] [ 9.1.p2 ] [ 9.1.p3 ] [ 9.2 ] [ 9.2.p1 ] [ 9.2.p2 ] [ 9.2.p3 ] [ 9.2.p4 ] [ 9.3 ] [ 9.3.p1 ] [ 9.3.p2 ] [ 9.4 ] [ 9.4.p1 ] [ 9.4.p2 ] [ 9.4.p3 ] [ 9.4.p4 ] [ 9.5 ] [ 9.5.p1 ] [ 9.5.p2 ] [ 9.6 ] [ 9.6.p1 ] [ 9.6.p2 ] [ 9.6.p3 ] [ 9.6.p4 ] [ 10.0 ] [ 10.0.p1 ] [ 10.0.p2 ] [ 10.0.p3 ] [ 10.0.p4 ] [ 10.1 ] [ 10.1.p1 ] [ 10.1.p2 ] [ 10.1.p3 ] [ 10.2 ] [ 10.2.p1 ] [ 10.2.p2 ] [ 10.2.p3 ] [ 10.3 ] [ 10.3.p1 ] [ 10.3.p2 ] [ 10.3.p3 ] [ 10.4 ] [ 10.4.p1 ] [ 10.4.p2 ] [ 10.4.p3 ] [ 10.5 ] [ 10.5.p1 ] [ 10.6 ] [ 10.6.p1 ] [ 10.6.p2 ] [ 10.6.p3 ] [ 10.7 ] [ 10.7.p1 ] [ 10.7.p2 ] [ 10.7.p3 ] [ 10.7.p4 ] [ 11.0 ] [ 11.0.p1 ] [ 11.0.p2 ] [ 11.0.p3, ] [ 11.0.p4 ] [ 11.1 ] [ 11.1.1 ] [ 11.1.2 ] [ 11.1.3 ] [ 11.2 ] [ 11.2.1 ] [ 11.2.2 ] [ 11.3.0 ]

Diff markup

Differences between /analysis/management/include/G4BaseFileManager.hh (Version 11.3.0) and /analysis/management/include/G4BaseFileManager.hh (Version 11.2.1)


  1 //                                                  1 //
  2 // *******************************************      2 // ********************************************************************
  3 // * License and Disclaimer                         3 // * License and Disclaimer                                           *
  4 // *                                                4 // *                                                                  *
  5 // * The  Geant4 software  is  copyright of th      5 // * The  Geant4 software  is  copyright of the Copyright Holders  of *
  6 // * the Geant4 Collaboration.  It is provided      6 // * the Geant4 Collaboration.  It is provided  under  the terms  and *
  7 // * conditions of the Geant4 Software License      7 // * conditions of the Geant4 Software License,  included in the file *
  8 // * LICENSE and available at  http://cern.ch/      8 // * LICENSE and available at  http://cern.ch/geant4/license .  These *
  9 // * include a list of copyright holders.           9 // * include a list of copyright holders.                             *
 10 // *                                               10 // *                                                                  *
 11 // * Neither the authors of this software syst     11 // * Neither the authors of this software system, nor their employing *
 12 // * institutes,nor the agencies providing fin     12 // * institutes,nor the agencies providing financial support for this *
 13 // * work  make  any representation or  warran     13 // * work  make  any representation or  warranty, express or implied, *
 14 // * regarding  this  software system or assum     14 // * regarding  this  software system or assume any liability for its *
 15 // * use.  Please see the license in the file      15 // * use.  Please see the license in the file  LICENSE  and URL above *
 16 // * for the full disclaimer and the limitatio     16 // * for the full disclaimer and the limitation of liability.         *
 17 // *                                               17 // *                                                                  *
 18 // * This  code  implementation is the result      18 // * This  code  implementation is the result of  the  scientific and *
 19 // * technical work of the GEANT4 collaboratio     19 // * technical work of the GEANT4 collaboration.                      *
 20 // * By using,  copying,  modifying or  distri     20 // * By using,  copying,  modifying or  distributing the software (or *
 21 // * any work based  on the software)  you  ag     21 // * any work based  on the software)  you  agree  to acknowledge its *
 22 // * use  in  resulting  scientific  publicati     22 // * use  in  resulting  scientific  publications,  and indicate your *
 23 // * acceptance of all terms of the Geant4 Sof     23 // * acceptance of all terms of the Geant4 Software license.          *
 24 // *******************************************     24 // ********************************************************************
 25 //                                                 25 //
 26                                                    26 
 27 // Base class for analysis file managers.          27 // Base class for analysis file managers.
 28 //                                                 28 //
 29 // Author: Ivana Hrivnacova, 18/06/2013  (ivan     29 // Author: Ivana Hrivnacova, 18/06/2013  (ivana@ipno.in2p3.fr)
 30                                                    30 
 31 #ifndef G4BaseFileManager_h                        31 #ifndef G4BaseFileManager_h
 32 #define G4BaseFileManager_h 1                      32 #define G4BaseFileManager_h 1
 33                                                    33 
 34 #include "G4AnalysisManagerState.hh"               34 #include "G4AnalysisManagerState.hh"
 35 #include "globals.hh"                              35 #include "globals.hh"
 36                                                    36 
 37 #include <vector>                                  37 #include <vector>
 38                                                    38 
 39 class G4BaseFileManager                            39 class G4BaseFileManager
 40 {                                                  40 {
 41   public:                                          41   public:
 42     explicit G4BaseFileManager(const G4Analysi     42     explicit G4BaseFileManager(const G4AnalysisManagerState& state);
 43     G4BaseFileManager() = delete;                  43     G4BaseFileManager() = delete;
 44     virtual ~G4BaseFileManager() = default;        44     virtual ~G4BaseFileManager() = default;
 45                                                    45 
 46     virtual void SetCompressionLevel(G4int lev <<  46     void SetCompressionLevel(G4int level);
 47       // Set the compression level                 47       // Set the compression level
 48     virtual G4bool SetFileName(const G4String&     48     virtual G4bool SetFileName(const G4String& fileName);
 49       // Set the base file name (without exten     49       // Set the base file name (without extension)
 50     virtual G4String GetFileType() const;          50     virtual G4String GetFileType() const;
 51       // Return the manager type (starts with      51       // Return the manager type (starts with a lowercase letter)
 52     virtual G4bool HasCycles() const;              52     virtual G4bool HasCycles() const;
 53       // Return true when the output supports      53       // Return true when the output supports writing the same object in a file
 54       // multiple times.                           54       // multiple times.
 55       // The default implementation returns fa     55       // The default implementation returns false.
 56                                                    56 
 57     void AddFileName(const G4String& fileName)     57     void AddFileName(const G4String& fileName);
 58       // For handling multiple files               58       // For handling multiple files
 59       // Save file name in a vector if not yet     59       // Save file name in a vector if not yet present
 60                                                    60 
 61     G4int    GetCompressionLevel() const;          61     G4int    GetCompressionLevel() const;
 62       // Return the compression level              62       // Return the compression level
 63     G4String GetFileName() const;                  63     G4String GetFileName() const;
 64       // Return the base file name (without ex     64       // Return the base file name (without extension)
 65     G4String GetFullFileName(const G4String& b     65     G4String GetFullFileName(const G4String& baseFileName = "",
 66                              G4bool isPerThrea     66                              G4bool isPerThread = true) const;
 67       // Compose and return the full file name     67       // Compose and return the full file name:
 68       // - add _tN suffix to the file base nam     68       // - add _tN suffix to the file base name if isPerThread
 69       // - add file extension if not present a     69       // - add file extension if not present and available in state
 70     const std::vector<G4String>& GetFileNames(     70     const std::vector<G4String>& GetFileNames() const;
 71      // Return the file names vector               71      // Return the file names vector
 72                                                    72 
 73     G4String GetHnFileName(const G4String& hnT     73     G4String GetHnFileName(const G4String& hnType,
 74                            const G4String& hnN     74                            const G4String& hnName) const;
 75       // Compose and return the histogram or p     75       // Compose and return the histogram or profile specific file name:
 76       // - add _hn_hnName suffix to the file b     76       // - add _hn_hnName suffix to the file base name
 77       // - add file extension if not present       77       // - add file extension if not present
 78                                                    78 
 79     G4String GetHnFileName(const G4String& fil     79     G4String GetHnFileName(const G4String& fileName,
 80                            G4int cycle = 0) co     80                            G4int cycle = 0) const;
 81       // Update Hn file name:                      81       // Update Hn file name:
 82       // - add _vN  suffix to the base namer i     82       // - add _vN  suffix to the base namer if cycle > 0
 83                                                    83 
 84     G4String GetNtupleFileName(const G4String&     84     G4String GetNtupleFileName(const G4String& ntupleName,
 85                                G4int cycle = 0     85                                G4int cycle = 0) const;
 86       // Compose and return the ntuple specifi     86       // Compose and return the ntuple specific file name:
 87       // - add _nt_ntupleName suffix to the fi     87       // - add _nt_ntupleName suffix to the file base name
 88       // - add _vN  suffix if cycle > 0            88       // - add _vN  suffix if cycle > 0
 89       // - add _tN suffix if called on thread      89       // - add _tN suffix if called on thread worker
 90       // - add file extension if not present       90       // - add file extension if not present
 91                                                    91 
 92     G4String GetNtupleFileName(G4int ntupleFil     92     G4String GetNtupleFileName(G4int ntupleFileNumber,
 93                                 G4int cycle =      93                                 G4int cycle = 0) const;
 94       // Compose and return the ntuple specifi     94       // Compose and return the ntuple specific file name:
 95       // - add _mN suffix to the file base nam     95       // - add _mN suffix to the file base name
 96       // - add _vN  suffix if cycle > 0            96       // - add _vN  suffix if cycle > 0
 97       // - add file extension if not present       97       // - add file extension if not present
 98                                                    98 
 99     G4String GetPlotFileName() const;              99     G4String GetPlotFileName() const;
100       // Return the file name for batch plotti    100       // Return the file name for batch plotting output
101                                                   101 
102   protected:                                      102   protected:
103     // Methods for verbose                        103     // Methods for verbose
104     void Message(G4int level,                     104     void Message(G4int level,
105                  const G4String& action,          105                  const G4String& action,
106                  const G4String& objectType,      106                  const G4String& objectType,
107                  const G4String& objectName =     107                  const G4String& objectName = "",
108                  G4bool success = true) const;    108                  G4bool success = true) const;
109                                                   109 
110     // Clear data                                 110     // Clear data
111     void ClearData();                             111     void ClearData();
112                                                   112 
113     // Data members                               113     // Data members
114     const G4AnalysisManagerState& fState;         114     const G4AnalysisManagerState& fState;
115     G4int fCompressionLevel { 1 };                115     G4int fCompressionLevel { 1 };
116     G4String fFileName;  // to be changed in f    116     G4String fFileName;  // to be changed in fDefaultFileName
117     std::vector<G4String> fFileNames;             117     std::vector<G4String> fFileNames;
118 };                                                118 };
119                                                   119 
120 inline void G4BaseFileManager::SetCompressionL    120 inline void G4BaseFileManager::SetCompressionLevel(G4int level)
121 { fCompressionLevel = level; }                    121 { fCompressionLevel = level; }
122                                                   122 
123 inline G4bool G4BaseFileManager::SetFileName(c    123 inline G4bool G4BaseFileManager::SetFileName(const G4String& fileName) {
124   // CHECK if still needed in this base class     124   // CHECK if still needed in this base class
125   fFileName = fileName;                           125   fFileName = fileName;
126   return true;                                    126   return true;
127 }                                                 127 }
128                                                   128 
129 inline G4bool G4BaseFileManager::HasCycles() c    129 inline G4bool G4BaseFileManager::HasCycles() const {
130   return false;                                   130   return false;
131 }                                                 131 }
132                                                   132 
133 inline G4int G4BaseFileManager::GetCompression    133 inline G4int G4BaseFileManager::GetCompressionLevel() const
134 { return fCompressionLevel; }                     134 { return fCompressionLevel; }
135                                                   135 
136 inline G4String G4BaseFileManager::GetFileName    136 inline G4String G4BaseFileManager::GetFileName() const {
137   return fFileName;                               137   return fFileName;
138 }                                                 138 }
139                                                   139 
140 inline const std::vector<G4String>& G4BaseFile    140 inline const std::vector<G4String>& G4BaseFileManager::GetFileNames() const {
141   return fFileNames;                              141   return fFileNames;
142 }                                                 142 }
143                                                   143 
144 inline void G4BaseFileManager::Message(           144 inline void G4BaseFileManager::Message(
145   G4int level, const G4String& action, const G    145   G4int level, const G4String& action, const G4String& objectType,
146   const G4String& objectName, G4bool success)     146   const G4String& objectName, G4bool success) const
147 {                                                 147 {
148   fState.Message(level, action, objectType, ob    148   fState.Message(level, action, objectType, objectName, success);
149 }                                                 149 }
150                                                   150 
151 inline void G4BaseFileManager::ClearData() {      151 inline void G4BaseFileManager::ClearData() {
152   fFileNames.clear();                             152   fFileNames.clear();
153 }                                                 153 }
154                                                   154 
155 #endif                                            155 #endif
156                                                   156