calc_OSLLxTxDecomposed: 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
)

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

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.

Function version

0.1.0

How to cite

Mittelstrass, D., 2025. 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., Colombo, M., Steinbuch, L., Boer, A.d., 2025. Luminescence: Comprehensive Luminescence Dating Data Analysis. R package version 1.0.0. https://r-lum.github.io/Luminescence/

Author

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