ooacquire 0.2.3

Main changes since version 0.2.2 are:

  • Implement support for on-the-fly retrieval of instrument descriptor and calibration data from EEPROM when calibration is not available as R objects: update acq_irrad_interactive() and the functions it uses to retrieve and save calibration data.  (Similar updates are pending for the other data acquisition functions).
  • Update calibration data for MAYP11278 and MAYP112785.
  • Test with old USB2000 spectrometer.

Full change history is available at: https://docs.r4photobiology.info/ooacquire/news/index.html

NOTE: This package is NOT available through CRAN.

This package is available through the r4photobiology repository  and through GitHub.

INSTALLATION:

Note: this version needs the recently released ‘rOmniDriver’ version 0.1.14 or later, so if this package is already installed it may need to be updated before updating or installing ‘ooacquire’ 0.2.3.

  1. From the binary or source packages of the released version from the CRAN-compatible repository at http://r.r4photobiology.info/.
  2. From sources of the under development version retrieved from the Git repository at GitHub.

devtools::install_github("aphalo/romnidriver")
devtools::install_github("aphalo/ooacquire")

Please raise issues concerning bugs or enhancements to this package through GitHub at https://github.com/aphalo/ooacquire/issues

 

ooacquire 0.2.2

During the last two years development has continued at a slow pace. Most changes are to the functions for interactive acquisition of spectra, correction of bugs and tracking to changes in packages from which imports are made. Testing was done with new OmniDriver releases. Some data examples have been added and also replaced. Some progress with the vignettes has been done. However, the documentation still needs work.

One visible change is the move of the Git repository from Bitbucket to GitHub. Package ‘rOmniDriver’ has also been moved to GitHub and its documentation updated to reflect this.

Starting from this release, the changelog is included in the online documentation at http://docs.r4photobiology.info/ooacquire/.

Please raise issues concerning bugs or enhancements to this package through GitHub at https://github.com/aphalo/ooacquire/issues

NOTE: This package is NOT available through CRAN.

This package is available through the r4photobiology repository  and through GitHub.

INSTALLATION:

  1. From the binary or source packages of the released version from the CRAN-compatible repository at http://r.r4photobiology.info/.
  2. From sources of the under development version retrieved from the Git repository at GitHub.

devtools::install_github("aphalo/romnidriver")
devtools::install_github("aphalo/ooacquire")

ggpmisc 0.3.2

This version (0.3.2) adds as new features scales and statistics that help with the creation of volcano and quadrant plots, such as used with transcriptomics and metabolomics data. A few rough edges remaining in the features added in versions 0.3.0. and 0.3.1 have been polished out. Two issues raised in Bitbucket about the documentation, highlighted some incomplete explanations. These explanations have now been expanded. One important change to the documentation of statistics whose returned values may change depending on arguments is the addition of an example of the use of geom_debug() from package ‘gginnards’ showing how to print to the R console the data returned by statistics, which is the input received by the paired geometries. The User Guide needs still some work, scheduled for the next release. Package documentation is available at https://docs.r4photobiology.info/ggpmisc/ as a web site.

Plots created using the new statistics and scales are shown below. In the quadrant plot, which observations were labelled and highlighted was decided automatically based on local 2D density. Counts for each quadrant are computed on the fly. As the plot is non-the-less created using the grammar of graphics, little if any of the flexibility of ‘ggplot2’ is lost.

Quadrant plot created with packages ‘ggplot2 (3.2.1)’, ‘ggpmisc (0.3.2)’ and ‘ggrepel (0.8.1)’.

Volcano plot created with packages ‘ggplot2’, ‘ggpmisc’ and ‘ggrepel’ (very small p-values have been squished to the top edge of the plotting area).

NOTE: The new version of ‘ggpmisc’ is on its way to CRAN.

ggspectra 0.3.3.1

This update includes a fix for a bug affecting autoplot() methods in the case of plotting multiple spectra in the same plot. It also includes improvements to the easy of use through the addition new or enhancements to existing convenience methods and functions. The required version of ‘photobiology’ is now 0.9.28 or higher.

The changes from version 0.3.2, the current CRAN release, are:

  • Make autotitle() the recommended method and deprecate the use of ggtitle_spct(), which remains available for backwards compatibility.
  • Enhance autotitle() to optionally set the caption in addition to title and subtitle of a plot.
  • Add support for setting of the plot caption controlled with the annotations argument of autoplot() methods.
  • Add convenience functions to make easier to modify default arguments used by autoplot() methods through R options: set_annotations_default() and set_w.band_default().
  • Add support for simultaneously adding and removing annotations from the current default by accepting lists of character vectors in addition to character vectors as argument for parameter annotations in autoplot() methods.
  • Add support in multiplot() function for adding a title to the composite figure.
  • Track changes in ‘photobiology’ (>= 0.9.28) adding support for using the "how.measured" attribute in plot titles, subtitles and captions.
  • Use a compute panel function instead of a compute group function in stat_wb_label(), stat_wb_box() and stat_wl_strip(), solving a bug affecting autoplot() methods when called with multiple spectra.

The justification for renaming the ggtitle_spct() function to autotitle() is that the new name is consistent with autoplot() and autolayer() in taking an R object of a specific class as first argument and automatically extracting the information from it.

Documentation web site at https://docs.r4photobiology.info/ggspectra/.

NOTE: The updated package is on its way to CRAN.

Please raise issues concerning bugs or enhancements to this package through Bitbucket at https://bitbucket.org/aphalo/ggspectra/issues

ggpmisc 0.3.1

After the previous major update to ‘ggpmisc’ (0.3.0), a follow up (0.3.1) with multiple new features and smoothed rough edges for some of the features added in version 3.0.0. Package documentation is available at https://docs.r4photobiology.info/ggpmisc/ as a web site.

The enhancements in this and the previous update to ‘ggpmisc’ are made possible by changes to ‘ggplot2’ (>= 3.0.0) made while adding support for sf (simple features).

The functions in ‘ggpmisc’ (>= 0.3.1) are related to different kinds of annotations and insets in ggplots. Annotations of plots with fitted-model equations, fit diagnosis, ANOVA and summary tables, highlighting and labelling of peaks and valleys in curves, and local density-based highlighting or labelling in scatter plots. Additionally specializations of the ggplot() constructor allow on-the-fly conversion of time-series. Two new geoms join geom_table() added in version 0.3.0, geom_plot() and geom_grob(). These three geoms make it possible to add tables, ggplots and arbitrary graphical objects (grobs) as insets to plots respecting the the Grammar of Graphics paradigm.

Inset plot showing means per group.
Inset grobs

A set of new geometries produce marginal annotations: geom_x_margin_point(), geom_y_margin_point(), geom_x_margin_arrow(), geom_y_margin_arrow(), geom_x_margin_grob() and geom_y_margin_grob().

Marginal “points” showing means per group.

Another novel feature is based on the addition of two new aesthetics npcx and npcy, the corresponding scales scale_npcx_continuous() and scale_npcy_continuous(), and several new geometries that make use of then: geom_text_npc(), geom_label_npc(), geom_table_npc(), geom_plot_npc() and geom_grob_npc(). These allow to position insets and annotations relative to the dimensions of the plotting area instead of using native data units. Using "npc" units is more natural for labels or insets that are not directly related to data but that look better if positioned consistently across multiple panels or multiple separately produced plots. One improvement to the stats from earlier versions of ‘ggpmisc’ is the use of these new geoms to achieve more consistent location for insets and labels.

Quadrant counts with panels.
Fitted equations in panels with free y limits.
Inset tables at different positions in different panels.

As in the announcement of the previous version, I have included some example plots taken from the documentation of the package. In all cases annotations are generated automatically, but formatting is flexible.

NOTE: The new version of ‘ggpmisc’ will be soon submitted to CRAN .

ooacquire 0.1.6

Improvements aiming at continuing the expansion of the support of different Ocean Optics spectrometers and of  additional measurement methods.

  • Update acq_irrad_interactive() adding alternative user-interface modes, allowing users to set comment and what.measured attributes, and to construct collections of spectra.
  • Add pre-built calibrations and methods for additional FLAME-S instruments.
  • Improve algorithm for automatic tuning of integration time to achieve faster convergence.
  • Fix various minor bugs.
  • Update vignettes.
  • Test against OmniDriver 1.2.56
  • Update read_ooov_files() for compatibility with ‘readr’ >= 1.2.0 which is now required

Add support for measurement of pulsed light sources (under development)

The new features described below are under development, subject to change without previous notice and not yet well tested!! (double-check any results and please report any bugs by raising an issue!)

Implement support for measuring output from xenon flashes, including use of such flashes as light sources for measurement of spectral transmittance and reflectance. Use of multiple exposures per integration is also supported and the number of exposures stored as metadata is used during later processing. In the case of pulsed light sources the first conversion of RAW spectra is into counts per exposure, and instead of spectral irradiance spectral fluence per exposure is computed. All changes are backwards compatible with raw data acquired with earlier versions of ‘ooacquire’ and the user interface remains unaltered for the measurement of continuous light sources.

  • Add function acq_fluence_interactive() for measuring spectral fluence of pulsed light sources.
  • Add acq_fraction_pulsed_interactive() for measuring transmittance and reflectance using a pulsed light source.

Documentation website is at http://docs.r4photobiology.info/ooacquire/.

Please raise issues concerning bugs or enhancements to this package through Bitbucket at https://bitbucket.org/aphalo/ooacquire/issues

NOTE: This package is NOT available through CRAN.

This version of the package is available through the r4photobiology repository  and through Bitbucket.

INSTALLATION:

  1. from the binary or source packages from the CRAN-compatible repository at http://r.r4photobiology.info/
  2. from sources retrieved from the Git repository at Bitbucket.

devtools::install_github("tidyverse/ggplot2")

devtools::install_bitbucket("aphalo/ooacquire", ref = "0.1.6")

devtools::install_bitbucket("aphalo/photobiology")  # only if not automatically installed/updated

devtools::install_bitbucket("aphalo/photobiologyWavebands")  # only if not automatically installed/updated

devtools::install_bitbucket("aphalo/ggspectra")  # only if not automatically installed/updated

photobiologyInOut 0.4.18

The main changes from version 0.4.17-1 the previous CRAN release, are:

  • Track code breaking change in ‘readr’ (>= 1.2.0)
  • Fix bug in read_oo_pidata() that was preventing reading of Ocean Optics “Raspberry Pi” Flame files with a sequence header line at the top.
  • Add decoding of file header to extract integration time and number of scans to read_oo_pidata().
  • Improve decoding of file header to extract instrument settings in read_oo_jazdata().

Because of code breaking change in package ‘readr’ this version of ‘photobiologyInOut’ requires ‘readr’ >= 1.2.0 to be installed. Function read_oopi_data() from ‘photobiologyInOut’ < 0.4.18 will not work as expected under ‘readr’ >= 1.2.0. (I thank Jim Hester for making a pull request that solved the problem introduced by the change in ‘readr’.

Documentation web site at http://docs.r4photobiology.info/photobiologyinout/.

NOTE: This version of the package is on its way to CRAN.

Please raise issues concerning bugs or enhancements to this package through Bitbucket at https://bitbucket.org/aphalo/photobiologyinout/issues

ggspectra 0.3.0


BUG WARNING

Occasional R crashes when stat_label_peaks() and stat_label_valleys() are used together with ggrepel::geom_label_repel(). This is a bug in ‘ggrepel’ (= 0.8.0) at least under Windows with long vectors of labels. The bug affects these stats and the "label.peaks" and "label.valleys" annotations in all plot() methods. The bug has been reported and the author is working on a fix.


Revise to track changes in ‘photobiology’ version 0.9.24 and ‘ggplot2’ 3.0.0, which are now required.

The changes from version 0.2.4, the current CRAN release, are:

Code breaking change!

Change the names of some the values calculated by the stats defined in ‘ggspectra’ to avoid confusion with the names of ‘ggplot2’ aesthetics. (This breaks old code only if any of the renamed variables has been manually mapped using aes(), which is rather unlikely.)

Other non-code breaking changes

  • stat_label_peaks() and stat_label_valleys() now have a new parameter, label.fill which can be used to set the content of ..x.label.. and ..y.label.. for labels not labelled as peaks or valleys. The earlier default of "" is maintained.
  • Add the new stat_find_wls() and stat_find_qtys(), two new statistics useful for highlighting features in spectra.
  • Add parameter ylim to all plot() methods. By default previous behaviour is preserved.
  • Revise plot() methods to support objects with multiple spectra in long form.
  • Revise plot() methods to NOT display by default calculated numerical summaries in annotations when a plot contains multiple spectra.
  • Revise plot() methods to retrieve and validate the name of the factor used to identify multiple spectra, using as default the value stored in the attribute "idfactor" implemented in ‘photobiology’ 0.9.21 and later.
  • Add autoplot() as an alias of plot() for spectra and collections of spectra.

Documentation web site at http://docs.r4photobiology.info/ggspectra/.

NOTE: The updated package has been submitted to CRAN.

Please raise issues concerning bugs or enhancements to this package through Bitbucket at https://bitbucket.org/aphalo/ggspectra/issues

photobiologyInOut 0.4.17-1

The main changes from version 0.4.16 the previous CRAN release, are:

  • Add new function read_oo_jazpc() to read transmittance (%) and reflectance (%) from processed data output by Ocean Optics’ Jaz modular spectrometer.
  • Fix bug that made CRAN tests to fail under “oldrel” : decoding of dates in fmi and TUV import functions not always returned POSIXct objects under R (=3.4.4) triggering errors in downstream code. (Possible underlying problem: class of returned values from some functions from package ‘lubridate’ seems to depend on the R version.)

Documentation web site at http://docs.r4photobiology.info/photobiologyinout/.

NOTE: This version of the package is in CRAN.

Please raise issues concerning bugs or enhancements to this package through Bitbucket at https://bitbucket.org/aphalo/photobiologyinout/issues

photobiology 0.9.21

The main changes from version 0.9.20, the most recent CRAN release, are:

  • Fix bugs in copy_attributes() function (some attributes were not copied).
  • Add copying of attributes to conversion functions cps2irrad(), cps2Tfr() and cps2Rfr().
  • Add merge_attributes() function and fix bugs in handling of metadata attributes in maths operators, affecting operations between two spectral objects.
  • Implement copy of attributes and automatic _adjustment_ of the "multiple.wl" attribute in the Extraction operator [] for spectral objects.
  • Improve handling of attributes in objects containing multiple spectra in tidy (longitudinal) form. Revise setMultipleWl() to guess number of spectra when multiple.wl argument is NULL.
  • Add setIdFactor() and getIdFactor(), and add parameter idfactor to setGenericSpct() and equivalent functions.
  • Handle gracefully attempts to apply smooth_spct() method to spectra containing NA values. (Warn and return as is.)
  • Add parameter na.rm to peaks(), valleys() and related methods and functions.
  • Add parameter na.rm to normalize() methods.
  • Option "photobiology.verbose" is initialized to the value of R’s option "verbose" at the time the package is attached.
  • If option photobiology.verbose == TRUE, the presence of NA values in spectral data triggers warnings.

Documentation web site at http://docs.r4photobiology.info/photobiology/ includes all help pages, with output from all examples, and vignettes in HTML format.
NOTE: The updated package is available through CRAN.

Please raise issues concerning bugs or enhancements to this package through Bitbucket https://bitbucket.org/aphalo/photobiology/issues

ggspectra 0.2.4.9001

The changes from version 0.2.4, the current CRAN release, are:

Track changes in package ‘photobiology’ 0.9.21:

  • Revise examples in the User Guides to use the new methods. Revise other documentation.
  • Revise to track changes in ‘photobiology’ version 0.9.21.
  • Revise plot() methods to support objects with multiple spectra in long form.
  • Revise plot() methods to not use by default calculated summaries in annotations when a plot contains multiple spectra.
  • Revise plot() methods to retrieve and validate the name of the factor used to identify multiple spectra, using as default the value stored in the attribute "idfactor" implemented in ‘photobiology’ 0.9.21.
  • Tested compatible with ‘ggplot2’ 2.3.0.

Documentation web site at http://docs.r4photobiology.info/ggspectra/.

NOTE: The updated package is available at a CRAN-like repository at https://r.r4photobiology.info/.

Please raise issues concerning bugs or enhancements to this package through Bitbucket at https://bitbucket.org/aphalo/ggspectra/issues

ggpmisc 0.2.17.9910 + gginnards 0.0.0.9001

[UPDATE 2018-0713] ‘ggplot2’ 3.0.0 and ‘gginnards’ 0.0.1 are now in CRAN, while ‘ggpmisc’ 0.3.0 will be soon on its way to CRAN becoming the only branch being maintained.


While waiting for the release of ‘ggplot2’ 3.0.0 I am keeping two parallel branches of  ‘ggpmisc’ under development.

‘ggpmisc’ 0.2.17 is in CRAN and remains unchanged. It requires the CRAN version of ‘ggplot2’.


‘ggpmisc’ 0.2.17.9910 is in the CRAN-like repository at this site. It is as thoroughly tested as the CRAN version but contains geom_table and the stats that use this geometry, which make use of the development version of ‘ggplot2’ from Github.  ‘ggplot2’ at commit #2620 (2018-05-17) or later is needed for ‘ggpmisc’ 0.2.17.9910, while 0.2.17.9902 and earlier versions from this branch require ‘ggplot2’ at least commit #2034 (2017-02-09).

If you install ‘ggplot2’ from Github after May 17, 2018 (selecting any commit from this day onwards) you will need this new version of  ‘ggpmisc’  or the CRAN version. If you are using ‘ggplot2’ from CRAN, or an earlier commit from Github, to use this new version you will need first to install the latest development version of ‘ggplot2’ from Github.

After ‘ggplot2’ (>= 2.3.0) makes it to CRAN, a version from this enhanced branch will be submitted to CRAN as version >= 0.3.0. Release seems to be now imminent.

Changes from version 0.2.17.9903 (3 June 2018)

  • Split the original package into two packages as per roadmap: debugging and and layer manipulation functions are now in pakage ‘gginnards’ while the rest of the functions remain in ‘ggmisc’.

NOTE: These versions of the packages are available from https://r.r4photobiology.info/. 


Documentation website is at https://docs.r4photobiology.info/ggpmisc/

Documentation website is at https://docs.r4photobiology.info/gginnards/

Please raise issues concerning bugs or enhancements to this package through Bitbucket at https://bitbucket.org/aphalo/ggpmisc/issues