Calo/include/Run.hh

0001 //
0002 // ********************************************************************
0003 // * License and Disclaimer                                           *
0004 // *                                                                  *
0005 // * The  Geant4 software  is  copyright of the Copyright Holders  of *
0006 // * the Geant4 Collaboration.  It is provided  under  the terms  and *
0007 // * conditions of the Geant4 Software License,  included in the file *
0008 // * LICENSE and available at  http://cern.ch/geant4/license .  These *
0009 // * include a list of copyright holders.                             *
0010 // *                                                                  *
0011 // * Neither the authors of this software system, nor their employing *
0012 // * institutes,nor the agencies providing financial support for this *
0013 // * work  make  any representation or  warranty, express or implied, *
0014 // * regarding  this  software system or assume any liability for its *
0015 // * use.  Please see the license in the file  LICENSE  and URL above *
0016 // * for the full disclaimer and the limitation of liability.         *
0017 // *                                                                  *
0018 // * This  code  implementation is the result of  the  scientific and *
0019 // * technical work of the GEANT4 collaboration.                      *
0020 // * By using,  copying,  modifying or  distributing the software (or *
0021 // * any work based  on the software)  you  agree  to acknowledge its *
0022 // * use  in  resulting  scientific  publications,  and indicate your *
0023 // * acceptance of all terms of the Geant4 Software license.          *
0024 // ********************************************************************
0025 //
0026 /// \file Run.hh
0027 /// \brief Definition of the Run class
0028
0029 #ifndef Run_h
0030 #define Run_h 1
0031
0032 #include "SteppingAction.hh"
0033 #include "TrackingAction.hh"
0034
0035 #include "G4Run.hh"
0036 #include "G4ThreeVector.hh"
0037
0038 #include <array>
0039
0040 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo......
0041
0042 class Run : public G4Run
0043 {
0044     // This class accumulates relevant quantities related to particle fluence collected during
0045     // the run.
0046     // ( Note: these information are provided via calls of accessor methods of this Run class
0047     //         made by SteppingAction::UserSteppingAction
0048     //         and     TrackingAction::PreUserTrackingAction. )
0049     // At the end of a run, the  PrintInfo  method is called by the run-action to print out
0050     // some summary information about these quantities.
0051     // In multithreaded (MT) mode, an object of this class is filled up for each working thread,
0052     // and then merged (automatically by the Geant4 kernel) into another object (of this class)
0053     // owned by the master class; the  PrintInfo  method is then called only for the latter run
0054     // object.
0055     // Note that, for simplicity and brevity, we avoid histograms and print-out instead some
0056     // statistics (compute by ourself) at the end of the run.
0057   public:
0058     Run();
0059     ~Run() override = default;
0060
0061     void RecordEvent(const G4Event* anEvent) override;
0062     // This method is called automatically by the Geant4 kernel (not by the user!) at the end
0063     // of each event. In the case of multithreaded mode, it is called only for the working thread
0064     // that handled that event.
0065
0066     void Merge(const G4Run* aRun) override;
0067     // This method is called automatically by the Geant4 kernel (not by the user!) only in the
0068     // case of multithreaded mode and only for working threads.
0069
0070     void PrintInfo() const;
0071     // This method is called by RunAction::EndOfRunAction : in the case of multithreaded mode,
0072     // only the master thread calls it.
0073
0074     void SetPrimaryParticleId(const G4int inputValue) { fPrimaryParticleId = inputValue; }
0075     void SetPrimaryParticleEnergy(const G4double inputValue)
0076     {
0077       fPrimaryParticleEnergy = inputValue;
0078     }
0079     void SetPrimaryParticleDirection(const G4ThreeVector& inputValue)
0080     {
0081       fPrimaryParticleDirection = inputValue;
0082     }
0083     void SetAbsorberMaterialName(const G4String& inputValue) { fAbsorberMaterialName = inputValue; }
0084     void SetActiveMaterialName(const G4String& inputValue) { fActiveMaterialName = inputValue; }
0085     void SetCubicVolumeScoringUpDown(const G4double inputValue)
0086     {
0087       fCubicVolumeScoringUpDown = inputValue;
0088     }
0089     void SetCubicVolumeScoringSide(const G4double inputValue)
0090     {
0091       fCubicVolumeScoringSide = inputValue;
0092     }
0093     G4int GetPrimaryParticleId() const { return fPrimaryParticleId; }
0094     G4double GetPrimaryParticleEnergy() const { return fPrimaryParticleEnergy; }
0095     G4ThreeVector GetPrimaryParticleDirection() const { return fPrimaryParticleDirection; }
0096     G4String GetAbsorberMaterialName() const { return fAbsorberMaterialName; }
0097     G4String GetActiveMaterialName() const { return fActiveMaterialName; }
0098     G4double GetCubicVolumeScoringUpDown() const { return fCubicVolumeScoringUpDown; }
0099     G4double GetCubicVolumeScoringSide() const { return fCubicVolumeScoringSide; }
0100
0101     void
0102     SetSteppingArray(const std::array<G4double, SteppingAction::fkNumberCombinations>& inputArray);
0103     std::array<G4double, SteppingAction::fkNumberCombinations> GetSteppingArray() const
0104     {
0105       return fSteppingArray;
0106     }
0107     // Accessor methods useful to transfer information collected by the stepping-action
0108     // into this Run class
0109
0110     void
0111     SetTrackingArray1(const std::array<G4long, TrackingAction::fkNumberCombinations>& inputArray);
0112     std::array<G4long, TrackingAction::fkNumberCombinations> GetTrackingArray1() const
0113     {
0114       return fTrackingArray1;
0115     }
0116     void
0117     SetTrackingArray2(const std::array<G4double, TrackingAction::fkNumberCombinations>& inputArray);
0118     std::array<G4double, TrackingAction::fkNumberCombinations> GetTrackingArray2() const
0119     {
0120       return fTrackingArray2;
0121     }
0122     // Accessor methods useful to transfer information collected by the tracking-action
0123     // into this Run class
0124
0125   private:
0126     G4int fNumEvents;
0127     G4int fPrimaryParticleId;
0128     G4double fPrimaryParticleEnergy;
0129     G4ThreeVector fPrimaryParticleDirection;
0130     G4String fAbsorberMaterialName;
0131     G4String fActiveMaterialName;
0132     G4double fCubicVolumeScoringUpDown;
0133     G4double fCubicVolumeScoringSide;
0134     std::array<G4double, SteppingAction::fkNumberCombinations> fSteppingArray;
0135     std::array<G4long, TrackingAction::fkNumberCombinations> fTrackingArray1;
0136     std::array<G4double, TrackingAction::fkNumberCombinations> fTrackingArray2;
0137 };
0138
0139 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo......
0140
0141 #endif