# Acoustic Reflection Analysis

## Überblick
Dieses Repository dokumentiert das Experiment **acoustic_reflection_analysis**. Ziel ist die Untersuchung akustischer Reflexionen in einem urbanen Raum, einschließlich der Aufzeichnung, Analyse und Visualisierung der Klangdaten.

**Link zum Artikel:** [Echo im Glasinnenhof – Akustische Spiegelungen](https://donau2space.de/echo-im-glasinnenhof-akustische-spiegelungen/)

**Git Repository:** [https://git.donau2space.de/Mika/acoustic_reflection_analysis](https://git.donau2space.de/Mika/acoustic_reflection_analysis)

### Hinweis
Alle Inhalte wurden per KI generiert.  
Nutzung, Anpassung und Weiterentwicklung erfolgen eigenverantwortlich auf eigenes Risiko.  
Es wird keine Korrektheit, Sicherheit, Funktionsfähigkeit oder rechtliche Eignung zugesichert.

## Inhalt des Repositories
Dieses Repository enthält mehrere Python-Skripte zur Erfassung, Analyse und Darstellung akustischer Daten.

### 1. acoustic_recorder
- **Art:** python_script  
- **Zielplattform:** linux-userspace  
- **Sprachen:** Python  
- **Zweck:** Aufnahme und Speicherung von Audiodaten über Mikrofone.  
- **API-Funktion:**  
  - `record_audio(duration)` → zeichnet Audiodaten über die angegebene Dauer auf und gibt sie zurück.

### 2. fft_analysis
- **Art:** python_script  
- **Zielplattform:** linux-userspace  
- **Sprachen:** Python  
- **Zweck:** Durchführung einer FFT-Analyse (Fast Fourier Transformation) zur Bestimmung der Frequenzanteile der aufgenommenen Audiodaten.  
- **API-Funktion:**  
  - `perform_fft(audio_data)` → berechnet das Frequenzspektrum der gegebenen Audiodaten.

### 3. data_visualization
- **Art:** python_script  
- **Zielplattform:** mixed  
- **Sprachen:** Python  
- **Zweck:** Visualisierung der berechneten Frequenzspektren.  
- **API-Funktion:**  
  - `plot_spectrum(frequency_data)` → erzeugt eine grafische Darstellung der Frequenzdaten.

## Installation & Nutzung
### Voraussetzungen
- Linux- oder kompatibles System mit Python 3.8 oder höher.
- Installierte Bibliotheken: `numpy`, `matplotlib`, `scipy`, `sounddevice`.

### Installation
1. Repository klonen:  
   `git clone https://git.donau2space.de/Mika/acoustic_reflection_analysis`
2. Verzeichnis wechseln:  
   `cd acoustic_reflection_analysis`
3. Abhängigkeiten installieren:  
   `pip install -r requirements.txt`

### Nutzung
1. Aufnahme starten:  
   `python acoustic_recorder.py`
2. FFT-Analyse durchführen:  
   `python fft_analysis.py`
3. Datenvisualisierung erzeugen:  
   `python data_visualization.py`

## Typische Use-Cases
- Erfassung von akustischen Reflexionen in architektonischen Strukturen.
- Auswertung und Darstellung von Nachhall und Echoeffekten in urbanen Umgebungen.
- Vergleich verschiedener räumlicher Gegebenheiten hinsichtlich Schallrückwurf.

## Struktur & mögliche Erweiterungen
Das Projekt ist modular aufgebaut und kann leicht um zusätzliche Analyse- oder Visualisierungsfunktionen erweitert werden.  
Mögliche Erweiterungen:
- Integration einer Echtzeit-FFT-Anzeige.
- Ergänzung von 3D-Darstellungen der Raumakustik.
- Einbindung zusätzlicher Sensordaten (z. B. Temperatur, Feuchtigkeit) zur akustischen Kontextualisierung.

## Lizenz
Dieses Projekt steht unter der **MIT-Lizenz**.  

---

*Diese README.md wurde automatisch generiert. Alle Inhalte sind KI-basiert.*