> ## Documentation Index
> Fetch the complete documentation index at: https://spec2vec.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Spec2Vec: Interpretable Spectral Fingerprint Extraction

> Extract objective spectral fingerprints from any time-series or time-frequency representation. Interpretable, physics-aware signal characterization.

![Minimal Elegant Spec2vec Logo](https://mintlify.s3.us-west-1.amazonaws.com/spec2vec/logo/MinimalElegantSpec2VecLogo.png)

Spec2Vec is a Python framework that turns any 1D time-series or 2D time-frequency representation into a compact, interpretable "spectral fingerprint" — a vector of information-theoretic, statistical, and spatial metrics that uniquely characterizes a signal. Developed for geophysics and planetary exploration, it provides a transparent, physics-aware alternative to black-box deep learning for signal characterization and clustering. You can apply it to raw waveforms, STFT spectrograms, or continuous wavelet transforms with just a few lines of Python.

## Get Started

> [card] [Introduction](https://spec2vec.mintlify.site/introduction.md)
>
> Learn what Spec2Vec does, who it is for, and how it differs from black-box deep learning approaches.

> [card] [Installation](https://spec2vec.mintlify.site/installation.md)
>
> Set up your Python environment and install all required dependencies using conda or pip.

> [card] [Quickstart](https://spec2vec.mintlify.site/quickstart.md)
>
> Extract your first spectral fingerprint from a synthetic signal in just a few lines of Python.

> [card] [Concepts Overview](https://spec2vec.mintlify.site/concepts/overview.md)
>
> Understand the pipeline architecture — pointwise metrics, pairwise metrics, and Hilbert curve encoding.

## Applications

> [card] [Distributed Acoustic Sensing](https://spec2vec.mintlify.site/applications/das.md)
>
> Process and characterize fiber-optic DAS arrays using spectral fingerprints.

> [card] [ESEC Catalog Clustering](https://spec2vec.mintlify.site/applications/esec-clustering.md)
>
> Cluster tectonic and non-tectonic earthquakes by their textural and statistical properties.

> [card] [Synthetic Signal Clustering](https://spec2vec.mintlify.site/applications/synthetic-signals.md)
>
> Generate and cluster randomized geophysical waveforms using time-frequency fingerprints.

> [card] [Acoustic Signal Modeling](https://spec2vec.mintlify.site/applications/acoustic-modeling.md)
>
> Model waveforms propagating through heterogeneous media and distinguish them with Spec2Vec.

## How It Works

**1. Install Spec2Vec**

Clone the repository and install dependencies into a fresh conda environment with Python 3.10.

**2. Load Your Data**

Pass your 1D time-series or 2D spectrogram array directly to the `GISQAPipeline` — no special data format required.

**3. Extract Spectral Features**

Call `compute_pointwise_metrics_from_spec()` to receive a pandas DataFrame of interpretable spectral features ready for clustering, classification, or visualization.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.