Luminescence (version 0.8.6)

RLum.Analysis-class: Class "RLum.Analysis"


Object class to represent analysis data for protocol analysis, i.e. all curves, spectra etc. from one measurements. Objects from this class are produced, by e.g. read_XSYG2R, read_Daybreak2R


# S4 method for RLum.Analysis

# S4 method for RLum.Analysis set_RLum(class, originator, .uid, .pid, protocol = NA_character_, records = list(), info = list())

# S4 method for RLum.Analysis get_RLum(object, = NULL, recordType = NULL, curveType = NULL, RLum.type = NULL, protocol = "UNKNOWN", get.index = NULL, drop = TRUE, recursive = TRUE, info.object = NULL, subset = NULL, env = parent.frame(2))

# S4 method for RLum.Analysis structure_RLum(object, fullExtent = FALSE)

# S4 method for RLum.Analysis length_RLum(object)

# S4 method for RLum.Analysis names_RLum(object)

# S4 method for RLum.Analysis smooth_RLum(object, ...)



get_RLum: names_RLum, length_RLum, structure_RLum (required): an object of class '>RLum.Analysis


set_RLum character (required): name of the RLum class to be created


set_RLum character (automatic): contains the name of the calling function (the function that produces this object); can be set manually.


set_RLum character (automatic): sets an unique ID for this object using the internal C++ function create_UID.


set_RLum character (with default): option to provide a parent id for nesting at will.


set_RLum character (optional): sets protocol type for analysis object. Value may be used by subsequent analysis functions.


set_RLum list (required): list of '>RLum.Analysis objects


set_RLum list (optional): a list containing additional info data for the object


Returns an '>RLum.Analysis object.

get_RLum: numeric or logical (optional): IDs of specific records. If of type logical the entire id range is assumed and TRUE and FALSE indicates the selection.


get_RLum: character (optional): record type (e.g., "OSL"). Can be also a vector, for multiple matching, e.g., recordType = c("OSL", "IRSL")


get_RLum: character (optional): curve type (e.g. "predefined" or "measured")


get_RLum: character (optional): RLum object type. Defaults to "RLum.Data.Curve" and "RLum.Data.Spectrum".


get_RLum: logical (optional): return a numeric vector with the index of each element in the RLum.Analysis object.


get_RLum: logical (with default): coerce to the next possible layer (which are RLum.Data-objects), drop = FALSE keeps the original RLum.Analysis


get_RLum: logical (with default): if TRUE (the default) and the result of the 'get_RLum' request is a single object this object will be unlisted, means only the object itself and no list containing exactly one object is returned. Mostly this makes things easier, however, if this method is used within a loop this might be undesired.


get_RLum: character (optional): name of the wanted info element


get_RLum: expression (optional): logical expression indicating elements or rows to keep: missing values are taken as false. This argument takes precedence over all other arguments, meaning they are not considered when subsetting the object.


get_RLum: environment (with default): An environment passed to eval as the enclosure. This argument is only relevant when subsetting the object and should not be used manually.


structure_RLum; logical (with default): extents the returned data.frame to its full extent, i.e. all info elements are part of the return as well. The default value is FALSE as the data frame might become rather big.


further arguments passed to underlying methods




  1. list of '>RLum.Data objects or

  2. Single '>RLum.Data object, if only one object is contained and recursive = FALSE or

  3. '>RLum.Analysis ojects for drop = FALSE


Returns '>data.frame showing the structure.


Returns the number records in this object.


Returns the names of the record types (recordType) in this object.


Same object as input, after smoothing

Methods (by generic)

  • show: Show structure of RLum.Analysis object

  • set_RLum: Construction method for '>RLum.Analysis objects.

  • get_RLum: Accessor method for RLum.Analysis object.

    The slots, recordType, curveType and RLum.type are optional to allow for records limited by their id (list index number), their record type (e.g. recordType = "OSL") or object type.

    Example: curve type (e.g. curveType = "predefined" or curveType ="measured")

    The selection of a specific RLum.type object superimposes the default selection. Currently supported objects are: RLum.Data.Curve and RLum.Data.Spectrum

  • structure_RLum: Method to show the structure of an '>RLum.Analysis object.

  • length_RLum: Returns the length of the object, i.e., number of stored records.

  • names_RLum: Returns the names of the '>RLum.Data objects objects (same as shown with the show method)

  • smooth_RLum: Smoothing of RLum.Data objects contained in this RLum.Analysis object zoo::rollmean or zoo::rollmedian. In particular the internal function .smoothing is used.



Object of class character describing the applied measurement protocol


Object of class list containing objects of class '>RLum.Data

Objects from the Class

Objects can be created by calls of the form set_RLum("RLum.Analysis", ...).

Class version


How to cite

Kreutzer, S. (2018). RLum.Analysis-class(): Class 'RLum.Analysis'. In: Kreutzer, S., Burow, C., Dietze, M., Fuchs, M.C., Schmidt, C., Fischer, M., Friedrich, J. (2018). Luminescence: Comprehensive Luminescence Dating Data Analysis. R package version 0.8.6.

See Also

Risoe.BINfileData2RLum.Analysis, '>Risoe.BINfileData, '>RLum



##set empty object
set_RLum(class = "RLum.Analysis")

###use example data
##load data
data(ExampleData.RLum.Analysis, envir = environment())

##show curves in object

##show only the first object, but by keeping the object
get_RLum(IRSAR.RF.Data, = 1, drop = FALSE)

# }