loadBINdata {numOSL}

BIN file loading (importing)

Description

Loading (importing) a BIN file into the R platform.

Usage

loadBINdata(filename, view = TRUE)

Arguments

filename

character(required): name(s) of file(s) (with file extension ".BIN", ".bin", "BINX", or "binx"), the file(s) must be available from the current working directory. Example: filename=c("foo1.bin","foo2.binx")

view

logical(optional): logical value indicating if the loaded data should be visualized in a Summary Table

Details

Function loadBINdata is used for loading BIN (BINX) files into the R platform. Five versions of binary files (V3, V4, V6, V7, and V8) are loadable. It can load a single BIN (BINX) file or a number of files into R simultaneously.
Items reserved during the loading process include:
(1) Position: Carousel position;

(2) Grain: Grain number;

(3) Run: Run number;

(4) Set: Set number;

(5) DType: Data type, includes: Natural, N+dose, bleach, Bleach+dose,
Natural(Bleach), N+dose(Bleach), Dose, Background;

(6) IRRTime: Irradiation time;

(7) NPoints: number of data points;

(8) LType: Luminescence type, includes: TL, OSL, IRSL, M-IR, M-VIS,
TOL, TRPOSL, RIR, RBR, USER, POSL, SGOSL, RL, XRF;

(9) Low: Low (temperature, time, wavelength);

(10) High: High (temperature, time, wavelength);

(11) Rate: Rate (temperature, time, wavelength);

(12) Temperature: Sample temperature;

(13) Delay: TOL "delay" channels;

(14) On: TOL "on" channels;

(15) Off: TOL "off" channels;

(16) LightSource: Light source, includes: None, Lamp, IRDiodes,
CalibraitionLED, BlueDiodes, WhiteLight, GreenLaser, IRLaser;

(17) AnTemp: Annealing temperature;

(18) TimeSinceIrr: Time since irradiation;

(19) Time: Data collection time;

(20) Date: Data collection date.

Value

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

records

a list containing loaded data records

tab

a table (data.frame) summarizing items of loaded data records

Note

We would like to appreciate Dr Lei Gao who prompts us to write this function and provides measured data sets to test this procedure.

References

Duller GAT, 2016. Analyst (v4.31.9), User Mannual.

See Also

pickBINdata; analyseBINdata; BIN

Examples

   ### Not run.
   ### Ensure that file "foo.bin" is available 
   ### from the current working directory.
   # obj_loadBIN <- loadBINdata("foo.bin", view=TRUE)
   # class(obj_loadBIN)
   # obj_loadBIN$records