# quinnsmitth/neuropedal architecture

> Architecture diagram of the GitHub repository quinnsmitth/neuropedal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/quinnsmitth/neuropedal
- Repository: https://github.com/quinnsmitth/neuropedal

## Overview

Neuropedal predicts guitar-pedal drive and tone settings from audio, and also includes training, evaluation, and audio-feature utilities. The primary user workflow is selecting a WAV in the GUI, preprocessing it, running inference, and displaying the prediction. The graph also preserves the documented training and analysis capabilities. Some implementation details are unsampled; edges are limited to relationships shown in excerpts, the SOURCE INDEX, or the README.

Main entry points: [`src/Classification/infer.py`](https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/infer.py) (Inference GUI), [`src/select_path.py`](https://github.com/quinnsmitth/neuropedal/blob/main/src/select_path.py) (Data-root selection), [`src/Classification/evaluate_model.py`](https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/evaluate_model.py) (Model evaluation), [`src/Classification/visualize_results.py`](https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/visualize_results.py) (Result visualization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_prediction["Prediction"]
  node_inference_gui["Inference GUI<br/>[infer.py]"]
  node_audio_preprocessing["Audio preprocessing<br/>[infer.py]"]
  node_mel_transform["Mel transform<br/>[melSpec.py]"]
  node_pedal_regressor["Pedal regressor<br/>[model.py]"]
end

subgraph group_learning["Model learning"]
  node_training_dataset["Training dataset<br/>[melDataLoader.py]"]
  node_training_pipeline["Training pipeline<br/>[melTrain.py]"]
  node_model_weights["Trained weights"]
end

subgraph group_analysis["Analysis"]
  node_model_evaluation["Model evaluation<br/>[evaluate_model.py]"]
  node_result_visualization["Result visualization"]
end

subgraph group_audio_tools["Audio utilities"]
  node_data_root["Data-root selection<br/>[select_path.py]"]
  node_feature_extraction["MFCC extraction"]
  node_feature_store["Feature CSV"]
  node_midi_renderer["MIDI rendering<br/>[render_to_wav.py]"]
end

node_guitarist(("Guitarist"))
node_fluidsynth["FluidSynth"]

node_guitarist -->|"selects WAV"| node_inference_gui
node_inference_gui -->|"preprocesses audio"| node_audio_preprocessing
node_audio_preprocessing -->|"returns Mel input"| node_inference_gui
node_inference_gui -.->|"runs prediction"| node_pedal_regressor
node_inference_gui -->|"displays settings"| node_guitarist
node_training_pipeline -->|"loads batches"| node_training_dataset
node_training_dataset -->|"converts audio"| node_mel_transform
node_training_pipeline -->|"saves weights"| node_model_weights
node_model_evaluation -->|"evaluates model"| node_pedal_regressor
node_model_evaluation -->|"preprocesses audio"| node_mel_transform
node_model_evaluation -.->|"loads data path"| node_data_root
node_result_visualization -->|"runs predictions"| node_pedal_regressor
node_result_visualization -->|"preprocesses audio"| node_mel_transform
node_result_visualization -.->|"loads data path"| node_data_root
node_feature_extraction -->|"loads data path"| node_data_root
node_feature_extraction -->|"writes features"| node_feature_store
node_midi_renderer -->|"loads data path"| node_data_root
node_midi_renderer -->|"renders MIDI"| node_fluidsynth

click node_inference_gui "https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/infer.py"
click node_audio_preprocessing "https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/infer.py"
click node_mel_transform "https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/melSpec.py"
click node_pedal_regressor "https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/model.py"
click node_data_root "https://github.com/quinnsmitth/neuropedal/blob/main/src/select_path.py"
click node_training_dataset "https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/melDataLoader.py"
click node_training_pipeline "https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/melTrain.py"
click node_model_weights "https://github.com/quinnsmitth/neuropedal/blob/main/weights/guitar_model_mel_36300_100.pth"
click node_model_evaluation "https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/evaluate_model.py"
click node_result_visualization "https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/visualize_results.py"
click node_feature_extraction "https://github.com/quinnsmitth/neuropedal/blob/main/src/extract_features.py"
click node_midi_renderer "https://github.com/quinnsmitth/neuropedal/blob/main/src/render_to_wav.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_inference_gui,node_audio_preprocessing,node_mel_transform,node_pedal_regressor toneBlue
class node_training_dataset,node_training_pipeline,node_model_weights toneAmber
class node_model_evaluation,node_result_visualization toneMint
class node_data_root,node_feature_extraction,node_feature_store,node_midi_renderer toneRose
class node_guitarist,node_fluidsynth toneIndigo
```

## Components

### Prediction

- [Inference GUI](https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/infer.py): `src/Classification/infer.py`
- [Audio preprocessing](https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/infer.py): `src/Classification/infer.py`
- [Mel transform](https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/melSpec.py): `src/Classification/melSpec.py`
- [Pedal regressor](https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/model.py): `src/Classification/model.py`

### Model learning

- [Training dataset](https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/melDataLoader.py): `src/Classification/melDataLoader.py`
- [Training pipeline](https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/melTrain.py): `src/Classification/melTrain.py`
- [Trained weights](https://github.com/quinnsmitth/neuropedal/blob/main/weights/guitar_model_mel_36300_100.pth): `weights/guitar_model_mel_36300_100.pth`

### Analysis

- [Model evaluation](https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/evaluate_model.py): `src/Classification/evaluate_model.py`
- [Result visualization](https://github.com/quinnsmitth/neuropedal/blob/main/src/Classification/visualize_results.py): `src/Classification/visualize_results.py`

### Audio utilities

- [Data-root selection](https://github.com/quinnsmitth/neuropedal/blob/main/src/select_path.py): `src/select_path.py`
- [MFCC extraction](https://github.com/quinnsmitth/neuropedal/blob/main/src/extract_features.py): `src/extract_features.py`
- **Feature CSV**
- [MIDI rendering](https://github.com/quinnsmitth/neuropedal/blob/main/src/render_to_wav.py): `src/render_to_wav.py`

### Other components

- **Guitarist**
- **FluidSynth**

## Connections

- Guitarist → Inference GUI: selects WAV (evidence: `README.md`)
- Inference GUI → Audio preprocessing: preprocesses audio (evidence: `src/Classification/infer.py`)
- Audio preprocessing → Inference GUI: returns Mel input (evidence: `src/Classification/infer.py`)
- Inference GUI → Pedal regressor: runs prediction
- Inference GUI → Guitarist: displays settings (evidence: `README.md`)
- Training pipeline → Training dataset: loads batches (evidence: `src/Classification/melTrain.py`)
- Training dataset → Mel transform: converts audio (evidence: `src/Classification/melDataLoader.py`)
- Training pipeline → Trained weights: saves weights (evidence: `src/Classification/melTrain.py`)
- Model evaluation → Pedal regressor: evaluates model (evidence: `src/Classification/evaluate_model.py`)
- Model evaluation → Mel transform: preprocesses audio (evidence: `src/Classification/evaluate_model.py`)
- Model evaluation → Data-root selection: loads data path (evidence: `src/Classification/evaluate_model.py`)
- Result visualization → Pedal regressor: runs predictions (evidence: `src/Classification/visualize_results.py`)
- Result visualization → Mel transform: preprocesses audio (evidence: `src/Classification/visualize_results.py`)
- Result visualization → Data-root selection: loads data path (evidence: `src/Classification/visualize_results.py`)
- MFCC extraction → Data-root selection: loads data path (evidence: `src/extract_features.py`)
- MFCC extraction → Feature CSV: writes features (evidence: `src/extract_features.py`)
- MIDI rendering → Data-root selection: loads data path (evidence: `src/render_to_wav.py`)
- MIDI rendering → FluidSynth: renders MIDI (evidence: `src/render_to_wav.py`)
