analyse_TL.MAAD: MAAD protocol for TL dating
In TLdating: Tools for Thermoluminescences Dating

Description Usage Arguments Details Value Author(s) References See Also Examples

Function to estimate the ED in TL dating using the MAAD protocol.
It provides an estimation of the palaeodose (Q) and/or the supralinearity correction (I). The equivalent dose (ED) is estimated by the addition of Q and I.
See details for more information.

analyse_TL.MAAD(object, eval.Tmin, eval.Tmax,
  rejection.criteria = list(testdose.error = 10, paleodose.error = 10),
  fitting.parameters = list(fit.method = "LIN", fit.weighted = FALSE,
  fit.use.slope = FALSE, fit.aDoses.min = 0, fit.aDoses.max = NA, fit.rDoses.min
  = 0, fit.rDoses.max = NA), plotting.parameters = list(plot.Tmin = 0,
  plot.Tmax = NA, no.plot = FALSE))

`object`	`TLum.Analysis` (required): object containing the TL curves used for the ED estimation.
`eval.Tmin`	integer (required): Temperature ( <c2><b0>C) of the lower boundary for the signal integration.
`eval.Tmax`	integer (required): Temperature ( <c2><b0>C) of the upper boundary for the signal integration.
`rejection.criteria`	list (with default): list containing the rejection criteria (in %). 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.

This function estimates the equivalent dose for the thermoluminescence dating with the MAAD protocol. It can provide an estimation of the palaeodose (Q) and the supralinearity correction (I) simultaniously or separately. These are estimated using the growth curve approach (QC) (Aitken, 1985) and the dose plateau approach (DP). Both approaches should provide a similar result. The equivalent dose is estimated by the addition of Q and I
The Lx/Tx matrix is estimated using calc_TL.LxTx.
The average TL curves for each dose step are estimate using calc_TL.MAAD.average.
The plateau test values are estimated using calc_TL.plateau.

Rejection criteria
The rejection criteria are:

testdose.error: numeric: Maximum error accepted on Tx (in %).
paleodose.error: numeric: Maximum error accepted on Lx (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.use.slope: logical: If the slope of the Q growth curve is reused for the supralinearity correction.
fit.aDoses.min: numeric: Lowest additive dose used for the fitting.
fit.aDoses.max: numeric: Highest additive dose used for the fitting.
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.MAAD.fit.Q and calc_TL.MAAD.fit.I.

Plotting parameters
The plotting parameters are:

plot.Tmin: numeric: Lowest temperature plotted.
plot.Tmax: numeric: Highest temperature plotted.
no.plot: logical: If TRUE, the results will not be plotted.

See also plot_TL.MAAD.

The results are plotted using plot_TL.MAAD.

The function also provides a TLum.Results containing:

De.GC: list: Results obtained with the dose plateau approach and their uncertainties (De, De.error, Q, Q.error, I, I.error)
De.DP: list: Results obtained with the growth curve approach and their uncertainties (De, De.error, Q, Q.error, I, I.error)
LnLxTnTx.table: matrix: Lx/Tx values
RC.Status: character: The acceptance result.