How do I choose between STFT and CWT spectrograms?
How do I choose between STFT and CWT spectrograms?
- STFT (
stft_basic_spectogram) uses a fixed window size, which gives you uniform time-frequency resolution across the entire signal. It is faster to compute and works well for signals whose frequency content is roughly stationary over time. This is a good first choice for most workflows. - CWT (
cwt_simple) uses wavelets that automatically widen at low frequencies and narrow at high frequencies, giving multi-resolution coverage. This makes CWT better at capturing short-lived transient features that vary rapidly in time. The trade-off is higher computational cost.
What does `is_hilbertize` do?
What does `is_hilbertize` do?
is_hilbertize=1, Spec2Vec flattens your 2D spectrogram into a 1D array using a Hilbert curve before computing pointwise features. A Hilbert curve is a space-filling fractal path that visits every cell of a 2D grid exactly once while preserving spatial locality — pixels that are close in 2D remain close in the flattened 1D array.This step is required when your input is a 2D spectrogram image, because the underlying feature extractors (antropy, ordpy, tsfel) operate on 1D arrays. For direct 1D time-series input you can set is_hilbertize=0.Why does the first call take longer?
Why does the first call take longer?
What are `ordpydx` and `antropydx`?
What are `ordpydx` and `antropydx`?
ordpydxcontrols the embedding dimension used byordpy-based features (permutation entropy, statistical complexity, Fisher–Shannon information, and Rényi/Tsallis variants).antropydxcontrols the embedding dimension used byantropy-based features (approximate entropy, sample entropy, SVD entropy, and others).
How do I reproduce paper results without downloading raw data?
How do I reproduce paper results without downloading raw data?
- ESEC application: pre-computed features live in
computed_dataset_files/inside theesec_catalog_clustering/folder. - Synthetic geophysical signal clustering: pre-computed data is in
synth_geophysical_signal_clustering/data/.
My notebook can't find the data files. What should I check?
My notebook can't find the data files. What should I check?
- Change to the repository root before launching Jupyter:
- Check the path variables defined at the top of the notebook (usually named
DATA_DIR,data_path, or similar) and update them to match your local file structure. - Confirm the pre-computed files exist in the expected subdirectory by listing its contents:
Can I use Spec2Vec on non-geophysical time-series?
Can I use Spec2Vec on non-geophysical time-series?
- Biomedical signals — EEG, ECG, and EMG characterization
- Audio and acoustics — environmental sound clustering, music genre analysis
- Financial time-series — volatility regime detection
- Industrial monitoring — vibration and fault-signature classification
compute_pointwise_metrics_from_spec() as you would with any seismic waveform.What does `is_best_features=1` return?
What does `is_best_features=1` return?
is_best_features=1, Spec2Vec returns only the 5 most discriminating features identified in the Spec2Vec research rather than the full feature set:I get an import error for `jwave` or `jax`. How do I fix it?
I get an import error for `jwave` or `jax`. How do I fix it?
jwave and jax are optional dependencies used exclusively by the acoustic wave propagation modeling module (acoustic_signal_modeling/). They are not required for core Spec2Vec feature extraction.If you need them, install them with:GISQAPipeline, spectrogram generation, or any of the other application notebooks.pip install jax[cpu]. GPU-enabled builds require matching CUDA and cuDNN versions; consult the JAX installation guide for details.How do I run the time complexity benchmark on my hardware?
How do I run the time complexity benchmark on my hardware?
time_complexity_analysis/ folder and can be visualized with the accompanying notebook in that directory.What output format does Spec2Vec return?
What output format does Spec2Vec return?
compute_pointwise_metrics_from_spec() returns a pandas.DataFrame where:- Each row corresponds to one input signal (identified by the name string you passed in).
- Each column is a named feature metric (e.g.,
permutation_entropy_antropy,Lempel-Ziv complexity,Kurtosis).
available_features_list.txt at the repository root.Can I run Spec2Vec on a GPU?
Can I run Spec2Vec on a GPU?
- The
acoustic_signal_modeling/application uses jwave and JAX for physics-based wave propagation simulations. - When JAX is installed with the appropriate CUDA backend, these simulations will automatically leverage your GPU or TPU.