include/Geant4/G4Trajectory.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 // G4Trajectory
0027 //
0028 // Class description:
0029 //
0030 // This class represents the trajectory of a particle being tracked.
0031 // It includes information of:
0032 //     1) List of trajectory points which compose the trajectory;
0033 //     2) Static information of the particle which generated the
0034 //        trajectory;
0035 //     3) Track ID and parent particle ID of the trajectory.
0036
0037 // Contact:
0038 //   Questions and comments to this code should be sent to
0039 //     Katsuya Amako  (e-mail: Katsuya.Amako@kek.jp)
0040 //     Makoto  Asai   (e-mail: asai@slac.stanford.edu)
0041 //     Takashi Sasaki (e-mail: Takashi.Sasaki@kek.jp)
0042 // --------------------------------------------------------------------
0043 #ifndef G4Trajectory_hh
0044 #define G4Trajectory_hh 1
0045
0046 #include "G4Allocator.hh"
0047 #include "G4ParticleDefinition.hh"  // Include from 'particle+matter'
0048 #include "G4Step.hh"
0049 #include "G4Track.hh"
0050 #include "G4TrajectoryPoint.hh"  // Include from 'tracking'
0051 #include "G4VTrajectory.hh"
0052 #include "G4ios.hh"  // Include from 'system'
0053 #include "globals.hh"  // Include from 'global'
0054
0055 #include "trkgdefs.hh"
0056 #include <stdlib.h>  // Include from 'system'
0057
0058 #include <vector>
0059
0060 class G4Polyline;
0061
0062 class G4Trajectory : public G4VTrajectory
0063 {
0064   using G4TrajectoryPointContainer = std::vector<G4VTrajectoryPoint*>;
0065
0066  public:
0067   // Constructors/Destructor
0068
0069   G4Trajectory() = default;
0070   G4Trajectory(const G4Track* aTrack);
0071   G4Trajectory(G4Trajectory&);
0072   ~G4Trajectory() override;
0073
0074   // Operators
0075
0076   inline void* operator new(size_t);
0077   inline void operator delete(void*);
0078   inline G4bool operator==(const G4Trajectory& r) const;
0079
0080   // Get/Set functions
0081
0082   inline G4int GetTrackID() const override { return fTrackID; }
0083   inline G4int GetParentID() const override { return fParentID; }
0084   inline G4String GetParticleName() const override { return ParticleName; }
0085   inline G4double GetCharge() const override { return PDGCharge; }
0086   inline G4int GetPDGEncoding() const override { return PDGEncoding; }
0087   inline G4double GetInitialKineticEnergy() const { return initialKineticEnergy; }
0088   inline G4ThreeVector GetInitialMomentum() const override { return initialMomentum; }
0089
0090   // Other member functions
0091
0092   void ShowTrajectory(std::ostream& os = G4cout) const override;
0093   void DrawTrajectory() const override;
0094   void AppendStep(const G4Step* aStep) override;
0095   G4int GetPointEntries() const override { return G4int(positionRecord->size()); }
0096   G4VTrajectoryPoint* GetPoint(G4int i) const override { return (*positionRecord)[i]; }
0097   void MergeTrajectory(G4VTrajectory* secondTrajectory) override;
0098
0099   G4ParticleDefinition* GetParticleDefinition();
0100
0101   const std::map<G4String, G4AttDef>* GetAttDefs() const override;
0102   std::vector<G4AttValue>* CreateAttValues() const override;
0103
0104  private:
0105   G4TrajectoryPointContainer* positionRecord = nullptr;
0106   G4int fTrackID = 0;
0107   G4int fParentID = 0;
0108   G4int PDGEncoding = 0;
0109   G4double PDGCharge = 0.0;
0110   G4String ParticleName = "";
0111   G4double initialKineticEnergy = 0.0;
0112   G4ThreeVector initialMomentum;
0113 };
0114
0115 extern G4TRACKING_DLL G4Allocator<G4Trajectory>*& aTrajectoryAllocator();
0116
0117 inline void* G4Trajectory::operator new(size_t)
0118 {
0119   if (aTrajectoryAllocator() == nullptr) {
0120     aTrajectoryAllocator() = new G4Allocator<G4Trajectory>;
0121   }
0122   return (void*)aTrajectoryAllocator()->MallocSingle();
0123 }
0124
0125 inline void G4Trajectory::operator delete(void* aTrajectory)
0126 {
0127   aTrajectoryAllocator()->FreeSingle((G4Trajectory*)aTrajectory);
0128 }
0129
0130 inline G4bool G4Trajectory::operator==(const G4Trajectory& r) const { return (this == &r); }
0131
0132 #endif