Learn R Programming

Luminescence (version 0.7.1)

read_BIN2R: Import Risoe BIN-file into R

Description

Import a *.bin or a *.binx file produced by a Risoe DA15 and DA20 TL/OSL reader into R.

Usage

read_BIN2R(file, show.raw.values = FALSE, position = NULL, n.records = NULL, zero_data.rm = TRUE, duplicated.rm = FALSE, fastForward = FALSE, show.record.number = FALSE, txtProgressBar = TRUE, forced.VersionNumber = NULL, ignore.RECTYPE = FALSE, pattern = NULL, verbose = TRUE, ...)

Arguments

file
character or list (required): path and file name of the BIN/BINX file. If input is a list it should comprise only characters representing each valid path and BIN/BINX-file names. Alternatively the input character can be just a directory (path), in this case the the function tries to detect and import all BIN/BINX files found in the directory.
show.raw.values
logical (with default): shows raw values from BIN file for LTYPE, DTYPE and LIGHTSOURCE without translation in characters. Can be provided as list if file is a list.
position
numeric (optional): imports only the selected position. Note: the import performance will not benefit by any selection made here. Can be provided as list if file is a list.
n.records
raw (optional): limits the number of imported records. Can be used in combination with show.record.number for debugging purposes, e.g. corrupt BIN-files. Can be provided as list if file is a list.
zero_data.rm
logical (with default): remove erroneous data with no count values. As such data are usally not needed for the subsequent data analysis they will be removed by default. Can be provided as list if file is a list.
duplicated.rm
logical (with default): remove duplicated entries if TRUE. This may happen due to an erroneous produced BIN/BINX-file. This option compares only predeccessor and successor. Can be provided as list if file is a list.
fastForward
logical (with default): if TRUE for a more efficient data processing only a list of RLum.Analysis objects is returned instead of a Risoe.BINfileData-class object. Can be provided as list if file is a list.
show.record.number
logical (with default): shows record number of the imported record, for debugging usage only. Can be provided as list if file is a list.
txtProgressBar
logical (with default): enables or disables txtProgressBar.
forced.VersionNumber
integer (optional): allows to cheat the version number check in the function by own values for cases where the BIN-file version is not supported. Can be provided as list if file is a list. Note: The usage is at own risk, only supported BIN-file versions have been tested.
ignore.RECTYPE
logical (with default): this argument allows to ignore values in the byte 'REGTYPE' (BIN-file version 08), in case there are not documented or faulty set. If set all records are treated like records of 'REGYPE' 0 or 1.
pattern
character (optional): argument that is used if only a path is provided. The argument will than be passed to the function list.files used internally to construct a list of wanted files
verbose
logical (with default): enables or disables verbose mode
...
further arguments that will be passed to the function Risoe.BINfileData2RLum.Analysis. Please note that any matching argument automatically sets fastForward = TRUE

Value

Returns an S4 Risoe.BINfileData-class object containing two slots:If fastForward = TRUE a list of RLum.Analysis object is returned. The internal coercing is done using the function Risoe.BINfileData2RLum.Analysis

Function version

0.15.2 (2017-01-24 21:10:47)

How to cite

Kreutzer, S., Fuchs, M.C., Fuchs, M. (2017). read_BIN2R(): Import Risoe BIN-file into R. Function version 0.15.2. In: Kreutzer, S., Dietze, M., Burow, C., Fuchs, M.C., Schmidt, C., Fischer, M., Friedrich, J. (2017). Luminescence: Comprehensive Luminescence Dating Data Analysis. R package version 0.7.1. https://CRAN.R-project.org/package=Luminescence

Details

The binary data file is parsed byte by byte following the data structure published in the Appendices of the Analyst manual p. 42. For the general BIN-file structure, the reader is referred to the Risoe website: http://www.nutech.dtu.dk/

References

DTU Nutech, 2016. The Squence Editor, Users Manual, February, 2016. http://www.nutech.dtu.dk/english/Products-and-Services/Dosimetry/Radiation-Measurement-Instruments/TL_OSL_reader/Manuals

See Also

write_R2BIN, Risoe.BINfileData, readBin, merge_Risoe.BINfileData, RLum.Analysis txtProgressBar, list.files

Examples

Run this code


##(1) import Risoe BIN-file to R (uncomment for usage)

#FILE <- file.choose()
#temp <- read_BIN2R(FILE)
#temp

Run the code above in your browser using DataLab