This version requires R >=4.5.0
The following S3 methods (deprecated in v1.3.1) have been removed (#1694):
as.data.frame.RLum.Data.* (use as.data.frame() instead)as.list.RLum.* (use as.list() instead)as.matrix.RLum.Data.* (use as.matrix() instead)dim.RLum.Data.* (use dim() instead)hist.RLum.* (use hist() instead)length.RLum.*, length.Risoe.BINfileData, length_RLum (use
length() instead)merge_RLum.* (use merge_RLum() instead)names.RLum.*, names.Risoe.BINfileData, names_RLum (use names()
instead)plot.RLum.* (use plot_RLum() instead)summary.RLum.* (use summary() instead)The following functions are no longer exported, but their functionality
can be accessed via the plot_RLum() generic (#1775):
plot_RLum.Analysis()plot_RLum.Data.Curve()plot_RLum.Data.Image()plot_RLum.Data.Spectrum()plot_RLum.Results()The following functions are no longer exported, but their functionality
can be accessed via the new bin_RLum() generic (#1782):
bin()bin.RLum.Data.Curve()bin.RLum.Data.Spectrum()bin_RLum.Data()read_XLUM2R() is a new function for importing files in XLUM format.
The function is currently in alpha state, as it still needs to undergo
further testing to ensure correctness for all inputs. More
functionality regarding XLUM is implemented in the xlum package,
available on CRAN (#1710).
write_RLum2XLUM() is a new generic function. No methods for this
generic are currently implemented in Luminescence, but they will be
provided by a future release of the xlum package (#1828).
analyse_IRSAR.RF()Swap fitting using nls() and the port algorithm with
minpack.lm::nlsLM() along with some code tunings. This should have
no user-visible effects other than better and more reliable fitting in
the case where method = "FIT" was chosen (#1748).
The function validates more strictly the vslide_range option. As a
result, assigning more than two values will now produce an error
instead of a warning (#1794).
The test_parameters argument no longer causes a crash when object
is a list (#1796).
When the curves_bounds threshold was exceeded with method = "FIT",
DE.STATUS was previously set either to “VALUE OUT OF BOUNDS” or
“FAILED” depending on whether the plot was generated or not. Now it is
consistently set to “FAILED” in such cases (#1802).
analyse_SAR.CWOSL()plot_onePage argument now defaults to TRUE as this turned out
to be a more meaningful default value than FALSE.as.data.frame()Risoe.BINfileData object (#1789).bin_RLum()The function no longer throws an error when applied to an empty
RLum.Data.Spectrum object, but returns the object itself. This
uniforms the behaviour to the one used when handling RLum.Data.Curve
objects.
The function no longer crashes on an RLum.Data.Spectrum object with
no row or column names, but assigns arbitrary names before proceeding
(#1798).
calc_FastRatio()plot = TRUE (#1808).calc_Huntley2006()fit_DoseResponseCurve()The new fit.IndexRegPoints replaces both fit.NumberRegPoints and
fit.NumberRegPointsReal. This accepts the indices of the
regeneration points to be used in fitting, thus providing a quick way
to check for the impact of additional regeneration points. The older
arguments will raise a deprecation warning and will be ignored
(#1762).
The progress bar during the Monte Carlo iteration is now shown for all
fit methods, while before it only appear for "QDR", "SSE+LIN" and
"DSE". To disable it, set txtProgressBar = FALSE (#1791).
Method DSE returned spurious D01 and D02 values when the fit
failed (#1800).
The Monte Carlo samples were previously generated by drawing 10,000
normal values and then resampling with replacement to produce n.MC
points. This was unnecessary and artificially limited the number of
distinct samples to 10,000 when n.MC > 10000. Now n.MC random
points are drawn directly. Note that since the random number stream is
used differently, results produced with a fixed seed will not be
identical to those from earlier versions (#1840).
get_RLum()class argument matching none of the
list elements, the class filter was silently ignored. The filter is
now always applied, so such a call returns an empty list instead of
the unfiltered contents (#1778).import_Data()verbose argument was not respected, and all output was
suppressed independently of its setting. This was a regression
introduced in v1.2.0 (#1816).merge_RLum()The function no longer crashes when attempting to merge an empty
RLum.Data.Spectrum object (#1771).
The function is now implemented as an S4 generic that allows automatic dispatch according to the type of elements being merged. This means that external packages can now fully overload it for their own classes (#1769).
Merging of more than two RLum.Data.Spectrum objects produced an
incorrect result when merge.method was one of -, * or /
(#1773).
The function no longer raises a warning when the list of objects to
merge is empty or contains only one element. In such cases, a NULL
is returned (this is unchanged from before) and a simple message is
printed (#1810).
plot_DoseResponseCurve()The presence of a repeated zero-dose point caused the plot not to
print the last dose point in mode = "alternate". This was a
regression partially introduced in v1.0.0 (#1762).
Repeated regenerated points were plotted twice: once as a normal dose
(full circle), then as a repeated dose (triangle). Also repeated
zero-dose points were overplotted with two different symbols. Now each
point appears only once in the plot: only the first zero-dose point is
plotted as a reg 0 point (empty circle if mode == "interpolation"),
repeated points (zero-dose or not) are plotted only as a repeated
point (triangle), while the rest are considered regenerated dose
points (#1766).
plot_DRTResults()When preheat values were provided in combination with
boxplot = TRUE, the x-axis showed out of order ticks if the preheat
values were unordered (#1804).
The summary argument was not respected when preheat values were
provided and boxplot = FALSE (#1806).
plot_RLum()plot_RLum.Analysis()sub_title graphical parameter (accepted via …) will raise
a deprecation warning and be ignored; the more standard sub
parameter should be used instead. As a consequence, the subset
argument must be spelled out in full and can no longer be abbreviated
to sub or anything else (#1776).plot_RLum.Data.Spectrum()read_BIN2R()The pattern argument is now validated to be a single string to avoid
the dir() behaviour of silently ignoring all but the first pattern
(#1751).
The pattern argument is no longer ignored when file contains more
than one input files or directories (#1753).
The function could get trapped in an infinite loop if any records declares to have size 0 (#1759).
If position was specified but not all the provided positions were
present in the file, then all curves were returned instead of only
those with matching positions. Now position is always respected,
even when no positions match, in which case an empty object is
returned (#1784; thanks to Annette Kadereit for reporting).
The keep.empty and fastForward arguments were previously not
respected when an empty object was produced (for example, when
selecting positions not present in the BIN file), and an empty
Risoe.BINfileData object was always returned. Now an empty result is
handled consistently with a regular import: keep.empty = FALSE
returns NULL, and fastForward = TRUE returns a list with an empty
RLum.Analysis object (#1792; thanks to Annette Kadereit for
reporting).
The default value for the fastForward argument has been changed to
TRUE. While technically a breaking change, we expect this not to
cause any major problems, as in order to run any analysis function, it
is expected to have converted the data into a list of RLum.Analysis
objects, which is what the fastForward argument does (#1829).
read_XSYG2R()The pattern argument is now validated to be a single string to avoid
the dir() behaviour of silently ignoring all but the first pattern
(#1751).
The pattern argument is no longer ignored when file contains more
than one input files or directories (#1753).
The auto_linearity_correction was not correctly applied when the
input was a list of XSYG files (#1812).
The function no longer crashes on files containing a completely empty
<Curve>, <Record> or <Sample> node (#1818, #1821, #1825).
The n_records argument has been renamed to n_sequences for
clarity, as it operates at the sequence rather than at the record
level (#1820).
The default value for the fastForward argument has been changed to
TRUE. While technically a breaking change, we expect this not to
cause any major problems, as in order to run any analysis function, it
is expected to have converted the data into a list of RLum.Analysis
objects, which is what the fastForward argument does (#1829).
When import = FALSE, now the function always returns a data frame
with information on the XSYG file and the sequence stored in it,
independently of the setting of the fastForward argument (#1833).
set_RLum()RLum.Analysis
object, the .pid slot is now correctly inherited from the source
object if not provided explicitly (#1814).