Learn R Programming

Luminescence

The R package 'Luminescence' by the R-Luminescence Group provides a collection of various R functions for luminescence dating data analysis.

Social media and other resources

Visit our R-Luminescence homepage.

Installation

i. Requirements

  • Windows (32/64bit): Rtools (provided by CRAN)
  • macOS: Xcode (provided by Apple)
  • Linux: gcc often comes pre-installed in most distributions.

ii. Install the package

Install any development versions using our RStudio add-in

The plain R way

To install the stable version from CRAN, simply run the following from an R console:

install.packages("Luminescence")

To install the latest development builds directly from GitHub, run

if(!require("devtools"))
  install.packages("devtools")
devtools::install_github("R-Lum/Luminescence@<wanted branch>")

Contribute

The R luminescence project is based on and evolves from ideas, contributions and constructive criticism of its users. Help us to maintain and develop the package, to find bugs and create new functions as well as a user-friendly design. Try https://github.com/R-Lum/Luminescence/issues or write us an e-mail if anything crosses your mind or if you want your new self-written function to be to implemented. You are kindly invited to bring forward the package with us!

Note

The package comes without any guarantee!

Please further note that this version is a development version and may change day by day. For stable branches please visit the package on CRAN Luminescence.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Funding

  • 2011-2013: The initial version of the package was developed in the framework of the PhD thesis by Sebastian Kreutzer, while he was funded through the DFG programme “Rekonstruktion der Umweltbedingungen des Spätpleistozäns in Mittelsachsen anhand von Löss-Paläobodensequenzen” (GEPRIS id: 46526743)

  • 2014-2018: Cooperation and personal exchange between the developers is gratefully funded by the DFG in the framework of the program “Scientific Networks”. Project title: “RLum.Network: Ein Wissenschaftsnetzwerk zur Analyse von Lumineszenzdaten mit R” (GEPRIS id: 250974974)

  • 05/2014-12/2019: The work of Sebastian Kreutzer as maintainer of the package was supported by LabEx LaScArBx (ANR - n. ANR-10-LABX-52).

  • 01/2020-04/2022: Sebastian Kreutzer as maintainer of the package has received funding from the European Union’s Horizon 2020 research and innovation programme under the Marie Skłodowska-Curie grant agreement No 844457 (CREDit), and could continue maintaining the package.

  • since 03/2023: Sebastian Kreutzer as maintainer of the package receives funding from the DFG Heisenberg programme No 505822867.

  • since 08/2024 the future and sustainable development of 'Luminescence' towards better reproducibility and usability is supported through the DFG programme “REPLAY: REProducible Luminescence Data AnalYses” No 528704761 led by Dr Sebastian Kreutzer (PI at Heidelberg University, DE) and Dr Thomas Kolb (PI at Justus-Liebig-University Giessen, DE).

  • All other authors gratefully received additional funding from various public funding bodies.

Related projects

Copy Link

Version

Install

install.packages('Luminescence')

Monthly Downloads

1,412

Version

0.9.25

License

GPL-3

Last Published

September 12th, 2024

Functions in Luminescence (0.9.25)

ExampleData.CW_OSL_Curve

Example CW-OSL curve data for the package Luminescence
ExampleData.ScaleGammaDose

Example data for scale_GammaDose()
RLum-class

Class "RLum"
ExampleData.SurfaceExposure

Example OSL surface exposure dating data
Luminescence-package

Comprehensive Luminescence Dating Data Analysis
r-luminescence.org
RLum.Analysis-class

Class "RLum.Analysis"
ExampleData.XSYG

Example data for a SAR OSL measurement and a TL spectrum using a lexsyg reader
ExampleData.TR_OSL

Example TR-OSL data
PSL2Risoe.BINfileData

Convert portable OSL data to a Risoe.BINfileData object
GitHub-API

GitHub API
ExampleData.portableOSL

Example portable OSL curve data for the package Luminescence
ExampleData.LxTxOSLData

Example Lx and Tx curve data from an artificial OSL measurement
RLum.Data.Image-class

Class "RLum.Data.Image"
Risoe.BINfileData2RLum.Analysis

Convert Risoe.BINfileData object to an RLum.Analysis object
RLum.Results-class

Class "RLum.Results"
Second2Gray

Converting equivalent dose values from seconds (s) to Gray (Gy)
analyse_Al2O3C_CrossTalk

Al2O3:C Reader Cross Talk Analysis
analyse_Al2O3C_ITC

Al2O3 Irradiation Time Correction Analysis
RLum.Data-class

Class "RLum.Data"
RLum.Data.Curve-class

Class "RLum.Data.Curve"
Risoe.BINfileData-class

Class "Risoe.BINfileData"
RLum.Data.Spectrum-class

Class "RLum.Data.Spectrum"
analyse_SAR.TL

Analyse SAR TL measurements
analyse_IRSAR.RF

Analyse IRSAR RF measurements
analyse_FadingMeasurement

Analyse fading measurements and returns the fading rate per decade (g-value)
analyse_SAR.CWOSL

Analyse SAR CW-OSL measurements
analyse_pIRIRSequence

Analyse post-IR IRSL measurement sequences
analyse_portableOSL

Analyse portable CW-OSL measurements
apply_EfficiencyCorrection

Function to apply spectral efficiency correction to RLum.Data.Spectrum S4 class objects
analyse_Al2O3C_Measurement

Al2O3:C Passive Dosimeter Measurement Analysis
analyse_baSAR

Bayesian models (baSAR) applied on luminescence data
apply_CosmicRayRemoval

Function to remove cosmic rays from an RLum.Data.Spectrum S4 class object
calc_FastRatio

Calculate the Fast Ratio for CW-OSL curves
as

as() - RLum-object coercion
calc_FadingCorr

Fading Correction after Huntley & Lamothe (2001)
calc_CommonDose

Apply the (un-)logged common age model after Galbraith et al. (1999) to a given De distribution
calc_CentralDose

Apply the central age model (CAM) after Galbraith et al. (1999) to a given De distribution
calc_AliquotSize

Estimate the amount of grains on an aliquot
bin_RLum.Data

Channel binning - method dispatcher
calc_AverageDose

Calculate the Average Dose and the dose rate dispersion
calc_CobbleDoseRate

Calculate dose rate of slices in a spherical cobble
calc_CosmicDoseRate

Calculate the cosmic dose rate
calc_FiniteMixture

Apply the finite mixture model (FMM) after Galbraith (2005) to a given De distribution
calc_IEU

Apply the internal-external-uncertainty (IEU) model after Thomsen et al. (2007) to a given De distribution
calc_Kars2008

Apply the Kars et al. (2008) model (deprecated)
calc_HomogeneityTest

Apply a simple homogeneity test after Galbraith (2003)
calc_MinDose

Apply the (un-)logged minimum age model (MAM) after Galbraith et al. (1999) to a given De distribution
calc_FuchsLang2001

Apply the model after Fuchs & Lang (2001) to a given De distribution.
calc_Lamothe2003

Apply fading correction after Lamothe et al., 2003
calc_Huntley2006

Apply the Huntley (2006) model
calc_MaxDose

Apply the maximum age model to a given De distribution
calc_OSLLxTxDecomposed

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

Calculates the Thermal Lifetime using the Arrhenius equation
calc_WodaFuchs2008

Obtain the equivalent dose using the approach by Woda and Fuchs 2008
calc_OSLLxTxRatio

Calculate Lx/Tx ratio for CW-OSL curves
calc_gSGC

Calculate De value based on the gSGC by Li et al., 2015
calc_SourceDoseRate

Calculation of the source dose rate via the date of measurement
calc_Statistics

Function to calculate statistic measures
convert_Activity2Concentration

Convert Nuclide Activities to Abundance and Vice Versa
combine_De_Dr

Combine Dose Rate and Equivalent Dose Distribution
calc_TLLxTxRatio

Calculate the Lx/Tx ratio for a given set of TL curves -beta version-
calc_gSGC_feldspar

Calculate Global Standardised Growth Curve (gSGC) for Feldspar MET-pIRIR
convert_Daybreak2CSV

Export measurement data produced by a Daybreak luminescence reader to CSV-files
convert_BIN2CSV

Export Risoe BIN-file(s) to CSV-files
convert_SG2MG

Converts Single-Grain Data to Multiple-Grain Data
convert_Wavelength2Energy

Emission Spectra Conversion from Wavelength to Energy Scales (Jacobian Conversion)
extdata

Collection of External Data
convert_Concentration2DoseRate

Dose-rate conversion function
extract_IrradiationTimes

Extract Irradiation Times from an XSYG-file
convert_RLum2Risoe.BINfileData

Converts RLum.Analysis-objects and RLum.Data.Curve-objects to RLum2Risoe.BINfileData-objects
convert_PSL2CSV

Export PSL-file(s) to CSV-files
convert_XSYG2CSV

Export XSYG-file(s) to CSV-files
fit_EmissionSpectra

Luminescence Emission Spectra Deconvolution
fit_OSLLifeTimes

Fitting and Deconvolution of OSL Lifetime Components
get_Quote

Function to return essential quotes
fit_ThermalQuenching

Fitting Thermal Quenching Data
extract_ROI

Extract Pixel Values through Circular Region-of-Interests (ROI) from an Image
fit_CWCurve

Nonlinear Least Squares Fit for CW-OSL curves -beta version-
fit_LMCurve

Nonlinear Least Squares Fit for LM-OSL curves
get_Layout

Collection of layout definitions
get_RLum

General accessors function for RLum S4 class objects
fit_SurfaceExposure

Nonlinear Least Squares Fit for OSL surface exposure data
merge_RLum.Results

Merge function for RLum.Results S4-class objects
length_RLum

General accessor function for RLum S4 class objects
install_DevelopmentVersion

Attempts to install the development version of the 'Luminescence' package
merge_RLum

General merge function for RLum S4 class objects
merge_RLum.Data.Curve

Merge function for RLum.Data.Curve S4 class objects
merge_RLum.Analysis

Merge function for RLum.Analysis S4 class objects
merge_Risoe.BINfileData

Merge Risoe.BINfileData objects or Risoe BIN-files
import_Data

Import Luminescence Data into R
get_rightAnswer

Function to get the right answer
get_Risoe.BINfileData

General accessor function for RLum S4 class objects
plot_FilterCombinations

Plot filter combinations along with the (optional) net transmission window
plot_DRCSummary

Create a Dose-Response Curve Summary Plot
plot_GrowthCurve

Fit and plot a dose-response curve for luminescence data (Lx/Tx against dose)
plot_AbanicoPlot

Function to create an Abanico Plot.
plot_KDE

Plot kernel density estimate with statistics
names_RLum

S4-names function for RLum S4 class objects
methods_RLum

methods_RLum
plot_DRTResults

Visualise dose recovery test results
plot_DetPlot

Create De(t) plot
plot_Histogram

Plot a histogram with separate error plot
plot_RLum.Data.Image

Plot function for an RLum.Data.Image S4 class object
plot_NRt

Visualise natural/regenerated signal ratios
plot_RLum.Analysis

Plot function for an RLum.Analysis S4 class object
plot_RadialPlot

Function to create a Radial Plot
plot_OSLAgeSummary

Plot Posterior OSL-Age Summary
plot_RLum.Data.Curve

Plot function for an RLum.Data.Curve S4 class object
plot_ROI

Create Regions of Interest (ROI) Graphic
plot_RLum

General plot function for RLum S4 class objects
plot_RLum.Results

Plot function for an RLum.Results S4 class object
plot_RLum.Data.Spectrum

Plot function for an RLum.Data.Spectrum S4 class object
read_BIN2R

Import Risø BIN/BINX-files into R
read_RF2R

Import RF-files to R
plot_ViolinPlot

Create a violin plot
plot_Risoe.BINfileData

Plot single luminescence curves from a BIN file object
read_SPE2R

Import Princeton Instruments (TM) SPE-file into R
read_XSYG2R

Import XSYG files to R
sTeve

sTeve - sophisticated tool for efficient data validation and evaluation
scale_GammaDose

Calculate the gamma dose deposited within a sample taking layer-to-layer variations in radioactivity into account (according to Aitken, 1985)
read_TIFF2R

Import TIFF Image Data into R
template_DRAC

Create a DRAC input data template (v1.2)
smooth_RLum

Smoothing of data
subset_SingleGrainData

Simple Subsetting of Single Grain Data from Risø BIN/BINX files
tune_Data

Tune data for experimental purpose
read_HeliosOSL2R

Import Luminescence Data from Helios Luminescence Reader
trim_RLum.Data

Trim Channels of RLum.Data-class Objects
read_Daybreak2R

Import measurement data produced by a Daybreak TL/OSL reader into R
read_PSL2R

Import PSL files to R
verify_SingleGrainData

Verify single grain data sets and check for invalid grains, i.e. zero-light level grains
structure_RLum

General structure function for RLum S4 class objects
write_R2TIFF

Export RLum.Data.Image and RLum.Data.Spectrum objects to TIFF Images
use_DRAC

Use DRAC to calculate dose rate data
report_RLum

Create a HTML-report for (RLum) objects
replicate_RLum

General replication function for RLum S4 class objects
set_Risoe.BINfileData

General accessor function for RLum S4 class objects
set_RLum

General set function for RLum S4 class objects
write_RLum2CSV

Export RLum-objects to CSV
write_R2BIN

Export Risoe.BINfileData into Risø BIN/BINX-file
CW2pLM

Transform a CW-OSL curve into a pLM-OSL curve
BaseDataSet.CosmicDoseRate

Base data set for cosmic dose rate calculation
CW2pLMi

Transform a CW-OSL curve into a pLM-OSL curve via interpolation under linear modulation conditions
BaseDataSet.FractionalGammaDose

Base data set of fractional gamma-dose values
CW2pHMi

Transform a CW-OSL curve into a pHM-OSL curve via interpolation under hyperbolic modulation conditions
ExampleData.Al2O3C

Example Al2O3:C Measurement Data
Analyse_SAR.OSLdata

Analyse SAR CW-OSL measurements.
BaseDataSet.GrainSizeAttenuation

Base dataset for grain size attenuation data by Guérin et al. (2012)
BaseDataSet.ConversionFactors

Base data set of dose-rate conversion factors
ExampleData.LxTxData

Example Lx/Tx data from CW-OSL SAR measurement
ExampleData.RLum.Analysis

Example data as RLum.Analysis objects
ExampleData.CobbleData

Example data for calc_CobbleDoseRate()
ExampleData.BINfileData

Example data from a SAR OSL and SAR TL measurement for the package Luminescence
ExampleData.DeValues

Example De data sets for the package Luminescence
CW2pPMi

Transform a CW-OSL curve into a pPM-OSL curve via interpolation under parabolic modulation conditions
ExampleData.FittingLM

Example data for fit_LMCurve() in the package Luminescence
ExampleData.Fading

Example data for feldspar fading measurements
ExampleData.RLum.Data.Image

Example data as RLum.Data.Image objects