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. News and updates on 'Luminescence' are also available from the REPLAY website.

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

Alternatively, to install the latest development builds directly from GitHub, run:

if (!require("pak"))
  install.packages("pak")
pak::pkg_install("R-Lum/Luminescence")

Please note that the version on the GitHub master branch is a development version and may change day by day. To install the stable version from CRAN, simply run the following from an R console:

install.packages("Luminescence")

For stable branches please visit the Luminescence package page on CRAN.

Contribute

The R-Luminescence project is based on and evolves from ideas, contributions and constructive criticism of its users. Help us maintain and improve the package by reporting bugs, requesting features, suggesting design improvements or contributing new functions.

Open an issue or write us an e-mail if anything crosses your mind or if you want your new self-written function to be to included in the package.

You are kindly invited to bring forward the package with us!

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 (until 2025), LIAG - Institute for Applied Geophysics, Hannover, DE (from 2026)) 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,557

Version

1.3.0

License

GPL-3

Maintainer

Sebastian Kreutzer

Last Published

July 22nd, 2026

Functions in Luminescence (1.3.0)

ExampleData.SurfaceExposure

Example OSL surface exposure dating data
ExampleData.ScaleGammaDose

Example data for scale_GammaDose()
Luminescence-package

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

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

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

Class "RLum.Results"
RLum-class

Class "RLum"
Risoe.BINfileData-class

Class "Risoe.BINfileData"
RLum.Data-class

Class "RLum.Data"
RLum.Analysis-class

Class "RLum.Analysis"
ExampleData.portableOSL

Example portable OSL curve data for the package Luminescence
RLum.Data.Image-class

Class "RLum.Data.Image"
analyse_Al2O3C_ITC

Al2O3 Irradiation Time Correction Analysis
Risoe.BINfileData2RLum.Analysis

Convert Risoe.BINfileData object to an RLum.Analysis object
analyse_SAR.CWOSL

Analyse SAR CW-OSL Measurements
analyse_FadingMeasurement

Analyse fading measurements and returns the fading rate per decade (g-value)
analyse_baSAR

Bayesian models (baSAR) applied on luminescence data
analyse_IRSAR.RF

Analyse IRSAR RF measurements
analyse_Al2O3C_Measurement

Al2O3:C Passive Dosimeter Measurement Analysis
analyse_SAR.NCF

Compute SAR palaeodoses using natural sensitivity correction (NCF)
analyse_SAR.TL

Analyse SAR TL measurements
analyse_Al2O3C_CrossTalk

Al2O3:C Reader Cross-Talk Analysis
calc_AliquotSize

Estimate the amount of grains on an aliquot
apply_CosmicRayRemoval

Cosmic-ray removal and spectrum smoothing for RLum.Data.Spectrum objects
apply_Crosstalk

Apply crosstalk
apply_EfficiencyCorrection

Apply spectral efficiency correction to RLum.Data.Spectrum objects
calc_AverageDose

Calculate the Average Dose and the dose rate dispersion
calc_CentralDose

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

Channel binning for RLum.Data-class objects
calc_CobbleDoseRate

Calculate dose rate of slices in a spherical cobble
analyse_pIRIRSequence

Analyse post-IR IRSL measurement sequences
analyse_portableOSL

Analyse portable CW-OSL measurements
calc_CommonDose

Apply the (un-)logged common age model after Galbraith et al. (1999) 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_HomogeneityTest

Apply a simple homogeneity test after Galbraith (2003)
calc_FastRatio

Calculate the Fast Ratio for CW-OSL curves
calc_FadingCorr

Fading Correction after Huntley & Lamothe (2001)
calc_FiniteMixture

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

Calculate the cosmic dose rate
calc_FuchsLang2001

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

Modelling Exponential Exposure Distribution
calc_Huntley2006

Apply the Huntley (2006) model
calc_Statistics

Function to calculate statistic measures
calc_MoransI

Calculate Moran's I
calc_MaxDose

Apply the maximum age model to a given De distribution
calc_MinDose

(Un-)logged minimum age model (MAM) after Galbraith et al. (1999)
calc_OSLLxTxDecomposed

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

Calculate Lx/Tx ratio for CW-OSL curves
calc_Lamothe2003

Apply fading correction after Lamothe et al., 2003
calc_ThermalLifetime

Calculates the Thermal Lifetime using the Arrhenius equation
calc_SourceDoseRate

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

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

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

Transform a CW-OSL curve into a pPM-OSL curve via interpolation under parabolic modulation conditions
convert_CW2pLM

Transform a CW-OSL curve into a pLM-OSL curve
calc_gSGC_feldspar

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

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

Transform a CW-OSL curve into a pLM-OSL curve via interpolation under linear modulation conditions
calc_gSGC

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

Transform a CW-OSL curve into a pHM-OSL curve via interpolation under hyperbolic modulation conditions
combine_De_Dr

Combine Dose Rate and Equivalent Dose Distribution
convert_Activity2Concentration

Convert Nuclide Activities to Abundance and Vice Versa
convert_PSL2CSV

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

Converts Single-Grain Data to Multiple-Grain Data
convert_Concentration2DoseRate

Dose-rate conversion function
convert_XSYG2CSV

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

Converting equivalent dose values from seconds (s) to Gray (Gy)
convert_RLum2Risoe.BINfileData

Converts RLum.Analysis and RLum.Data.Curve objects to RLum2Risoe.BINfileData objects
convert_Daybreak2CSV

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

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

Dead-time (linearity) Correction for Photomultiplier tubes (PMT)
convert_PSL2Risoe.BINfileData

Convert portable OSL data to a Risoe.BINfileData object
.as.latex.table

Create LaTeX tables from data.frames and RLum objects
fit_OSLLifeTimes

Fitting and Deconvolution of OSL Lifetime Components
fit_DoseResponseCurve

Fit a dose-response curve for luminescence data (Lx/Tx against dose)
extdata

Collection of External Data
extract_ROI

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

Nonlinear Least Squares Fit for OSL surface exposure data
fit_EmissionSpectra

Luminescence Emission Spectra Deconvolution
fit_LMCurve

Non-linear Least Squares Fit for LM-OSL curves
fit_CWCurve

Non-linear Least Squares Fit for CW-OSL curves -beta version-
extract_IrradiationTimes

Extract Irradiation Times from an XSYG-file or RLum.Analysis object
merge_RLum.Data.Curve

Merge function for RLum.Data.Curve S4 class objects
get_rightAnswer

Function to get the right answer
get_Layout

Collection of layout definitions
fit_ThermalQuenching

Fitting Thermal Quenching Data
melt_RLum

Melt RLum-class objects into a flat data.frame
import_Data

Import Luminescence Data into R
merge_RLum.Data.Spectrum

Merge function for RLum.Data.Spectrum S4 class objects
length_RLum

Length retrieval function for RLum-class objects
get_RLum

General accessor function for RLum-class objects
merge_RLum.Analysis

Merge function for RLum.Analysis S4 class objects
merge_RLum.Results

Merge function for RLum.Results S4-class objects
plot_DRCSummary

Create a Dose-Response Curve Summary Plot
plot_AbanicoPlot

Function to create an Abanico Plot.
plot_DRTResults

Visualise dose recovery test results
merge_RLum

General merge function for RLum-class objects
add_metadata<-

Safe manipulation of object metadata
names_RLum

Name retrieval function for RLum-class objects
normalise_RLum

Normalisation of RLum-class objects
methods_RLum

methods_RLum
merge_Risoe.BINfileData

Merge Risoe.BINfileData objects or Risoe BIN-files
plot_GrowthCurve

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

Plot a histogram with separate error plot
plot_DetPlot

Create De(t) plot
plot_KDE

Plot kernel density estimate with statistics
plot_MoranScatterplot

Moran Scatter Plot: Visualizing Spatial Dependency
plot_RLum.Analysis

Plot function for an RLum.Analysis S4 class object
plot_DoseResponseCurve

Plot a dose-response curve for luminescence data (Lx/Tx against dose)
plot_NRt

Visualise natural/regenerated signal ratios
plot_OSLAgeSummary

Plot Posterior OSL-Age Summary
plot_FilterCombinations

Plot filter combinations along with the (optional) net transmission window
plot_RLum.Data.Curve

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

Plot a disc with its values
plot_ViolinPlot

Create a violin plot
plot_RadialPlot

Function to create a Radial Plot
plot_RLum.Data.Image

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

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

General plot function for RLum S4 class objects
plot_Risoe.BINfileData

Plot Single Luminescence Curves from a Risoe.BINfileData-class object
plot_ROI

Create Regions of Interest (ROI) Graphic
plot_RLum.Results

Plot function for an RLum.Results S4 class object
read_Daybreak2R

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

Import Luminescence Data from Helios Luminescence Reader
read_XSYG2R

Import XSYG files into R
read_PSL2R

Import SUERC portable OSL Reader PSL files into R
read_BINXLOG2R

Import Risø BINX-data from the BINX Log File
read_RF2R

Import RF-files to R
remove_RLum

Strips records from RLum-class objects
read_TIFF2R

Import TIFF Image Data into R
read_SPE2R

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

Import Risø BIN/BINX-files into R
remove_SignalBackground

Remove Signal Background from RLum.Data.Curve Objects
show

Show the structure of RLum-class and Risoe.BINfileData-class objects
report_RLum

Create a HTML-report for (RLum) objects
set_Risoe.BINfileData

General setter function for Risoe.BINfileData objects
sTeve

sTeve - sophisticated tool for efficient data validation and evaluation
replicate_RLum

General replication function for RLum-class objects
set_RLum

General setter function for RLum-class objects
scale_GammaDose

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

Sort data for RLum-class and Risoe.BINfileData-class objects
smooth_RLum

Smoothing of data for RLum-class objects
tune_Data

Tune data for experimental purpose
use_DRAC

Use DRAC to calculate dose rate data
template_DRAC

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

Convenience data visualisation function
write_R2BIN

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

Trim Channels of RLum.Data-class Objects
subset_SingleGrainData

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

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

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

Export RLum-objects to CSV
structure_RLum

General structure function for RLum-class objects
BaseDataSet

Base datasets
ExampleData.CW_OSL_Curve

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

Example data for feldspar fading measurements
ExampleData.CobbleData

Example data for calc_CobbleDoseRate()
ExampleData.BINfileData

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

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

Example Al2O3:C Measurement Data
BaseDataSet.CosmicDoseRate

Base data set for cosmic dose rate calculation
ExampleData.LxTxData

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

Example TR-OSL data
ExampleData

All examples
ExampleData.DeValues

Example De data sets for the package Luminescence
ExampleData.RLum.Data.Image

Example data as RLum.Data.Image objects
ExampleData.RF70Curves

RF70 Example data as RLum.Analysis objects
ExampleData.RLum.Analysis

Example data as RLum.Analysis objects
ExampleData.MortarData

Example equivalent dose data from mortar samples
ExampleData.LxTxOSLData

Example Lx and Tx curve data from an artificial OSL measurement
ExampleData.XSYG

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