Learn R Programming

⚠️There's a newer version (1.0.1) of this package.Take me there.

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

2,140

Version

1.0.0

License

GPL-3

Maintainer

Sebastian Kreutzer

Last Published

February 21st, 2025

Functions in Luminescence (1.0.0)

ExampleData.ScaleGammaDose

Example data for scale_GammaDose()
ExampleData.DeValues

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

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

Example OSL surface exposure dating data
ExampleData.TR_OSL

Example TR-OSL data
BaseDataSet.FractionalGammaDose

Base data set of fractional gamma-dose values
ExampleData.Fading

Example data for feldspar fading measurements
ExampleData.FittingLM

Example data for fit_LMCurve() in the package Luminescence
BaseDataSet.CosmicDoseRate

Base data set for cosmic dose rate calculation
ExampleData.XSYG

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

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

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

Example equivalent dose data from mortar samples
ExampleData.LxTxOSLData

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

Example data as RLum.Analysis objects
PSL2Risoe.BINfileData

Convert portable OSL data to a Risoe.BINfileData object
RLum.Analysis-class

Class "RLum.Analysis"
RLum.Data-class

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

Class "RLum.Data.Curve"
GitHub-API

GitHub API
RLum.Data.Image-class

Class "RLum.Data.Image"
RLum-class

Class "RLum"
Luminescence-package

Comprehensive Luminescence Dating Data Analysis
r-luminescence.org
Second2Gray

Converting equivalent dose values from seconds (s) to Gray (Gy)
Risoe.BINfileData-class

Class "Risoe.BINfileData"
analyse_FadingMeasurement

Analyse fading measurements and returns the fading rate per decade (g-value)
analyse_IRSAR.RF

Analyse IRSAR RF measurements
analyse_Al2O3C_CrossTalk

Al2O3:C Reader Cross Talk Analysis
analyse_Al2O3C_ITC

Al2O3 Irradiation Time Correction Analysis
Risoe.BINfileData2RLum.Analysis

Convert Risoe.BINfileData object to an RLum.Analysis object
analyse_Al2O3C_Measurement

Al2O3:C Passive Dosimeter Measurement Analysis
RLum.Data.Spectrum-class

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

Class "RLum.Results"
apply_Crosstalk

Apply crosstalk
analyse_baSAR

Bayesian models (baSAR) applied on luminescence data
analyse_pIRIRSequence

Analyse post-IR IRSL measurement sequences
apply_EfficiencyCorrection

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

as() - RLum-object coercion
bin_RLum.Data

Channel binning for RLum.Data S4 class objects.
analyse_portableOSL

Analyse portable CW-OSL measurements
analyse_SAR.CWOSL

Analyse SAR CW-OSL measurements
analyse_SAR.TL

Analyse SAR TL measurements
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
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
calc_FiniteMixture

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

Calculate the Average Dose and the dose rate dispersion
calc_CobbleDoseRate

Calculate dose rate of slices in a spherical cobble
calc_CommonDose

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

Modelling Exponential Exposure Distribution
calc_CosmicDoseRate

Calculate the cosmic dose rate
calc_FadingCorr

Fading Correction after Huntley & Lamothe (2001)
calc_OSLLxTxDecomposed

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

Apply the Huntley (2006) model
calc_MaxDose

Apply the maximum age model to a given De distribution
calc_Lamothe2003

Apply fading correction after Lamothe et al., 2003
calc_OSLLxTxRatio

Calculate Lx/Tx ratio for CW-OSL curves
calc_IEU

Apply the internal-external-uncertainty (IEU) model after Thomsen et al. (2007) to a given De distribution
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_HomogeneityTest

Apply a simple homogeneity test after Galbraith (2003)
calc_SourceDoseRate

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

Function to calculate statistic measures
calc_TLLxTxRatio

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

Calculate Moran's I
calc_ThermalLifetime

Calculates the Thermal Lifetime using the Arrhenius equation
calc_WodaFuchs2008

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

Convert Nuclide Activities to Abundance and Vice Versa
calc_gSGC

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

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

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

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

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

Combine Dose Rate and Equivalent Dose Distribution
convert_Concentration2DoseRate

Dose-rate conversion function
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_CW2pLMi

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

Converts Single-Grain Data to Multiple-Grain Data
convert_XSYG2CSV

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

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

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

Nonlinear Least Squares Fit for CW-OSL curves -beta version-
convert_PSL2Risoe.BINfileData

Convert portable OSL data to a Risoe.BINfileData object
fit_EmissionSpectra

Luminescence Emission Spectra Deconvolution
convert_Second2Gray

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

Collection of External Data
get_Quote

Function to return essential quotes
fit_LMCurve

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

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

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

General accessor function for RLum S4 class objects
fit_OSLLifeTimes

Fitting and Deconvolution of OSL Lifetime Components
get_Risoe.BINfileData

General accessor function for Risoe.BINfileData objects
length_RLum

Length retrieval function for RLum S4 class objects
import_Data

Import Luminescence Data into R
get_rightAnswer

Function to get the right answer
install_DevelopmentVersion

Attempts to install the development version of the 'Luminescence' package
add_metadata<-

Safe manipulation of object metadata
merge_RLum.Results

Merge function for RLum.Results S4-class objects
extract_ROI

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

methods_RLum
extract_IrradiationTimes

Extract Irradiation Times from an XSYG-file
melt_RLum

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

Plot a histogram with separate error plot
fit_ThermalQuenching

Fitting Thermal Quenching Data
merge_Risoe.BINfileData

Merge Risoe.BINfileData objects or Risoe BIN-files
plot_KDE

Plot kernel density estimate with statistics
plot_DetPlot

Create De(t) plot
plot_DoseResponseCurve

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

Collection of layout definitions
fit_SurfaceExposure

Nonlinear Least Squares Fit for OSL surface exposure data
plot_RLum.Data.Curve

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

Plot Posterior OSL-Age Summary
merge_RLum.Analysis

Merge function for RLum.Analysis S4 class objects
plot_FilterCombinations

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

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

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

Plot function for an RLum.Data.Spectrum S4 class object
merge_RLum.Data.Curve

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

Moran Scatter Plot: Visualizing Spatial Dependency
names_RLum

Name retrieval function for RLum S4 class objects
plot_AbanicoPlot

Function to create an Abanico Plot.
plot_NRt

Visualise natural/regenerated signal ratios
plot_RLum.Data.Image

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

Plot function for an RLum.Results S4 class object
plot_ROI

Create Regions of Interest (ROI) Graphic
plot_RLum

General plot function for RLum S4 class objects
read_PSL2R

Import PSL files to R
read_HeliosOSL2R

Import Luminescence Data from Helios Luminescence Reader
set_RLum

General setter function for RLum S4 class objects
read_BIN2R

Import Risø BIN/BINX-files into R
plot_SingleGrainDisc

Plot a disc with its values
plot_ViolinPlot

Create a violin plot
set_Risoe.BINfileData

General setter function for Risoe.BINfileData objects
template_DRAC

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

Import TIFF Image Data into R
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_RF2R

Import RF-files to R
read_SPE2R

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

Function to create a Radial Plot
smooth_RLum

Smoothing of data for RLum S4-class objects
plot_Risoe.BINfileData

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

Sort data for RLum S4-class objects
tune_Data

Tune data for experimental purpose
read_XSYG2R

Import XSYG files to R
use_DRAC

Use DRAC to calculate dose rate data
verify_SingleGrainData

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

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

General merge function for RLum S4 class objects
plot_DRCSummary

Create a Dose-Response Curve Summary Plot
plot_DRTResults

Visualise dose recovery test results
sTeve

sTeve - sophisticated tool for efficient data validation and evaluation
structure_RLum

General structure function for RLum S4 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)
view

Convenience data visualisation function
write_R2BIN

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

Export RLum-objects to CSV
write_R2TIFF

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

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

Create a HTML-report for (RLum) objects
replicate_RLum

General replication function for RLum S4 class objects
ExampleData.BINfileData

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

Example CW-OSL curve data for the package Luminescence
BaseDataSet.ConversionFactors

Base data set of dose-rate conversion factors
BaseDataSet.GrainSizeAttenuation

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

Analyse SAR CW-OSL measurements (deprecated)
ExampleData.Al2O3C

Example Al2O3:C Measurement Data
ExampleData.CobbleData

Example data for calc_CobbleDoseRate()