HyperCoast
A Python Package for Visualizing and Analyzing Hyperspectral Data in Coastal Environments
- Free software: MIT License
- Documentation: https://hypercoast.org
Introduction
HyperCoast is a Python package designed to provide an accessible and comprehensive set of tools for visualizing and analyzing hyperspectral data in coastal environments. Hyperspectral data refers to the information collected by sensors that capture light across a wide range of wavelengths, beyond what the human eye can see. This data allows scientists to detect and analyze various materials and conditions on the Earth's surface with great detail. Unlike multispectral data, which captures light in a limited number of broad wavelength bands (typically 3 to 10), hyperspectral data captures light in many narrow, contiguous wavelength bands, often numbering in the hundreds. This provides much more detailed spectral information. Leveraging the capabilities of popular packages like Leafmap and PyVista, HyperCoast streamlines the exploration and interpretation of complex hyperspectral remote sensing data from existing spaceborne and airborne missions. It is also poised to support future hyperspectral missions, such as NASA's SBG and GLIMR. It enables researchers and environmental managers to gain deeper insights into the dynamic processes occurring in aquatic environments.
HyperCoast supports the reading and visualization of hyperspectral data from various missions, including AVIRIS, NEON, PACE, EMIT, DESIS, PRISMA and ENMAP along with other datasets like ECOSTRESS. Users can interactively explore hyperspectral data, extract spectral signatures, change band combinations and colormaps, visualize data in 3D, and perform interactive slicing and thresholding operations (see Figure 1). Additionally, by leveraging the earthaccess package, HyperCoast provides tools for interactively searching NASA's hyperspectral data. This makes HyperCoast a versatile and powerful tool for working with hyperspectral data globally, with a particular focus on coastal regions.
Citations
If you find HyperCoast useful in your research, please consider citing the following papers to support us. Thank you!
- Liu, B., & Wu, Q. (2024). HyperCoast: A Python Package for Visualizing and Analyzing Hyperspectral Data in Coastal Environments. Journal of Open Source Software, 9(100), 7025. https://doi.org/10.21105/joss.07025.
Features
- Searching for NASA hyperspectral data interactively
- Performing atmospheric correction using Acolite
- Interactive visualization and analysis of hyperspectral data, such as AVIRIS, DESIS, EMIT, PACE, NEON AOP, Tanager, PRISMA and ENMAP
- Interactive visualization of NASA ECOSTRESS data
- Interactive visualization of PACE chlorophyll-a data
- Interactive extraction and visualization of spectral signatures
- Changing band combinations and colormaps interactively
- Visualizing hyperspectral data in 3D
- Visualizing ERA5 temperature data in 3D
- Interactive slicing and thresholding of hyperspectral data in 3D
- Saving spectral signatures as CSV files
QGIS Plugin
HyperCoast also provides a QGIS plugin for visualizing and analyzing hyperspectral data, including EMIT, PACE, DESIS, NEON, AVIRIS, PRISMA, EnMAP, Tanager, and Wyvern datasets.
To install the QGIS plugin, please follow the instructions in the QGIS Plugin README.
Check out this short video demo and full video tutorial on how to use the HyperCoast plugin in QGIS.
Demos
- Visualizing hyperspectral data in 3D (notebook)
- Interactive slicing of hyperspectral data in 3D (notebook)
- Interactive thresholding of hyperspectral data in 3D (notebook)
- Visualizing ERA5 temperature data in 3D (notebook)
- Changing band combinations and colormaps interactively (notebook)
Acknowledgement
The HyperCoast project draws inspiration from the nasa/EMIT-Data-Resources repository. Credits to the original authors. We also acknowledge the NASA EMIT program support through grant no. 80NSSC24K0865.
License
HyperCoast is released under the MIT License. However, some of the modules in HyperCoast adapt code from other open-source projects, which may have different licenses. Please refer to the license notice in each module for more information. Credits to the original authors.
- emit.py: Part of the code is adapted from the nasa/EMIT-Data-Resources repository, which is released under the Apache License 2.0.
- aviris.py: Part of the code is adapted from the jjmcnelis/aviris-ng-notebooks, which is released under the MIT License.
Contributors
 Bingqing Liu 💻 🎨 🤔 |
 Qiusheng Wu 💻 🎨 🚧 |
 Alex Leith 💻 👀 |
 arfy slowy 💻 🚧 |
 Guillermo E. Ponce-Campos 💻 🐛 |
 Carsten Lemmen 👀 |
 Advait Dhamorikar 💻 |
2 maintainers
Metadata
2 maintainers
Release files for HyperCoast 0.27.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hypercoast-0.27.0.tar.gz | 1.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hypercoast-0.27.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.3 MB
Release files / hypercoast-0.27.0.tar.gz
| Download URL | hypercoast-0.27.0.tar.gz |
|---|---|
| Size | 1.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4bc02336eda5e17fd7f36cd3f94288ee58410116fc40cb9bdfbb02baa4dae9c4
|
|
BLAKE2b-256 checksum How to use checksums |
63c5aa57a3152e646690e9df0c38a4a7c08419d515bd1f7d3459e72eeb48bd18
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.5
|
Release files / hypercoast-0.27.0-py3-none-any.whl
| Download URL | hypercoast-0.27.0-py3-none-any.whl |
|---|---|
| Size | 178.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
eb90c0eaa28893fb034a3e98bb676b4551d957858ed26e811ce3eaf6ba23d8ed
|
|
BLAKE2b-256 checksum How to use checksums |
5ac19a6e95d4e46ebe6d8b27c7c9554c5f03cca4e544a648b98e79d7ffb58a1d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.5
|
