Garfield++ 4.0
A toolkit for the detailed simulation of particle detectors based on ionisation measurement in gases and semiconductors
Loading...
Searching...
No Matches
Heed::HeedParticle Class Reference

#include <HeedParticle.h>

+ Inheritance diagram for Heed::HeedParticle:

Public Member Functions

 HeedParticle ()
 Default constructor.
 
 HeedParticle (manip_absvol *primvol, const point &pt, const vec &vel, vfloat time, particle_def *fpardef, HeedFieldMap *fieldmap, const bool fs_loss_only=false, const bool fs_print_listing=false)
 
virtual ~HeedParticle ()
 Destructor.
 
HeedParticlecopy () const override
 Clone the particle.
 
void print (std::ostream &file, int l) const override
 Print-out.
 
- Public Member Functions inherited from Heed::eparticle
 eparticle ()=default
 Default constructor.
 
 eparticle (manip_absvol *primvol, const point &pt, const vec &vel, vfloat time, particle_def *fpardef, HeedFieldMap *fieldmap)
 Constructor using velocity vector.
 
virtual ~eparticle ()
 Destructor.
 
eparticlecopy () const override
 Clone the particle.
 
void print (std::ostream &file, int l) const override
 Print-out.
 
- Public Member Functions inherited from Heed::mparticle
 mparticle ()=default
 Default constructor.
 
 mparticle (manip_absvol *primvol, const point &pt, const vec &vel, vfloat ftime, double fmass)
 Constructor, $\gamma - 1$ calculated from the from velocity vector.
 
virtual ~mparticle ()
 Destructor.
 
double kinetic_energy () const
 Get the current kinetic energy.
 
void print (std::ostream &file, int l) const override
 Print-out.
 
mparticlecopy () const override
 Clone the particle.
 
- Public Member Functions inherited from Heed::gparticle
 gparticle ()=default
 Default constructor.
 
 gparticle (manip_absvol *primvol, const point &pt, const vec &vel, vfloat time)
 Constructor.
 
virtual ~gparticle ()
 Destructor.
 
virtual void fly (std::vector< gparticle * > &secondaries)
 Transport the particle.
 
virtual void fly (std::vector< gparticle * > &secondaries, const bool one_step)
 
void set_step_limits (const vfloat fmax_range, const vfloat frad_for_straight, const vfloat fmax_straight_arange, const vfloat fmax_circ_arange)
 Set limits/parameters for trajectory steps.
 
const vecposition () const
 Get the current position of the particle.
 
vfloat time () const
 Get the current time of the particle.
 
const vecdirection () const
 Get the current direction of the particle.
 
bool alive () const
 
virtual void print (std::ostream &file, int l) const
 Print-out.
 
virtual gparticlecopy () const
 Clone the particle.
 
- Public Member Functions inherited from Heed::particle_type
 particle_type ()=default
 
 particle_type (particle_def *f)
 
 particle_type (const char *name, int s=0)
 
int operator== (const particle_type &f)
 
int operator!= (const particle_type &f)
 
void print_notation (std::ostream &file) const
 

Protected Member Functions

void physics (std::vector< gparticle * > &secondaries) override
 Apply any other processes (turn the trajectory, kill the particle, ...).
 
- Protected Member Functions inherited from Heed::eparticle
int force (const point &pt, vec &f, vec &f_perp, vfloat &mrange) override
 Calculate force components.
 
- Protected Member Functions inherited from Heed::mparticle
void step (std::vector< gparticle * > &secondaries) override
 
void curvature (bool &curved, vec &frelcen, vfloat &fmrange, vfloat prec) override
 
virtual int force (const point &pt, vec &f, vec &f_perp, vfloat &mrange)
 
- Protected Member Functions inherited from Heed::gparticle
virtual void step (std::vector< gparticle * > &secondaries)
 
virtual void change_vol ()
 Move from one volume to another.
 
virtual void curvature (bool &curved, vec &frelcen, vfloat &fmrange, vfloat prec)
 
virtual void physics_after_new_speed (std::vector< gparticle * > &)
 Apply any other processes (turn the trajectory, kill the particle, ...).
 
virtual void physics (std::vector< gparticle * > &)
 Apply any other processes (turn the trajectory, kill the particle, ...).
 
virtual void physics_mrange (double &fmrange)
 
virtual stvpoint calc_step_to_bord ()
 Determine next position.
 
stvpoint switch_new_vol ()
 Generate next position in new volume.
 

Additional Inherited Members

- Public Attributes inherited from Heed::particle_type
particle_defpardef = nullptr
 
- Protected Attributes inherited from Heed::eparticle
HeedFieldMapm_fieldMap = nullptr
 Pointer to field map.
 
- Protected Attributes inherited from Heed::mparticle
double m_mass = 0.
 Mass (not mass * speed_of_light^2)
 
double m_curr_ekin = 0.
 Current kinetic energy.
 
double m_orig_ekin = 0.
 Original kinetic energy.
 
double m_prev_ekin = 0.
 Previous kinetic energy.
 
double m_curr_gamma_1 = 0.
 Current $\gamma - 1$.
 
double m_orig_gamma_1 = 0.
 Original $\gamma - 1$.
 
double m_prev_gamma_1 = 0.
 Previous $\gamma - 1$.
 
- Protected Attributes inherited from Heed::gparticle
bool m_alive = false
 Status flag whether the particle is active.
 
long m_nstep = 0
 Step number.
 
long m_nzero_step = 0
 Number of previous steps with zero range (including this step).
 
stvpoint m_origin
 Original point.
 
double m_total_range_from_origin = 0.
 Range from origin to current position.
 
stvpoint m_prevpos
 Previous point.
 
stvpoint m_currpos
 Current point.
 
stvpoint m_nextpos
 Next point.
 
- Static Protected Attributes inherited from Heed::gparticle
static constexpr long m_max_qzero_step = 100
 Max. number of zero-steps allowed.
 

Detailed Description

Charged particle which can be traced through the geometry.

2003, I. Smirnov

Definition at line 15 of file HeedParticle.h.

Constructor & Destructor Documentation

◆ HeedParticle() [1/2]

Heed::HeedParticle::HeedParticle ( )
inline

Default constructor.

Definition at line 18 of file HeedParticle.h.

18: eparticle() {}
eparticle()=default
Default constructor.

Referenced by copy().

◆ HeedParticle() [2/2]

Heed::HeedParticle::HeedParticle ( manip_absvol primvol,
const point pt,
const vec vel,
vfloat  time,
particle_def fpardef,
HeedFieldMap fieldmap,
const bool  fs_loss_only = false,
const bool  fs_print_listing = false 
)

Constructor. If fs_loss_only == false only transferred energy is simulated: no deposition of clusters, no generation of virtual photons.

Definition at line 22 of file HeedParticle.cpp.

26 : eparticle(primvol, pt, vel, ftime, fpardef, fieldmap),
27 m_print_listing(fprint_listing),
28 m_loss_only(floss_only),
29 m_particle_number(last_particle_number++) {}
long last_particle_number
Definition: HeedParticle.h:9

◆ ~HeedParticle()

virtual Heed::HeedParticle::~HeedParticle ( )
inlinevirtual

Destructor.

Definition at line 28 of file HeedParticle.h.

28{}

Member Function Documentation

◆ copy()

HeedParticle * Heed::HeedParticle::copy ( ) const
inlineoverridevirtual

Clone the particle.

Reimplemented from Heed::gparticle.

Definition at line 30 of file HeedParticle.h.

30{ return new HeedParticle(*this); }
HeedParticle()
Default constructor.
Definition: HeedParticle.h:18

◆ physics()

void Heed::HeedParticle::physics ( std::vector< gparticle * > &  )
overrideprotectedvirtual

Apply any other processes (turn the trajectory, kill the particle, ...).

Reimplemented from Heed::gparticle.

Definition at line 31 of file HeedParticle.cpp.

31 {
32 mfunname("void HeedParticle::physics()");
33 if (m_print_listing) {
34 mcout << "HeedParticle::physics is started\n";
36 }
37 m_edep = 0.;
38 // Get the step.
39 if (m_currpos.prange <= 0.0) return;
40 const double step = m_currpos.prange / cm;
41 const vec dir = unit_vec(m_currpos.pt - m_prevpos.pt);
42 const double range = (m_currpos.pt - m_prevpos.pt).length();
43 if (m_print_listing) Iprint3n(mcout, m_prevpos.pt, dir, range);
44 // Get local volume.
45 const absvol* av = m_currpos.volume();
46 auto etcs = dynamic_cast<const EnTransfCS*>(av);
47 if (!etcs) return;
48 HeedMatterDef* hmd = etcs->hmd;
49 MatterDef* matter = hmd->matter;
50 EnergyMesh* emesh = hmd->energy_mesh;
51 const double* aetemp = emesh->get_ae();
52 PointCoorMesh<double, const double*> pcm(emesh->get_q() + 1, &(aetemp));
53 basis tempbas(m_currpos.dir, "tempbas");
54 // Particle mass and energy.
55 const double mp = m_mass * c_squared;
56 const double ep = mp + m_curr_ekin;
57 // Electron mass.
58 const double mt = electron_def.mass * c_squared;
59 // Particle velocity.
60 const double invSpeed = 1. / m_prevpos.speed;
61 // Shorthand.
62 const auto sampleTransfer = t_hisran_step_ar<double, std::vector<double>,
63 PointCoorMesh<double, const double*> >;
64 const long qa = matter->qatom();
65 if (m_print_listing) Iprintn(mcout, qa);
66 for (long na = 0; na < qa; ++na) {
67 if (m_print_listing) Iprintn(mcout, na);
68 const long qs = hmd->apacs[na]->get_qshell();
69 for (long ns = 0; ns < qs; ++ns) {
70 if (m_print_listing) Iprintn(mcout, ns);
71 if (etcs->quan[na][ns] <= 0.0) continue;
72 // Sample the number of collisions for this shell.
73 const long qt = pois(etcs->quan[na][ns] * step);
74 if (m_print_listing) Iprintn(mcout, qt);
75 if (qt <= 0) continue;
76 for (long nt = 0; nt < qt; ++nt) {
77 // Sample the energy transfer in this collision.
78 const double r = sampleTransfer(pcm, etcs->fadda[na][ns], SRANLUX());
79 // Convert to internal units.
80 const double et = r * MeV;
81 m_edep += et;
82 if (m_print_listing) Iprint2n(mcout, nt, et);
83 // Sample the position of the collision.
84 const double arange = SRANLUX() * range;
85 point pt = m_prevpos.pt + dir * arange;
86 if (m_loss_only) continue;
87 if (m_print_listing) mcout << "generating new cluster\n";
88 if (m_store_clusters) {
89 m_clusterBank.emplace_back(HeedCluster(et, pt, na, ns));
90 }
91 // Generate a virtual photon.
92 double theta_p, theta_t;
93 theta_two_part(ep, ep - et, mp, mt, theta_p, theta_t);
94 vec vel;
95 vel.random_conic_vec(fabs(theta_t));
96 vel.down(&tempbas); // direction is OK
97 vel *= c_light;
98 const double t = m_prevpos.time + arange * invSpeed;
99 if (m_print_listing) mcout << "generating new virtual photon\n";
100 HeedPhoton* hp = new HeedPhoton(m_currpos.tid.eid[0], pt, vel, t,
101 m_particle_number, et, m_fieldMap);
102 if (!hp->alive()) {
103 delete hp;
104 continue;
105 }
106 hp->m_photon_absorbed = true;
107 hp->m_delta_generated = false;
108 hp->m_na_absorbing = na;
109 hp->m_ns_absorbing = ns;
110 secondaries.push_back(hp);
111 }
112 }
113 }
114 if (m_print_listing) {
115 Iprintn(mcout, m_edep);
116 mcout << "Exiting HeedParticle::physics\n";
117 }
118}
#define mfunname(string)
Definition: FunNameStack.h:45
HeedFieldMap * m_fieldMap
Pointer to field map.
Definition: eparticle.h:34
stvpoint m_prevpos
Previous point.
Definition: gparticle.h:262
stvpoint m_currpos
Current point.
Definition: gparticle.h:264
std::vector< manip_absvol * > eid
List of volumes.
Definition: volume.h:37
double m_curr_ekin
Current kinetic energy.
Definition: mparticle.h:73
void step(std::vector< gparticle * > &secondaries) override
Definition: mparticle.cpp:71
double m_mass
Mass (not mass * speed_of_light^2)
Definition: mparticle.h:70
vfloat time
Definition: gparticle.h:47
absvol * volume()
Definition: gparticle.h:137
vec dir
Unit vector, in the first system in the tree.
Definition: gparticle.h:25
vfloat prange
Range from previous point.
Definition: gparticle.h:46
vfloat speed
Longitudinal velocity.
Definition: gparticle.h:31
point pt
Coordinates in the first system in the tree.
Definition: gparticle.h:23
manip_absvol_treeid tid
Definition: gparticle.h:32
void theta_two_part(const double Ep0, const double Ep1, const double Mp, const double Mt, double &theta_p, double &theta_t)
Scattering angles as function of incident and final projectile energy.
Definition: kinem.cpp:28
long pois(const double amu)
Definition: pois.cpp:9
DoubleAc fabs(const DoubleAc &f)
Definition: DoubleAc.h:615
particle_def electron_def("electron", "e-", electron_mass_c2/c_squared, electron_charge, 1, 0, 0.5, spin_def(0.0, 0.0))
Definition: particle_def.h:106
#define mcout
Definition: prstream.h:126
#define Iprint3n(file, name1, name2, name3)
Definition: prstream.h:232
#define Iprintn(file, name)
Definition: prstream.h:204
#define Iprint2n(file, name1, name2)
Definition: prstream.h:219

◆ print()

void Heed::HeedParticle::print ( std::ostream &  file,
int  l 
) const
overridevirtual

Print-out.

Reimplemented from Heed::gparticle.

Definition at line 120 of file HeedParticle.cpp.

120 {
121 if (l < 0) return;
122 Ifile << "HeedParticle (l=" << l << "): particle_number="
123 << m_particle_number << " type=";
124 print_notation(file);
125 file << std::endl;
126 if (l == 1) return;
127 mparticle::print(file, l - 1);
128 Iprintn(mcout, m_edep);
129}
void print(std::ostream &file, int l) const override
Print-out.
Definition: mparticle.cpp:243
void print_notation(std::ostream &file) const
#define Ifile
Definition: prstream.h:195

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