include/Geant4/G4FermiBreakUpAN.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 //
0027 // G4FermiBreakUpAN is an alternative realisation of Fermi Break Up
0028 // de-excitation by A. Novikov, Yandex and MIPT (January 2025)
0029 // under supervision of Aleksandr Svetlichnyi, INR RAS and MIPT
0030 //
0031 // The model originally developed in J.P. Bondorf, A.S. Botvina, A.S. Iljinov,
0032 // I.N. Mishustin, and K. Sneppen, "Statistical multifragmentation of nuclei."
0033 // Physics Reports, 257(3):133–221, Jun 1995.
0034 // https://doi.org/10.1016/0370-1573(94)00097-M, doi:10.1016/0370-1573(94)00097-m.
0035 //
0036
0037 #ifndef G4FERMIBREAKUPAN_HH
0038 #define G4FERMIBREAKUPAN_HH
0039
0040 #include "G4FermiDataTypes.hh"
0041 #include "G4FermiParticle.hh"
0042 #include "G4FermiSplitter.hh"
0043 #include "G4VFermiBreakUp.hh"
0044 #include "globals.hh"
0045
0046 #include <memory>
0047
0048 class G4FermiBreakUpAN : public G4VFermiBreakUp
0049 {
0050   private:
0051     class PossibleSplits
0052     {
0053       private:
0054         using NucleiSplits = std::vector<G4FermiFragmentVector>;
0055
0056       public:
0057         PossibleSplits() = default;
0058         PossibleSplits& operator=(PossibleSplits&&) noexcept = default;
0059
0060         PossibleSplits(const G4FermiAtomicMass maxAtomicMass);
0061
0062         const NucleiSplits& GetSplits(const G4FermiAtomicMass atomicMass,
0063                                       const G4FermiChargeNumber chargeNumber) const;
0064
0065         void InsertSplits(const G4FermiAtomicMass atomicMass,
0066                           const G4FermiChargeNumber chargeNumber,
0067               NucleiSplits&& splits);
0068
0069       private:
0070         std::vector<NucleiSplits> splits_;
0071     };
0072
0073   public:
0074     explicit G4FermiBreakUpAN(G4int verbosity = 0);
0075     ~G4FermiBreakUpAN() override = default;
0076
0077     void Initialise() override;
0078
0079     // check if the Fermi Break Up model can be used
0080     G4bool IsApplicable(G4int Z, G4int A, G4double eexc) const override;
0081
0082     // vector of products is added to the provided vector
0083     // if no decay channel is found out for the primary fragment
0084     // then it is added to the results vector
0085     // if primary decays then it is deleted
0086     void BreakFragment(G4FragmentVector* results, G4Fragment* theNucleus) override;
0087
0088     std::vector<G4FermiParticle> BreakItUp(const G4FermiParticle& nucleus) const;
0089
0090   private:
0091     std::vector<G4FermiParticle> SplitToParticles(const G4FermiParticle& sourceParticle,
0092                                                   const G4FermiFragmentVector& split) const;
0093
0094     // improve performance, reusing allocated memory
0095     mutable std::vector<G4double> weights_;
0096     PossibleSplits splits_;
0097
0098     G4int secID_;
0099     G4int verbosity_ = 0;
0100 };
0101
0102 #endif  // G4FERMIBREAKUP_HH