spbparser

Header only Spectral Binary Format utils.

Just include header of the required file from ìnclude folder. All files are provided with spb namespace.

WARNING

The parser is tested in a little endian machine. Though we check if the case is otherwise for a given machine before proceeding further, it is not heavily tested.

The specification of spb format does not allow heterogeneous spds to be serialized. Resampling of your original spds might be necessary before proceeding with serialization.

Dependency

• None. We are not even using STL or vectors. Probably can be ported to C with a little work.

• Should be mostly C++98 compliant as well.

Features

• Reader
• Writer

SPectral Binary Specification Summary

File section	Bytes
File identifier ’SPB’	3
Header Part
Image width x	4
Image height y	4
Number of spectral channels n	4
First wavelength	4
Wavelength Resolution	4
Last Wavelength	4
Image Data	x*y*n*4

Image data is written to the file in column order and values are stored in little endian form. Dimensions (x,y and n) are stored in uint32-format and wavelength values in float32-format. Spectral image values are reflectance values stored as float32.

Usage

To read an spb file:

c++

#include <spb/spbreader.hpp>

const char *path = "path/to/my/file.spb";

uint32_t width, height, nb_channels;
float first_wavelength, wavelength_resolution;
float last_wavelength;

spb::read_header(path, width, height, nb_channels,
                 first_wavelength, wavelength_resolution,
                 last_wavelength);
float *data = new float[width * height * nb_channels];
spb::read_file(path, width, height, nb_channels, data);

To write an spb file:

c++

#include <spb/spbwriter.hpp>

const char *path = "path/to/my/outfile.spb";

MyCustomSpd spectrum();
/**
some operations ...
.
.
.
*/

uint32_t width = spectrum.image_width();
uint32_t height = spectrum.image_height();
uint32_t nb_spectral_channels =  spectrum.nb_channels();
float first_wavelength = spectrum.first_wavelength();
float wavelength_resolution = spectrum.wavelength_resolution();
float last_wavelength = spectrum.last_wavelength();
float *data = new float[width * height * nb_spectral_channels];
spectrum.put_data(data);

spb::write_file(path, width, height, nb_channels,
                first_wavelength, wavelength_resolution,
                last_wavelength, data);