# kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling architecture

> Architecture diagram of the GitHub repository kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling
- Repository: https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling

## Overview

This repository is an offline seismic P-wave detection research system. Its primary workflow reads three-channel HDF5 records, preprocesses waveforms and creates Gaussian arrival targets, trains configurable U-Net++ models, then predicts arrivals and evaluates timing accuracy. Separate capabilities cover dataset auditing, waveform visualization, model/noise experiments, and an optional Bayesian magnitude-estimation extension. The graph follows documented capabilities and indexed imports; unsampled modules are included where their role is clear, but their internal call paths are not inferred.

Main entry points: [`src/earthquake_detection/inference/predict.py`](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/inference/predict.py) (Inference Engine), [`src/earthquake_detection/data/dataset.py`](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/data/dataset.py) (HDF5 Dataset), [`src/earthquake_detection/training/train.py`](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/training/train.py) (Training Coordinator), [`scripts/evaluate_model.py`](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/scripts/evaluate_model.py) (Evaluation Entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Seismic Data"]
  node_inspect_cli["Dataset Inspection<br/>[inspect_dataset.py]"]
  node_audit["Dataset Audit<br/>[dataset_audit.py]"]
  node_dataset["HDF5 Dataset<br/>[dataset.py]"]
  node_labels["Gaussian Targets<br/>[gaussian_labels.py]"]
end

subgraph group_signal["Signal Processing"]
  node_config["Experiment Config<br/>[config.py]"]
  node_filter["Bandpass Filter<br/>[filtering.py]"]
  node_normalize["Waveform Normalize<br/>[normalization.py]"]
  node_window["Trace Windowing<br/>[windowing.py]"]
  node_displacement["Displacement Features<br/>[displacement.py]"]
end

subgraph group_learning["Modeling and Training"]
  node_train_cli["Training Entry<br/>[train_model.py]"]
  node_train_flow["Training Coordinator<br/>[train.py]"]
  node_loss["Training Losses<br/>[losses.py]"]
  node_trainer["Trainer<br/>[trainer.py]"]
  node_unet["1D U-Net++<br/>[unetplusplus_1d.py]"]
  node_dilated["Dilated Blocks<br/>[dilated_blocks.py]"]
  node_attention["Self-Attention<br/>[attention.py]"]
end

subgraph group_operations["Prediction and Evaluation"]
  node_predict_cli["Prediction Entry<br/>[predict.py]"]
  node_predictor["Inference Engine<br/>[predict.py]"]
  node_decoder["Arrival Decoder<br/>[decoder.py]"]
  node_eval_cli["Evaluation Entry<br/>[evaluate_model.py]"]
  node_metrics["Detection Metrics<br/>[metrics.py]"]
  node_plots["Scientific Plots<br/>[plots.py]"]
end

subgraph group_research["Research Extensions"]
  node_noise_cli["Noise Experiment Entry"]
  node_noise["Noise Robustness"]
  node_magnitude["Bayesian Magnitude<br/>[mcmc_magnitude.py]"]
end

node_researcher(("Researcher"))
node_hdf5[("HDF5 Records")]

node_researcher -->|"inspects data"| node_inspect_cli
node_inspect_cli -->|"loads settings"| node_config
node_inspect_cli -->|"runs audit"| node_audit
node_hdf5 -->|"provides records"| node_dataset
node_dataset -->|"filters traces"| node_filter
node_dataset -->|"normalizes traces"| node_normalize
node_dataset -->|"derives features"| node_displacement
node_dataset -->|"generates targets"| node_labels
node_researcher -->|"trains model"| node_train_cli
node_train_cli -->|"loads settings"| node_config
node_train_cli -->|"starts training"| node_train_flow
node_train_flow -->|"creates splits"| node_dataset
node_train_flow -->|"builds model"| node_unet
node_train_flow -->|"builds loss"| node_loss
node_train_flow -->|"runs trainer"| node_trainer
node_unet -->|"uses blocks"| node_dilated
node_unet -->|"uses attention"| node_attention
node_researcher -->|"requests prediction"| node_predict_cli
node_predict_cli -->|"loads settings"| node_config
node_predict_cli -->|"requests prediction"| node_predictor
node_predictor -->|"filters input"| node_filter
node_predictor -->|"normalizes input"| node_normalize
node_predictor -->|"derives features"| node_displacement
node_predictor -->|"builds model"| node_unet
node_predictor -->|"decodes scores"| node_decoder
node_researcher -->|"evaluates model"| node_eval_cli
node_eval_cli -->|"loads records"| node_dataset
node_eval_cli -->|"predicts arrivals"| node_predictor
node_eval_cli -->|"computes metrics"| node_metrics
node_eval_cli -->|"plots results"| node_plots
node_researcher -->|"runs robustness study"| node_noise_cli
node_noise_cli -->|"runs experiment"| node_noise
node_noise -->|"tests predictions"| node_predictor
node_noise -->|"scores results"| node_metrics
node_researcher -.->|"explores extension"| node_magnitude

click node_inspect_cli "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/scripts/inspect_dataset.py"
click node_audit "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/data/dataset_audit.py"
click node_dataset "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/data/dataset.py"
click node_labels "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/data/gaussian_labels.py"
click node_config "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/config.py"
click node_filter "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/preprocessing/filtering.py"
click node_normalize "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/preprocessing/normalization.py"
click node_window "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/preprocessing/windowing.py"
click node_displacement "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/preprocessing/displacement.py"
click node_train_cli "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/scripts/train_model.py"
click node_train_flow "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/training/train.py"
click node_loss "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/training/losses.py"
click node_trainer "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/training/trainer.py"
click node_unet "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/models/unetplusplus_1d.py"
click node_dilated "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/models/dilated_blocks.py"
click node_attention "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/models/attention.py"
click node_predict_cli "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/scripts/predict.py"
click node_predictor "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/inference/predict.py"
click node_decoder "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/inference/decoder.py"
click node_eval_cli "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/scripts/evaluate_model.py"
click node_metrics "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/evaluation/metrics.py"
click node_plots "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/visualization/plots.py"
click node_noise_cli "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/scripts/run_noise_experiment.py"
click node_noise "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/experiments/noise_robustness.py"
click node_magnitude "https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/magnitude/mcmc_magnitude.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_inspect_cli,node_audit,node_dataset,node_labels toneBlue
class node_config,node_filter,node_normalize,node_window,node_displacement,node_hdf5 toneAmber
class node_train_cli,node_train_flow,node_loss,node_trainer,node_unet,node_dilated,node_attention toneMint
class node_predict_cli,node_predictor,node_decoder,node_eval_cli,node_metrics,node_plots toneRose
class node_noise_cli,node_noise,node_magnitude,node_researcher toneIndigo
```

## Components

### Seismic Data

- [Dataset Inspection](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/scripts/inspect_dataset.py): `scripts/inspect_dataset.py`
- [Dataset Audit](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/data/dataset_audit.py): `src/earthquake_detection/data/dataset_audit.py`
- [HDF5 Dataset](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/data/dataset.py): `src/earthquake_detection/data/dataset.py`
- [Gaussian Targets](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/data/gaussian_labels.py): `src/earthquake_detection/data/gaussian_labels.py`

### Signal Processing

- [Experiment Config](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/config.py): `src/earthquake_detection/config.py`
- [Bandpass Filter](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/preprocessing/filtering.py): `src/earthquake_detection/preprocessing/filtering.py`
- [Waveform Normalize](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/preprocessing/normalization.py): `src/earthquake_detection/preprocessing/normalization.py`
- [Trace Windowing](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/preprocessing/windowing.py): `src/earthquake_detection/preprocessing/windowing.py`
- [Displacement Features](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/preprocessing/displacement.py): `src/earthquake_detection/preprocessing/displacement.py`

### Modeling and Training

- [Training Entry](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/scripts/train_model.py): `scripts/train_model.py`
- [Training Coordinator](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/training/train.py): `src/earthquake_detection/training/train.py`
- [Training Losses](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/training/losses.py): `src/earthquake_detection/training/losses.py`
- [Trainer](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/training/trainer.py): `src/earthquake_detection/training/trainer.py`
- [1D U-Net++](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/models/unetplusplus_1d.py): `src/earthquake_detection/models/unetplusplus_1d.py`
- [Dilated Blocks](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/models/dilated_blocks.py): `src/earthquake_detection/models/dilated_blocks.py`
- [Self-Attention](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/models/attention.py): `src/earthquake_detection/models/attention.py`

### Prediction and Evaluation

- [Prediction Entry](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/scripts/predict.py): `scripts/predict.py`
- [Inference Engine](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/inference/predict.py): `src/earthquake_detection/inference/predict.py`
- [Arrival Decoder](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/inference/decoder.py): `src/earthquake_detection/inference/decoder.py`
- [Evaluation Entry](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/scripts/evaluate_model.py): `scripts/evaluate_model.py`
- [Detection Metrics](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/evaluation/metrics.py): `src/earthquake_detection/evaluation/metrics.py`
- [Scientific Plots](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/visualization/plots.py): `src/earthquake_detection/visualization/plots.py`

### Research Extensions

- [Noise Experiment Entry](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/scripts/run_noise_experiment.py): `scripts/run_noise_experiment.py`
- [Noise Robustness](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/experiments/noise_robustness.py): `src/earthquake_detection/experiments/noise_robustness.py`
- [Bayesian Magnitude](https://github.com/kmshivani05/earthquake-p-wave-detection-system-using-u-net-and-gaussian-labeling/blob/main/src/earthquake_detection/magnitude/mcmc_magnitude.py): `src/earthquake_detection/magnitude/mcmc_magnitude.py`

### Other components

- **Researcher**
- **HDF5 Records**

## Connections

- Researcher → Dataset Inspection: inspects data (evidence: `README.md`)
- Dataset Inspection → Experiment Config: loads settings (evidence: `scripts/inspect_dataset.py`)
- Dataset Inspection → Dataset Audit: runs audit (evidence: `scripts/inspect_dataset.py`)
- HDF5 Records → HDF5 Dataset: provides records (evidence: `src/earthquake_detection/data/dataset.py`)
- HDF5 Dataset → Bandpass Filter: filters traces (evidence: `src/earthquake_detection/data/dataset.py`)
- HDF5 Dataset → Waveform Normalize: normalizes traces (evidence: `src/earthquake_detection/data/dataset.py`)
- HDF5 Dataset → Displacement Features: derives features (evidence: `src/earthquake_detection/data/dataset.py`)
- HDF5 Dataset → Gaussian Targets: generates targets (evidence: `src/earthquake_detection/data/dataset.py`)
- Researcher → Training Entry: trains model (evidence: `README.md`)
- Training Entry → Experiment Config: loads settings (evidence: `scripts/train_model.py`)
- Training Entry → Training Coordinator: starts training (evidence: `scripts/train_model.py`)
- Training Coordinator → HDF5 Dataset: creates splits (evidence: `src/earthquake_detection/training/train.py`)
- Training Coordinator → 1D U-Net++: builds model (evidence: `src/earthquake_detection/training/train.py`)
- Training Coordinator → Training Losses: builds loss (evidence: `src/earthquake_detection/training/train.py`)
- Training Coordinator → Trainer: runs trainer (evidence: `src/earthquake_detection/training/train.py`)
- 1D U-Net++ → Dilated Blocks: uses blocks (evidence: `src/earthquake_detection/models/unetplusplus_1d.py`)
- 1D U-Net++ → Self-Attention: uses attention (evidence: `src/earthquake_detection/models/unetplusplus_1d.py`)
- Researcher → Prediction Entry: requests prediction (evidence: `README.md`)
- Prediction Entry → Experiment Config: loads settings (evidence: `scripts/predict.py`)
- Prediction Entry → Inference Engine: requests prediction (evidence: `scripts/predict.py`)
- Inference Engine → Bandpass Filter: filters input (evidence: `src/earthquake_detection/inference/predict.py`)
- Inference Engine → Waveform Normalize: normalizes input (evidence: `src/earthquake_detection/inference/predict.py`)
- Inference Engine → Displacement Features: derives features (evidence: `src/earthquake_detection/inference/predict.py`)
- Inference Engine → 1D U-Net++: builds model (evidence: `src/earthquake_detection/inference/predict.py`)
- Inference Engine → Arrival Decoder: decodes scores (evidence: `src/earthquake_detection/inference/predict.py`)
- Researcher → Evaluation Entry: evaluates model (evidence: `README.md`)
- Evaluation Entry → HDF5 Dataset: loads records (evidence: `scripts/evaluate_model.py`)
- Evaluation Entry → Inference Engine: predicts arrivals (evidence: `scripts/evaluate_model.py`)
- Evaluation Entry → Detection Metrics: computes metrics (evidence: `scripts/evaluate_model.py`)
- Evaluation Entry → Scientific Plots: plots results (evidence: `scripts/evaluate_model.py`)
- Researcher → Noise Experiment Entry: runs robustness study (evidence: `README.md`)
- Noise Experiment Entry → Noise Robustness: runs experiment (evidence: `scripts/run_noise_experiment.py`)
- Noise Robustness → Inference Engine: tests predictions (evidence: `src/earthquake_detection/experiments/noise_robustness.py`)
- Noise Robustness → Detection Metrics: scores results (evidence: `src/earthquake_detection/experiments/noise_robustness.py`)
- Researcher → Bayesian Magnitude: explores extension (evidence: `README.md`)
