ooacquire 0.2.6

Version 0.2.6 is a maintenance update, fixing compatibility with recent versions of ‘dplyr’ and the just reelased ‘photobiology’ 0.10.14. It also includes minor enhancements to the interactive user interface (UI) of function acq_irrad_interactive() . OceanInsight recently released version 2.70 of OmniDriver, and removed some functions from the API. For the time being, keep using version 2.56 that is known to work.

Continue reading

ooacquire 0.2.4 and 0.2.5

The main new feature in version 0.2.5 is that the package can be installed and used in an off-line mode without need to install what were previously system requirements and required packages. In this mode data acquisition and communication with spectrometers is disabled, but processing of spectral data previously acquired or acquired with a different computer or using other software remains available unchanged.

Version 0.2.4 brings some improvements to the user interface for interactive data acquisition. It also fixes problems caused by code-breaking changes in package ‘readr’.

Continue reading

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")

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

ooacquire 0.1.5

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

  • Support use of irradiance calibrations supplied by Ocean Optics
  • Add pre-built calibrations and methods for two Flame-S instruments.

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.  In addition, this version of package ‘ooacquire’ depends on versions of packages ‘photobiology’, ‘photobiologyWavebands’, ‘ggspectra’, and ‘ggplot2’ not yet 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.5")

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

ooacquire 0.1.4.9003

Fix “breaking” bug causing fatal errors after package ‘Rcpp’ was updated, and many non-breaking but important bugs.

Several improvements aiming at continuing the expanding the support to different Ocean Optics spectrometers, and to the documentation.

  •  Fix serious bug that triggered a fatal error with current version of ‘Rcpp’.
  • Add functions choose_sr_interactive() and choose_ch_interactive() and revise acq_irrad_interactive() and acq_fraction_interactive() to make use of them.
  •  Add fields to the instrument descriptor to store the numeric coefficients in addition to functions for non-linearity and wavelength calibrations.
  • Add pre-built calibrations and methods for our Jaz instrument.
  • Update and expand the vignettes and examples.

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

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

ooacquire 0.1.2

This is the second release of package ‘ooacquire’. It is an important update as it include bug fixes and enhancements which have some (minor) effect on the calculated spectral values. The update also removes some spurious warnings and has additional documentation, although not yet in final form.This package allows the acquisition of spectral data from spectrometers from Ocean Optics connected through the OmniDriver run-time, which is available at no cost from Ocean Optics. The current version implements several corrections and measuring protocols unavailable elsewhere in a single modular framework. Some of these cannot be used off-the-shelf as they require the characterisation and calibration of each individual spectrometer, so as to obtain usable values for constants. However, once these constants are available they can be passed as data arguments without need to modify the package itself. Functions are provided for spectral irradiance, spectral transmittance and spectral reflectance measurements. As transmittance and reflectance measurements are normally done relative to reference objects the calibration requirements are less involved than for spectral irradiance.

The package is available through r4photobiology repository.

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

New: ooacquire 0.1.1

This is the first release of package ‘ooacquire’ . This package allows the acquisition of spectral data from spectrometers from Ocean Optics connected through the OmniDriver run-time, which is available at no cost from Ocean Optics. The current version implements several corrections and measuring protocols unavailable elsewhere in a single modular framework. Some of these cannot be used off-the-shelf as they require the characterization and calibration of each individual spectrometer, to obtain usable values for constants. However, once these constants are available they can be passed as data arguments without need to modify the package itself. Functions are provided for spectral irradiance, spectral transmittance and spectral reflectance measurements. As transmittance and reflectance measurements are normally done relative to reference objects the calibration requirements are less involved than for  spectral irradiance. Continue reading

Packages available

rOmniDriver 0.1.6

This package allows the control of all Ocean Optics spectrometers and the acquisition of spectral data directly from within R code. The current version implements only a subset of the functions available in OmniDriver. Adding other functions should be almost trivial, but not all of them can be tested with the spectrometers we have access to.

It is fully functional  with the installation of the free run-time provided by Ocean Optics, but it is not supported in any way by Ocean Optics, without purchase of a licence. We thank Ocean Optics’ for helping in the development of this package. (The run-time can be installed from the same file as a full installation, but without the need to enter a password.)

MayaCalc 3.2.2

This package implements functions for acquisition of spectral data, application of special correction and calibration algorithms using a Maya2000Pro spectrometer from Ocean Optics. It also implements different radiation measurement protocols. Functions are also provided for estimating calibration constants from measurements of calibration lamps. The algorithms allow in most cases a gain of one order of magnitude in signal to noise ratio, allowing acceptably good measurements of solar ultraviolet radiation with this single-monochromator array instrument. The code is based on algorithms developed by Lasse Ylianttila at the Radiation Safety Authority Finland.

This package can be used as is only with our own Ocean Optics spectrometer unit, a Maya2000Pro. It is made publicly available as an example that could be adapted to other spectrometers. In addition, by making it publicly available, we contribute to making our own research reproducible.

A bugfix update will be released as soon as we have access to the spectrometer for testing it. The bug affects only measurements done under extremely low irradiance levels.

NOTE: Sources, and Windows binaries for R 3.2.x, are now available in the repository.