Light serves as one of the primary environmental cues for regulating various physiological and behavioral processes. Disruptions in circadian rhythms resulting from mistimed or inadequate light exposure have been linked to a range of health problems across mammalian species. As a consequence, ensuring appropriate lighting is crucial for indoor housed mammals. Lux is the most commonly used metric for measuring lighting, yet it is a weighted spectral function based on human perceived brightness and is unsuitable for capturing non-image forming effects of light or for measuring light exposure across different species. Photoreceptor-specific (α-opic) measurements of lighting have been proposed as a more suitable units of quantifying light in humans. Since the number of photoreceptor types, photopigment spectral sensitivities, and eye anatomy differ across mammalian species, we have developed a method for measuring light exposure in a species-specific manner based on photoreceptor activation.
The package was prepared by Time Vision Behaviour Lab in the University of Manchester. This project has received funding from the Wellcome Trust Investigator Award (210684/Z/18/Z) to Robert Lucas. Problems or requests can be emailed to package maintainer Altug Didikoglu. This package includes R functions to calculate animal light exposure and required reference data. The packege is also available as an online app: Animal α-opic light exposure calculator.
R package to calculate mammal species and photopigment specific light exposures
Install with GitHub
To install this package from GitHub, make sure that the devtools
library is installed.
install.packages("devtools")
library(devtools)
Use install_github
to install using devtools
.
install_github("altugdidikoglu/alphaopics")
To calculate species and photopigment-specific ligh exposure, use the alphaopic()
function. This function calculates species-specific a-opic EDIs (+ photopic illuminance), irradiances and effective photons from predefined species specific parameters.
exposure <- alphaopic(spd, wl, species, opsin, lmax, pfilter);
The arguments taken by alphaopic() are used to specify light stimuli and calculation parameters.
spd Vector containing spectral power distribution in W/m2.nm
wl Corresponding wavelength range over which measurements are acquired; assumes equally spaced spectra and uses spline extrapolation if not have 1nm spacing
species String containing the name of a species e.g. 'Mouse'
opsin Target photopigment name (One of the following options: 'Mel','Rod','Scone','Mcone','Lcone') or 'Photopic' for human lux
lmax The lambda max of the opsin's photon sensitivity in the absence of preceptoral filtering. One of the following options: a string specifying a species specific work space in the subdirectory '/data' e.g. 'Mouse', or a numerical wavelength value specifying the lambda max to allow modelling
pfilter Information about function for prereceptoral filtering. One of the following options: string specifying a species-specific work space in the subdirectory '/data' e.g. 'Mouse', zero for no prereceptoral filtering, or new transmission measurement data matrix with transmissions and wavelengths
This function generates a list of species name, target opsin, (EDI) a-opic equivalent daylight illuminance [lux], (IRR) a-opic irradiance [W/m2], (PHO) Effective photon [log10(photons/cm2.s)]
# Example calculations
# Wavelength range
wl = 300:780
# Spectral power distribution in W/m2.nm
spd = dnorm(300:780, mean = 480, sd = 30)
# If target species is available in the package data
exposure1 <- alphaopic(spd, wl, 'Mouse', 'Scone', 'Mouse', 'Mouse');
# If lambda max value of opsin's photon sensitivity will be used
exposure2 <- alphaopic(spd, wl, 'Cat', 'Mel', 480, 'Cat');
# If new lens transmission observations will be used
exposure3 <- alphaopic(spd, wl, 'Sheep', 'Rod', 500, data.frame(wavelen = 350:750, trans = seq(0,100,length.out=401)));
- aopicSpecies
Show the list of species with available data of lens transmission and opsin sensitivity
- govardovskii
Calculate Govardovskii nomogram as Govardovskii et al. 2000. (Vis Neurosci. 2000 Jul-Aug;17(4):509-28. doi: 10.1017/s0952523800174036)
- photonenergy
Calculates the energy of a photon at a given wavelengths(nm)
- harmonisetrans
Extrapolate/adjust curve to match the wavelength range for species-specific prereceptoral filtering data
- harmonisesens
Extrapolate/adjust curve to match the wavelength range for species specific action spectra
- generateaopicactionspec
Generate a govardovski nomogram with corrections prereceptoral filtering
Lucas, R. J. et al. Measuring and using light in the melanopsin age. Trends Neurosci 37, 1-9 (2014). https://doi.org:10.1016/j.tins.2013.10.004
CIE S026/E:2018: CIE System for Metrology of Optical Radiation for ipRGC-Influenced Responses to Light. (2018). https://doi.org:10.25039/S026.2018
Douglas, R. H. & Jeffery, G. The spectral transmission of ocular media suggests ultraviolet sensitivity is widespread among mammals. Proc Biol Sci 281, 20132995 (2014). https://doi.org:10.1098/rspb.2013.2995
Govardovskii, V. I., Fyhrquist, N., Reuter, T., Kuzmin, D. G. & Donner, K. In search of the visual pigment template. Vis Neurosci 17, 509-528 (2000). https://doi.org:10.1017/s0952523800174036
Peirson, S. N., Brown, L. A., Pothecary, C. A., Benson, L. A. & Fisk, A. S. Light and the laboratory mouse. J Neurosci Methods 300, 26-36 (2018). https://doi.org:10.1016/j.jneumeth.2017.04.007