G4FTFModel.hh

Go to the documentation of this file.

//
// ********************************************************************
// * License and Disclaimer                                           *
// *                                                                  *
// * The  Geant4 software  is  copyright of the Copyright Holders  of *
// * the Geant4 Collaboration.  It is provided  under  the terms  and *
// * conditions of the Geant4 Software License,  included in the file *
// * LICENSE and available at  http://cern.ch/geant4/license .  These *
// * include a list of copyright holders.                             *
// *                                                                  *
// * Neither the authors of this software system, nor their employing *
// * institutes,nor the agencies providing financial support for this *
// * work  make  any representation or  warranty, express or implied, *
// * regarding  this  software system or assume any liability for its *
// * use.  Please see the license in the file  LICENSE  and URL above *
// * for the full disclaimer and the limitation of liability.         *
// *                                                                  *
// * This  code  implementation is the result of  the  scientific and *
// * technical work of the GEANT4 collaboration.                      *
// * By using,  copying,  modifying or  distributing the software (or *
// * any work based  on the software)  you  agree  to acknowledge its *
// * use  in  resulting  scientific  publications,  and indicate your *
// * acceptance of all terms of the Geant4 Software license.          *
// ********************************************************************
//
//
//
// Class Description
// Final state production code for hadron inelastic scattering above 3 GeV
// based on the modeling ansatz used in FRITIOF.
// To be used in your physics list in case you need this physics.
// In this case you want to register an object of this class with an object
// of G4TheoFSGenerator. 
// Class Description - End
 
#ifndef G4FTFModel_h
#define G4FTFModel_h 1
 
// ------------------------------------------------------------
//      GEANT 4 class header file
//
//      ---------------- G4FTFModel ----------------
//             by Gunter Folger, May 1998.
//       class implementing the excitation in the FTF Parton String Model
// ------------------------------------------------------------
 
#include "G4VPartonStringModel.hh"
#include "G4FTFParameters.hh"
#include "G4FTFParticipants.hh"
#include "G4ExcitedStringVector.hh"
#include "G4DiffractiveExcitation.hh"
#include "G4ElasticHNScattering.hh"
#include "G4FTFAnnihilation.hh"
#include "G4Proton.hh"
#include "G4Neutron.hh"
 
class G4VSplitableHadron;
class G4ExcitedString;
 
 
class G4FTFModel : public G4VPartonStringModel {
  public:
    G4FTFModel( const G4String& modelName = "FTF" );
    ~G4FTFModel() override;
 
    G4V3DNucleus* GetTargetNucleus() const;
    G4V3DNucleus* GetWoundedNucleus() const override;
    G4V3DNucleus* GetProjectileNucleus() const override;
 
    void ModelDescription( std::ostream& ) const override;
 
    G4FTFModel( const G4FTFModel& right ) = delete;
    const G4FTFModel& operator=( const G4FTFModel& right ) = delete;
    G4bool operator==( const G4FTFModel& right ) const = delete;
    G4bool operator!=( const G4FTFModel& right ) const = delete;
 
  protected:
    void Init( const G4Nucleus& aNucleus, 
               const G4DynamicParticle& aProjectile ) override;
    G4ExcitedStringVector* GetStrings() override;
 
  private:
    void StoreInvolvedNucleon();              
    void ReggeonCascade();
    G4bool PutOnMassShell();
    G4bool ExciteParticipants();
    void BuildStrings( G4ExcitedStringVector* strings );
    void GetResiduals();
      
    G4bool AdjustNucleons( G4VSplitableHadron* SelectedAntiBaryon,
                           G4Nucleon*          ProjectileNucleon,
                           G4VSplitableHadron* SelectedTargetNucleon,
                           G4Nucleon*          TargetNucleon,
                           G4bool              Annihilation ); 
    // The "AdjustNucleons" method uses the following struct and 3 new utility methods:
    struct CommonVariables {
      G4int TResidualMassNumber = 0, TResidualCharge = 0, PResidualMassNumber = 0, 
        PResidualCharge = 0;
      G4double SqrtS = 0.0, S = 0.0, SumMasses = 0.0,
        TResidualExcitationEnergy = 0.0, TResidualMass = 0.0, TNucleonMass = 0.0,
        PResidualExcitationEnergy = 0.0, PResidualMass = 0.0, PNucleonMass = 0.0,
        Mprojectile = 0.0, M2projectile = 0.0, Pzprojectile = 0.0, Eprojectile = 0.0, 
        WplusProjectile = 0.0,
        Mtarget = 0.0, M2target = 0.0, Pztarget = 0.0, Etarget = 0.0, WminusTarget = 0.0,
        Mt2targetNucleon = 0.0, PztargetNucleon = 0.0, EtargetNucleon = 0.0,
        Mt2projectileNucleon = 0.0, PzprojectileNucleon = 0.0, EprojectileNucleon = 0.0,
        YtargetNucleus = 0.0, YprojectileNucleus = 0.0,
        XminusNucleon = 0.0, XplusNucleon = 0.0, XminusResidual = 0.0, XplusResidual = 0.0;
      G4ThreeVector PtNucleon, PtResidual, PtNucleonP, PtResidualP, PtNucleonT, PtResidualT;
      G4LorentzVector Psum, Pprojectile, Ptmp, Ptarget, TResidual4Momentum, PResidual4Momentum;
      G4LorentzRotation toCms, toLab;
    };
    G4int AdjustNucleonsAlgorithm_beforeSampling( G4int               interactionCase, 
                                                  G4VSplitableHadron* SelectedAntiBaryon,
                                                  G4Nucleon*          ProjectileNucleon,
                                                  G4VSplitableHadron* SelectedTargetNucleon,
                                                  G4Nucleon*          TargetNucleon,
                                                  G4bool              Annihilation,
                                                  CommonVariables&    common );  
    G4bool AdjustNucleonsAlgorithm_Sampling(      G4int interactionCase, 
                                                  CommonVariables& common );
    void AdjustNucleonsAlgorithm_afterSampling( G4int               interactionCase, 
                                                G4VSplitableHadron* SelectedAntiBaryon,
                                                G4VSplitableHadron* SelectedTargetNucleon,
                                                CommonVariables&    common ); 
 
    G4ThreeVector GaussianPt( G4double AveragePt2, G4double maxPtSquare ) const;
 
    G4bool ComputeNucleusProperties( G4V3DNucleus* nucleus, G4LorentzVector& nucleusMomentum, 
                                     G4LorentzVector& residualMomentum, G4double& sumMasses,   
                                     G4double& residualExcitationEnergy, G4double& residualMass,
                                     G4int& residualMassNumber, G4int& residualCharge );
    // Utility method used by PutOnMassShell.
 
    G4bool GenerateDeltaIsobar( const G4double sqrtS, const G4int numberOfInvolvedNucleons,
                                G4Nucleon* involvedNucleons[], G4double& sumMasses );
    // Utility method used by PutOnMassShell.
 
    G4bool SamplingNucleonKinematics( G4double averagePt2, const G4double maxPt2,
                                      G4double dCor, G4V3DNucleus* nucleus,
                                      const G4LorentzVector& pResidual, 
                                      const G4double residualMass, const G4int residualMassNumber,
                                      const G4int numberOfInvolvedNucleons,
                                      G4Nucleon* involvedNucleons[], G4double& mass2 );
 
    // Utility method used by PutOnMassShell.
 
    G4bool CheckKinematics( const G4double sValue, const G4double sqrtS, 
                            const G4double projectileMass2, const G4double targetMass2,
                            const G4double nucleusY, const G4bool isProjectileNucleus,
                            const G4int numberOfInvolvedNucleons, G4Nucleon* involvedNucleons[],
                            G4double& targetWminus, G4double& projectileWplus, G4bool& success );
    // Utility method used by PutOnMassShell.
 
    G4bool FinalizeKinematics( const G4double w, const G4bool isProjectileNucleus, 
                               const G4LorentzRotation& boostFromCmsToLab,
                               const G4double residualMass, const G4int residualMassNumber,
                               const G4int numberOfInvolvedNucleons, 
                               G4Nucleon* involvedNucleons[],
                           G4LorentzVector& residual4Momentum );
    // Utility method used by PutOnMassShell.
 
    G4ReactionProduct theProjectile;       
    G4FTFParticipants theParticipants;
       
    G4Nucleon* TheInvolvedNucleonsOfTarget[250];
    G4int NumberOfInvolvedNucleonsOfTarget;
 
    G4Nucleon* TheInvolvedNucleonsOfProjectile[250];
    G4int NumberOfInvolvedNucleonsOfProjectile;
 
    G4FTFParameters* theParameters;
    G4DiffractiveExcitation* theExcitation;
    G4ElasticHNScattering* theElastic;
    G4FTFAnnihilation* theAnnihilation;  
 
    std::vector< G4VSplitableHadron* > theAdditionalString; 
 
    G4double LowEnergyLimit;
    G4bool HighEnergyInter;
 
    G4LorentzVector ProjectileResidual4Momentum;
    G4int           ProjectileResidualMassNumber;
    G4int           ProjectileResidualCharge;
    G4double        ProjectileResidualExcitationEnergy;
 
    G4LorentzVector TargetResidual4Momentum;
    G4int           TargetResidualMassNumber;
    G4int           TargetResidualCharge;
    G4double        TargetResidualExcitationEnergy;
};
 
inline G4V3DNucleus* G4FTFModel::GetWoundedNucleus() const {
  return theParticipants.GetWoundedNucleus();
}
 
inline G4V3DNucleus* G4FTFModel::GetTargetNucleus() const {
  return theParticipants.GetWoundedNucleus();
}
 
inline G4V3DNucleus* G4FTFModel::GetProjectileNucleus() const {
  return theParticipants.GetProjectileNucleus();
}
 
#endif