scaleSGCN: Natural-dose signal re-scaling

In numOSL: Numeric Routines for Optically Stimulated Luminescence Dating

Natural-dose signal re-scaling

Description

Re-scaling sensitivity-corrected natural-dose signals according to the "global standardised growth curve" (gSGC) method suggested by Li et al. (2015, 2016).

Usage

scaleSGCN(obj_analyseBIN, SGCpars, model, origin, 
          SAR.Cycle, Tn.above.3BG = TRUE, 
          TnBG.ratio.low = NULL, rseTn.up = NULL, 
          FR.low = NULL, use.se = TRUE, outfile = NULL)

Arguments

obj_analyseBIN	list(required): an object of S3 class "analyseBIN" produced by function analyseBINdata or as_analyseBIN
SGCpars	vector(required): optimized parameters of the SGC obtained using function fitGrowth or lsNORM
model	character(required): fitting model used for obtaining SGCpars
origin	logical(required): logical value indicating if established SGC passes the origin
SAR.Cycle	character(required): a two-element character vector containing SAR cycles used for natural-dose signal re-scaling. Example: SAR.Cycle=c("N","R3")
Tn.above.3BG	logical(with default): logical value indicating if aliquot (grain) with Tn below 3 sigma BG should be rejected
TnBG.ratio.low	numeric(optional): lower limit on ratio of initial Tn signal to BG
rseTn.up	numeric(optional): upper limit on relative standard error of Tn in percent
FR.low	numeric(optional): lower limit on fast ratio of Tn
use.se	logical(with default): logical value indicating if standard errors of values should be used during application of rejection criteria
outfile	character(optional): if specified, scaled SGC data related quantities will be written to a CSV file named "outfile" and saved to the current work directory

Details

Sensitivity-corrected natural-dose signals are re-scaled according to Eqn.(10) of Li et al. (2015).

Value

Return an invisible list that contains the following elements:

scale.Ltx	scaled natural-dose signals and associated standard errors
agID	aliquot (grain) ID of scaled natural-dose signals

References

Li B, Roberts RG, Jacobs Z, Li SH, 2015. Potential of establishing a "global standardised growth curve" (gSGC) for optical dating of quartz from sediments. Quaternary Geochronology, 27: 94-104.

Li B, Jacobs Z, Roberts RG, 2016. Investigation of the applicability of standardised growth curves for OSL dating of quartz from Haua Fteah cave, Libya. Quaternary Geochronology, 35: 1-15.

See Also

lsNORM; calSGCED

Examples

 # Not run.
 data(SARdata)
 gSGCpars <- c(137.440874251, 0.007997863, 2.462035263, -0.321536177)
 scaleSGCN(as_analyseBIN(SARdata), SGCpars=gSGCpars, model="gok", 
           origin=FALSE, SAR.Cycle=c("N","R3"))

numOSL documentation built on Sept. 18, 2023, 9:07 a.m.