Luminescence (version 0.3.4)

analyse_SAR.CWOSL: Analyse SAR CW-OSL measurements

Description

The function performs a SAR CW-OSL analysis on a RLum.Analysis object including growth curve fitting.

Usage

analyse_SAR.CWOSL(object, signal.integral.min, signal.integral.max, 
    background.integral.min, background.integral.max, rejection.criteria = list(
      recycling.ratio = 10, 
      recuperation.rate = 10, palaeodose.error = 10), dose.points, 
    log = "", output.plot = TRUE, output.plot.single = FALSE, 
    ...)

Arguments

object

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

signal.integral.min

integer (required): lower bound of the signal integral

signal.integral.max

code{integer} (required): upper bound of the signal integral

background.integral.min

integer (required): lower bound of the background integral

background.integral.max

integer (required): upper bound of the background integral

rejection.criteria

dose.points

numeric (optional): a numeric vector containg the dose points values Using this argument overwrites dose point values in the signal curves.

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

output.plot

logical (with default): enables or disables plot output.

output.plot.single

logical (with default): single plot output (TRUE/FALSE) to allow for plotting the results in single plot windows. Requires output.plot = TRUE.

...

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, De-error 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.
• The output should be accessed using the function get_RLum.Results

Function version

0.3.4 (2014-05-13 15:18:33)

Details

The function performs an analysis for a standard SAR protocol measurements introduced by Murray and Wintle (2000) with CW-OSL curves. For the calculation of the Lx/Tx value the function calc_OSLLxTxRatio 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. Duller, G., 2003. Distinguishing quartz and feldspar in single grain luminescence measurements. Radiation Measurements, 37 (2), pp. 161-165. 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_OSLLxTxRatio, plot_GrowthCurve, RLum.Analysis, RLum.Results get_RLum.Results

Examples

##load data
##ExampleData.BINfileData contains two BINfileData objects 
##CWOSL.SAR.Data and TL.SAR.Data
data(ExampleData.BINfileData, envir = environment())

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

##perform SAR analysis
analyse_SAR.CWOSL(object, 
                  signal.integral.min = 1,
                  signal.integral.max = 2,
                  background.integral.min = 900,
                  background.integral.max = 1000,
                  log = "x",
                  fit.method = "EXP")