Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/processes/biasing/management/include/G4VBiasingInteractionLaw.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 ]

  1 //
  2 // ********************************************************************
  3 // * License and Disclaimer                                           *
  4 // *                                                                  *
  5 // * The  Geant4 software  is  copyright of the Copyright Holders  of *
  6 // * the Geant4 Collaboration.  It is provided  under  the terms  and *
  7 // * conditions of the Geant4 Software License,  included in the file *
  8 // * LICENSE and available at  http://cern.ch/geant4/license .  These *
  9 // * include a list of copyright holders.                             *
 10 // *                                                                  *
 11 // * Neither the authors of this software system, nor their employing *
 12 // * institutes,nor the agencies providing financial support for this *
 13 // * work  make  any representation or  warranty, express or implied, *
 14 // * regarding  this  software system or assume any liability for its *
 15 // * use.  Please see the license in the file  LICENSE  and URL above *
 16 // * for the full disclaimer and the limitation of liability.         *
 17 // *                                                                  *
 18 // * This  code  implementation is the result of  the  scientific and *
 19 // * technical work of the GEANT4 collaboration.                      *
 20 // * By using,  copying,  modifying or  distributing the software (or *
 21 // * any work based  on the software)  you  agree  to acknowledge its *
 22 // * use  in  resulting  scientific  publications,  and indicate your *
 23 // * acceptance of all terms of the Geant4 Software license.          *
 24 // ********************************************************************
 25 //
 26 // G4VBiasingInteractionLaw
 27 //
 28 // Class Description:
 29 //
 30 // An abstract class to model interaction laws, not necessarily.
 31 // exponential ones.
 32 // These laws, p(l), are caraterized by their:
 33 //    - non-interaction probability over l:
 34 //      P_NI(l) = 1 - integral(0,l) p(s) ds
 35 //    - effective cross-section at l:
 36 //      sigma_eff(l) = p(l)/P_NI(l) (several forms exist)
 37 // If several laws compete, the resulting net law has:
 38 //    - an non-interaction probability over a lenght l which
 39 //      is the product of the individual non-interaction probabilities.
 40 //    - an effective cross-section which is the
 41 //      sum on the individual effective cross-sections.
 42 //
 43 // Author: M.Verderi (LLR), November 2013
 44 // --------------------------------------------------------------------
 45 #ifndef G4VBiasingInteractionLaw_hh
 46 #define G4VBiasingInteractionLaw_hh 1
 47 
 48 #include "globals.hh"
 49 #include <vector>
 50 
 51 class G4BiasingProcessInterface;
 52 
 53 class G4VBiasingInteractionLaw
 54 {
 55   public:
 56 
 57     G4VBiasingInteractionLaw(const G4String& name)
 58       : fName(name), fSampledInteractionLength(DBL_MAX) {}
 59     virtual ~G4VBiasingInteractionLaw() = default;
 60 
 61     const G4String& GetName() const { return fName; }
 62 
 63     // -- Compute non-interaction probability and effective cross-section:
 64     // -- (probability of interaction over dl =  effective_cross-section* dl)
 65     virtual G4double ComputeNonInteractionProbabilityAt(G4double length) const = 0;
 66     virtual G4double ComputeEffectiveCrossSectionAt(G4double length) const = 0;
 67 
 68     // -- Methods to deal with singularities : null cross sections or infinite ones.
 69     // -- In such cases, weight can not always be computed.
 70     // -- Tells if this interaction law has singularities:
 71     virtual G4bool IsSingular() const { return false; }
 72     // -- method interrogated only in case interaction law is IsSingular() == true:
 73     virtual G4bool IsEffectiveCrossSectionInfinite() const { return false; }
 74 
 75     // -----------------------------------------
 76     // -- public interface to protected methods:
 77     // -----------------------------------------
 78     G4double Sample()
 79     {
 80       fSampledInteractionLength = SampleInteractionLength();
 81       return fSampledInteractionLength;
 82     }
 83     G4double UpdateForStep(G4double truePathLength)
 84     {
 85       fSampledInteractionLength = UpdateInteractionLengthForStep(truePathLength);
 86       return fSampledInteractionLength;
 87     }
 88     G4double GetSampledInteractionLength() const
 89     {
 90       return fSampledInteractionLength;
 91     }
 92 
 93   protected:
 94 
 95     // -- Sample the distribution for point like interaction (PostStep ones)
 96     virtual G4double SampleInteractionLength() = 0;
 97 
 98     // -- Convenience method, used in many daughters classes :
 99     // -- update the distribution for a made step of truePathLength size:
100     virtual G4double UpdateInteractionLengthForStep(G4double /* truePathLength */)
101       { return DBL_MAX; }
102 
103   private:
104 
105     G4String fName;
106     G4double fSampledInteractionLength;
107 };
108 
109 #endif
110