G4VEvaporationChannel.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.          *
// ********************************************************************
//
//
// Hadronic Process: Nuclear De-excitations
// by V. Lara (Oct 1998)
//
// Modified:
// 03.09.2008 (J.M.Quesada) for external choice of inverse cross section option
// 06.09.2008 (J.M.Quesada) external choices have been added for superimposed 
//                          Coulomb barrier (if useSICB is set true, by default 
//                          is false) 
// 24.04.2010 (V.Ivanchenko) moved constructor and destructor to source; added 
//                          two new virtual methods EmittedFragment(s) to allow
//                          more optimal work with G4Fragment objects
// 12.02.2013 (V.Ivanchenko) added virtual method GetLifeTime,
//                          enumerator G4EvaporationChannelType,
//                          which is defined in constructor of the class
//                          
 
#ifndef G4VEvaporationChannel_h
#define G4VEvaporationChannel_h 1
 
#include "globals.hh"
#include "G4Fragment.hh"
 
class G4VEvaporationChannel
{
public:
 
  G4VEvaporationChannel(const G4String & aName = "");
  virtual ~G4VEvaporationChannel() = default;
 
  virtual G4double GetEmissionProbability(G4Fragment* theNucleus) = 0;
 
  // option definition
  virtual void Initialise();
 
  // return level life time, by default zero
  virtual G4double GetLifeTime(G4Fragment* theNucleus);
 
  // return emitted fragment, initial fragment is modified
  // and not deleted
  virtual G4Fragment* EmittedFragment(G4Fragment* theNucleus);
 
  // returns "true" if primary fragment is decayed and deleted
  // returns "false" if primary fragment is modified but stay alive
  // emitted fragments are added to the vector of results
  virtual G4bool 
  BreakUpChain(G4FragmentVector* theResult, G4Fragment* theNucleus);
 
  // return vector of emitted fragments, initial fragment is modified
  // but not included in this vector
  inline G4FragmentVector* BreakUpFragment(G4Fragment* theNucleus);
 
  // methods for unit tests
  virtual G4double ComputeInverseXSection(G4Fragment* theNucleus, 
                      G4double kinEnergy);
  virtual G4double ComputeProbability(G4Fragment* theNucleus, 
                      G4double kinEnergy);
 
  virtual void Dump() const;
 
  // enable internal conversion
  virtual void SetICM(G4bool);
 
  // flag of the radioactive decay module
  virtual void RDMForced(G4bool);
 
  // for cross section selection
  inline void SetOPTxs(G4int);
  // for superimposed Coulomb Barrier for inverse cross sections    
  inline void UseSICB(G4bool);
 
  G4VEvaporationChannel(const G4VEvaporationChannel & right) = delete;
  const G4VEvaporationChannel & operator= 
  (const G4VEvaporationChannel & right) = delete;
  G4bool operator==(const G4VEvaporationChannel & right) const = delete;
  G4bool operator!=(const G4VEvaporationChannel & right) const = delete;
 
protected:
 
  G4int OPTxs{3};
  G4bool useSICB{true};
};
 
inline G4FragmentVector* 
G4VEvaporationChannel::BreakUpFragment(G4Fragment* theNucleus)
{
  G4FragmentVector* results = new G4FragmentVector();
  BreakUpChain(results, theNucleus);
  return results;
}
 
 
inline void G4VEvaporationChannel::SetOPTxs(G4int val) 
{
  if(val >= 0) { OPTxs = val; } 
}
 
inline void G4VEvaporationChannel::UseSICB(G4bool val)
{
  useSICB = val;
}
 
#endif