Datasets
Two catalogs drive this analysis:- ESEC (Exotic Seismic Event Catalog): A curated database of non-tectonic events — including landslides, glacial calving events, and debris flows — sourced from IRIS SPUD. The master reference catalog is
Master_ESEC_Catalog_vel_all.csv, included in theesec_catalog_clustering/directory. - Tectonic EQ Catalog: A manually curated set of conventional tectonic earthquakes downloaded via IRIS Wilber 3. The master reference catalog is
Master_tectonic_eq_catalog.csv, also included in the directory.
Directory Structure
Theesec_catalog_clustering/ directory is organized as follows:
Step-by-Step Workflow
(To process from scratch)
1
Download and process ESEC data
Run
step1_esec_catalog_dataprepandprocess.py. This script reads Master_ESEC_Catalog_vel_all.csv, queries the IRIS web services, and downloads raw waveforms for each catalogued event. Remember to update the global path variables at the top of the file first.Output: Raw ESEC waveform files saved into esec_raw_data/.2
Process tectonic EQ data
Run
step2_tectonic_eq_dataprepandprocess.py. Because the tectonic earthquake data is manually downloaded via IRIS Wilber 3, this script focuses on applying standard signal processing routines — detrending, filtering, and instrument response removal — to the existing waveform files.Output: Processed velocity traces saved into eq_processed_vel/.3
Compute Spec2Vec features
Run
step3_spec2vec_metrics_prep.py. This script reads all processed waveforms from both catalogs, converts each trace to a spectrogram, and feeds the spectrograms through the GISQAPipeline to extract the full Spec2Vec feature suite.Output: Feature CSV files written to computed_dataset_files/, one per event class or combined, ready for analysis.4
Analyze and reproduce paper results
Open
spec2vec_analysis_notebooks/spec2vec_analysis_main.ipynb in Jupyter and run it from top to bottom. The notebook loads the feature CSVs from computed_dataset_files/, performs dimensionality reduction, clustering, and statistical comparisons, and regenerates the figures presented in the Spec2Vec publication.Optional Visualizations
After completing the core workflow, three additional scripts let you generate deeper visual analyses:- Reference input figures — Run
optional_input_figures_ref_prep.pyto generate reference plots of the raw input signals for both the ESEC and tectonic EQ catalogs. Outputs are saved toesec_spec2vec_ip_figures/andeq_spec2vec_ip_figures/(pre-generated figures are already included in those folders for immediate inspection). - Comprehensive metric plots — Run
optional_comprehensive_metrics_plots.pyto produce detailed visualizations of every computed Spec2Vec feature, useful for exploratory analysis and feature selection. Outputs are saved tocomprehensive_metrics_plots/. - Rolling analysis — Run
optional_esec_spec2vec_rolling_metrics_prep.pyto apply Spec2Vec on a rolling basis over N-second chunks of each time series rather than the full waveform. This sliding-window approach lets you track how spectral fingerprints evolve through an event and is particularly useful for long-duration exotic events such as sustained debris flows.