00001 // 00002 // ******************************************************************** 00003 // * License and Disclaimer * 00004 // * * 00005 // * The Geant4 software is copyright of the Copyright Holders of * 00006 // * the Geant4 Collaboration. It is provided under the terms and * 00007 // * conditions of the Geant4 Software License, included in the file * 00008 // * LICENSE and available at http://cern.ch/geant4/license . These * 00009 // * include a list of copyright holders. * 00010 // * * 00011 // * Neither the authors of this software system, nor their employing * 00012 // * institutes,nor the agencies providing financial support for this * 00013 // * work make any representation or warranty, express or implied, * 00014 // * regarding this software system or assume any liability for its * 00015 // * use. Please see the license in the file LICENSE and URL above * 00016 // * for the full disclaimer and the limitation of liability. * 00017 // * * 00018 // * This code implementation is the result of the scientific and * 00019 // * technical work of the GEANT4 collaboration. * 00020 // * By using, copying, modifying or distributing the software (or * 00021 // * any work based on the software) you agree to acknowledge its * 00022 // * use in resulting scientific publications, and indicate your * 00023 // * acceptance of all terms of the Geant4 Software license. * 00024 // ******************************************************************** 00025 // 00026 #ifndef G4CASCADE_COLLIDER_BASE_HH 00027 #define G4CASCADE_COLLIDER_BASE_HH 00028 // $Id$ 00029 // 00030 // 20100714 M. Kelsey -- Move functionality from G4VCascadeCollider, and 00031 // provide conservation-checking here, with wrapper function 00032 // and control flag. 00033 // 20100720 M. Kelsey -- Change G4CascadeCheckBalance to pointer member 00034 // 20100925 M. Kelsey -- Add explosion(A,Z,Eex) and explosion(G4Fragment) 00035 // interfaces 00036 // 20110225 M. Kelsey -- Add setVerboseLevel(), calls through to members 00037 // 20110304 M. Kelsey -- Add dummy rescatter() interface here, to enforce 00038 // consistency in subclass colliders. 00039 // 20110321 M. Kelsey -- Hide names of arguments to rescatter(), to avoid 00040 // compiler warnings on some GCC versions. 00041 00042 #include "G4VCascadeCollider.hh" 00043 00044 #include "globals.hh" 00045 #include "G4InteractionCase.hh" 00046 #include <vector> 00047 00048 class G4InuclElementaryParticle; 00049 class G4InuclNuclei; 00050 class G4InuclParticle; 00051 class G4CollisionOutput; 00052 class G4CascadeCheckBalance; 00053 class G4Fragment; 00054 class G4KineticTrackVector; 00055 class G4V3DNucleus; 00056 00057 00058 class G4CascadeColliderBase : public G4VCascadeCollider { 00059 public: 00060 G4CascadeColliderBase(const char* name, G4int verbose=0); 00061 virtual ~G4CascadeColliderBase(); 00062 00063 // For use with top-level Propagate to preload a set of secondaries 00064 virtual void rescatter(G4InuclParticle* /*bullet*/, 00065 G4KineticTrackVector* /*theSecondaries*/, 00066 G4V3DNucleus* /*theNucleus*/, 00067 G4CollisionOutput& /*globalOutput*/) { ; } 00068 00069 virtual void setVerboseLevel(G4int verbose=0); 00070 00071 virtual void setConservationChecks(G4bool doBalance=true) { 00072 doConservationChecks = doBalance; 00073 } 00074 00075 protected: 00076 G4InteractionCase interCase; // Determine bullet vs. target 00077 G4bool doConservationChecks; // Conservation-law validation 00078 G4CascadeCheckBalance* balance; 00079 00080 // Decide whether to use G4ElementaryParticleCollider or not 00081 virtual G4bool useEPCollider(G4InuclParticle* bullet, 00082 G4InuclParticle* target) const; 00083 00084 // Decide whether to use G4BigBanger or not 00085 virtual G4bool explosion(G4InuclNuclei* target) const; 00086 virtual G4bool explosion(G4Fragment* target) const; 00087 virtual G4bool explosion(G4int A, G4int Z, G4double excitation) const; 00088 00089 // Decide whether to use G4IntraNuclearCascader or not 00090 virtual G4bool inelasticInteractionPossible(G4InuclParticle* bullet, 00091 G4InuclParticle* target, 00092 G4double ekin) const; 00093 00094 // ==> Provide same interfaces as G4CascadeCheckBalance itself 00095 00096 // Validate output for energy, momentum conservation, etc. 00097 virtual G4bool validateOutput(G4InuclParticle* bullet, 00098 G4InuclParticle* target, 00099 G4CollisionOutput& output); 00100 00101 // This is for use with G4EPCollider and G4BigBanger 00102 virtual G4bool validateOutput(G4InuclParticle* bullet, 00103 G4InuclParticle* target, 00104 const std::vector<G4InuclElementaryParticle>& particles); 00105 00106 // This is for use with G4Fissioner 00107 virtual G4bool validateOutput(G4InuclParticle* bullet, 00108 G4InuclParticle* target, 00109 const std::vector<G4InuclNuclei>& fragments); 00110 }; 00111 00112 #endif /* G4CASCADE_COLLIDER_BASE_HH */