ggspectra (version 0.3.2)

autoplot.source_spct: Create a complete ggplot for a light-source spectrum.

Description

These methods return a ggplot object with an annotated plot of a source_spct object or of the spectra contained in a source_mspct object.

Usage

# S3 method for source_spct
autoplot(object, ...,
  w.band = getOption("photobiology.plot.bands", default = list(UVC(),
  UVB(), UVA(), PAR())), range = NULL,
  unit.out = getOption("photobiology.radiation.unit", default =
  "energy"), label.qty = NULL, span = NULL, annotations = NULL,
  time.format = "", tz = "UTC", text.size = 2.5, idfactor = NULL,
  ylim = c(NA, NA), object.label = deparse(substitute(object)),
  na.rm = TRUE)
# S3 method for source_mspct
autoplot(object, ..., range = NULL,
  plot.data = "as.is")

Arguments

object

a source_spct or a source_mspct object.

...

in the case of collections of spectra, additional arguments passed to the plot methods for individual spectra, otherwise currently ignored.

w.band

a single waveband object or a list of waveband objects.

range

an R object on which range() returns a vector of length 2, with min annd max wavelengths (nm).

unit.out

character string indicating type of radiation units to use for plotting: "photon" or its synomin "quantum", or "energy".

label.qty

character string giving the type of summary quantity to use for labels, one of "mean", "total", "contribution", and "relative".

span

a peak is defined as an element in a sequence which is greater than all other elements within a window of width span centered at that element.

annotations

a character vector.

time.format

character Format as accepted by strptime.

tz

character Time zone to use for title and/or subtitle.

text.size

numeric size of text in the plot decorations.

idfactor

character Name of an index column in data holding a factor with each spectrum in a long-form multispectrum object corresponding to a distinct spectrum. If idfactor=NULL the name of the factor is retrieved from metadata or if no metadata found, the default "spct.idx" is tried.

ylim

numeric y axis limits,

object.label

character The name of the object being plotted.

na.rm

logical.

plot.data

character Data to plot. Default is "as.is" plotting one line per spectrum. When passing "mean" or "median" as argument all the spectra must contain data at the same wavelength values.

Value

a ggplot object.

See Also

Other autoplot methods: autoplot.calibration_spct, autoplot.cps_spct, autoplot.filter_spct, autoplot.object_spct, autoplot.raw_spct, autoplot.reflector_spct, autoplot.response_spct, autoplot.waveband

Examples

# NOT RUN {
autoplot(sun.spct)
autoplot(sun.spct, unit.out = "photon")

# }