<p align="center">
<a href="" rel="noopener">
<img max-width=960px src="https://github.com/rbstabbins/sptk/blob/main/title.gif?raw=true" alt="Project logo"></a>
</p>
<h3 align="center">sptk: The Spectral Parameters Toolkit</h3>
<div align='center'>
[](https://doi.org/10.5281/zenodo.10692531)
</div>
---
<p align="center">
<strong>sptk</strong> 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.
<br>
</p>
## Table of Contents
- [Table of Contents](#table-of-contents)
- [About ](#about-)
- [Installing ](#installing-)
- [Prerequisites](#prerequisites)
- [Installing](#installing)
- [Running the Tests](#running-the-tests)
- [Running the Example Notebooks](#running-the-example-notebooks)
- [Authors](#authors)
- [Citing the Software](#citing-the-software)
- [Acknowledgements](#acknowledgements)
## About <a name = "about"></a>
**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 <a name = "installing"></a>
```sptk``` is available via PyPI.
We recommend downloading a copy of the [https://github.com/rbstabbins/sptk](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](https://zenodo.org/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<a name = "running-the-tests"></a>
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<a name = "running-the-example-notebooks"></a>
We recommend exploring the [example notebooks](./examples/) to become familiar with the software and the placement of directories in the repository.
Please follow the guidelines in the [README.md](./examples/README.md) to download the required [Example Dataset](https://zenodo.org/doi/10.5281/zenodo.10683367) 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<a name = "authors"></a>
The Spectral Parameters Toolkit was designed and developed by [@rbstabbins](https://github.com/rbstabbins).
See also the list of [contributors](https://github.com/rbstabbins/sptk/contributors) who participated in this project.
## Citing the Software<a name = "citing-the-software"></a>
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.10692531
## 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
Raw data
{
"_id": null,
"home_page": "https://github.com/rbstabbins/sptk",
"name": "sptk",
"maintainer": "Roger Stabbins",
"docs_url": null,
"requires_python": ">=3.10.8,<4.0.0",
"maintainer_email": "r.stabbins@nhm.ac.uk",
"keywords": "reflectance,spectroscopy,spectral imaging,planetary surfaces,remote sensing,spectral parameters",
"author": "Roger Stabbins",
"author_email": "r.stabbins@nhm.ac.uk",
"download_url": "https://files.pythonhosted.org/packages/00/63/613179529d14ac516938eda2149dbac878af618722cfbdf237f9e0af29d7/sptk-0.1.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a href=\"\" rel=\"noopener\">\n <img max-width=960px src=\"https://github.com/rbstabbins/sptk/blob/main/title.gif?raw=true\" alt=\"Project logo\"></a>\n</p>\n\n<h3 align=\"center\">sptk: The Spectral Parameters Toolkit</h3>\n\n<div align='center'>\n\n[](https://doi.org/10.5281/zenodo.10692531)\n\n</div>\n\n---\n\n<p align=\"center\">\n<strong>sptk</strong> 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.\n <br>\n</p>\n\n## Table of Contents\n\n- [Table of Contents](#table-of-contents)\n- [About ](#about-)\n- [Installing ](#installing-)\n - [Prerequisites](#prerequisites)\n - [Installing](#installing)\n- [Running the Tests](#running-the-tests)\n- [Running the Example Notebooks](#running-the-example-notebooks)\n- [Authors](#authors)\n- [Citing the Software](#citing-the-software)\n- [Acknowledgements](#acknowledgements)\n\n## About <a name = \"about\"></a>\n\n**sptk** provides a simple interface for:\n* simulating the spectral response of an instrument,\n* sampling a spectral library with the instrument,\n* measuring the reconstruction error of the instrument on the spectral library,\n* evaluating the spectral parameters afforded by the instrument,\n* evaluating and ranking the ability of the spectral parmameters, and spectral parameter combinations, to separate categories of materials.\n\n## Installing <a name = \"installing\"></a>\n\n```sptk``` is available via PyPI. \n\nWe recommend downloading a copy of the [https://github.com/rbstabbins/sptk](https://github.com/rbstabbins/sptk) repository, and running the unit tests and working through the example notebooks. \n\nTo 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](https://zenodo.org/doi/10.5281/zenodo.10683367).\n\n### Prerequisites\n\nFirst, prepare a new environment with Python=3.10.8, using your environment manager of choice. \n\nFor example, with conda:\n```\nconda env create -n sptk python=3.10.8\n```\nand activate the environment:\n```\nconda activate sptk\n```\n\nCurrently **sptk** is only available via pip, so make sure you have pip installed on your environment also, e.g.:\n\n```\nconda install pip\n```\n\n\n### Installing\n\nInstall the latest version of **sptk** with pip:\n\n```\npip install sptk\n```\nyou can also specify the version you'd like to install, e.g.:\n```\npip install sptk=0.1\n```\n\n## Running the Tests<a name = \"running-the-tests\"></a>\n\nThe ```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.\n\nThe unit tests can be executed by navigating to the ```sptk/tests``` directory and running:\n\n```\npython -m unittest -v\n```\n\nThe unit tests provided are comprehensive but not exhaustive. We recommend also executing the example notebooks to test and understand the software.\n\n## Running the Example Notebooks<a name = \"running-the-example-notebooks\"></a>\n\nWe recommend exploring the [example notebooks](./examples/) to become familiar with the software and the placement of directories in the repository.\n\nPlease follow the guidelines in the [README.md](./examples/README.md) to download the required [Example Dataset](https://zenodo.org/doi/10.5281/zenodo.10683367) for executing the example notebooks.\n\nThe ```sptk/tests/``` directory hosts a set of unit tests for each module of the **sptk** package. These have been written with\n\n## Authors<a name = \"authors\"></a>\n\nThe Spectral Parameters Toolkit was designed and developed by [@rbstabbins](https://github.com/rbstabbins).\n\nSee also the list of [contributors](https://github.com/rbstabbins/sptk/contributors) who participated in this project.\n\n## Citing the Software<a name = \"citing-the-software\"></a>\n\nIf you use **sptk** in your research, please provide acknowledgement to the authors with the following citation:\n\nRoger Stabbins, & Grindrod, P. (2024). rbstabbins/sptk: Release v0.1 (v0.1). Zenodo. https://doi.org/10.5281/zenodo.10692531\n\n## Acknowledgements\n\nThe development of this software has been funded by the following grants:\n- UK Space Agency Aurora Science Programme: Geochemistry to Geology for ExoMars 2020 visible to near infrared spectral variability ST/T001747/1\n- UK Space Agency Mars Exploration Science Standard Call 2023: Exploring the Limits of Material Discrimination with CaSSIS Multiband Imaging ST/Y005910/1",
"bugtrack_url": null,
"license": "MIT",
"summary": "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.",
"version": "0.1",
"project_urls": {
"Homepage": "https://github.com/rbstabbins/sptk",
"Repository": "https://github.com/rbstabbins/sptk"
},
"split_keywords": [
"reflectance",
"spectroscopy",
"spectral imaging",
"planetary surfaces",
"remote sensing",
"spectral parameters"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e3adae3631a48e96a8740684804bb5f901617a1d5f1563b9a68f2161d89c5a81",
"md5": "cdef51d8264ffe70dcd97bc29542094e",
"sha256": "5d2ec8a62d2b863923afbf8b0374f28d827807dbdd327970946cb5ffaf27ae1c"
},
"downloads": -1,
"filename": "sptk-0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cdef51d8264ffe70dcd97bc29542094e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10.8,<4.0.0",
"size": 67424,
"upload_time": "2024-02-22T16:33:49",
"upload_time_iso_8601": "2024-02-22T16:33:49.044722Z",
"url": "https://files.pythonhosted.org/packages/e3/ad/ae3631a48e96a8740684804bb5f901617a1d5f1563b9a68f2161d89c5a81/sptk-0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0063613179529d14ac516938eda2149dbac878af618722cfbdf237f9e0af29d7",
"md5": "97101ed1efcb9ef4d611bc8ad903d609",
"sha256": "9381e3a244cd8bc21fd7fd629c7ecf623600b3502b1c4a18c1ae152a5e976b2d"
},
"downloads": -1,
"filename": "sptk-0.1.tar.gz",
"has_sig": false,
"md5_digest": "97101ed1efcb9ef4d611bc8ad903d609",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10.8,<4.0.0",
"size": 63851,
"upload_time": "2024-02-22T16:33:50",
"upload_time_iso_8601": "2024-02-22T16:33:50.936430Z",
"url": "https://files.pythonhosted.org/packages/00/63/613179529d14ac516938eda2149dbac878af618722cfbdf237f9e0af29d7/sptk-0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-22 16:33:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rbstabbins",
"github_project": "sptk",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sptk"
}
JSON
