Luminescence (version 0.7.1)

analyse_SAR.TL: Analyse SAR TL measurements

Description

The function performs a SAR TL analysis on a RLum.Analysis object including growth curve fitting.

Usage

analyse_SAR.TL(object, object.background, signal.integral.min, signal.integral.max, sequence.structure = c("PREHEAT", "SIGNAL", "BACKGROUND"), rejection.criteria = list(recycling.ratio = 10, recuperation.rate = 10), dose.points, log = "", ...)

Arguments

object

RLum.Analysis(required): input object containing data for analysis

object.background

currently not used

signal.integral.min

integer (required): requires the channel number for the lower signal integral bound (e.g. signal.integral.min = 100)

signal.integral.max

integer (required): requires the channel number for the upper signal integral bound (e.g. signal.integral.max = 200)

sequence.structure

vector character (with default): specifies the general sequence structure. Three steps are allowed ( "PREHEAT", "SIGNAL", "BACKGROUND"), in addition a parameter "EXCLUDE". This allows excluding TL curves which are not relevant for the protocol analysis. (Note: None TL are removed by default)

rejection.criteria

list (with default): list containing rejection criteria in percentage for the calculation.

dose.points

numeric (optional): option set dose points manually

log

character (with default): a character string which contains "x" if the x axis is to be logarithmic, "y" if the y axis is to be logarithmic and "xy" or "yx" if both axes are to be logarithmic. See plot.default).

...

further arguments that will be passed to the function plot_GrowthCurve

Value

A plot (optional) and an RLum.Results object is returned containing the following elements: returned containing the following elements:note: the output should be accessed using the function get_RLum

Function version

0.1.5 (2016-12-05 17:06:05)

How to cite

Kreutzer, S. (2017). analyse_SAR.TL(): Analyse SAR TL measurements. Function version 0.1.5. In: Kreutzer, S., Dietze, M., Burow, C., Fuchs, M.C., Schmidt, C., Fischer, M., Friedrich, J. (2017). Luminescence: Comprehensive Luminescence Dating Data Analysis. R package version 0.7.1. https://CRAN.R-project.org/package=Luminescence

Details

This function performs a SAR TL analysis on a set of curves. The SAR procedure in general is given by Murray and Wintle (2000). For the calculation of the Lx/Tx value the function calc_TLLxTxRatio is used. Provided rejection criteria ‘recyling.ratio’: calculated for every repeated regeneration dose point. ‘recuperation.rate’: recuperation rate calculated by comparing the Lx/Tx values of the zero regeneration point with the Ln/Tn value (the Lx/Tx ratio of the natural signal). For methodological background see Aitken and Smith (1988)

References

Aitken, M.J. and Smith, B.W., 1988. Optical dating: recuperation after bleaching. Quaternary Science Reviews 7, 387-393.

Murray, A.S. and Wintle, A.G., 2000. Luminescence dating of quartz using an improved single-aliquot regenerative-dose protocol. Radiation Measurements 32, 57-73.

See Also

calc_TLLxTxRatio, plot_GrowthCurve, RLum.Analysis, RLum.Results get_RLum

Examples

##load data
data(ExampleData.BINfileData, envir = environment())

##transform the values from the first position in a RLum.Analysis object
object <- Risoe.BINfileData2RLum.Analysis(TL.SAR.Data, pos=3)

##perform analysis
analyse_SAR.TL(object,
               signal.integral.min = 210,
               signal.integral.max = 220,
               log = "y",
               fit.method = "EXP OR LIN",
               sequence.structure = c("SIGNAL", "BACKGROUND"))