Metadata-Version: 2.4
Name: prismatools
Version: 0.1.4
Summary: prismatools is an open-source Python package for reading, analyzing, and visualizing hyperspectral imagery from the PRISMA mission.
Author-email: Lorenzo Crecco <lorenzo.crecco@hotmail.com>
License: MIT License
Project-URL: Homepage, https://github.com/gthlor/prismatools
Keywords: prismatools
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: affine
Requires-Dist: bqplot
Requires-Dist: h5py
Requires-Dist: ipyevents
Requires-Dist: ipyfilechooser
Requires-Dist: ipyleaflet
Requires-Dist: ipywidgets
Requires-Dist: leafmap
Requires-Dist: localtileserver
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: rioxarray
Requires-Dist: scikit-learn
Requires-Dist: xarray
Provides-Extra: all
Requires-Dist: prismatools[extra]; extra == "all"
Provides-Extra: extra
Requires-Dist: pandas; extra == "extra"
Dynamic: license-file

# Welcome to prismatools


[![PyPI](https://img.shields.io/pypi/v/prismatools.svg?color=red)](https://pypi.python.org/pypi/prismatools)
[![Conda](https://img.shields.io/conda/vn/conda-forge/prismatools.svg?color=green)](https://anaconda.org/conda-forge/prismatools)
[![Platform](https://img.shields.io/conda/pn/conda-forge/prismatools.svg?color=yellowgreen)](https://anaconda.org/conda-forge/prismatools)
![Python](https://img.shields.io/badge/language-python-brightgreen)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI Downloads](https://static.pepy.tech/personalized-badge/prismatools?period=total&units=INTERNATIONAL_SYSTEM&left_color=GRAY&right_color=red&left_text=downloads+%28pypi%29)](https://pepy.tech/projects/prismatools)
[![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/prismatools?label=downloads%20(conda)&color=green)](https://anaconda.org/conda-forge/prismatools)
![Status](https://img.shields.io/badge/status-active-magenta)
![Release Date](https://anaconda.org/conda-forge/prismatools/badges/latest_release_date.svg)

[![logo](https://raw.githubusercontent.com/gthlor/prismatools/main/docs/assets/logo150_nobg.png)](https://github.com/gthlor/prismatools/blob/main/docs/assets/logo150_nobg.png)


**prismatools** is an open-source Python package for reading, visualizing, and analyzing hyperspectral imagery from the PRISMA mission.

-   Documentation: <https://gthlor.github.io/prismatools>
-   PyPI: <https://pypi.org/project/prismatools/>
-   Conda-forge: <https://anaconda.org/conda-forge/prismatools>
-   Free software: [MIT License](https://opensource.org/licenses/MIT)

## Introduction

Hyperspectral remote sensing provides detailed information on the Earth's surface by capturing hundreds of contiguous, narrow spectral bands in the VNIR and SWIR ranges. This spectral richness allows scientists to analyze vegetation, water quality, soil properties, and many other environmental variables with unprecedented accuracy.

Launched in 2019 by the Italian Space Agency ([ASI](https://www.asi.it/)), **PR**ecursore **I**per**S**pettrale della **M**issione **A**pplicativa ([PRISMA](http://www.prisma-i.it/index.php/en))  is a spaceborne mission that delivers medium-resolution high-quality hyperspectral imagery (30m) combined with a panchromatic channel (5m). PRISMA products are distributed in multiple levels (L2B, L2C, L2D) and have become a key dataset for applications in agriculture, forestry, inland and coastal waters, geology, and climate studies.

With **prismatools**, researchers can explore PRISMA imagery interactively, extract meaningful biophysical information, and integrate the data into broader geospatial workflows.

## Features

- 📂 Read and Write PRISMA hyperspectral and panchromatic L2 products (L2D, L2B, L2C)
- 🎨 Visualize PRISMA data interactively (2D maps, RGB composites, custom band combinations)
- 📊 Analyze hyperspectral imagery (band math, vegetation indices, PCA)
- 🌍 Extract and plot spectral signatures from any pixel or region of interest
- 💾 Export spectral signatures as CSV files
- 🧩 Integrate seamlessly with popular Python libraries (xarray, rasterio, geopandas, matplotlib)

## Citations

If you find **prismatools** useful in your research, please consider citing the following paper:
[*DOI will be provided upon publication*].
Thank you!
