Version: SMASH-3.0
scatteraction.h
Go to the documentation of this file.
1 /*
2  *
3  * Copyright (c) 2014-2022
4  * SMASH Team
5  *
6  * GNU General Public License (GPLv3 or later)
7  *
8  */
9 
10 #ifndef SRC_INCLUDE_SMASH_SCATTERACTION_H_
11 #define SRC_INCLUDE_SMASH_SCATTERACTION_H_
12 
13 #include <memory>
14 #include <set>
15 #include <string>
16 #include <utility>
17 
18 #include "action.h"
19 #include "isoparticletype.h"
21 #include "stringprocess.h"
22 
23 namespace smash {
24 
30 class ScatterAction : public Action {
31  public:
44  ScatterAction(const ParticleData& in_part1, const ParticleData& in_part2,
45  double time, bool isotropic = false,
46  double string_formation_time = 1.0, double box_length = -1.0);
47 
53  void add_collision(CollisionBranchPtr p);
54 
60  void add_collisions(CollisionBranchList pv);
61 
82  double transverse_distance_sqr() const;
83 
91  double cov_transverse_distance_sqr() const;
100  double mandelstam_s() const;
101 
108  double relative_velocity() const;
109 
117  void generate_final_state() override;
118 
124  double get_total_weight() const override;
125 
131  double get_partial_weight() const override;
132 
136  void sample_angles(std::pair<double, double> masses,
137  double kinetic_energy_cm) override;
138 
144  void add_all_scatterings(
145  const ScatterActionsFinderParameters& finder_parameters);
146 
152  const CollisionBranchList& collision_channels() {
153  return collision_channels_;
154  }
155 
160  class InvalidScatterAction : public std::invalid_argument {
161  using std::invalid_argument::invalid_argument;
162  };
163 
173  string_process_ = str_proc;
174  }
175 
181  virtual double cross_section() const { return total_cross_section_; }
182 
183  protected:
190  double cm_momentum() const;
197  double cm_momentum_squared() const;
198 
209  ThreeVector beta_cm() const;
216  double gamma_cm() const;
217 
219  void elastic_scattering();
220 
222  void inelastic_scattering();
223 
225  void two_to_many_scattering();
226 
233  void string_excitation();
234 
239  void format_debug_output(std::ostream& out) const override;
240 
242  CollisionBranchList collision_channels_;
243 
246 
249 
251  bool isotropic_ = false;
252 
255 
256  private:
262  bool is_elastic() const;
263 
268  void resonance_formation();
269 
272 };
273 
274 } // namespace smash
275 
276 #endif // SRC_INCLUDE_SMASH_SCATTERACTION_H_
Action is the base class for a generic process that takes a number of incoming particles and transfor...
Definition: action.h:35
ParticleData contains the dynamic information of a certain particle.
Definition: particledata.h:58
Thrown when ScatterAction is called to perform with unknown ProcessType.
ScatterAction is a special action which takes two incoming particles and performs a scattering,...
Definition: scatteraction.h:30
bool is_elastic() const
Check if the scattering is elastic.
bool isotropic_
Do this collision isotropically?
double string_formation_time_
Time fragments take to be fully formed in hard string excitation.
const CollisionBranchList & collision_channels()
Get list of possible collision channels.
void add_collision(CollisionBranchPtr p)
Add a new collision channel.
void resonance_formation()
Perform a 2->1 resonance-formation process.
ThreeVector beta_cm() const
Get the velocity of the center of mass of the scattering/incoming particles in the calculation frame.
double partial_cross_section_
Partial cross-section to the chosen outgoing channel.
double relative_velocity() const
Get the relative velocity of the two incoming particles.
double mandelstam_s() const
Determine the Mandelstam s variable,.
double get_partial_weight() const override
Get the partial cross section of the chosen channel.
StringProcess * string_process_
Pointer to interface class for strings.
void create_string_final_state()
Creates the final states for string-processes after they are performed.
void set_string_interface(StringProcess *str_proc)
Set the StringProcess object to be used.
double cm_momentum_squared() const
Get the squared momentum of the center of mass of the incoming particles in the calculation frame.
void generate_final_state() override
Generate the final-state of the scattering process.
void add_all_scatterings(const ScatterActionsFinderParameters &finder_parameters)
Add all possible scattering subprocesses for this action object.
void two_to_many_scattering()
Perform an inelastic two-to-many-body scattering (more than 2)
double get_total_weight() const override
Get the total cross section of scattering particles.
void string_excitation()
Todo(ryu): document better - it is not really UrQMD-based, isn't it? Perform the UrQMD-based string e...
void elastic_scattering()
Perform an elastic two-body scattering, i.e. just exchange momentum.
void inelastic_scattering()
Perform an inelastic two-body scattering, i.e. new particles are formed.
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.
void sample_angles(std::pair< double, double > masses, double kinetic_energy_cm) override
Sample final-state angles in a 2->2 collision (possibly anisotropic).
void add_collisions(CollisionBranchList pv)
Add several new collision channels at once.
double total_cross_section_
Total hadronic cross section.
double gamma_cm() const
Get the gamma factor corresponding to a boost to the center of mass frame of the colliding particles.
double cm_momentum() const
Get the momentum of the center of mass of the incoming particles in the calculation frame.
double cov_transverse_distance_sqr() const
Calculate the transverse distance of the two incoming particles in their local rest frame written in ...
virtual double cross_section() const
Get the total cross section of the scattering particles.
CollisionBranchList collision_channels_
List of possible collisions.
double transverse_distance_sqr() const
Calculate the transverse distance of the two incoming particles in their local rest frame.
String excitation processes used in SMASH.
Definition: stringprocess.h:45
The ThreeVector class represents a physical three-vector with the components .
Definition: threevector.h:31
void format_debug_output(std::ostream &out) const override
Writes information about this scatter action to the out stream.
constexpr int p
Proton.
Definition: action.h:24
Helper structure for ScatterActionsFinder.