smash::ScatterAction Class Reference

#include <scatteraction.h>

ScatterAction is a special action which takes two incoming particles and performs a scattering, producing one or more final-state particles.

Definition at line 30 of file scatteraction.h.

Inheritance diagram for smash::ScatterAction:

Collaboration diagram for smash::ScatterAction:

Classes
class	InvalidScatterAction

Public Member Functions
	ScatterAction (const ParticleData &in_part1, const ParticleData &in_part2, double time, bool isotropic=false, double string_formation_time=1.0, double box_length=-1.0)
	Construct a ScatterAction object. More...
void	add_collision (CollisionBranchPtr p)
	Add a new collision channel. More...
void	add_collisions (CollisionBranchList pv)
	Add several new collision channels at once. More...
double	transverse_distance_sqr () const
	Calculate the transverse distance of the two incoming particles in their local rest frame. More...
double	cov_transverse_distance_sqr () const
	Calculate the transverse distance of the two incoming particles in their local rest frame written in a covariant form. More...
double	mandelstam_s () const
	Determine the Mandelstam s variable,. More...
double	relative_velocity () const
	Get the relative velocity of the two incoming particles. More...
void	generate_final_state () override
	Generate the final-state of the scattering process. More...
double	get_total_weight () const override
	Get the total cross section of scattering particles. More...
double	get_partial_weight () const override
	Get the partial cross section of the chosen channel. More...
void	sample_angles (std::pair< double, double > masses, double kinetic_energy_cm) override
	Sample final-state angles in a 2->2 collision (possibly anisotropic). More...
void	add_all_scatterings (double elastic_parameter, bool two_to_one, ReactionsBitSet included_2to2, MultiParticleReactionsBitSet included_multi, double low_snn_cut, bool strings_switch, bool use_AQM, bool strings_with_probability, NNbarTreatment nnbar_treatment, double scale_xs, double additional_el_xs)
	Add all possible scattering subprocesses for this action object. More...
const CollisionBranchList &	collision_channels ()
	Get list of possible collision channels. More...
void	set_string_interface (StringProcess *str_proc)
	Set the StringProcess object to be used. More...
virtual double	cross_section () const
	Get the total cross section of the scattering particles. 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 void	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 Particles &particles, 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 void	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
double	cm_momentum () const
	Get the momentum of the center of mass of the incoming particles in the calculation frame. More...
double	cm_momentum_squared () const
	Get the squared momentum of the center of mass of the incoming particles in the calculation frame. More...
ThreeVector	beta_cm () const
	Get the velocity of the center of mass of the scattering/incoming particles in the calculation frame. More...
double	gamma_cm () const
	Get the gamma factor corresponding to a boost to the center of mass frame of the colliding particles. More...
void	elastic_scattering ()
	Perform an elastic two-body scattering, i.e. just exchange momentum. More...
void	inelastic_scattering ()
	Perform an inelastic two-body scattering, i.e. new particles are formed. More...
void	two_to_three_scattering ()
	Perform a two-to-three-body scattering. More...
void	string_excitation ()
	Todo(ryu): document better - it is not really UrQMD-based, isn't it? Perform the UrQMD-based string excitation and decay. More...
void	format_debug_output (std::ostream &out) const override
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 std::pair< double, double >	sample_masses (double kinetic_energy_cm) const
	Sample final-state masses in general X->2 processes (thus also fixing the absolute c.o.m. 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_3body_phasespace ()
	Sample the full 3-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
CollisionBranchList	collision_channels_
	List of possible collisions. More...
double	total_cross_section_
	Total hadronic cross section. More...
double	partial_cross_section_
	Partial cross-section to the chosen outgoing channel. More...
bool	isotropic_ = false
	Do this collision isotropically? More...
double	string_formation_time_ = 1.0
	Time fragments take to be fully formed in hard string excitation. 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/c). 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...

Private Member Functions
bool	is_elastic () const
	Check if the scattering is elastic. More...
void	resonance_formation ()
	Perform a 2->1 resonance-formation process. More...

Private Attributes
StringProcess *	string_process_ = nullptr
	Pointer to interface class for strings. 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...

Constructor & Destructor Documentation

ScatterAction()

smash::ScatterAction::ScatterAction	(	const ParticleData &	in_part1,
		const ParticleData &	in_part2,
		double	time,
		bool	isotropic = false,
		double	string_formation_time = 1.0,
		double	box_length = -1.0
	)

Construct a ScatterAction object.

Parameters

[in]	in_part1	first scattering partner
[in]	in_part2	second scattering partner
[in]	time	Time at which the action is supposed to take place
[in]	isotropic	if true, do the collision isotropically
[in]	string_formation_time	Time string fragments take to form
[in]	box_length	Passing box length to determine coordinate of the collision, in case it happened through the wall in a box. If negative, then there is no wrapping.

Definition at line 29 of file scatteraction.cc.

    : Action({in_part_a, in_part_b}, time),
      total_cross_section_(0.),
      isotropic_(isotropic),
      string_formation_time_(string_formation_time) {
  box_length_ = box_length;
}

Member Function Documentation

add_collision()

void smash::ScatterAction::add_collision

(

CollisionBranchPtr

p

)

Add a new collision channel.

Parameters

[in]

p

Channel to be added.

Definition at line 40 of file scatteraction.cc.

                                                      {
  add_process<CollisionBranch>(p, collision_channels_, total_cross_section_);
}

Here is the caller graph for this function:

add_collisions()

void smash::ScatterAction::add_collisions

(

CollisionBranchList

pv

)

Add several new collision channels at once.

Parameters

[in]

pv

list of channels to be added.

Definition at line 44 of file scatteraction.cc.

                                                         {
  add_processes<CollisionBranch>(std::move(pv), collision_channels_,
                                 total_cross_section_);
}

Here is the caller graph for this function:

transverse_distance_sqr()

double smash::ScatterAction::transverse_distance_sqr

(

)

const

Calculate the transverse distance of the two incoming particles in their local rest frame.

According to UrQMD criterion position of particle a: x_a
position of particle b: x_b
momentum of particle a: p_a
momentum of particle b: p_b

\[d^2_\mathrm{coll} = (\vec{x_a} - \vec{x_b})^2 - \frac{((\vec{x_a} - \vec{x_b}) \cdot (\vec{p_a} - \vec{p_b}))^2 } {(\vec{p_a} - \vec{p_b})^2}\]

Returns

squared distance \(d^2_\mathrm{coll}\).

UrQMD squared distance criterion: Bass:1998ca [4] (3.27): in center of momentum frame position of particle a: x_a position of particle b: x_b momentum of particle a: p_a momentum of particle b: p_b d^2_{coll} = (x_a - x_b)^2 - ((x_a - x_b) . (p_a - p_b))^2 / (p_a - p_b)^2

Definition at line 182 of file scatteraction.cc.

                                                    {
  // local copy of particles (since we need to boost them)
  ParticleData p_a = incoming_particles_[0];
  ParticleData p_b = incoming_particles_[1];
  /* Boost particles to center-of-momentum frame. */
  const ThreeVector velocity = beta_cm();
  p_a.boost(velocity);
  p_b.boost(velocity);
  const ThreeVector pos_diff =
      p_a.position().threevec() - p_b.position().threevec();
  const ThreeVector mom_diff =
      p_a.momentum().threevec() - p_b.momentum().threevec();
 
  logg[LScatterAction].debug("Particle ", incoming_particles_,
                             " position difference [fm]: ", pos_diff,
                             ", momentum difference [GeV]: ", mom_diff);
 
  const double dp2 = mom_diff.sqr();
  const double dr2 = pos_diff.sqr();
  /* Zero momentum leads to infite distance. */
  if (dp2 < really_small) {
    return dr2;
  }
  const double dpdr = pos_diff * mom_diff;
 
  const double result = dr2 - dpdr * dpdr / dp2;
  return result > 0.0 ? result : 0.0;
}

Here is the call graph for this function:

cov_transverse_distance_sqr()

double smash::ScatterAction::cov_transverse_distance_sqr

(

)

const

Calculate the transverse distance of the two incoming particles in their local rest frame written in a covariant form.

Equivalent to the UrQMD transverse distance. See Hirano:2012yy [22] (5.6)-(5.11).

Returns

squared distance \(d^2_\mathrm{coll}\).

Definition at line 219 of file scatteraction.cc.

                                                        {
  // local copy of particles (since we need to boost them)
  ParticleData p_a = incoming_particles_[0];
  ParticleData p_b = incoming_particles_[1];
 
  const FourVector delta_x = p_a.position() - p_b.position();
  const double mom_diff_sqr =
      (p_a.momentum().threevec() - p_b.momentum().threevec()).sqr();
  const double x_sqr = delta_x.sqr();
 
  if (mom_diff_sqr < really_small) {
    return -x_sqr;
  }
 
  const double p_a_sqr = p_a.momentum().sqr();
  const double p_b_sqr = p_b.momentum().sqr();
  const double p_a_dot_x = p_a.momentum().Dot(delta_x);
  const double p_b_dot_x = p_b.momentum().Dot(delta_x);
  const double p_a_dot_p_b = p_a.momentum().Dot(p_b.momentum());
 
  const double b_sqr =
      -x_sqr -
      (p_a_sqr * std::pow(p_b_dot_x, 2) + p_b_sqr * std::pow(p_a_dot_x, 2) -
       2 * p_a_dot_p_b * p_a_dot_x * p_b_dot_x) /
          (std::pow(p_a_dot_p_b, 2) - p_a_sqr * p_b_sqr);
  return b_sqr > 0.0 ? b_sqr : 0.0;
}

Here is the call graph for this function:

mandelstam_s()

double smash::ScatterAction::mandelstam_s

(

)

const

Determine the Mandelstam s variable,.

\[s = (p_a + p_b)^2\]

Equal to the square of CMS energy.

Returns

Mandelstam s

Definition at line 159 of file scatteraction.cc.

{ return total_momentum().sqr(); }

Here is the call graph for this function:

Here is the caller graph for this function:

relative_velocity()

double smash::ScatterAction::relative_velocity

(

)

const

Get the relative velocity of the two incoming particles.

For a defintion see e.g. Seifert:2017oyb [44], eq. (5)

Returns

relative velocity.

Definition at line 173 of file scatteraction.cc.

                                              {
  const double m1 = incoming_particles()[0].effective_mass();
  const double m2 = incoming_particles()[1].effective_mass();
  const double m_s = mandelstam_s();
  const double lamb = lambda_tilde(m_s, m1 * m1, m2 * m2);
  return std::sqrt(lamb) / (2. * incoming_particles()[0].momentum().x0() *
                            incoming_particles()[1].momentum().x0());
}

Here is the call graph for this function:

generate_final_state()

void smash::ScatterAction::generate_final_state ( )

overridevirtual

Generate the final-state of the scattering process.

Performs either elastic or inelastic scattering.

Exceptions

InvalidScatterAction

Implements smash::Action.

Reimplemented in smash::ScatterActionPhoton.

Definition at line 49 of file scatteraction.cc.

                                         {
  logg[LScatterAction].debug("Incoming particles: ", incoming_particles_);
 
  /* Decide for a particular final state. */
  const CollisionBranch *proc = choose_channel<CollisionBranch>(
      collision_channels_, total_cross_section_);
  process_type_ = proc->get_type();
  outgoing_particles_ = proc->particle_list();
  partial_cross_section_ = proc->weight();
 
  logg[LScatterAction].debug("Chosen channel: ", process_type_,
                             outgoing_particles_);
 
  /* The production point of the new particles.  */
  FourVector middle_point = get_interaction_point();
 
  switch (process_type_) {
    case ProcessType::Elastic:
      /* 2->2 elastic scattering */
      elastic_scattering();
      break;
    case ProcessType::TwoToOne:
      /* resonance formation */
      resonance_formation();
      break;
    case ProcessType::TwoToTwo:
      /* 2->2 inelastic scattering */
      /* Sample the particle momenta in CM system. */
      inelastic_scattering();
      break;
    case ProcessType::TwoToThree:
      /* 2->3 scattering */
      two_to_three_scattering();
      break;
    case ProcessType::StringSoftSingleDiffractiveAX:
    case ProcessType::StringSoftSingleDiffractiveXB:
    case ProcessType::StringSoftDoubleDiffractive:
    case ProcessType::StringSoftAnnihilation:
    case ProcessType::StringSoftNonDiffractive:
    case ProcessType::StringHard:
      string_excitation();
      break;
    default:
      throw InvalidScatterAction(
          "ScatterAction::generate_final_state: Invalid process type " +
          std::to_string(static_cast<int>(process_type_)) + " was requested. " +
          "(PDGcode1=" + incoming_particles_[0].pdgcode().string() +
          ", PDGcode2=" + incoming_particles_[1].pdgcode().string() + ")");
  }
 
  for (ParticleData &new_particle : outgoing_particles_) {
    // Boost to the computational frame
    new_particle.boost_momentum(
        -total_momentum_of_outgoing_particles().velocity());
    /* Set positions of the outgoing particles */
    if (proc->get_type() != ProcessType::Elastic) {
      new_particle.set_4position(middle_point);
    }
  }
}

Here is the call graph for this function:

get_total_weight()

double smash::ScatterAction::get_total_weight ( ) const

overridevirtual

Get the total cross section of scattering particles.

Returns

total cross section.

Implements smash::Action.

Reimplemented in smash::ScatterActionPhoton.

Definition at line 141 of file scatteraction.cc.

                                             {
  return total_cross_section_ * incoming_particles_[0].xsec_scaling_factor() *
         incoming_particles_[1].xsec_scaling_factor();
}

get_partial_weight()

double smash::ScatterAction::get_partial_weight ( ) const

overridevirtual

Get the partial cross section of the chosen channel.

Returns

partial cross section.

Implements smash::Action.

Definition at line 146 of file scatteraction.cc.

                                               {
  return partial_cross_section_ * incoming_particles_[0].xsec_scaling_factor() *
         incoming_particles_[1].xsec_scaling_factor();
}

sample_angles()

void smash::ScatterAction::sample_angles ( std::pair< double, double >  masses, double  kinetic_energy_cm  )

overridevirtual

Sample final-state angles in a 2->2 collision (possibly anisotropic).

NN → NN: Choose angular distribution according to Cugnon parametrization, see Cugnon:1996kh [15].

NN → NΔ: Sample scattering angles in center-of-mass frame from an anisotropic angular distribution, using the same distribution as for elastic pp scattering, as suggested in Cugnon:1996kh [15].

NN → NR: Fit to HADES data, see Agakishiev:2014wqa [1].

Reimplemented from smash::Action.

Definition at line 291 of file scatteraction.cc.

                                                            {
  if (is_string_soft_process(process_type_) ||
      (process_type_ == ProcessType::StringHard)) {
    // We potentially have more than two particles, so the following angular
    // distributions don't work. Instead we just keep the angular
    // distributions generated by string fragmentation.
    return;
  }
  assert(outgoing_particles_.size() == 2);
 
  // NN scattering is anisotropic currently
  const bool nn_scattering = incoming_particles_[0].type().is_nucleon() &&
                             incoming_particles_[1].type().is_nucleon();
  /* Elastic process is anisotropic and
   * the angular distribution is based on the NN elastic scattering. */
  const bool el_scattering = process_type_ == ProcessType::Elastic;
 
  const double mass_in_a = incoming_particles_[0].effective_mass();
  const double mass_in_b = incoming_particles_[1].effective_mass();
 
  ParticleData *p_a = &outgoing_particles_[0];
  ParticleData *p_b = &outgoing_particles_[1];
 
  const double mass_a = masses.first;
  const double mass_b = masses.second;
 
  const std::array<double, 2> t_range = get_t_range<double>(
      kinetic_energy_cm, mass_in_a, mass_in_b, mass_a, mass_b);
  Angles phitheta;
  if (el_scattering && !isotropic_) {
    double mandelstam_s_new = 0.;
    if (nn_scattering) {
      mandelstam_s_new = mandelstam_s();
    } else {
      /* In the case of elastic collisions other than NN collisions,
       * there is an ambiguity on how to get the lab-frame momentum (plab),
       * since the incoming particles can have different masses.
       * Right now, we first obtain the center-of-mass momentum
       * of the collision (pcom_now).
       * Then, the lab-frame momentum is evaluated from the mandelstam s,
       * which yields the original center-of-mass momentum
       * when nucleon mass is assumed. */
      const double pcm_now = pCM_from_s(mandelstam_s(), mass_in_a, mass_in_b);
      mandelstam_s_new =
          4. * std::sqrt(pcm_now * pcm_now + nucleon_mass * nucleon_mass);
    }
    double bb, a, plab = plab_from_s(mandelstam_s_new);
    if (nn_scattering &&
        p_a->pdgcode().antiparticle_sign() ==
            p_b->pdgcode().antiparticle_sign() &&
        std::abs(p_a->type().charge() + p_b->type().charge()) == 1) {
      // proton-neutron and antiproton-antineutron
      bb = std::max(Cugnon_bnp(plab), really_small);
      a = (plab < 0.8) ? 1. : 0.64 / (plab * plab);
    } else {
      /* all others including pp, nn and AQM elastic processes
       * This is applied for all particle pairs, which are allowed to
       * interact elastically. */
      bb = std::max(Cugnon_bpp(plab), really_small);
      a = 1.;
    }
    double t = random::expo(bb, t_range[0], t_range[1]);
    if (random::canonical() > 1. / (1. + a)) {
      t = t_range[0] + t_range[1] - t;
    }
    // determine scattering angles in center-of-mass frame
    phitheta = Angles(2. * M_PI * random::canonical(),
                      1. - 2. * (t - t_range[0]) / (t_range[1] - t_range[0]));
  } else if (nn_scattering && p_a->pdgcode().is_Delta() &&
             p_b->pdgcode().is_nucleon() &&
             p_a->pdgcode().antiparticle_sign() ==
                 p_b->pdgcode().antiparticle_sign() &&
             !isotropic_) {
    const double plab = plab_from_s(mandelstam_s());
    const double bb = std::max(Cugnon_bpp(plab), really_small);
    double t = random::expo(bb, t_range[0], t_range[1]);
    if (random::canonical() > 0.5) {
      t = t_range[0] + t_range[1] - t;  // symmetrize
    }
    phitheta = Angles(2. * M_PI * random::canonical(),
                      1. - 2. * (t - t_range[0]) / (t_range[1] - t_range[0]));
  } else if (nn_scattering && p_b->pdgcode().is_nucleon() && !isotropic_ &&
             (p_a->type().is_Nstar() || p_a->type().is_Deltastar())) {
    const std::array<double, 4> p{1.46434, 5.80311, -6.89358, 1.94302};
    const double a = p[0] + mass_a * (p[1] + mass_a * (p[2] + mass_a * p[3]));
    /*  If the resonance is so heavy that the index "a" exceeds 30,
     *  the power function turns out to be too sharp. Take t directly to be
     *  t_0 in such a case. */
    double t = t_range[0];
    if (a < 30) {
      t = random::power(-a, t_range[0], t_range[1]);
    }
    if (random::canonical() > 0.5) {
      t = t_range[0] + t_range[1] - t;  // symmetrize
    }
    phitheta = Angles(2. * M_PI * random::canonical(),
                      1. - 2. * (t - t_range[0]) / (t_range[1] - t_range[0]));
  } else {
    /* isotropic angular distribution */
    phitheta.distribute_isotropically();
  }
 
  ThreeVector pscatt = phitheta.threevec();
  // 3-momentum of first incoming particle in center-of-mass frame
  ThreeVector pcm =
      incoming_particles_[0].momentum().lorentz_boost(beta_cm()).threevec();
  pscatt.rotate_z_axis_to(pcm);
 
  // final-state CM momentum
  const double p_f = pCM(kinetic_energy_cm, mass_a, mass_b);
  if (!(p_f > 0.0)) {
    logg[LScatterAction].warn("Particle: ", p_a->pdgcode(),
                              " radial momentum: ", p_f);
    logg[LScatterAction].warn("Etot: ", kinetic_energy_cm, " m_a: ", mass_a,
                              " m_b: ", mass_b);
  }
  p_a->set_4momentum(mass_a, pscatt * p_f);
  p_b->set_4momentum(mass_b, -pscatt * p_f);
 
  /* Debug message is printed before boost, so that p_a and p_b are
   * the momenta in the center of mass frame and thus opposite to
   * each other.*/
  logg[LScatterAction].debug("p_a: ", *p_a, "\np_b: ", *p_b);
}

Here is the call graph for this function:

Here is the caller graph for this function:

add_all_scatterings()

void smash::ScatterAction::add_all_scatterings	(	double	elastic_parameter,
		bool	two_to_one,
		ReactionsBitSet	included_2to2,
		MultiParticleReactionsBitSet	included_multi,
		double	low_snn_cut,
		bool	strings_switch,
		bool	use_AQM,
		bool	strings_with_probability,
		NNbarTreatment	nnbar_treatment,
		double	scale_xs,
		double	additional_el_xs
	)

Add all possible scattering subprocesses for this action object.

Parameters

[in]	elastic_parameter	If non-zero, given global elastic cross section.
[in]	two_to_one	2->1 reactions enabled?
[in]	included_2to2	Which 2->2 reactions are enabled?
[in]	included_multi	Which multi-particle reactions are enabled?
[in]	low_snn_cut	Elastic collisions with CME below are forbidden.
[in]	strings_switch	Are string processes enabled?
[in]	use_AQM	use elastic cross sections via AQM?
[in]	strings_with_probability	Are string processes triggered according to a probability?
[in]	nnbar_treatment	NNbar treatment through resonance, strings or none
[in]	scale_xs	Factor by which all (partial) cross sections are scaled
[in]	additional_el_xs	Additional constant elastic cross section

Definition at line 110 of file scatteraction.cc.

                                                                              {
  CrossSections xs(incoming_particles_, sqrt_s(),
                   get_potential_at_interaction_point());
  CollisionBranchList processes = xs.generate_collision_list(
      elastic_parameter, two_to_one, included_2to2, included_multi, low_snn_cut,
      strings_switch, use_AQM, strings_with_probability, nnbar_treatment,
      string_process_, scale_xs, additional_el_xs);
 
  /* Add various subprocesses.*/
  add_collisions(std::move(processes));
 
  /* If the string processes are not triggered by a probability, then they
   * always happen as long as the parametrized total cross section is larger
   * than the sum of the cross sections of the non-string processes, and the
   * square root s exceeds the threshold by at least 0.9 GeV. The cross section
   * of the string processes are counted by taking the difference between the
   * parametrized total and the sum of the non-strings. */
  if (!strings_with_probability &&
      xs.string_probability(strings_switch, strings_with_probability, use_AQM,
                            nnbar_treatment == NNbarTreatment::Strings) == 1.) {
    const double xs_diff = xs.high_energy() - cross_section();
    if (xs_diff > 0.) {
      add_collisions(xs.string_excitation(xs_diff, string_process_, use_AQM));
    }
  }
}

Here is the call graph for this function:

collision_channels()

const CollisionBranchList& smash::ScatterAction::collision_channels ( )

inline

Get list of possible collision channels.

Returns

list of possible collision channels.

Definition at line 165 of file scatteraction.h.

                                                  {
    return collision_channels_;
  }

set_string_interface()

void smash::ScatterAction::set_string_interface ( StringProcess *  str_proc )

inline

Set the StringProcess object to be used.

The StringProcess object is used to handle string excitation and to generate final state particles.

Parameters

[in]

str_proc

String process object to be used.

Definition at line 185 of file scatteraction.h.

                                                     {
    string_process_ = str_proc;
  }

cross_section()

virtual double smash::ScatterAction::cross_section ( ) const

inlinevirtual

Get the total cross section of the scattering particles.

Returns

total cross section.

Definition at line 194 of file scatteraction.h.

{ return total_cross_section_; }

Here is the caller graph for this function:

cm_momentum()

double smash::ScatterAction::cm_momentum ( ) const

protected

Get the momentum of the center of mass of the incoming particles in the calculation frame.

Returns

center of mass momentum.

Definition at line 161 of file scatteraction.cc.

                                        {
  const double m1 = incoming_particles_[0].effective_mass();
  const double m2 = incoming_particles_[1].effective_mass();
  return pCM(sqrt_s(), m1, m2);
}

Here is the call graph for this function:

Here is the caller graph for this function:

cm_momentum_squared()

double smash::ScatterAction::cm_momentum_squared ( ) const

protected

Get the squared momentum of the center of mass of the incoming particles in the calculation frame.

Returns

center of mass momentum squared.

Definition at line 167 of file scatteraction.cc.

                                                {
  const double m1 = incoming_particles_[0].effective_mass();
  const double m2 = incoming_particles_[1].effective_mass();
  return pCM_sqr(sqrt_s(), m1, m2);
}

Here is the call graph for this function:

beta_cm()

ThreeVector smash::ScatterAction::beta_cm ( ) const

protected

Get the velocity of the center of mass of the scattering/incoming particles in the calculation frame.

Note: Do not use this function to boost the outgoing particles. Use total_momentum_of_outgoing_particles(), which corrects for the effect of potentials on intial and final state.

Returns

boost velocity between center of mass and calculation frame.

Definition at line 151 of file scatteraction.cc.

                                         {
  return total_momentum().velocity();
}

Here is the call graph for this function:

Here is the caller graph for this function:

gamma_cm()

double smash::ScatterAction::gamma_cm ( ) const

protected

Get the gamma factor corresponding to a boost to the center of mass frame of the colliding particles.

Returns

gamma factor.

Definition at line 155 of file scatteraction.cc.

                                     {
  return (1. / std::sqrt(1.0 - beta_cm().sqr()));
}

Here is the call graph for this function:

elastic_scattering()

void smash::ScatterAction::elastic_scattering ( )

protected

Perform an elastic two-body scattering, i.e. just exchange momentum.

Definition at line 424 of file scatteraction.cc.

                                       {
  // copy initial particles into final state
  outgoing_particles_[0] = incoming_particles_[0];
  outgoing_particles_[1] = incoming_particles_[1];
  // resample momenta
  sample_angles({outgoing_particles_[0].effective_mass(),
                 outgoing_particles_[1].effective_mass()},
                sqrt_s());
}

Here is the call graph for this function:

Here is the caller graph for this function:

inelastic_scattering()

void smash::ScatterAction::inelastic_scattering ( )

protected

Perform an inelastic two-body scattering, i.e. new particles are formed.

Definition at line 434 of file scatteraction.cc.

                                         {
  // create new particles
  sample_2body_phasespace();
  assign_formation_time_to_outgoing_particles();
}

Here is the call graph for this function:

Here is the caller graph for this function:

two_to_three_scattering()

void smash::ScatterAction::two_to_three_scattering ( )

protected

Perform a two-to-three-body scattering.

Definition at line 440 of file scatteraction.cc.

                                            {
  sample_3body_phasespace();
  assign_formation_time_to_outgoing_particles();
  logg[LScatterAction].debug("2->3 scattering:", incoming_particles_, " -> ",
                             outgoing_particles_);
}

Here is the call graph for this function:

Here is the caller graph for this function:

string_excitation()

void smash::ScatterAction::string_excitation ( )

protected

Todo(ryu): document better - it is not really UrQMD-based, isn't it? Perform the UrQMD-based string excitation and decay.

Definition at line 469 of file scatteraction.cc.

                                      {
  assert(incoming_particles_.size() == 2);
  // Disable floating point exception trap for Pythia
  {
    DisableFloatTraps guard;
    /* initialize the string_process_ object for this particular collision */
    string_process_->init(incoming_particles_, time_of_execution_);
    /* implement collision */
    bool success = false;
    int ntry = 0;
    const int ntry_max = 10000;
    while (!success && ntry < ntry_max) {
      ntry++;
      switch (process_type_) {
        case ProcessType::StringSoftSingleDiffractiveAX:
          /* single diffractive to A+X */
          success = string_process_->next_SDiff(true);
          break;
        case ProcessType::StringSoftSingleDiffractiveXB:
          /* single diffractive to X+B */
          success = string_process_->next_SDiff(false);
          break;
        case ProcessType::StringSoftDoubleDiffractive:
          /* double diffractive */
          success = string_process_->next_DDiff();
          break;
        case ProcessType::StringSoftNonDiffractive:
          /* soft non-diffractive */
          success = string_process_->next_NDiffSoft();
          break;
        case ProcessType::StringSoftAnnihilation:
          /* soft BBbar 2 mesonic annihilation */
          success = string_process_->next_BBbarAnn();
          break;
        case ProcessType::StringHard:
          success = string_process_->next_NDiffHard();
          break;
        default:
          logg[LPythia].error("Unknown string process required.");
          success = false;
      }
    }
    if (ntry == ntry_max) {
      /* If pythia fails to form a string, it is usually because the energy
       * is not large enough. In this case, an elastic scattering happens.
       *
       * Since particles are normally added after process selection for
       * strings, outgoing_particles is still uninitialized, and memory
       * needs to be allocated. We also shift the process_type_ to elastic
       * so that sample_angles does a proper treatment. */
      outgoing_particles_.reserve(2);
      outgoing_particles_.push_back(ParticleData{incoming_particles_[0]});
      outgoing_particles_.push_back(ParticleData{incoming_particles_[1]});
      process_type_ = ProcessType::FailedString;
      elastic_scattering();
    } else {
      outgoing_particles_ = string_process_->get_final_state();
      assign_formation_time_to_outgoing_particles();
      /* Check momentum difference for debugging */
      FourVector out_mom;
      for (ParticleData data : outgoing_particles_) {
        out_mom += data.momentum();
      }
      logg[LPythia].debug("Incoming momenta string:", total_momentum());
      logg[LPythia].debug("Outgoing momenta string:", out_mom);
    }
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

is_elastic()

bool smash::ScatterAction::is_elastic ( ) const

private

Check if the scattering is elastic.

Returns

whether the scattering is elastic.

resonance_formation()

void smash::ScatterAction::resonance_formation ( )

private

Perform a 2->1 resonance-formation process.

Exceptions

InvalidResonanceFormation

Definition at line 447 of file scatteraction.cc.

                                        {
  if (outgoing_particles_.size() != 1) {
    std::string s =
        "resonance_formation: "
        "Incorrect number of particles in final state: ";
    s += std::to_string(outgoing_particles_.size()) + " (";
    s += incoming_particles_[0].pdgcode().string() + " + ";
    s += incoming_particles_[1].pdgcode().string() + ")";
    throw InvalidResonanceFormation(s);
  }
  // Set the momentum of the formed resonance in its rest frame.
  outgoing_particles_[0].set_4momentum(
      total_momentum_of_outgoing_particles().abs(), 0., 0., 0.);
  assign_formation_time_to_outgoing_particles();
  /* this momentum is evaluated in the computational frame. */
  logg[LScatterAction].debug("Momentum of the new particle: ",
                             outgoing_particles_[0].momentum());
}

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

collision_channels_

CollisionBranchList smash::ScatterAction::collision_channels_

protected

List of possible collisions.

Definition at line 253 of file scatteraction.h.

total_cross_section_

double smash::ScatterAction::total_cross_section_

protected

Total hadronic cross section.

Definition at line 256 of file scatteraction.h.

partial_cross_section_

double smash::ScatterAction::partial_cross_section_

protected

Partial cross-section to the chosen outgoing channel.

Definition at line 259 of file scatteraction.h.

isotropic_

bool smash::ScatterAction::isotropic_ = false

protected

Do this collision isotropically?

Definition at line 262 of file scatteraction.h.

string_formation_time_

double smash::ScatterAction::string_formation_time_ = 1.0

protected

Time fragments take to be fully formed in hard string excitation.

Definition at line 265 of file scatteraction.h.

string_process_

StringProcess* smash::ScatterAction::string_process_ = nullptr

private

Pointer to interface class for strings.

Definition at line 282 of file scatteraction.h.

---

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

• src/include/smash/scatteraction.h
• src/scatteraction.cc