write_RLum2CSV function

Export RLum-objects to CSV

This function exports RLum -objects to CSV-files using the R function utils::write.table . All RLum -objects are supported, but the export is lossy, i.e. the pure numerical values are exported only. Information that cannot be coerced to a data.frame or a matrix are discarded as well as metadata.

write_RLum2CSV(
  object,
  path = NULL,
  prefix = "",
  export = TRUE,
  compact = TRUE,
  ...
)

Arguments

• object: RLum or a list of RLum objects (required ): objects to be written. Can be a data.frame if needed internally.

• path: character (optional): character string naming folder for the output to be written. If nothing is provided path will be set to the working directory. Note: this argument is ignored when export = FALSE.

• prefix: character (with default): optional prefix to name the files. This prefix is valid for all written files

• export: logical (with default): enable/disable the file export. If set to FALSE nothing is written to the file connection, but a list comprising objects of type data.frame and matrix

  is returned instead.

• compact: logical (with default): if TRUE (default) the output will be simpler but less comprehensive, that is not all elements in the objects will be fully broken down. This is in particular useful for writing RLum.Results objects to CSV files, as such objects can be rather complex and not all information are needed in a CSV file or can be meaningfully translated to CSV format.

• ...: further arguments that will be passed to the function utils::write.table . All arguments except the argument file are supported

Returns

The function returns either a CSV-file (or many of them) or for the option export == FALSE a list comprising objects of type data.frame and matrix

Details

However, in combination with the implemented import functions, nearly every supported import data format can be exported to CSV-files, this gives a great deal of freedom in terms of compatibility with other tools.

Input is a list of objects

If the input is a list of objects all explicit function arguments can be provided as list .

Function version

0.2.2

Examples

##transform values to a list (and do not write)
data(ExampleData.BINfileData, envir = environment())
object <- Risoe.BINfileData2RLum.Analysis(CWOSL.SAR.Data)[[1]]
write_RLum2CSV(object, export = FALSE)

## Not run:

##create temporary filepath
##(for usage replace by own path)
temp_file <- tempfile(pattern = "output", fileext = ".csv")

##write CSV-file to working directory
write_RLum2CSV(temp_file)
## End(Not run)

See Also

RLum.Analysis , RLum.Data , RLum.Results , utils::write.table

Author(s)

Sebastian Kreutzer, Geography & Earth Science, Aberystwyth University (United Kingdom) , RLum Developer Team

How to cite

Kreutzer, S., 2025. write_RLum2CSV(): Export RLum-objects to CSV. Function version 0.2.2. 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.1. https://r-lum.github.io/Luminescence/