numOSL (version 2.0)

viewer: BIN file importing

Description

Importing a BIN file into R platform to visualize and extract measurement records.

Usage

viewer(filename)

Arguments

filename

character(required): name of a file (in ".bin" or "binx" format), the user need ensure that the file is available from the current work directory

Value

Return an invisible list of S3 class "binfile" containing the following elements:

records

a list that contains imported data records, each record is a numeric vector of nPoints long with 9 attributes (see above)

tab

a table that summaries the data structure and attributes of imported data records

Details

Function viewer is used for importing data records stored in a BIN file produced by a Risoe reader into the R platform. It visualizes datasets in a manner similar to software Viewer. Two kinds of binary data file are supported: (1) file in ".bin" format with data structure described in Appendix 1 in user mannual (version 3.22b) of the Analyst software; (2) file in ".binx" format with data structure outlined in user manual (February 2013) of the Viewer software. Each data record stored in a BIN file is associated with a number of items (attributes). Only items that facilate record identification and equivalent dose calculation are reserved. Items of this kind may include: (1) position: carousel position of an aliquot; (2) runNumber: run number of measurement; (3) nPoints: number of data points of the current record; (4) low: lower limit on temperature (TL stimulation), time (OSL stimulation), or wavelength; (5) high: upper limit on temperature (TL stimulation), time (OSL stimulation), or wavelength; (6) irrTime: irradiation time; (7) lumtype: luminescence type (includes: tl, osl, irsl, m-ir, m-vis, tol, pulsed, trposl, rir, rbr, user, posl, sgosl, rl, xrf); (8) dataType: data type (includes: natural, n+dose, bleach, bleach+dose, natural(bleach), n+dose(bleach), dose, background); (9) lightSource: light source (includes: none, lamp, ir-diodes/ir-laster, calibraition-led, blue-diodes, white-light, green-laser(single-grain), ir-laser(single-grain)). Note that long strings ir-diodes/ir-laser, green-laser(single-grain), ir-laser(single-grain) are abbreviated as ir-diodes, green-laser(sg), ir-laser(sg), respectively.

References

Both documents (user manuals of Analyst and Viewer) are available in http://www.nutech.dtu.dk/english/Products-and-Services/Dosimetry/Radiation-Measurement-Instruments/TL_OSL_reader/Manuals.

See Also

select

Examples

   ### please ensure that file "foo.bin" is 
   ### available in the current work directory.
   # obj <- viewer("foo.bin")
   # class(obj)
   # obj$tab