Call: MICROSCOPIC_AVALANCHE
x-Coordinate of the primary electron.
See coordinates.
y-Coordinate of the primary electron.
See coordinates.
z-Coordinate of the primary electron.
See coordinates.
See status.
See time.
A String which may contain one or more of
the following options and their negated versions (prefixed with NO):
- ABORT-100
- Kills avalanche tracing when it reaches a size of 100. By
default, an avalanche is allowed to grow until it exhausts
the memory allocated for it.
- ABORT-1000
- Kills avalanche tracing when it reaches a size of 1000. By
default, an avalanche is allowed to grow until it exhausts
the memory allocated for it.
- ABORT-10000
- Kills avalanche tracing when it reaches a size of 10000. By
default, an avalanche is allowed to grow until it exhausts
the memory allocated for it.
- ABORT-100000
- Kills avalanche tracing when it reaches a size of 100000. By
default, an avalanche is allowed to grow until it exhausts
the memory allocated for it.
- MARK-ATTACHMENT
- Marks the location where attachment occurs with representation
ATTACHMENT. The
electron will as a rule stop at these locations. This option is
not active by default.
- MARK-ELASTIC
- Marks the locations of elastic interactions, using
ELASTIC.
This is nearly always the most common type of collision. This
option is not active by default.
- MARK-EXCITATION
- Marks the locations of inelastic collisions where an excited
state is produced. The point will be drawn using
EXCITATION. This
option is not active by default.
- MARK-INELASTIC
- Marks the locations of inelastic but non-exciting
interactions. The position will be marked using
INELASTIC. This
option is not active by default.
- MARK-IONISATION
- Marks the locations where ionisations occur using
IONISATION. This
option is not active by default.
- MARK-SUPER-ELASTIC
- Marks the locations of super-elastic interactions using
SUPER-ELASTIC. This
option is not active by default.
- PLOT-ELECTRON
- Plots all electron trajectories. PLOT_DRIFT_LINE
would only show the last electron trajectory calculated, not
the entire avalanche.
- PRINT
- Switches on Magboltz printing. Use the DEBUG
option to obtain details for each step.
Note: switching on any of the MARK and PLOT options presumes that you have already
opened a graphics window suitable for plotting the drift line. Example:
Call plot_drift_area
Call new_track
Do
Call get_cluster(x,y,z,n,e,done)
If done Then Leave
Call microscopic_avalanche(x, y, z, ...
`mark-ion nomark-super mark-att print plot-electron abort-10000`, ...
200.0, 1.0, 0,0,0, histe, rates, ne, ni)
Say "Electrons: {ne}, Ions: {ni}"
Enddo
Call plot_track
Call plot_end
In this example, all electrons generated along a track, as well as the
avalanches they generate are traced up to a size of 10000. The electron
trajectories are plotted and locations where ionisation and attachment
occurs are marked.
Maximum kinetic energy in eV any electron in the avalanche is expected
to reach.
The calculation of the avalanche as a whole is aborted when at any point
an electron energy exceeds this value. The global variable OK
will be set to False should this occur.
The trajectory will be inaccurate if the maximum energy is chosen too large.
A simple way to find suitable values for this parameter is running
MAGBOLTZ with the PLOT-DISTRIBUTION-FUNCTIONS
option switched on. Beware that e_maximum must be suitable over the entire
drift path of the electron, including the avalanche region.
[Default: 200 eV]
Kinetic energy in eV of the primary electron at the start of the avalanche.
The energy of secondary electrons is randomised according to a splitting
function.
This energy must be strictly positive (non-zero) and less than
e_maximum.
[Default: 2 % of e_maximum.]
Direction vector of the initial velocity of the primary electron.
The initial direction has, in most gaseous detectors, little impact.
The direction of secondary electrons is assumed to be isotropic.
The norm of the initial velocity is taken from
e_start,
not from the direction vector. The normalisation is arbitrary.
All three components must be specified. If all 3 components of the direction
vector are zero, then an isotropic random vector will be generated.
[A random direction is assumed if no direction is specified.]
On return an Histogram which contains
the electron energy distribution sampled just prior to every interaction with
the gas molecules.
If this argument is on entry an existing histogram, then new entries will
be added to it. This can be used to force a scale and also to accumulate
statistics across multiple calls.
If this argument is of another type on entry, then the current value will
be deleted and a new histogram will be booked with 100 bins and ranging
from 0 to e_maximum.
This procedure returns the detailed counts of the interactions in the form
of a 1-dimensional Matrix.
The cross sections present in the vector vary with
e_maximum since Magboltz eliminates,
for reasons of efficiency, negligibly small cross section terms.
The various terms can be identified with the help of the
CROSS_SECTION_IDENTIFIER procedure:
See the rates argument of the
DRIFT_MICROSCOPIC_ELECTRON procedure for an example.
Contains on return the Number
of electrons produced in the avalanche minus the number of electrons
lost via attachment.
This is an optional output parameter. If present, it must be modifiable.
The value assigned to this parameter on entry is not used and will be lost
after the call.
Contains on return the Number
of ions produced in the avalanche.
This is an optional output parameter. If present, it must be modifiable.
The value assigned to this parameter on entry is not used and will be lost
after the call.
Go to the top level,
to Call,
to MICROSCOPIC_AVALANCHE,
to the topic index,
to the table of contents, or to the full text.
Formatted on 09/03/10 at 00:22.