Function List
Contents
Scyllarus
Scyllarus is the main function in the toolbox. It provides a means to compute a hyperspectral data structure (HSZ) which contains photometric parameters and material information. It also provides a varied set of processing options and spectra representations. For convenience, the toolbox also includes the function RGB2FLA (see General Purpose Functions below).
Whenever this function is used for research purposes, please cite:
- A. Robles-Kelly and Cong Huynh, Imaging Spectroscopy for Scene Analysis, Springer, 2013.
Spectra Representation Functions
eval_gaussian_mixture: Evaluates spectra represented as a Gaussian mixture.
eval_nurbs: Evaluates spectra represented as a spline (NURBS). Whenever this function is used for research purposes, please cite
- C. P. Huynh and A. Robles-Kelly, "A NURBS-Based Spectral Reflectance Descriptor with Applications in Computer Vision and Pattern Recognition”, In Proceedings of the IEEE Conference on Computer Vision and Pattern Recognition, 2008.
get_gaussian_mixture: Represents raw spectra using a Gaussian mixture model.
get_nurbs: Computes the B-spline (NURBS) representation of the input spectra. When using this function, please cite:
- C. P. Huynh and A. Robles-Kelly, "A NURBS-Based Spectral Reflectance Descriptor with Applications in Computer Vision and Pattern Recognition”, In Proceedings of the IEEE Conference on Computer Vision and Pattern Recognition, 2008.
Input-Output Functions
FLAread: Reads a flat (FLA) file from disk.
FLAwrite: Writes a flat file (FLA) to disk.
HSZread: Loads a hyperspectral zipped file (HSZ) from disk.
HSZwrite: Writes a hyperspectral zipped file (HSZ) to disk.
SLZread: Reads a Scyllarus spectral library file (SLZ) from disk.
SLZwrite: Writes a spectral library file (SLZ) to disk.
Photogrammetry Functions
recover_dichromatic_parameters: Computes the dichromatic photometric parameters for an input hyperspectral image. Whenever this function is used for research purposes, please cite:
- L. Gu, A. Robles-Kelly and J. Zhou, “Efficient Estimation of Reflectance Parameters from Imaging Spectroscopy”, In IEEE Transactions on Image Processing. Vol 22(9), 3648-3663, 2013.
recover_global_illuminant: Recovers the global illuminant in the scene. Whenever this function is used for research purposes, please cite:
- C. P. Huynh and A. Robles-Kelly, “A Solution of the Dichromatic Model for Multispectral Photometric Invariance”, In International Journal of Computer Vision, Vol. 40(1), 1-27, 2010.
recover_materials: Recovers the scene materials and their abundances per pixel. Whenever this function is used for research purposes, please cite:
- C. P. Huynh and A. Robles-Kelly, “A Probabilistic Approach to Spectral Unmixing”, In Proceedings of the 13th Int Workshop on Structural and Syntactical Pattern Recognition (S+SSPR 2010), 344-353,2010.
recover_multi_illuminant: Computes the power spectrum of the illuminants in the scene. Whenever this function is used for research purposes, please cite:
- L. Gu, C. P. Huynh and A. Robles-Kelly, “Segmentation and Estimation of Spatially Varying Illumination”, In IEEE Transactions on Image Processing. In press, 2014.
General Purpose Functions
encode_HSZ: Encodes a Scyllarus data structure using spectral descriptors such as NURBS or Gaussian mixtures.
eval_HSZ: Evaluates a Scyllarus data structure which has been encoded using spectral descriptors such as NURBS or Gaussian mixtures so as to obtain a RAW HSZ.
L2_unmixing: Performs spectral unmixing using a regularised L2 norm. Whenever this function is used for research purposes, please cite:
- Y. Qian, S. Jia, J. Zhou and A. Robles-Kelly, “Hyperspectral Unmixing Via L1/2 Sparsity-constrained Nonnegative Matrix Factorization”. In IEEE Transactions on Geoscience and Remote Sensing, Vol. 49(11): 4282-4297, 2011.
mix_spectra: Computes the mixed spectra from a matrix of end members and abundances.
reconstruct_illuminant: Illuminant evaluation routine for HSZ data structures
reconstruct_image: Computes flat image (FLA) from an HSZ data structure.
reconstruct_reflectance: Reflectance evaluation routine for HSZ data structures.
reconstruct_specularity: Evaluates the image highlights as represented on a HSZ data structure.
recover_RGBImage: Computes a pseudo-colour image from either an HSZ or flat data structure using camera sensitivity functions.
resize_I: Resizes a hyperspectral image cube.
crop_I: Crops a hyperspectral image cube.
resize_image: Resizes a hyperspectral flat image (FLA) or HSZ data structure.
crop_image: Crops a hyperspectral image (FLA) or HSZ data structure.
RGB2FLA: Converts a trichromatic or monochrome image into a flat data structure (FLA). This function has been provided for the sake of convenience so as to allow Scyllarus to process trichromatic imagery in if required.
translate_HSZ: Re-evaluation routine for HSZ data structures.
translate_spectra: Re-evaluation routine for spectral data.
unmix_illuminant: Unmixes the illuminants in an HSZ data structure with respect to a library of canonical illuminants.
unmix_reflectance: Unmixes the reflectancde in an HSZ data structure with respect to a library of end members.
wavelength_subset: Returns the indices and values for the subset of wavelengths that are common to the input spectral data
HSZ2SLZ: Creates a spectral library (SLZ) data structure from an HSZ data structure.