Plot Single Luminescence Curves from a Risoe.BINfileData-class object
Source:R/plot_Risoe.BINfileData.R
plot_Risoe.BINfileData.Rd
Plots single luminescence curves from a Risoe.BINfileData object produced by read_BIN2R.
Usage
plot_Risoe.BINfileData(
data,
position = NULL,
run = NULL,
set = NULL,
sorter = "POSITION",
ltype = c("IRSL", "OSL", "TL", "RIR", "RBR", "RL"),
curve.transformation = "None",
dose_rate,
temp.lab = "°C",
cex.global = 1,
...
)
Arguments
- data
Risoe.BINfileData (required): an S4 object generated by the read_BIN2R 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
,run = c(1,3,5)
).- set
vector (optional): option to limit the plotted curves by set (e.g.,
set = 1
,set = c(1,3,5)
).- sorter
character (with default): ordering used in plotting the curves, one of "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"
,"RBR"
(corresponds to LM-OSL),"RL"
. All type of curves are plotted by default.- curve.transformation
character (optional): allows transforming CW-OSL and CW-IRSL curves to pseudo-LM curves via transformation functions. Allowed values are:
CW2pLM
,CW2pLMi
,CW2pHMi
andCW2pPMi
, see details. If set toNone
(default), no transformation is applied.- dose_rate
numeric (optional): dose rate of the irradiation source at the measurement date. If set, the given irradiation dose will be shown in Gy. See details.
- temp.lab
character (with default): the temperature unit to display in the plot labels, by default deg C.
- cex.global
numeric (with default): global scaling factor.
- ...
further undocumented plot arguments.
Details
Nomenclature
curve.transformation
This argument allows transforming 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.
How to cite
Kreutzer, S., Dietze, M., Colombo, M., 2025. plot_Risoe.BINfileData(): Plot Single Luminescence Curves from a Risoe.BINfileData-class object. Function version 0.4.3. In: Kreutzer, S., Burow, C., Dietze, M., Fuchs, M.C., Schmidt, C., Fischer, M., Friedrich, J., Mercier, N., Philippe, A., Riedesel, S., Autzen, M., Mittelstrass, D., Gray, H.J., Galharret, J., Colombo, M., Steinbuch, L., Boer, A.d., 2025. Luminescence: Comprehensive Luminescence Dating Data Analysis. R package version 1.1.1. https://r-lum.github.io/Luminescence/
Author
Sebastian Kreutzer, Institute of Geography, Heidelberg University (Germany)
Michael Dietze, GFZ Potsdam (Germany)
Marco Colombo, Institute of Geography, Heidelberg University (Germany)
, RLum Developer Team
Examples
##load data
data(ExampleData.BINfileData, envir = environment())
##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<- file.choose()
#BINfileData<-read_BIN2R(BINfile)
#par(mfrow = c(4,3), oma = c(0.5,1,0.5,1))
#plot_Risoe.BINfileData(CWOSL.SAR.Data,position = 1)
#mtext(side = 4, BINfile, outer = TRUE, col = "blue", cex = .7)
#dev.off()