Learn R Programming

⚠️There's a newer version (0.5.2) of this package.Take me there.

photobiologyWavebands

Package ‘photobiologyWavebands’ is a set of functions and data to be used together with package ‘photobiology’ for calculation of derived quantities from spectral data. Non-weighed derived quantities represent summaries of a given range of wavelengths. All constructors default to ISO standardized definitions when they are available, but other competing definitions are also available. These additional definitions include the wavelength 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 formulations that we consider the most frequently used are the 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’.

Installation

Installation of the most recent stable version from CRAN:

install.packages("photobiologyWavebands")

Installation of the current unstable version from Bitbucket:

# install.packages("devtools")
devtools::install_bitbucket("aphalo/photobiologyWavebands")

Documentation

HTML documentation is available at (https://docs.r4photobiology.info/photobiologyWavebands/), including an User Guide.

News on updates to the different packages of the ‘r4photobiology’ suite are regularly posted at (https://www.r4photobiology.info/).

Two articles introduce the basic ideas behind the design of the suite and describe its use: Aphalo P. J. (2015) (https://doi.org/10.19232/uv4pb.2015.1.14) and Aphalo P. J. (2016) (https://doi.org/10.19232/uv4pb.2016.1.15).

A book is under preparation, and the draft is currently available at (https://leanpub.com/r4photobiology/).

A handbook written before the suite was developed contains useful information on the quantification and manipulation of ultraviolet and visible radiation: Aphalo, P. J., Albert, A., Björn, L. O., McLeod, A. R., Robson, T. M., & Rosenqvist, E. (Eds.) (2012) Beyond the Visible: A handbook of best practice in plant UV photobiology (1st ed., p. xxx + 174). Helsinki: University of Helsinki, Department of Biosciences, Division of Plant Biology. ISBN 978-952-10-8363-1 (PDF), 978-952-10-8362-4 (paperback). PDF file available from (http://doi.org/10.31885/9789521083631).

Contributing

Pull requests, bug reports, and feature requests are welcome at (https://bitbucket.org/aphalo/photobiologyWavebands).

Citation

If you use this package to produce scientific or commercial publications, please cite according to:

citation("photobiologyWavebands")
#> 
#> To cite package 'photobiologyWavebands' in publications, please use:
#> 
#>   Aphalo, Pedro J. (2015) The r4photobiology suite. UV4Plants Bulletin,
#>   2015:1, 21-29. DOI:10.19232/uv4pb.2015.1.14
#> 
#> A BibTeX entry for LaTeX users is
#> 
#>   @Article{,
#>     author = {Pedro J. Aphalo},
#>     title = {The r4photobiology suite},
#>     journal = {UV4Plants Bulletin},
#>     volume = {2015},
#>     number = {1},
#>     pages = {21-29},
#>     year = {2015},
#>     doi = {10.19232/uv4pb.2015.1.14},
#>   }

License

© 2012-2020 Pedro J. Aphalo (pedro.aphalo@helsinki.fi). Released under the GPL, version 2 or greater. This software carries no warranty of any kind.

Copy Link

Version

Install

install.packages('photobiologyWavebands')

Monthly Downloads

346

Version

0.4.4

License

GPL (>= 2)

Maintainer

Pedro Aphalo

Last Published

April 28th, 2020

Functions in photobiologyWavebands (0.4.4)

CIE2008_lef2deg.spct

CIE2008 luminous efficiency function (2-deg) (photopic human vision)
Blue

Constructor of blue waveband
CIE_e_fun

Gives values for the erythemal BSWF as a function of wavelength
CIE_q_fun

Gives values for the erythemal BSWF as a function of wavelength
CIE

Constructor of CIE weighted waveband
CH4_e_fun

Gives values for the CH4 production from pectin BSWF as a function of wavelength
CH4

Constructor of CH4 production from pectin weighted waveband
CH4_q_fun

Gives values for the CH4 production from pectin BSWF as a function of wavelength
CIE1951_scotopic_lef.spct

Luminous efficiency function (scotopic human vision)
CIE1924_lef.spct

CIE1924 luminous efficiency function (photopic human vision)
DNA_N

Constructor of DNA damage (SETLOW) weighted waveband
DNA.GM

Constructor of DNA damage (SETLOW) weighted waveband
GEN_M_q_fun

Gives values for GPAS BSWF (Micheletti's formulation) as a function of wavelength
DNA_GM_q_fun

Gives values for naked DNA BSWF (SETLOW) as a function of wavelength
DNA_GM

Constructor of DNA damage (SETLOW) weighted waveband
Green

Constructor of green waveband
GEN_T_q_fun

Gives values for GPAS BSWF (Timijan's formulation) as a function of wavelength
GEN.M

Constructor of GPAS (Micheletti) weighted waveband
UVB

Constructor of UV-B waveband
UVC

Constructor of UV-C waveband
GEN.G

Constructor of GPAS (Green) weighted waveband
FLAV

Constructor of FLAV BSWF flavonoids
GEN_T

Constructor of GPAS (Timijan) weighted waveband
DNA_P_q_fun

Gives values for plant DNA BSWF (Quaite) as a function of wavelength
DNA.P

Constructor of DNA damage (Quaite) weighted waveband
GEN_M

Constructor of GPAS (Micheletti) weighted waveband
DNA_N_q_fun

Gives values for naked DNA BSWF (SETLOW) as a function of wavelength
GEN_G_q_fun

Gives values for GPAS BSWF (Green's formulation) as a function of wavelength
DNA.N

Constructor of DNA damage (SETLOW) weighted waveband
Yellow

Constructor of yellow waveband
VIS_bands

Contructor of lists of VIS wavebands
photobiologyWavebands-package

photobiologyWavebands: Waveband Definitions for UV, VIS, and IR Radiation
PG

Constructor of PG weighted waveband
Landsat_bands

Constructor of lists of wavebands matching Landsat imagers
FLAV_q_fun

Gives values for FLAV BSWF (flavonoid) as a function of wavelength
Orange

Constructor of orange waveband
SetlowTUV.spct

Setlow's action spectrum for DNA damage
NDVI

Normalized Vegetation Index
DNA_P

Constructor of DNA damage (Quaite) weighted waveband
PAR

Constructor of PAR waveband
GEN.T

Constructor of GPAS (Timijan) weighted waveband
Far_red

Constructor of FR waveband
GEN_G

Constructor of GPAS (Green) weighted waveband
ICNIRP

Constructor of ICNIRP 2004 weighted waveband
VIS

Constructor of VIS waveband
ICNIRP_e_fun

Values for the ICNIRP BSWF as a function of wavelength
IR

Constructors of infra-red wavebands
Purple

Constructor of purple waveband
IR_bands

Constructor of lists of infrared wavebands
Plant_bands

Constructor of lists of wavebands used in plant biology
UVI_wb

Constructor of CIE weighted waveband
UVA

Constructor of UV-A waveband
UV

Constructor of UV waveband
UV_bands

Constructor of lists of UV wavebands
PG_q_fun

Gives values for the Plant Growth BSWF as a function of wavelength
photopic_sensitivity

Photopic sensitivity of the human eye
Red

Constructor of red waveband
scotopic_sensitivity

Scotopic sensitivity of the human eye
UVI

Calculate UVI from spectral irradiance