R/run_MC_ISO_TUN.R
run_MC_ISO_TUN.Rd
Runs a Monte-Carlo (MC) simulation of isothermally stimulated luminescence (ISO-TL or ITL) using the tunnelling (TUN) model. Tunnelling refers to quantum mechanical tunnelling processes from the excited state of the trapped charge, into the recombination centre.
run_MC_ISO_TUN(
E,
s,
T = 200,
rho,
times,
clusters = 10,
r_c = 0,
delta.r = 0.1,
N_e = 200,
method = "par",
output = "signal",
...
)
numeric (required): Thermal activation energy of the trap (eV).
numeric (required): The effective frequency factor for the
tunnelling process (s^-1
).
numeric (with default): Constant stimulation temperature (°C).
numeric (required): The dimensionless density of recombination centres (defined as \(\rho\)' in Huntley 2006) (dimensionless).
numeric (required): The sequence of time steps within the simulation (s).
numeric (with default): The number of created clusters for the MC runs. The input can be the output of create_ClusterSystem. In that case n_filled
indicate absolute numbers of a system.
numeric (with default): Critical distance (>0) that must be provided if the
sample has been thermally and/or optically pretreated. This parameter expresses the fact
that electron-hole pairs within a critical radius r_c
have already recombined.
numeric (with default): Fractional change of the dimensionless distance of nearest recombination centres (r')
numeric (width default): The total number of electron traps available (dimensionless).
Can be a vector of length(clusters)
, shorter values are recycled.
character (with default): Sequential 'seq'
or parallel 'par'
processing. In
the parallel mode the function tries to run the simulation on multiple CPU cores (if available) with
a positive effect on the computation time.
character (with default): output is either the 'signal'
(the default) or
'remaining_e'
(the remaining charges/electrons in the trap)
further arguments, such as cores
to control the number of used CPU cores or verbose
to silence the terminal
This function returns an object of class RLumCarlo_Model_Output
which
is a list consisting of an array with dimension length(times) x length(r) x clusters
and a numeric time vector.
The model
$$ I_{TUN}(r',t) = -dn/dt = (s * exp(-E/(k_{B}*T_{ISO}))) * exp(-(\rho')^{-1/3} * r') * n (r',t) $$
Where in the function:
E := thermal activation energy (eV)
s := the effective frequency factor for the tunnelling process (s^-1)
\(T_{ISO}\) := the temperature of the isothermal experiment (°C)
\(k_{B}\) := Boltzmann constant (8.617 x 10^-5 eV K^-1)
r' := the dimensionless tunnelling radius
\(\rho\)' := rho
the dimensionless density of recombination centres see Huntley (2006)
t := time (s)
n := the instantaneous number of electrons corresponding to the radius r'
0.1.0
Friedrich, J., Kreutzer, S., 2022. run_MC_ISO_TUN(): Monte-Carlo Simulation for ISO-TL (tunnelling transitions). Function version 0.1.0. In: Friedrich, J., Kreutzer, S., Pagonis, V., Schmidt, C., 2022. RLumCarlo: Monte-Carlo Methods for Simulating Luminescence Phenomena. R package version 0.1.9. https://CRAN.R-project.org/package=RLumCarlo
Pagonis, V. and Kulp, C., 2017. Monte Carlo simulations of tunneling phenomena and nearest neighbor hopping mechanism in feldspars. Journal of Luminescence 181, 114–120. doi:10.1016/j.jlumin.2016.09.014
Further reading Aitken, M.J., 1985. Thermoluminescence dating. Academic Press.
Huntley, D.J., 2006. An explanation of the power-law decay of luminescence. Journal of Physics: Condensed Matter, 18(4), 1359.
Jain, M., Guralnik, B., Andersen, M.T., 2012. Stimulated luminescence emission from localized recombination in randomly distributed defects. Journal of Physics: Condensed Matter 24, 385402.
Pagonis, V., Friedrich, J., Discher, M., Müller-Kirschbaum, A., Schlosser, V., Kreutzer, S., Chen, R. and Schmidt, C., 2019. Excited state luminescence signals from a random distribution of defects: A new Monte Carlo simulation approach for feldspar. Journal of Luminescence 207, 266–272. doi:10.1016/j.jlumin.2018.11.024
## short example
run_MC_ISO_TUN(
E = .8,
s = 1e16,
T = 50,
rho = 1e-4,
times = 0:100,
clusters = 10,
N_e = 100,
r_c = 0.2,
delta.r = 0.5,
method = "seq") %>%
plot_RLumCarlo(legend = TRUE)
if (FALSE) {
## long (meaningful) example
results <- run_MC_ISO_TUN(
E = .8,
s = 1e16,
T = 50,
rho = 1e-4,
times = 0:100,
clusters = 1000,
N_e = 200,
r_c = 0.1,
delta.r = 0.05,
method = "par")
plot_RLumCarlo(results, legend = TRUE)
}