photobiology (version 0.9.16)

split_photon_irradiance: Photon irradiance for split spectrum regions

Description

This function returns the photon irradiance for a series of contiguous wavebands from a radiation spectrum. The returned values can be either absolute or relative to their sum.

Usage

split_photon_irradiance(w.length, s.irrad, cut.w.length = range(w.length),
  unit.in = "energy", scale = "absolute", check.spectrum = TRUE,
  use.cached.mult = FALSE, use.hinges = getOption("photobiology.use.hinges",
  default = NULL))

Arguments

w.length

numeric Vector of wavelengths (nm)

s.irrad

numeric Corresponding vector of spectral (energy) irradiances (W m-2 nm-1)

cut.w.length

numeric Vector of wavelengths (nm)

unit.in

character Allowed values "energy", and "photon", or its alias "quantum"

scale

a character A string indicating the scale used for the returned values ("absolute", "relative", "percent")

check.spectrum

logical Flag indicating whether to sanity check input data, default is TRUE

use.cached.mult

logical Flag indicating whether multiplier values should be cached between calls

use.hinges

logical Falg indicating whether to use hinges to reduce interpolation errors

Value

a numeric array of photon irradiances with no change in scale factor: [W m-2 nm-1] -> [mol s-1 m-2] or relative values (fraction of one) if scale = "relative" or scale = "percent"

See Also

Other split a spectrum into regions functions: split_energy_irradiance, split_irradiance

Examples

# NOT RUN {
with(sun.data,
     split_photon_irradiance(w.length, s.e.irrad,
             cut.w.length = c(300, 400, 500, 600, 700)))
with(sun.data,
     split_photon_irradiance(w.length, s.e.irrad,
             cut.w.length = c(200, 400, 500, 600, 900)))
with(sun.data,
     split_photon_irradiance(w.length, s.e.irrad,
             cut.w.length = c(300, 400, 500)))
with(sun.data,
     split_photon_irradiance(w.length, s.e.irrad))

# }