include/Geant4/G4INCLCoulombNonRelativistic.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 // INCL++ intra-nuclear cascade model
0027 // Alain Boudard, CEA-Saclay, France
0028 // Joseph Cugnon, University of Liege, Belgium
0029 // Jean-Christophe David, CEA-Saclay, France
0030 // Pekka Kaitaniemi, CEA-Saclay, France, and Helsinki Institute of Physics, Finland
0031 // Sylvie Leray, CEA-Saclay, France
0032 // Davide Mancusi, CEA-Saclay, France
0033 //
0034 #define INCLXX_IN_GEANT4_MODE 1
0035
0036 #include "globals.hh"
0037
0038 /** \file G4INCLCoulombNonRelativistic.hh
0039  * \brief Class for non-relativistic Coulomb distortion.
0040  *
0041  * \date 14 February 2011
0042  * \author Davide Mancusi
0043  */
0044
0045 #ifndef G4INCLCOULOMBNONRELATIVISTIC_HH_
0046 #define G4INCLCOULOMBNONRELATIVISTIC_HH_
0047
0048 #include "G4INCLParticle.hh"
0049 #include "G4INCLNucleus.hh"
0050 #include "G4INCLICoulomb.hh"
0051 #include "G4INCLCoulombNone.hh"
0052 #include "G4INCLGlobals.hh"
0053
0054 namespace G4INCL {
0055
0056   class CoulombNonRelativistic : public ICoulomb {
0057     public:
0058       CoulombNonRelativistic() {}
0059       virtual ~CoulombNonRelativistic() {}
0060
0061       /** \brief Modify the momentum of the particle and position it on the
0062        *         surface of the nucleus.
0063        *
0064        * This method performs non-relativistic distortion.
0065        *
0066        * \param p incoming particle
0067        * \param n distorting nucleus
0068        **/
0069       ParticleEntryAvatar *bringToSurface(Particle * const p, Nucleus * const n) const;
0070
0071      ParticleEntryAvatar *bringToSurfaceAbar(Particle * const p, Nucleus * const n) const;
0072
0073       /** \brief Modify the momentum of the incoming cluster and position it on
0074        *         the surface of the nucleus.
0075        *
0076        * This method performs non-relativistic distortion. The momenta of the
0077        * particles that compose the cluster are also distorted.
0078        *
0079        * \param c incoming cluster
0080        * \param n distorting nucleus
0081        **/
0082       IAvatarList bringToSurface(Cluster * const c, Nucleus * const n) const;
0083
0084       /** \brief Modify the momenta of the outgoing particles.
0085        *
0086        * This method performs non-relativistic distortion.
0087        *
0088        * \param pL list of outgoing particles
0089        * \param n distorting nucleus
0090        */
0091       void distortOut(ParticleList const &pL, Nucleus const * const n) const;
0092
0093       /** \brief Return the maximum impact parameter for Coulomb-distorted
0094        *         trajectories. **/
0095       G4double maxImpactParameter(ParticleSpecies const &p, const G4double kinE, Nucleus const *
0096           const n) const;
0097
0098     private:
0099       /// \brief Return the minimum distance of approach in a head-on collision (b=0).
0100       G4double minimumDistance(ParticleSpecies const &p, const G4double kineticEnergy, Nucleus const * const n) const {
0101         const G4double particleMass = ParticleTable::getTableSpeciesMass(p);
0102         const G4double nucleusMass = n->getTableMass();
0103         const G4double reducedMass = particleMass*nucleusMass/(particleMass+nucleusMass);
0104         const G4double kineticEnergyInCM = kineticEnergy * reducedMass / particleMass;
0105         const G4double theMinimumDistance = ( kineticEnergyInCM <= 0.0 ? 0.0 :
0106                 PhysicalConstants::eSquared * p.theZ * n->getZ() * particleMass
0107                 / (kineticEnergyInCM * reducedMass) );
0108         INCL_DEBUG("Minimum distance of approach due to Coulomb = " << theMinimumDistance << '\n');
0109         return theMinimumDistance;
0110       }
0111
0112       /// \brief Return the minimum distance of approach in a head-on collision (b=0).
0113       G4double minimumDistance(Particle const * const p, Nucleus const * const n) const {
0114         return minimumDistance(p->getSpecies(), p->getKineticEnergy(), n);
0115       }
0116
0117       /** \brief Perform Coulomb deviation
0118        *
0119        * Modifies the entrance angle of the particle and its impact parameter.
0120        * Can be applied to Particles and Clusters.
0121        *
0122        * The trajectory for an asymptotic impact parameter \f$b\f$ is
0123        * parametrised as follows:
0124        * \f[
0125        * r(\theta) = \frac{(1-e^2)r_0/2}{1-e \sin(\theta-\theta_R/2)},
0126        * \f]
0127        * here \f$e\f$ is the hyperbola eccentricity:
0128        * \f[
0129        * e = \sqrt{1+4b^2/r_0^2};
0130        * \f]
0131        * \f$\theta_R\f$ is the Rutherford scattering angle:
0132        * \f[
0133        * \theta_R = \pi - 2\arctan\left(\frac{2b}{r_0}\right)
0134        * \f]
0135        * \f$\theta\f$ ranges from \f$\pi\f$ (initial state) to \f$\theta_R\f$
0136        * (scattered particle) and \f$r_0\f$ is the minimum distance of approach
0137        * in a head-on collision (see the minimumDistance() method).
0138        *
0139        * \param p pointer to the Particle
0140        * \param n pointer to the Nucleus
0141        * \return false if below the barrier
0142        */
0143       G4bool coulombDeviation(Particle * const p, Nucleus const * const n) const;
0144
0145       /** \brief Get the Coulomb radius for a given particle
0146        *
0147        * That's the radius of the sphere that the Coulomb trajectory of the
0148        * incoming particle should intersect. The intersection point is used to
0149        * determine the effective impact parameter of the trajectory and the new
0150        * entrance angle.
0151        *
0152        * If the particle is not a Cluster, the Coulomb radius reduces to the
0153        * surface radius. We use a parametrisation for d, t, He3 and alphas. For
0154        * heavier clusters we fall back to the surface radius.
0155        *
0156        * \param p the particle species
0157        * \param n the deflecting nucleus
0158        * \return Coulomb radius
0159        */
0160       G4double getCoulombRadius(ParticleSpecies const &p, Nucleus const * const n) const;
0161
0162       /// \brief Internal CoulombNone slave to generate the avatars
0163       CoulombNone theCoulombNoneSlave;
0164   };
0165 }
0166
0167 #endif /* G4INCLCOULOMBNONRELATIVISTIC_HH_ */