sptk: The Spectral Parameters Toolkit

---

sptk is a Python package for investigating the ability of a multispectral imaging system to identify distinct materials and material groups through differences in reflectance spectra.

Table of Contents

• Table of Contents
• About
• Installing
  • Prerequisites
  • Installing
• Running the Tests
• Running the Example Notebooks
• Authors
• Citing the Software
• Acknowledgements

About

sptk provides a simple interface for:

• simulating the spectral response of an instrument,
• sampling a spectral library with the instrument,
• measuring the reconstruction error of the instrument on the spectral library,
• evaluating the spectral parameters afforded by the instrument,
• evaluating and ranking the ability of the spectral parmameters, and spectral parameter combinations, to separate categories of materials.

Installing

sptk is available via PyPI.

We recommend downloading a copy of the https://github.com/rbstabbins/sptk repository, and running the unit tests and working through the example notebooks.

To run the example notebooks you'll also need to download the accompanying Example Dataset, hosted in the following Zenodo repository: doi:10.5281/zenodo.10683367.

Prerequisites

First, prepare a new environment with Python=3.10.8, using your environment manager of choice.

For example, with conda:

conda env create -n sptk python=3.10.8

and activate the environment:

conda activate sptk

Currently sptk is only available via pip, so make sure you have pip installed on your environment also, e.g.:

conda install pip

Installing

Install the latest version of sptk with pip:

pip install sptk

you can also specify the version you'd like to install, e.g.:

pip install sptk=0.1

Running the Tests

The sptk/tests/ directory hosts a set of unit tests for each module of the sptk package. These have been written for the unittest unit testing framework.

The unit tests can be executed by navigating to the sptk/tests directory and running:

python -m unittest -v

The unit tests provided are comprehensive but not exhaustive. We recommend also executing the example notebooks to test and understand the software.

Running the Example Notebooks

We recommend exploring the example notebooks to become familiar with the software and the placement of directories in the repository.

Please follow the guidelines in the README.md to download the required Example Dataset for executing the example notebooks.

The sptk/tests/ directory hosts a set of unit tests for each module of the sptk package. These have been written with

Authors

The Spectral Parameters Toolkit was designed and developed by @rbstabbins.

See also the list of contributors who participated in this project.

Citing the Software

If you use sptk in your research, please provide acknowledgement to the authors with the following citation:

Roger Stabbins, & Grindrod, P. (2024). rbstabbins/sptk: Release v0.1 (v0.1). Zenodo. https://doi.org/10.5281/zenodo.10694286

Acknowledgements

The development of this software has been funded by the following grants:

• UK Space Agency Aurora Science Programme: Geochemistry to Geology for ExoMars 2020 visible to near infrared spectral variability ST/T001747/1
• UK Space Agency Mars Exploration Science Standard Call 2023: Exploring the Limits of Material Discrimination with CaSSIS Multiband Imaging ST/Y005910/1