v0.9.19 (CRAN)

Changes in version 0.9.19 (2022-03-10)

This package version requires R >= 4.0.5

New functions

• extract_ROI(): Light-weighted function to extract pixel values
  from pre-defined regions-of-interest (ROI) from
  RLum.Data.Image-class, array or matrix objects and provide
  simple image processing capacity. While the function comes with a
  simple control plot output, the results can be passed also to
  plot_ROI()

• write_R2TIFF(): Export RLum.Data.Image and RLum.Data.Spectrum
  objects or a list of such to TIFF Images. A convenient wrapper
  around the function tiff::writeTIFF()

Bugfixes and changes

merge_RLum.Results()

• If elements of type matrix, data.frame or vector were merged,
  usually attributes, additional to the standard attributes (e.g.,
  class for data.frame) were lost during the merging. Now, such
  attributes are preserved so far they are not of a similar name as
  the standard object of the object element (e.g., dim for matrix
  or class for data.frame). This small addition allows to merge
  more complex objects and retain all attributes for further
  processing.

plot_DRTResults()

• The plot messed with the par() settings, which was problematic if,
  for instance, a second x-axis was wanted; fixed.
• The function examples were not anymore up-to-date; fixed.

plot_RLum.Data.Image()

• Minor correction of the colour legend, which did always show the
  highest value
• New ... argument zlim_image to maintain a consistent z-scale
  over a series of images.
• The colour stretching could fail for lin and a lot of zero values;
  fixed.

plot_RLum.Data.Spectrum()

• Fixed a bug that let plot_RLum.Data.Spectrum() crash under very
  particular circumstances due to a wrong conditional statement.
• If the count limits are oddly chosen, i.e. limit_counts is smaller
  than the actual number of counts on the z-scale, the function does
  not crash anymore but replaces the value with the lowest possible
  value.
• The argument box for the plot persp now accepts alternate for
  the customized plot without the box usually drawn around the plot.
• The function now returns the adjusted matrix used for the plotting
  regardless of whether the argument plot is set to TRUE or
  FALSE.
• If the plot type is persp, the default, the “viewing
  transformation matrix” is returned as an attribute pmat. This can
  be further used in conjunction with the function graphics::trans3d
  to add additional information to the graphic.

plot_FilterCombinations()

• The function returned a wrongly calculated optical density, using
  log() instead of log10; fixed.= Note: The shiny filter app was
  not immediately affected because the values here were taken from a
  spreadsheet.
• The output object is now invisible since the function’s main purpose
  is to plot a graphic and not return an object.

plot_ROI()

• Add support for the new function extract_ROI()
• Add new argument bg_image to support background image plotting
• The numerical output is now consistently invisble as it is for all
  plot functions in the package