speclib
Federated spectral signature library with Kentucky-focused collections
Overview
speclib aggregates reflectance spectra from major public spectral libraries into a unified, searchable platform. It provides a Python package for researchers, a static web viewer for discovery, and an optional self-hosted API for power users.
The library federates spectra from USGS Spectral Library v7, ECOSTRESS, ASTER/JPL, and EMIT L2B, with a dedicated Kentucky chapter seeded with invasive species spectral data from Lyons et al. (2024).
Features
- Federated ingestion from USGS splib07, ECOSTRESS, ASTER/JPL, and EMIT L2B
- Dual storage — HDF5 archival backend + Parquet query layer
- Export to .esl (Esri), .sli (ENVI), SPECPR binary, ASCII, JSON
- Spectral resampling to Landsat, Sentinel-2, AVIRIS, EMIT, and custom sensors
- Static web viewer on GitHub Pages with D3.js interactive spectral plots
- Optional FastAPI server with REST API and Jinja templates
- Kentucky chapter with invasive species, mineral, and reclamation spectra
Getting Started
Prerequisites
- Python 3.11+
- pip
Installation
pip install speclib
With optional dependencies:
pip install speclib[server] # FastAPI server
pip install speclib[emit] # EMIT L2B support (netCDF4)
pip install speclib[all] # Everything including dev tools
Quick Start
from speclib import SpectralLibrary
# Load the library from an HDF5 archive
lib = SpectralLibrary.from_hdf5("speclib_archive.h5")
# Search for quartz spectra
results = lib.search("quartz", category="MINERAL")
# Plot a spectrum
results[0].plot()
# Export to Esri Spectral Library format
results[0].export("quartz.esl", format="esl")
# Resample to Landsat 8 OLI bands
resampled = results[0].resample("L8_OLI")
CLI
speclib ingest usgs --config data/upstream/usgs_splib07.yaml
speclib search "honeysuckle" --category KY_INVASIVE
speclib export usgs_mineral_quartz_a1b2c3d4 --format sli --output quartz.sli
speclib build
speclib serve
Web Viewer
Browse the spectral library at: https://chrislyonsKY.github.io/speclib/
Data Sources
| Source | License | Description |
|---|---|---|
| USGS Spectral Library v7 | US Public Domain | Minerals, rocks, soils, vegetation, manmade materials |
| ECOSTRESS Spectral Library | CC0 / Public Domain | Minerals, vegetation, soils, water, manmade |
| ASTER/JPL Spectral Library | NASA Open Data | Minerals, rocks, soils |
| EMIT L2B | NASA Open Data | Spaceborne mineral identification spectra |
| Kentucky Field Data | CC-BY-4.0 | Invasive species spectra (Lyons et al. 2024) |
Citation
@software{lyons2026speclib,
author = {Lyons, Chris},
title = {speclib: Federated Spectral Signature Library},
year = {2026},
url = {https://github.com/chrislyonsKY/speclib},
doi = {10.5281/zenodo.19390679},
license = {GPL-3.0}
}
Contributing
See CONTRIBUTING.md.
Security
See SECURITY.md for reporting vulnerabilities.
License
GPL-3.0-only — see LICENSE for details.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file speclib-1.0.1.tar.gz.
File metadata
- Download URL: speclib-1.0.1.tar.gz
- Upload date:
- Size: 44.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
17228f6185c7b382845dc3b828ef4625801685db8d3cdf7f83066f4d7e018e18
|
|
| MD5 |
aead4871241a2c5d5e42f6316cde0c55
|
|
| BLAKE2b-256 |
dc5d493cb1e62a00755096614f730a7c67e963e8213a814ce1e137d992949c95
|
Provenance
The following attestation bundles were made for speclib-1.0.1.tar.gz:
Publisher:
publish.yml on chrislyonsKY/speclib
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
speclib-1.0.1.tar.gz -
Subject digest:
17228f6185c7b382845dc3b828ef4625801685db8d3cdf7f83066f4d7e018e18 - Sigstore transparency entry: 1218446081
- Sigstore integration time:
-
Permalink:
chrislyonsKY/speclib@1d671dd271abca3dfb8cbcb580a9eb01a33e3970 -
Branch / Tag:
refs/tags/v1.0.1 - Owner: https://github.com/chrislyonsKY
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1d671dd271abca3dfb8cbcb580a9eb01a33e3970 -
Trigger Event:
release
-
Statement type:
File details
Details for the file speclib-1.0.1-py3-none-any.whl.
File metadata
- Download URL: speclib-1.0.1-py3-none-any.whl
- Upload date:
- Size: 34.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
69817eed8076823be5065228251960eaa41e332ab13added279f24b99e50db73
|
|
| MD5 |
a934c3aaa17e409e3e3710428375f418
|
|
| BLAKE2b-256 |
e10cd353ac0568d66ea23d0337fad0891e73932ac9f1b1eb5b304f15f4bfb2c5
|
Provenance
The following attestation bundles were made for speclib-1.0.1-py3-none-any.whl:
Publisher:
publish.yml on chrislyonsKY/speclib
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
speclib-1.0.1-py3-none-any.whl -
Subject digest:
69817eed8076823be5065228251960eaa41e332ab13added279f24b99e50db73 - Sigstore transparency entry: 1218446167
- Sigstore integration time:
-
Permalink:
chrislyonsKY/speclib@1d671dd271abca3dfb8cbcb580a9eb01a33e3970 -
Branch / Tag:
refs/tags/v1.0.1 - Owner: https://github.com/chrislyonsKY
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1d671dd271abca3dfb8cbcb580a9eb01a33e3970 -
Trigger Event:
release
-
Statement type:
