acoustic_reflection_analysis/README.md
2026-04-19 02:07:49 +00:00

80 lines
No EOL
3.3 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.*