Version: SMASH-1.8
smash::DecayActionsFinder Class Reference

#include <decayactionsfinder.h>

A simple decay finder: Just loops through all particles and checks if they can decay during the next timestep.

Definition at line 25 of file decayactionsfinder.h.

Inheritance diagram for smash::DecayActionsFinder:
[legend]
Collaboration diagram for smash::DecayActionsFinder:
[legend]

Public Member Functions

 DecayActionsFinder (double res_lifetime_factor)
 Initialize the finder. More...
 
ActionList find_actions_in_cell (const ParticleList &search_list, double dt, const double, const std::vector< FourVector > &) const override
 Check the whole particle list for decays. More...
 
ActionList find_actions_with_neighbors (const ParticleList &, const ParticleList &, double, const std::vector< FourVector > &) const override
 Ignore the neighbor searches for decays. More...
 
ActionList find_actions_with_surrounding_particles (const ParticleList &, const Particles &, double, const std::vector< FourVector > &) const override
 Ignore the surrounding searches for decays. More...
 
ActionList find_final_actions (const Particles &search_list, bool only_res=false) const override
 Force all resonances to decay at the end of the simulation. More...
 
- Public Member Functions inherited from smash::ActionFinderInterface
virtual ~ActionFinderInterface ()=default
 

Public Attributes

const double res_lifetime_factor_ = 1.
 Multiplicative factor to be applied to resonance lifetimes. More...
 

Constructor & Destructor Documentation

◆ DecayActionsFinder()

smash::DecayActionsFinder::DecayActionsFinder ( double  res_lifetime_factor)
inline

Initialize the finder.

Parameters
[in]res_lifetime_factorThe multiplicative factor to be applied to resonance lifetimes; default is 1

Definition at line 33 of file decayactionsfinder.h.

34  : res_lifetime_factor_(res_lifetime_factor) {}

Member Function Documentation

◆ find_actions_in_cell()

ActionList smash::DecayActionsFinder::find_actions_in_cell ( const ParticleList &  search_list,
double  dt,
const double  ,
const std::vector< FourVector > &   
) const
overridevirtual

Check the whole particle list for decays.

Parameters
[in]search_listAll particles in grid cell.
[in]dtSize of timestep [fm]
Returns
List with the found (Decay)Action objects.

Implements smash::ActionFinderInterface.

Definition at line 22 of file decayactionsfinder.cc.

24  {
25  ActionList actions;
26  /* for short time steps this seems reasonable to expect
27  * less than 10 decays in most time steps */
28  actions.reserve(10);
29 
30  for (const auto &p : search_list) {
31  if (p.type().is_stable()) {
32  continue; // particle doesn't decay
33  }
34 
35  DecayBranchList processes = p.type().get_partial_widths(
36  p.momentum(), p.position().threevec(), WhichDecaymodes::Hadronic);
37  // total decay width (mass-dependent)
38  const double width = total_weight<DecayBranch>(processes);
39 
40  // check if there are any (hadronic) decays
41  if (!(width > 0.0)) {
42  continue;
43  }
44 
45  constexpr double one_over_hbarc = 1. / hbarc;
46 
47  /* The decay_time is sampled from an exponential distribution.
48  * Even though it may seem suspicious that it is sampled every
49  * timestep, it can be proven that this still overall obeys
50  * the exponential decay law.
51  */
52  double decay_time =
53  res_lifetime_factor_ * random::exponential<double>(
54  /* The clock goes slower in the rest
55  * frame of the resonance */
56  one_over_hbarc * p.inverse_gamma() * width);
57  /* If the particle is not yet formed, shift the decay time by the time it
58  * takes the particle to form */
59  if (p.xsec_scaling_factor() < 1.0) {
60  decay_time += p.formation_time() - p.position().x0();
61  }
62  if (decay_time < dt) {
63  /* => decay_time ∈ [0, dt[
64  * => the particle decays in this timestep. */
65  auto act = make_unique<DecayAction>(p, decay_time);
66  act->add_decays(std::move(processes));
67  actions.emplace_back(std::move(act));
68  }
69  }
70  return actions;
71 }

◆ find_actions_with_neighbors()

ActionList smash::DecayActionsFinder::find_actions_with_neighbors ( const ParticleList &  ,
const ParticleList &  ,
double  ,
const std::vector< FourVector > &   
) const
inlineoverridevirtual

Ignore the neighbor searches for decays.

Implements smash::ActionFinderInterface.

Definition at line 48 of file decayactionsfinder.h.

50  {
51  return {};
52  }

◆ find_actions_with_surrounding_particles()

ActionList smash::DecayActionsFinder::find_actions_with_surrounding_particles ( const ParticleList &  ,
const Particles ,
double  ,
const std::vector< FourVector > &   
) const
inlineoverridevirtual

Ignore the surrounding searches for decays.

Implements smash::ActionFinderInterface.

Definition at line 55 of file decayactionsfinder.h.

57  {
58  return {};
59  }

◆ find_final_actions()

ActionList smash::DecayActionsFinder::find_final_actions ( const Particles search_list,
bool  only_res = false 
) const
overridevirtual

Force all resonances to decay at the end of the simulation.

Parameters
[in]search_listAll particles at the end of simulation.
[in]only_resoptional parameter that requests that only actions regarding resonances are considered (disregarding stable particles)
Returns
List with the found (Decay)Action objects.

Implements smash::ActionFinderInterface.

Definition at line 73 of file decayactionsfinder.cc.

74  {
75  ActionList actions;
76 
77  for (const auto &p : search_list) {
78  if (p.type().is_stable()) {
79  continue; // particle doesn't decay
80  }
81  auto act = make_unique<DecayAction>(p, 0.);
82  act->add_decays(p.type().get_partial_widths(
83  p.momentum(), p.position().threevec(), WhichDecaymodes::All));
84  actions.emplace_back(std::move(act));
85  }
86  return actions;
87 }

Member Data Documentation

◆ res_lifetime_factor_

const double smash::DecayActionsFinder::res_lifetime_factor_ = 1.

Multiplicative factor to be applied to resonance lifetimes.

Definition at line 74 of file decayactionsfinder.h.


The documentation for this class was generated from the following files:
smash::DecayActionsFinder::res_lifetime_factor_
const double res_lifetime_factor_
Multiplicative factor to be applied to resonance lifetimes.
Definition: decayactionsfinder.h:74
smash::WhichDecaymodes::All
All decay mode widths.
smash::hbarc
constexpr double hbarc
GeV <-> fm conversion factor.
Definition: constants.h:25
smash::WhichDecaymodes::Hadronic
Ignore dilepton decay modes widths.
smash::pdg::p
constexpr int p
Proton.
Definition: pdgcode_constants.h:28