Luminescence (version 0.3.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), 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

rejection.criteria

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

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

...

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:
• De.values
  data.frame containing De-values and further parameters
• LnLxTnTx.values
  data.frame of all calculated Lx/Tx values including signal, background counts and the dose points.
• rejection.criteria
  data.frame with values that might by used as rejection criteria. NA is produced if no R0 dose point exists.
• note: the output should be accessed using the function get_RLum.Results

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. & Smith, B.W., 1988. Optical dating: recuperation after bleaching. Quaternary Science Reviews, 7, pp. 387-393. Murray, A.S. & Wintle, A.G., 2000. Luminescence dating of quartz using an improved single-aliquot regenerative-dose protocol. Radiation Measurements, 32, pp. 57-73.

See Also

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

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