# Spec2Vec - [Introduction to Spec2Vec: What It Does and Who It Is For](https://spec2vec.mintlify.app/introduction.md): Spec2VEC extracts physics-aware spectral embeddings from signals. Learn what it does, who it is for, and how it differs from black-box approaches. - [Install Spec2Vec and Set Up Your Python Environment](https://spec2vec.mintlify.app/installation.md): Step-by-step guide to installing Spec2Vec's Python dependencies using conda or pip. Includes optional jax/jwave for acoustic modeling. - [Extract Your First Spectral Fingerprint with Spec2Vec](https://spec2vec.mintlify.app/quickstart.md): Extract spectral fingerprints from raw 1D waveforms and 2D STFT spectrograms using Spec2Vec's GISQAPipeline in a few lines of Python. - [How Spec2Vec Works: Framework Architecture Overview](https://spec2vec.mintlify.app/concepts/overview.md): Understand Spec2Vec's two-stage architecture: pointwise (texture and spatial features) from individual time-series/spectrograms and pairwise (spatial features) against a noise reference bank filtering. - [Spectral Fingerprints: How Spec2Vec Encodes Signals](https://spec2vec.mintlify.app/concepts/spectral-fingerprints.md): Learn how Spec2Vec builds a unique spectral fingerprint using entropy, fractal, and statistical metrics extracted from time-frequency representations. - [GISQAPipeline: Spec2Vec Pointwise and Pairwise Features](https://spec2vec.mintlify.app/concepts/pipeline.md): Use GISQAPipeline to extract named spectral features from signals or spectrograms, with controls for normalization, embedding depth, and feature selection. - [Complete Feature Catalog: All 50+ Spec2Vec Metrics](https://spec2vec.mintlify.app/concepts/feature-catalog.md): Browse all 50+ spectral features available in Spec2Vec, organized by category: entropy, complexity, fractal dimension, and statistical measures. - [Applying Spec2Vec to Distributed Acoustic Sensing Arrays](https://spec2vec.mintlify.app/applications/das.md): Step-by-step guide to processing fiber-optic DAS array data with Spec2Vec: read HDF5 data, generate spectrograms, and extract spectral fingerprints. - [Seismic Event Clustering with Spec2Vec: ESEC Catalog](https://spec2vec.mintlify.app/applications/esec-clustering.md): Reproduce the ESEC catalog analysis: download seismic waveforms, compute Spec2Vec features, and cluster exotic vs. tectonic earthquake signatures. - [Clustering Synthetic Geophysical Signals with Spec2Vec](https://spec2vec.mintlify.app/applications/synthetic-signals.md): Validate Spec2Vec on synthetic geophysical waveforms representing T-phase earthquakes, Strombolian explosions, and surface wave dispersions. - [Acoustic Wave Propagation Modeling and Spec2Vec Analysis](https://spec2vec.mintlify.app/applications/acoustic-modeling.md): Build heterogeneous physical media, simulate acoustic wave propagation with the Simulator class, and analyze resulting waveforms using Spec2Vec features. - [GISQAPipeline API Reference: Methods and Parameters](https://spec2vec.mintlify.app/reference/api.md): Complete reference for GISQAPipeline: compute pointwise metrics, run pairwise spatial pipelines, build noise banks, and extract features from spectrograms. - [Spectrogram Functions: stft_basic_spectogram and cwt_simple](https://spec2vec.mintlify.app/reference/spectrogram-functions.md): Reference for stft_basic_spectogram and cwt_simple: convert 1D time-series into 2D time-frequency representations for Spec2Vec feature extraction. - [Spec2Vec Noise Generation and Synthetic Signal Utilities](https://spec2vec.mintlify.app/reference/noise-synthesis.md): Reference for Spec2Vec noise generation tools: ColoredNoiseGenerator, white_noise_series, AR-driven and PSD-driven series, and synthetic signal models. - [Spec2Vec Performance Benchmarks and Time Complexity](https://spec2vec.mintlify.app/reference/performance.md): Spec2Vec runtime scaling by resolution: benchmark results, optimization tips, and Numba warm-up guidance for large-batch spectrogram processing. - [Citing Spec2Vec in Your Research](https://spec2vec.mintlify.app/resources/citation.md): BibTeX entries and citation guidelines for the Spec2Vec framework and the accompanying paper currently in review at Geophysical Journal International. - [Spec2Vec FAQ and Troubleshooting Guide](https://spec2vec.mintlify.app/resources/faq.md): Answers to common questions about installing Spec2Vec, running notebooks, choosing between STFT and CWT, and interpreting spectral features. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.