Package ‘photobiologyBase’ loads three packages from the “R for Photobiology Suite”, the ones which are most frequently used.

photobiology

Package ‘photobiology’ defines a system of classes for storing spectral data and accompanying metadata. For each of these classes specialised summary methods, maths operators and functions are provided. In addition, classes for storing collections of objects of the classes for individual spectra are defined as well as ‘apply’ functions. Extraction and replacement operators are also implemented.

photobiologyWavebands

Package ‘photobiologyWavebands’ is a set of functions and data to be used together with package ‘photobiology’ for calculating derived quantities from spectral data. Non-weighed derived quantities represent summaries of a given range of wavelengths, which can be expressed either in energy or photon based units. All constructors default to ISO standardized definitions when they are available, but other competing definitions are available. These additional definitions include the wavelengths ranges used by Landsat satellite imagers, as these may be needed to approximate remote-sensing-related index calculations on spectral data.

Derived biologically effective quantities are used to quantify the effect of radiation on different organisms or processes within organisms. These effects can range from damage to perception of informational light signals. Except for the definition of the erythemal and vitamin-D spectra for which CIE definitions exist, those which we consider the most frequently used formulations are used as default. Weighting functions included in the package are the luminous efficiency functions for human vision and several biological spectral weighting functions (BSWFs) used to estimate effective UV doses.

The definitions cover most non-weighted wavebands in common use, and in addition many weighting functions used in the calculation of effective irradiances and exposures. The current version of the package puts emphasis, in the case of weighting functions, on a subset of those in use, but in the future the package will be expanded to included responses relevant to additional groups of organisms. Colour-response and colour-matching functions for human vision and bee vision are included in package ‘photobiology’.

ggspectra

Package ‘ggspectra’ is a set of stats, geoms and functions to be used together with packages ‘ggplot2’ and ‘photobiology’ for plotting radiation-related spectra and annotating the plots with quantities derived from spectral data. Unweighted derived quantities represent summaries of a given range of wavelengths, which can be expressed either in energy or photon based units. Derived biologically effective quantities are used to quantify the effect of radiation on different organisms or processes within organisms. These effects can range from damage to perception of informational light signals. Peaks and valleys present in spectral data can also be annotated. Color-patch charts can also be created based on any R color definitions, including those generated from wavelengths and visual response functions with functions in package ‘photobiology’.

This package uses the new functionality added to ‘ggplot2’ at version 2.2.0 and is not compatible with earlier versions.

photobiologyInOut

Package ‘photobiologyInOut’ provides functions for importing spectral data from diverse sources including instrument-specific files, as well as spectral data output by solar-radiation simulation models. It also includes functions for exchanging spectral data with other R packages. Package ‘photobiologyInOut’ complements other packages in the ‘r4photobiology suite’ by allowing reading and writing “foreign” spectral data as well as reading data saved from data loggers.

More resources

The suite of R packages for photobiological calculations is described at the r4photobiology web site, where documentation is also available as web pages.