donau_strommessung/README.md
2026-02-15 03:06:28 +00:00

88 lines
No EOL
3.6 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.

# Donau Strommessung
## Überblick
Dieses Experiment (experiment_key: donau_strommessung) untersucht die elektrische Aktivität der Donau mithilfe von selbstgebauten Sensoren und dokumentiert die Messergebnisse sowie die Erfahrungen der Durchführung unter realen Bedingungen.
**Link zum Artikel:** [https://donau2space.de/donau-atmet-strom-nachtmessung-an-der-staustufe/](https://donau2space.de/donau-atmet-strom-nachtmessung-an-der-staustufe/)
**Git-Repository:** [https://git.donau2space.de/Mika/donau_strommessung](https://git.donau2space.de/Mika/donau_strommessung)
### 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
### Artefakte
#### 1. sensor_logging
- **Art:** python_script
- **Ziel:** linux-userspace
- **Sprachen:** Python
- **Zweck:** Aufzeichnung von Messdaten der angeschlossenen Sensoren (ADS1115, DHT22) in Logdateien.
- **API-Funktionen:**
- `log_sensor_data(voltage: float, temperature: float, humidity: float)` schreibt Messwerte in das Logfile.
- **Datenstrukturen:**
- `SensorData (json)` mit den Feldern: timestamp, voltage, temperature, humidity.
#### 2. data_analysis
- **Art:** python_script
- **Ziel:** linux-userspace
- **Sprachen:** Python
- **Zweck:** Analyse der gesammelten Messdaten, Ermittlung statistischer Kenngrößen und Korrelation zwischen Spannung und Wetterparametern.
- **API-Funktionen:**
- `analyze_data(data: List[SensorData])` liefert einen `SummaryReport` über Spannungswerte und deren Beziehungen zu Wetterdaten.
- **Datenstrukturen:**
- `SummaryReport (json)` mit Feldern: max_voltage, min_voltage, average_voltage, correlation_with_weather.
#### 3. measurement_log
- **Art:** csv_dataset
- **Ziel:** mixed
- **Sprache:** CSV
- **Zweck:** Rohdaten der Messreihen, nutzbar für weitere Auswertungen.
- **Struktur:**
- `MeasurementLog (table)` mit Spalten: timestamp, voltage, temperature, humidity.
## Installation & Nutzung
### Voraussetzungen
- Linux-System mit installiertem Python (Version ≥ 3.8)
- Zugriff auf Sensor-Hardware (ADS1115, DHT22)
- Schreibrechte im Projektverzeichnis für Logdateien
### Installation
1. Repository klonen:
`git clone https://git.donau2space.de/Mika/donau_strommessung`
2. In das Projektverzeichnis wechseln:
`cd donau_strommessung`
3. Abhängigkeiten installieren:
`pip install -r requirements.txt`
### Nutzung
1. Sensor-Logging starten:
`python sensor_logging.py`
2. Nach Abschluss: Datenanalyse durchführen:
`python data_analysis.py`
3. Ergebnisse in Log- und Report-Dateien einsehen.
## Typische Use-Cases
- Aufzeichnen elektrischer Signale aus experimentellen Sensoraufbauten an der Donau.
- Untersuchung von Zusammenhängen zwischen elektrischer Aktivität und Umweltparametern (Temperatur, Luftfeuchtigkeit).
- Bereitstellen der erhobenen Daten für weitergehende wissenschaftliche Auswertungen.
## Struktur & mögliche Erweiterungen
- **sensor_logging.py** Messdatenerfassung und Log-Erstellung.
- **data_analysis.py** statistische Analyse und Ergebnisaufbereitung.
- **measurement_log.csv** Sammeldatei mit Rohdaten aller Messungen.
**Erweiterbar durch:**
- zusätzliche Sensorkomponenten (z.B. Leitfähigkeitssensoren)
- Echtzeit-Datenvisualisierung
- Exportformate für wissenschaftliche Publikationen
## Lizenz
Veröffentlicht unter der **MIT-Lizenz**.
Die Inhalte wurden automatisch per KI generiert. Nutzung und Weiterentwicklung erfolgen auf eigenes Risiko.