R: Calculate Lx/Tx ratio for decomposed CW-OSL signal components

calc_OSLLxTxDecomposed {Luminescence}

R Documentation

Calculate Lx/Tx ratio for decomposed CW-OSL signal components

Description

Calculate Lx/Tx ratios from a given set of decomposed CW-OSL curves decomposed by ⁠[OSLdecomposition::RLum.OSL_decomposition]⁠

Usage

calc_OSLLxTxDecomposed(
  Lx.data,
  Tx.data = NULL,
  OSL.component = 1L,
  sig0 = 0,
  digits = NULL
)

Arguments

`Lx.data`	data.frame (required): Component table created by `⁠[OSLdecomposition::RLum.OSL_decomposition]⁠` and per default located at `object@records[[...]]@info$COMPONENTS`.The value of `⁠$n[OSL.component]⁠` is set as `LnLx`. The value of `⁠$n.error[OSL.component]⁠` is set as `LnLx.error`
`Tx.data`	data.frame (optional): Component table created by `⁠[OSLdecomposition::RLum.OSL_decomposition]⁠` and per default located at `object@records[[...]]@info$COMPONENTS`. The value of `⁠$n[OSL.component]⁠` is set as `TnTx`. The value of `⁠$n.error[OSL.component]⁠` is set as `TnTx.error`
`OSL.component`	integer or character (optional): a single index or a name describing which OSL signal component shall be evaluated. This argument can either be the name of the OSL component assigned by `⁠[OSLdecomposition::RLum.OSL_global_fitting]⁠` or the index of component. Then `'1'` selects the fastest decaying component, `'2'` the second fastest and so on. If not defined, the fastest decaying component is selected.
`sig0`	numeric (with default): allows adding an extra error component to the final `Lx/Tx` error value (e.g., instrumental error).
`digits`	integer (with default): round numbers to the specified digits. If digits is set to `NULL` nothing is rounded.

Value

Returns an S4 object of type RLum.Results.

Slot data contains a list with the following structure:

@data

$LxTx.table (data.frame)
.. $ LnLx
.. $ TnTx
.. $ Net_LnLx
.. $ Net_LnLx.Error
.. $ Net_TnTx
.. $ Net_TnTx.Error
.. $ LxTx
.. $ LxTx.relError
.. $ LxTx.Error

Function version

0.1.0

How to cite

Mittelstrass, D., 2024. calc_OSLLxTxDecomposed(): Calculate Lx/Tx ratio for decomposed CW-OSL signal components. Function version 0.1.0. In: Kreutzer, S., Burow, C., Dietze, M., Fuchs, M.C., Schmidt, C., Fischer, M., Friedrich, J., Mercier, N., Philippe, A., Riedesel, S., Autzen, M., Mittelstrass, D., Gray, H.J., Galharret, J., 2024. Luminescence: Comprehensive Luminescence Dating Data Analysis. R package version 0.9.24. https://CRAN.R-project.org/package=Luminescence

Author(s)

Dirk Mittelstrass , RLum Developer Team

References

Mittelstrass D., Schmidt C., Beyer J., Straessner A., 2019. Automated identification and separation of quartz CW-OSL signal components with R. talk presented at DLED 2019, Bingen, Germany http://luminescence.de/OSLdecomp_talk.pdf