script_TL.MAAD: Script for the MAAD protocol

In TLdating: Tools for Thermoluminescences Dating

Description

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.

Usage

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))

Arguments

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.

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.

Value

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

Author(s)

David Strebler, University of Cologne (Germany),
David Strebler

See Also

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.

TLdating documentation built on May 2, 2019, 9:26 a.m.