BIN file records selection

Description

Extracting data records according to certain criteria.

Usage

1
2
3
select(obj, position = NULL, runNumber = NULL, nPoints = NULL, 
       low = NULL, high = NULL, irrTime = NULL, lumType = NULL, 
       dataType = NULL, lightSource = NULL)

Arguments

obj

list(required): an object of S3 class "binfile", which is produced by function viewer

position

vector(optional): carousel position(s)

runNumber

vector(optional): run number(s)

nPoints

vector(optional): number(s) of points of records

low

double(optional): lower limit on temperature, time, or wavelength

high

double(optional): upper limit on temperature, time, or wavelength

irrTime

vector(optional): irradiation time(s)

lumType

character(optional): luminescence type(s), see viewer for available luminescence types

dataType

character(optional): data type(s), see viewer for available data types

lightSource

character(optional): light source(s), see viewer for available light sources

Details

Function select is used for extracting records that satisfy a number of specified criteria (attributes) from an object of S3 class "binfile". Extracted equal-length records are stored in a matrix column by column and can be used in further analysis.

Value

Return a list containing the following elements:

records

a matrix (if records are of equal-length) or a list (if records have different lengths) that contains selected data records

tab

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

See Also

pickSARdata; pickSARED; viewer

Examples

1
2
3
   # Do not run.
   # obj <- viewer("foo.bin")
   # select(obj, position=2, lumType="osl")