View source: R/analyse_SAR.TL.R
analyse_SAR.TL | R Documentation |
The function performs a SAR TL analysis on a RLum.Analysis object including growth curve fitting.
analyse_SAR.TL(
object,
object.background,
signal.integral.min,
signal.integral.max,
integral_input = "channel",
sequence.structure = c("PREHEAT", "SIGNAL", "BACKGROUND"),
rejection.criteria = list(recycling.ratio = 10, recuperation.rate = 10),
dose.points,
log = "",
...
)
object |
RLum.Analysis or a list of such objects (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.max |
integer (required):
requires the channel number for the upper signal integral bound
(e.g. |
integral_input |
character (with default):
defines the input for the arguments |
sequence.structure |
vector character (with default):
specifies the general sequence structure. Three steps are allowed
( |
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 |
... |
further arguments that will be passed to the function fit_DoseResponseCurve |
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
[recycling.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)
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 |
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.
0.3.0
THIS IS A BETA VERSION
None TL curves will be removed from the input object without further warning.
Sebastian Kreutzer, Institute of Geography, Heidelberg University (Germany)
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.
calc_TLLxTxRatio, fit_DoseResponseCurve, RLum.Analysis, RLum.Results, get_RLum
##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 = object,
signal.integral.min = 210,
signal.integral.max = 220,
fit.method = "EXP OR LIN",
sequence.structure = c("SIGNAL", "BACKGROUND"))
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.