Skip to contents

Reads a Diaspective Vision TIVITA *_SpecCube.dat recording through the tivis.r package and returns it as an hsi_cube.

Usage

hs_read_tivita(path, bands = NULL, verbose = TRUE)

Arguments

path

Path to a *_SpecCube.dat file.

bands

Optional integer vector of band indices to read. NULL (default) reads all bands.

verbose

Logical. Print progress messages. Default TRUE.

Value

An hsi_cube object. Values are calibrated reflectance, normally within [0, 1] but not clamped, since specular regions legitimately exceed it.

Details

Unlike the Cubert reader, this needs no vendor SDK: the TIVITA container is a plain binary format and tivis.r is pure R.

Acquisition metadata from the Suite's *_meta.log is attached to the cube when present, along with the paths of the parameter images the Suite exported beside the recording (RGB rendering, oxygenation, NIR perfusion, THI, TWI). Those are vendor outputs for comparison, not independent physiological ground truth or equivalents of this package's research indices.

See also

hs_read_cube() for extension-based dispatch, hs_read_cubert() for Cubert session files.

Examples

if (requireNamespace("tivis.r", quietly = TRUE)) {
  cube <- hs_read_tivita(tivis.r::tivis_example_file(), verbose = FALSE)
  dim(cube)
}
#> [1] 12 16  8