Skip to contents

Mean and standard error from collection of spectra

Source: R/mspct.mean.se.r
s_mean_se.Rd

Method to compute the "parallel" mean and the SEM. The spectral values are summarised across members of a collection of spectra or of a spectral object containing multiple spectra in long form.

Usage

s_mean_se(x, na.rm, mult, ...)

# Default S3 method
s_mean_se(x, na.rm = FALSE, mult = 1, ...)

# S3 method for class 'generic_spct'
s_mean_se(x, na.rm = FALSE, mult = 1, ...)

# S3 method for class 'filter_mspct'
s_mean_se(x, na.rm = FALSE, mult = 1, ...)

# S3 method for class 'source_mspct'
s_mean_se(x, na.rm = FALSE, mult = 1, ...)

# S3 method for class 'response_mspct'
s_mean_se(x, na.rm = FALSE, mult = 1, ...)

# S3 method for class 'reflector_mspct'
s_mean_se(x, na.rm = FALSE, mult = 1, ...)

# S3 method for class 'calibration_mspct'
s_mean_se(x, na.rm = FALSE, mult = 1, ...)

# S3 method for class 'cps_mspct'
s_mean_se(x, na.rm = FALSE, mult = 1, ...)

# S3 method for class 'raw_mspct'
s_mean_se(x, na.rm = FALSE, mult = 1, ...)

Arguments

x

An R object Currently this package defines methods for collections of spectral objects.

na.rm

logical A value indicating whether NA values should be stripped before the computation proceeds.

mult

numeric number of multiples of standard error.

...

Further arguments passed to or from other methods.

Value

If x is a collection spectral of objects, such as a "filter_mspct" object, the returned object is of same class as the members of the collection, such as "filter_spct", containing the summary spectrum, with variables with names tagged for summaries other than mean or median.

Details

Method specializations compute the mean and SEM at each wavelength across a group of spectra stored in an object of one of the classes defined in package 'photobiology'. Omission of NAs is done separately at each wavelength. Interpolation is not applied, so all spectra in x must share the same set of wavelengths. An error is triggered if this condition is nor fulfilled. The value passed as argument to `mult`

Methods (by class)

  • s_mean_se(default):

  • s_mean_se(generic_spct):

  • s_mean_se(filter_mspct):

  • s_mean_se(source_mspct):

  • s_mean_se(response_mspct):

  • s_mean_se(reflector_mspct):

  • s_mean_se(calibration_mspct):

  • s_mean_se(cps_mspct):

  • s_mean_se(raw_mspct):

Note

Objects of classes raw_spct and cps_spct can contain data from multiple scans in multiple variables or "columns". The methods accept as arguments objects of these classes only if spectra contain data for a single spectrometer scan. In the case of cps_spct objects, a single column can also contain data from multiple scans spliced into a single variable.

See also

See mean for the mean() method to compute the mean and se for the method used to compute the standard error of the mean.

Examples

s_mean_se(sun_evening.mspct)
#> Object: source_spct [1,593 x 3]
#> Wavelength range 290-1000 nm, step 0.34-0.47 nm 
#> Label: Mean and SEM of 5 source_spct objects. 
#> Variables:
#>  w.length: Wavelength [nm]
#>  s.e.irrad: Spectral energy irradiance [W m-2 nm-1] 
#> --
#> # A tibble: 1,593 × 3
#>    w.length s.e.irrad s.e.irrad.se
#>       <dbl>     <dbl>        <dbl>
#>  1     290          0            0
#>  2     290.         0            0
#>  3     291.         0            0
#>  4     291.         0            0
#>  5     292.         0            0
#>  6     292.         0            0
#>  7     293.         0            0
#>  8     293.         0            0
#>  9     294.         0            0
#> 10     294.         0            0
#> # ℹ 1,583 more rows