numOSL (version 1.8)

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