plot_BINfileData: Plot single luminescence curves from a BIN file object.

Description

Plot single luminescence curves from an object returned by the readBIN2R function.

Usage

plot_BINfileData(BINfileData, position, run, set,
                 sorter = "POSITION", 
                 ltype = c("IRSL","OSL","TL","RIR","RBR"),
                 curve.transformation,    
                 
                 dose_rate,
                 temp.lab = "deg. C", 
                 cex.global = 1)

Arguments

BINfileData

Risoe.BINfileData-class (required): requires an S4 object returned by the readBIN2R function.

position

vector (optional): option to limit the plotted curves by position (e.g. position = 1, position = c(1,3,5)).

run

vector (optional): option to limit the plotted curves by run (e.g. run = 1, set = c(1,3,5)).

set

vector (optional): option to limit the plotted curves by set (e.g. run = 1, set = c(1,3,5)).

sorter

character (with default): the plot output can be ordered by "POSITION","SET" or "RUN". POSITION, SET and RUN are options defined in the Risoe Sequence Editor.

ltype

character (with default): option to limit the plotted curves by the type of luminescence stimulation. Allowed values: "IRSL","OSL","TL","RIR" and "RBR". All type of curves are plotted by default.

curve.transformation

character (optional): allows to transform CW-OSL and CW-IRSL curves to be transformed to pseudo-LM curves via transformation functions. Allowed values are: CW2pLM, CW2pLMi, CW2

dose_rate

numeric (optional): dose rate of the irradition source at the measurement date. If set, the given irradiation dose will be shown in Gy. See details.

temp.lab

character (optional): option to plot a circle (for degree) before the C (Celsius) instead of 'deg.'. This argument is just a technical issue (s. details).

cex.global

numeric (with default): global scaling factor.

Value

Returns a plot.

Version

0.4 [2013-03-05]

Details

Nomenclature The nomenclature used for the function (e.g. ltype, position) are taken from the Analyst manual (Duller, 2007, p. 42): rlll{ [,1] ID : Unique record ID (same ID as in slot DATA) numeric [,2] SEL : Record selection logical [,3] VERSION : Data format version number raw [,4] LENGTH : Length of this record integer [,5] PREVIOUS : Length of previous record integer [,6] NPOINTS : Number of data points in the record integer [,7] LTYPE : Luminescence type factor [,8] LOW : Low (temperature, time, wavelength) numeric [,10] HIGH : High (temperature, time, wavelength) numeric [,11] RATE : Rate (heating rate, scan rate) numeric [,12] TEMPERATURE : Sample temperature integer [,13] XCOORD : X position of a single grain integer [,14] YCOORD : Y position of a single grain integer [,15] TOLDELAY : TOL 'delay' channels integer [,16] TOLON : TOL 'on' channels integer [,17] TOLOFF : TOL 'off' channels integer [,18] POSITION : Carousel position integer [,19] RUN : Run number integer [,20] TIME : Data collection time (hh-mm-ss) factor [,21] DATA : Data collection date (dd-mm-yy) factor [,22] SEQUENCE : Sequence name factor [,23] USER : User name factor [,24] DTYPE : Data type factor [,25] IRR_TIME : Irradiation time numeric [,26] IRR_TYPE : Irradiation type (alpha, beta or gamma) integer [,27] IRR_UNIT : Irradiation unit (Gy, Rads, secs, mins, hrs) integer [,28] BL_TIME : Bleaching time numeric [,29] BL_UNIT : Bleaching unit (mJ, J, secs, mins, hrs) integer [,30] AN_TEMP : Annealing temperature numeric [,31] AN_TIME : Annealing time numeric [,32] NORM1 : Normalisation factor (1) numeric [,33] NORM2 : Normalisation factor (2) numeric [,34] NORM3 : Normalisation factor (3) numeric [,35] BG : Background level numeric [,36] SHIFT : Number of channels to shift data integer [,37] SAMPLE : Sample name factor [,38] COMMENT : Comment factor [,39] LIGHTSOURCE : Light source factor [,40] SET : Set Number integer [,41] TAG : Tag integer [,42] GRAIN : Grain number integer [,43] LPOWER : Optical Stimulation Power numeric [,44] SYSTEMID : System ID integer }

curve.transformation This argument allows to transform continuous wave (CW) curves to pseudo (linear) modulated curves. For the transformation the functions of the package are used. Currently it is not possible to pass further arguments to the transformation functions. The argument works only for ltype OSL and IRSL.

Irradiation time Plotting the irradiation time (s) or the given dose (Gy) requires that the variable IRR_TIME has been set within the BIN-file. This is normally done by using the 'Run Info' option within the Sequence Editor or by editing in R. Circle instead of 'deg.' Unfortunately, the circle (for degree) is not an ASCII character and therefore a warning is produced during compiling the R-package. To avoid the warning message the default scale unit is 'deg. C'.

References

Duller, G., 2007. Analyst. pp. 1-45.

Examples

Run this code

##load data
data(ExampleData.BINfileData)

##plot all curves from the first position to the desktop
#pdf(file = "~/Desktop/CurveOutput.pdf", paper = "a4", height = 11, onefile = TRUE)
  
  ##example - load from *.bin file
  #BINfile<-"[your path]"
  #BINfileData<-readBIN2R(BINfile)

#par(mfrow = c(4,3), oma = c(0.5,1,0.5,1))
#plot_BINfileData(CWOSL.SAR.Data,position = 1)
#mtext(side = 4, BINfile, outer = TRUE, col = "blue", cex = .7)
#dev.off()

Run the code above in your browser using DataLab