#include <decayaction.h>

DecayAction is a special action which takes one single particle in the initial state and makes it decay into a number of daughter particles (currently two or three).

Definition at line 25 of file decayaction.h.

Inheritance diagram for smash::DecayAction:

Classes
class	InvalidDecay
	Thrown when DecayAction is called to perform with 0 or more than 2 entries in outgoing_particles. More...

Public Member Functions
	DecayAction (const ParticleData &p, double time)
	Construct a DecayAction from a particle `p`. More...

void	add_decays (DecayBranchList pv)
	Add several new decays at once. More...

void	add_decay (DecayBranchPtr p)
	Add one new decay. More...

void	generate_final_state () override
	Generate the final state of the decay process. More...

std::pair< double, double >	sample_masses (double kinetic_energy_cm) const override
	Sample the masses of the final particles. More...

double	get_total_weight () const override
	Return the total width of the decay process. More...

double	get_partial_weight () const override
	Get partial width of chosen channel. More...

double	total_width () const
	Get total decay width. More...

Public Member Functions inherited from smash::Action
	Action (const ParticleList &in_part, double time)
	Construct an action object with incoming particles and relative time. More...

	Action (const ParticleData &in_part, const ParticleData &out_part, double time, ProcessType type)
	Construct an action object with the incoming particles, relative time, and the already known outgoing particles and type of the process. More...

	Action (const ParticleList &in_part, const ParticleList &out_part, double absolute_execution_time, ProcessType type)
	Construct an action object with the incoming particles, absolute time, and the already known outgoing particles and type of the process. More...

	Action (const Action &)=delete
	Copying is disabled. Use pointers or create a new Action. More...

virtual	~Action ()
	Virtual Destructor. More...

bool	operator< (const Action &rhs) const
	Determine whether one action takes place before another in time. More...

virtual ProcessType	get_type () const
	Get the process type. More...

template<typename Branch >
void	add_process (ProcessBranchPtr< Branch > &p, ProcessBranchList< Branch > &subprocesses, double &total_weight)
	Add a new subprocess. More...

template<typename Branch >
void	add_processes (ProcessBranchList< Branch > pv, ProcessBranchList< Branch > &subprocesses, double &total_weight)
	Add several new subprocesses at once. More...

virtual double	perform (Particles *particles, uint32_t id_process)
	Actually perform the action, e.g. More...

bool	is_valid (const Particles &particles) const
	Check whether the action still applies. More...

bool	is_pauli_blocked (const std::vector< Particles > &ensembles, const PauliBlocker &p_bl) const
	Check if the action is Pauli-blocked. More...

const ParticleList &	incoming_particles () const
	Get the list of particles that go into the action. More...

void	update_incoming (const Particles &particles)
	Update the incoming particles that are stored in this action to the state they have in the global particle list. More...

const ParticleList &	outgoing_particles () const
	Get the list of particles that resulted from the action. More...

double	time_of_execution () const
	Get the time at which the action is supposed to be performed. More...

virtual double	check_conservation (const uint32_t id_process) const
	Check various conservation laws. More...

double	sqrt_s () const
	Determine the total energy in the center-of-mass frame [GeV]. More...

FourVector	total_momentum_of_outgoing_particles () const
	Calculate the total kinetic momentum of the outgoing particles. More...

FourVector	get_interaction_point () const
	Get the interaction point. More...

std::pair< FourVector, FourVector >	get_potential_at_interaction_point () const
	Get the skyrme and asymmetry potential at the interaction point. More...

void	set_stochastic_pos_idx ()
	Setter function that stores a random incoming particle index latter used to determine the interaction point. More...

Protected Member Functions
void	format_debug_output (std::ostream &out) const override
	Writes information about this decay action to the `out` stream. More...

Protected Member Functions inherited from smash::Action
FourVector	total_momentum () const
	Sum of 4-momenta of incoming particles. More...

template<typename Branch >
const Branch *	choose_channel (const ProcessBranchList< Branch > &subprocesses, double total_weight)
	Decide for a particular final-state channel via Monte-Carlo and return it as a ProcessBranch. More...

virtual void	sample_angles (std::pair< double, double > masses, double kinetic_energy_cm)
	Sample final-state momenta in general X->2 processes (here: using an isotropical angular distribution). More...

void	sample_2body_phasespace ()
	Sample the full 2-body phase-space (masses, momenta, angles) in the center-of-mass frame for the final state particles. More...

virtual void	sample_manybody_phasespace ()
	Sample the full n-body phase-space (masses, momenta, angles) in the center-of-mass frame for the final state particles. More...

void	assign_formation_time_to_outgoing_particles ()
	Assign the formation time to the outgoing particles. More...

Protected Attributes
DecayBranchList	decay_channels_
	List of possible decays. More...

double	total_width_
	total decay width More...

double	partial_width_
	partial decay width to the chosen outgoing channel More...

int	L_ = 0
	Angular momentum of the decay. More...

Protected Attributes inherited from smash::Action
ParticleList	incoming_particles_
	List with data of incoming particles. More...

ParticleList	outgoing_particles_
	Initially this stores only the PDG codes of final-state particles. More...

const double	time_of_execution_
	Time at which the action is supposed to be performed (absolute time in the lab frame in fm). More...

ProcessType	process_type_
	type of process More...

double	box_length_ = -1.0
	Box length: needed to determine coordinates of collision correctly in case of collision through the wall. More...

int	stochastic_position_idx_ = -1
	This stores a randomly-chosen index to an incoming particle. More...

Additional Inherited Members
Static Public Member Functions inherited from smash::Action
static double	lambda_tilde (double a, double b, double c)
	Little helper function that calculates the lambda function (sometimes written with a tilde to better distinguish it) that appears e.g. More...

static void	sample_manybody_phasespace_impl (double sqrts, const std::vector< double > &m, std::vector< FourVector > &sampled_momenta)
	Implementation of the full n-body phase-space sampling (masses, momenta, angles) in the center-of-mass frame for the final state particles. More...

Constructor & Destructor Documentation

◆ DecayAction()

smash::DecayAction::DecayAction	(	const ParticleData &	p,
		double	time
	)

Construct a DecayAction from a particle p.

It does not initialize the list of possible decay processes. You need to call add_processes after construction.

Parameters

[in]	p	The particle that should decay if the action is performed.
[in]	time	Time at which the action is supposed to take place

Definition at line 19 of file decayaction.cc.

20 : Action({p}, time), total_width_(0.) {}

smash::Action::Action

Action(const ParticleList &in_part, double time)

Construct an action object with incoming particles and relative time.

Definition: action.h:44

smash::DecayAction::total_width_

double total_width_

total decay width

Definition: decayaction.h:100

smash::pdg::p

constexpr int p

Proton.

Definition: pdgcode_constants.h:28

Member Function Documentation

◆ add_decays()

void smash::DecayAction::add_decays ( DecayBranchList pv )

Add several new decays at once.

Parameters

[in] pv List of decays to be added.

Definition at line 22 of file decayaction.cc.

                                                {
   add_processes<DecayBranch>(std::move(pv), decay_channels_, total_width_);
 }

◆ add_decay()

void smash::DecayAction::add_decay ( DecayBranchPtr p )

Add one new decay.

Parameters

[in] p Decay to be added.

Definition at line 26 of file decayaction.cc.

                                             {
   add_process<DecayBranch>(p, decay_channels_, total_width_);
 }

◆ generate_final_state()

void smash::DecayAction::generate_final_state ( )

overridevirtual

Generate the final state of the decay process.

Performs a decay of one particle to two or three particles.

Exceptions

InvalidDecay

Implements smash::Action.

Definition at line 30 of file decayaction.cc.

                                        {
   logg[LDecayModes].debug("Process: Resonance decay. ");
   /* Execute a decay process for the selected particle.
    *
    * randomly select one of the decay modes of the particle
    * according to their relative weights. Then decay the particle
    * by calling function sample_2body_phasespace or sample_manybody_phasespace.
    */
   const DecayBranch *proc =
       choose_channel<DecayBranch>(decay_channels_, total_width_);
   outgoing_particles_ = proc->particle_list();
   // set positions of the outgoing particles
   for (auto &p : outgoing_particles_) {
     p.set_4position(incoming_particles_[0].position());
   }
   process_type_ = proc->get_type();
   L_ = proc->angular_momentum();
   partial_width_ = proc->weight();
  
   switch (outgoing_particles_.size()) {
     case 2:
       sample_2body_phasespace();
       break;
     case 3:
       sample_manybody_phasespace();
       break;
     default:
       throw InvalidDecay(
           "DecayAction::perform: Only 1->2 or 1->3 processes are supported. "
           "Decay from 1->" +
           std::to_string(outgoing_particles_.size()) +
           " was requested. (PDGcode=" +
           incoming_particles_[0].pdgcode().string() + ", mass=" +
           std::to_string(incoming_particles_[0].effective_mass()) + ")");
   }
  
   // Set formation time.
   for (auto &p : outgoing_particles_) {
     logg[LDecayModes].debug("particle momenta in lrf ", p);
     // assuming decaying particles are always fully formed
     p.set_formation_time(time_of_execution_);
     // Boost to the computational frame
     p.boost_momentum(-total_momentum_of_outgoing_particles().velocity());
     logg[LDecayModes].debug("particle momenta in comp ", p);
   }
 }

◆ sample_masses()

std::pair< double, double > smash::DecayAction::sample_masses ( double kinetic_energy_cm ) const

overridevirtual

Sample the masses of the final particles.

Returns: Pair of sampled masses of particle 1 and 2

Reimplemented from smash::Action.

Definition at line 79 of file decayaction.cc.

                                     {
   const ParticleType &t_a = outgoing_particles_[0].type();
   const ParticleType &t_b = outgoing_particles_[1].type();
  
   // start with pole masses
   std::pair<double, double> masses = {t_a.mass(), t_b.mass()};
  
   if (kinetic_energy_cm < t_a.min_mass_kinematic() + t_b.min_mass_kinematic()) {
     const std::string reaction =
         incoming_particles_[0].type().name() + "→" + t_a.name() + t_b.name();
     throw InvalidResonanceFormation(
         reaction + ": not enough energy, " + std::to_string(kinetic_energy_cm) +
         " < " + std::to_string(t_a.min_mass_kinematic()) + " + " +
         std::to_string(t_b.min_mass_kinematic()));
   }
  
   // If one of the particles is a resonance, sample its mass.
   if (!t_a.is_stable() && t_b.is_stable()) {
     masses.first = t_a.sample_resonance_mass(t_b.mass(), kinetic_energy_cm, L_);
   } else if (!t_b.is_stable() && t_a.is_stable()) {
     masses.second =
         t_b.sample_resonance_mass(t_a.mass(), kinetic_energy_cm, L_);
   } else if (!t_a.is_stable() && !t_b.is_stable()) {
     // two resonances in final state
     masses = t_a.sample_resonance_masses(t_b, kinetic_energy_cm, L_);
   }
  
   return masses;
 }

◆ get_total_weight()

double smash::DecayAction::get_total_weight ( ) const

inlineoverridevirtual

Return the total width of the decay process.

Implements smash::Action.

Reimplemented in smash::DecayActionDilepton.

Definition at line 66 of file decayaction.h.

66 { return total_width_; }

◆ get_partial_weight()

double smash::DecayAction::get_partial_weight ( ) const

inlineoverridevirtual

Get partial width of chosen channel.

Returns: Partial width of chosen channel

Implements smash::Action.

Definition at line 72 of file decayaction.h.

72 { return partial_width_; }

◆ total_width()

double smash::DecayAction::total_width ( ) const

inline

Get total decay width.

Returns: Total width of decay

Definition at line 78 of file decayaction.h.

78 { return total_width_; }

Member Data Documentation

◆ decay_channels_

DecayBranchList smash::DecayAction::decay_channels_

protected

List of possible decays.

Definition at line 97 of file decayaction.h.

◆ total_width_

double smash::DecayAction::total_width_

protected

total decay width

Definition at line 100 of file decayaction.h.

◆ partial_width_

double smash::DecayAction::partial_width_

protected

partial decay width to the chosen outgoing channel

Definition at line 103 of file decayaction.h.

◆ L_

int smash::DecayAction::L_ = 0

protected

Angular momentum of the decay.

Definition at line 106 of file decayaction.h.

The documentation for this class was generated from the following files:

src/include/smash/decayaction.h
src/decayaction.cc

Classes

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ DecayAction()

Member Function Documentation

◆ add_decays()

◆ add_decay()

◆ generate_final_state()

◆ sample_masses()

◆ get_total_weight()

◆ get_partial_weight()

◆ total_width()

Member Data Documentation

◆ decay_channels_

◆ total_width_

◆ partial_width_

◆ L_