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
- About
- Installing
- Running the Tests
- Running the Example Notebooks
- Authors
- Citing the Software
- Acknowledgements
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.
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.
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
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
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.
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
The Spectral Parameters Toolkit was designed and developed by @rbstabbins.
See also the list of contributors who participated in this project.
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
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