# thomeou/salsa-lite architecture

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

- Interactive diagram: https://gitdiagram.com/thomeou/salsa-lite
- Repository: https://github.com/thomeou/salsa-lite

## Overview

SALSA-Lite is a research workflow for polyphonic sound event localization and detection (SELD): multichannel microphone audio is converted into SALSA-Lite features, then used to train or run a CRNN that detects sound classes and estimates event directions and timing. The README also describes dataset preparation, alternative feature comparisons, and evaluation results. The supplied tree contains no implementation files, so component paths and internal call wiring cannot be verified; the links below reflect only documented data flow.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Dataset"]
  node_audio[("MIC audio")]
  node_metadata[("Event metadata")]
  node_prepare["Dataset preparation"]
end

subgraph group_features["Feature extraction"]
  node_extract["Feature extraction"]
  node_salsalite["SALSA-Lite NIPD"]
  node_alternatives["Feature alternatives"]
end

subgraph group_model["SELD model"]
  node_train["CRNN training"]
  node_crnn["CRNN inference"]
  node_seld["SELD events"]
end

subgraph group_evaluation["Evaluation"]
  node_evaluate["Performance evaluation"]
  node_results["SELD metrics"]
end

node_researcher(("Researcher"))

node_researcher -->|"prepares data"| node_prepare
node_audio -->|"provides recordings"| node_prepare
node_metadata -->|"provides labels"| node_prepare
node_prepare -->|"supplies audio"| node_extract
node_extract -->|"computes features"| node_salsalite
node_salsalite -->|"provides features"| node_train
node_metadata -->|"provides targets"| node_train
node_train -->|"produces model"| node_crnn
node_salsalite -->|"provides features"| node_crnn
node_crnn -->|"predicts events"| node_seld
node_seld -->|"supplies predictions"| node_evaluate
node_metadata -->|"supplies references"| node_evaluate
node_evaluate -->|"reports metrics"| node_results
node_researcher -.->|"compares features"| node_alternatives

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_audio,node_metadata,node_prepare toneBlue
class node_extract,node_salsalite,node_alternatives toneAmber
class node_train,node_crnn,node_seld toneMint
class node_evaluate,node_results toneRose
class node_researcher toneIndigo
```

## Components

### Dataset

- **MIC audio**
- **Event metadata**
- **Dataset preparation**

### Feature extraction

- **Feature extraction**
- **SALSA-Lite NIPD**
- **Feature alternatives**

### SELD model

- **CRNN training**
- **CRNN inference**
- **SELD events**

### Evaluation

- **Performance evaluation**
- **SELD metrics**

### Other components

- **Researcher**

## Connections

- Researcher → Dataset preparation: prepares data
- MIC audio → Dataset preparation: provides recordings
- Event metadata → Dataset preparation: provides labels
- Dataset preparation → Feature extraction: supplies audio
- Feature extraction → SALSA-Lite NIPD: computes features
- SALSA-Lite NIPD → CRNN training: provides features
- Event metadata → CRNN training: provides targets
- CRNN training → CRNN inference: produces model
- SALSA-Lite NIPD → CRNN inference: provides features
- CRNN inference → SELD events: predicts events
- SELD events → Performance evaluation: supplies predictions
- Event metadata → Performance evaluation: supplies references
- Performance evaluation → SELD metrics: reports metrics
- Researcher → Feature alternatives: compares features