read_cid_spectravue_csv: Read File Saved by CID's SpectraVue.

In photobiologyInOut: Read Spectral and Logged Data from Foreign Files

Read File Saved by CID's SpectraVue.

Description

Read wavelength and spectral data from Measurements.CSV files exported from CID Bio-Sciences' SpectraVue CI-710s (not the older CI-710!) leaf spectrometer, importing them into R. Available metadata is also extracted from the file. Functio read_cid_spectravue_csv() only accepts "row oriented" CSV files. These may contain multiple spectra, one per row.

Usage

read_cid_spectravue_csv(
  file,
  date = NULL,
  geocode = NULL,
  label = NULL,
  tz = NULL,
  locale = readr::default_locale(),
  range = c(380, 1100),
  simplify = TRUE,
  absorbance.to = "object",
  strict.range = NA,
  ...
)

Arguments

file	character string Path to the file to be read, following R's use of forward slashes as separator for folder names.
date	a POSIXct object to use to set the "when.measured" attribute. If NULL, the default, the date is extracted from the file header.
geocode	A data frame with columns lon and lat, and optionally address used to set attribute "where.measured".
label	character string to which to set the "what.measured" attribute. If NULL the value of basename(file) is used, and if NA the "what.measured" attribute is not set.
tz	character A time zone recognized by R. If NULL, the default, it is extracted from 'locale'.
locale	The locale controls defaults that vary from place to place. The default locale is US-centric (like R), but you can use locale to create your own locale that controls things like the default time zone, encoding, decimal mark, big mark, and day/month names. Its value must match that used to write the imported file, which is not necessarily the default one or the local one.
range	a numeric vector of length two, or any other object for which function range() will return a range of wavelengths expressed in nanometres.
simplify	logical If TRUE, single spectra are returned as individual spectra instead of collections of length one.
absorbance.to	character Affects only absorbance measurements: "object", "all" or "A".
strict.range	logical Flag indicating whether off-range values result in an error (TRUE) instead of a warning (FALSE), or the test is disabled (NA).
...	additional arguments passed to the constructor of the 'filter_spct' object.

Details

SpectraVue's row-wise spectral Measurements.CSV files contain columns with metadata on the left edge, followed by columns with data for each of the 2048 pixels or wavelengths. The value in column "Mode" indicates the quantity measured, decoded into variables Tpc, Rpc or A. The data in each row of the CSV file are read and stored in a filter_spct, reflector_spct or object_spct object. These objects are collected into a single filter_mspct, reflector_mspct, object_mspct or generic_spct object and returned.

Spectral data outside the range 400 nm to 1000 nm are very noisy and thus outside the valid range for the measurements. Out-of-range spectral data can also be cause by calibration drift. Consequently, reading of data is done always with the range check disabled, while whether a check is used before returning the collection of spectra depends on the argument passed to strict.range which by default is set to disable checks. This is done, because in most cases measurements from this instrument tend to require further processing before they comply with theoretical expectations of Tfr + Rfr + Afr = 1.

Value

An object of class filter_spct, relector_spct, object_spct or generic_mspct.

Internal vs. total transmittance and absorbance

Spectravue returns transmittance values labelled with Transmittance as Mode. Transmittance values are not total as most of the scattered light transmitted is not detected. Absorbance (Abs) values returned labelled with Absorbance as Mode are for absorbance computed from the Transmittance. This estimate of absorbance overestimates real absorbance in the case of scattering materials like plant leaves. It is best to save spectral data acquired as absorbance into objects of class 'object_spct' containing reflectance and transmittance, the default, as this preserves all the acquired data.

Specular vs. total reflectance

This function assumes that SpectraVue returns close to total reflectance readings. Given the optics of the instrument this is likely only a weak approximation.

Warning!!

CID's support has answered on 2022-05-19 that the extremely biased (plainly wrong!) values of transmittance measured by this instrument are due to a design flaw and that they are working on a solution for the problem. In practice, reflectance seems biased but usable as an instrument-specific quantity with arbitrary units. Transmittance and absorbance seem useless as values are wrong by about an order of magnitude. As of 2025-06-29 they are still to contact me again.

Note

SpectraVue creates three or four .CSV files for each series of measurements saved. Of these files, this function reads the one with name ending in Measurements.CSV. The first part of the file name gives the time of the session, but as the files can contain multiple spectra measured at different times, the time metadata is extracted separately for each spectrum. We provide a default argument for range that discards data for short and long wavelengths because values outside this range are according to the instrument's manual outside the usable range and in practice extremely noisy.

References

https://cid-inc.com/

Examples

# read file containing a single reflectaance spectrum

 file.name <-
   system.file("extdata", "cid-spectravue-Rpc-Measurements.csv",
               package = "photobiologyInOut", mustWork = TRUE)

 cid_filter.spct <-
   read_cid_spectravue_csv(file = file.name)
 summary(cid_filter.spct)

 cid_filter.spct <-
   read_cid_spectravue_csv(file = file.name, simplify = FALSE)
 summary(cid_filter.spct)

 # read data measured as absorbance (A, Rpc and Tpc)

 file.name <-
   system.file("extdata", "cid-spectravue-Abs-Measurements.csv",
               package = "photobiologyInOut", mustWork = TRUE)
 cid.object_spct <-
   read_cid_spectravue_csv(file = file.name)
 summary(cid.object_spct)

 cid_A.filter_spct <-
   read_cid_spectravue_csv(file = file.name, absorbance.to = "A")
 summary(cid_A.filter_spct)

photobiologyInOut documentation built on Nov. 5, 2025, 6:24 p.m.