Description Usage Arguments Details Value Author(s) See Also
View source: R/script_TL.SAR.R
This function provides and estimation of the ED using the SAR protocol. It only requires the name of the files with the TL curves, the relative error on the measurements and the temperature boundaries for the signal integration. Extra parameters can be provided to improve the ED estimation.
1 2 3 4 5 6 7 8 | script_TL.SAR(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.rDoses.min = 0, fit.rDoses.max = NA),
plotting.parameters = list(plot.Tmin = 0, plot.Tmax = NA, no.plot = FALSE),
rejection.criteria = list(recycling.ratio = 10, recuperation.rate = 10,
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 that 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 the Tx curves as reference for the peak maximum position.
Rejection criteria
The rejection criteria are:
recycling.ratio
numeric: Maximum recycling ratio accepted (in %).
recuperation.rate
numeric: Maximum recuparation rate accepted (in %).
paleodose.error
numeric: Maximum error accepted on the regenative signals (in %).
testdose.error
numeric: Maximum error accepted on the testdose signals (in %).
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.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.SAR.fit.
Plotting parameters
The plotting parameters are:
plot.Tmin
numeric: Lower temperature plotted.
plot.Tmax
numeric: Higher temperature plotted.
no.plot
logical: If TRUE
, the results will not be plotted.
See also plot_TL.SAR.
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.SAR.
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
list: Results obtained with the dose plateau approach and their uncertainties
(De
, De.error
)
De.DP
list: Results obtained with the growth curve approach and their uncertainties
(De
, De.error
)
David Strebler, University of Cologne (Germany).
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.SAR.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.