numOSL (version 2.8)

loadBINdata: BIN file loading (importing)

Description

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

Usage

loadBINdata(filename, view = TRUE)

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

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.

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