Description Usage Arguments Details Value Author(s) See Also
View source: R/script_TL.MAAD.R
This script calls a series of data functions before estimating the ED using the MAAD protocol. It just requires the name of the files with the TL curves, the relative error on the measurement and the temperature boundaries for the signal integration.
1 2 3 4 5 6 7 8 | script_TL.MAAD(file.name, eval.Tmin, eval.Tmax, k = 1, remove.discs = NULL,
file.parameters = list(file.extension = ".binx", folder.in = "./",
folder.out = "./"), aligning.parameters = list(peak.Tmin = NULL, peak.Tmax =
NULL, no.testdose = FALSE), fitting.parameters = list(fit.method = "LIN",
fit.weighted = FALSE, fit.use.slope = FALSE, fit.aDoses.min = 0,
fit.aDoses.max = NA, fit.rDoses.min = 0, fit.rDoses.max = NA),
plotting.parameters = list(plot.Tmin = 0, plot.Tmax = NA, no.plot = FALSE),
rejection.criteria = list(testdose.error = 10, paleodose.error = 10))
|
file.name |
character (required): Name of the file containing the luminescence data. |
eval.Tmin |
integer (required): Temperature ( <c2><b0>C) of the lower boundary for the signal integration. |
eval.Tmax |
integer (required): Temperature (<c2><b0>C) of the upper boundary for the signal integration. |
k |
numeric (with default): Corrective factor for estimating the uncertainties using a poisson distribution. |
remove.discs |
numeric (with default): list containing the position of the aliquots to shall be removed. |
file.parameters |
list (with default): list containing the input/output parameters. See details. |
aligning.parameters |
list (with default): list containing the aligning parameters. See details. |
fitting.parameters |
list (with default): list containing the fitting parameters. See details. |
plotting.parameters |
list (with default): list containing the plotting parameters. See details. |
rejection.criteria |
list (with default): list containing the rejection criteria (in %). See details. |
File parameters
The file parameters are:
file.extension
character (with default): extension of the file containing the luminescence data (.bin or .binx)
folder.in
character (with default): Folder containing the file with the luminescene data.
folder.out
character (with default): Folder containing the file with the new luminescene data.
see also script_TL.pretreatment.
Aligning parameters
The aligning parameters are:
peak.Tmin
numeric: Lower boundary for looking for the peak maximum position.
peak.Tmax
numeric: Upper boundary for looking for the peak maximum position.
no.testdose
logical: If TRUE
, the function will use the Lx curves rather than the Tx curves as reference for the peak maximum position.
Fitting parameters
The fitting parameters are:
method
character: Fitting method (LIN
, EXP
, EXP+LIN
or EXP+EXP
).
fit.weighted
logical: If the fitting is weighted or not.
fit.use.slope
logical: If the slope of the Q growth curve is reused for the supralinearity correction.
fit.aDoses.min
numeric: Lowest additive dose used for the fitting.
fit.aDoses.max
numeric: Highest additive dose used for the fitting.
fit.rDoses.min
numeric: Lowest regenerative dose used for the fitting.
fit.rDoses.max
numeric: Highest regenerative dose used for the fitting.
See also calc_TL.MAAD.fit.Q and calc_TL.MAAD.fit.I.
Plotting parameters
The plotting parameters are:
plot.Tmin
numeric: Lowest temperature plotted.
plot.Tmax
numeric: Highest temperature plotted.
no.plot
logical: If TRUE
, the results will not be plotted.
See also plot_TL.MAAD.
Rejection criteria
The rejection criteria are:
testdose.error
numeric: Maximum error accepted on the testdose signal within the selected temperature interval.
paleodose.error
numeric: Maximum error accepted on the palaeodose signal within the selected temperature interval.
This function plots the results from the differents functions called using:
plot_extract.TL,
plot_remove.preheat
plot_substract.background
plot_align.peaks and
plot_TL.MAAD.
This function saves a file containing the luminescence data after the pretreatment in the specified folder.
Finally, it also provides an list containing:
De.GC
data.frame: Results obtained with the dose plateau approach and their uncertainties
(De
, De.error
De.DP
data.frame: Results obtained with the growth curve approach and their uncertainties
(De
, De.error
David Strebler, University of Cologne (Germany),
David Strebler
read_BIN2R, Risoe.BINfileData2TLum.BIN.File, mod_extract.TL, mod_update.dType, mod_remove.aliquot, mod_remove.preheat, mod_substract.background, mod_align.peaks, write_R2BIN, TLum.BIN.File2TLum.Analysis and analyse_TL.MAAD.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.