Import Geant4 7.1.0 source tree

source/event/include/G4PrimaryTransformer.hh

@@ -21,8 +21,8 @@
 // ********************************************************************
 //
 //
-// $Id: G4PrimaryTransformer.hh,v 1.8 2004/08/10 23:59:37 asaim Exp $
-// GEANT4 tag $Name: geant4-07-00-cand-01 $
+// $Id: G4PrimaryTransformer.hh,v 1.10 2005/04/27 01:32:46 asaim Exp $
+// GEANT4 tag $Name: geant4-07-01 $
 //
 
 #ifndef G4PromaryTransformer_h 
@@ -63,17 +63,35 @@ class G4PrimaryTransformer
     inline void SetVerboseLevel(G4int vl)
     { verboseLevel = vl; };
 
+  public: //with description
+    void SetUnknnownParticleDefined(G4bool vl);
+    // By invoking this Set method, the user can alter the treatment of unknown
+    // particle. The ideal place to invoke this method is in the BeginOfRunAction.
+
+    inline G4bool GetUnknownParticleDefined() const
+    { return unknownParticleDefined; }
+
   protected:
     void GenerateTracks(G4PrimaryVertex* primaryVertex);
     void GenerateSingleTrack(G4PrimaryParticle* primaryParticle,
               G4double x0,G4double y0,G4double z0,G4double t0,G4double wv);
     void SetDecayProducts(G4PrimaryParticle* mother,
                             G4DynamicParticle* motherDP);
+    G4bool CheckDynamicParticle(G4DynamicParticle*DP);
+
   protected: //with description
+  // Following two virtual methods are provided to customize the use of PrimaryTransformer
+  // for particle types exotic to Geant4.
+
     virtual G4ParticleDefinition* GetDefinition(G4PrimaryParticle*pp);
-    // virtual method to be overwritten. Return appropriate G4ParticleDefinition
-    // w.r.t. the primary particle. If NULL is return, the particle will not be
-    // treated as a track, but its daughters will be examined.
+    // Return appropriate G4ParticleDefinition w.r.t. the primary particle. 
+    // If NULL is returned, the particle will not be treated as a track, but its daughters
+    // will be examined in case it has "pre-assigned decay products".
+
+    virtual G4bool IsGoodForTrack(G4ParticleDefinition*pd);
+    // Return true if a primary particle should be converted into a track.
+    // By default, all particles of non-shortlived and shortlived with valid decay
+    // tables are converted.
 };
 
 #endif