script_TL.SAR: Easy script for the SAR protocol

In dstreble/TLdating: Tools for Thermoluminescence Dating

Description

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.

Usage

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

Arguments

file.name	character (required): Name of the file containing the luminescence data.
eval.Tmin	integer (required): Temperature ( °C) of the lower boundary for the signal integration.
eval.Tmax	integer (required): Temperature (°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.

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.

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

Author(s)

David Strebler, University of Cologne (Germany).

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.SAR.

dstreble/TLdating documentation built on May 15, 2019, 4:50 p.m.