thermal_mapping_innufer/readme_md
2026-04-12 02:07:11 +00:00

103 lines
3.8 KiB
Text
Raw Permalink Blame History

This file contains ambiguous Unicode characters

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.

# Thermal Mapping Innufer
## Überblick
Das Experiment **thermal_mapping_innufer** umfasst die Entwicklung eines Python-basierten Systems zur Erfassung, Speicherung und Analyse von Temperaturdaten. Ziel ist die Erstellung eines reproduzierbaren Workflows zur Gewinnung und Auswertung von Messwerten aus thermalen Sensoren und daraus abgeleiteten JSON-Datensätzen.
**Link zum Artikel:** [https://donau2space.de/naechtliche-thermal-kartografie-am-innufer/](https://donau2space.de/naechtliche-thermal-kartografie-am-innufer/)
**Git Repository:** [https://git.donau2space.de/Mika/thermal_mapping_innufer](https://git.donau2space.de/Mika/thermal_mapping_innufer)
### Hinweis
Alle Inhalte wurden per KI generiert.
Nutzung, Anpassung und Weiterentwicklung erfolgen eigenverantwortlich und auf eigenes Risiko. Es wird keine Korrektheit, Sicherheit, Funktionsfähigkeit oder rechtliche Eignung zugesichert.
---
## Inhalt des Repositories
Das Repository enthält mehrere Artefakte, die gemeinsam den Gesamtworkflow der Temperaturerfassung und -analyse bilden.
### 1. python_sensor_logger
- **Art:** python_script
- **Zielumgebung:** Linux Userspace
- **Sprache:** Python
- **Zweck:** Liest Temperaturdaten von einem angeschlossenen Sensor aus und protokolliert diese in eine Datei.
**API-Funktionen:**
- `read_temperature()` Ermittelt die aktuelle Temperatur in Grad Celsius.
- `log_temperature(timestamp, temperature)` Schreibt Messdaten mit Zeitstempel in den Log.
**Datenstruktur:**
- `TemperatureData` (JSON) mit Feldern `timestamp`, `temperature`
### 2. temperature_data_analysis
- **Art:** python_script
- **Zielumgebung:** Linux Userspace
- **Sprache:** Python
- **Zweck:** Analysiert die erfassten Datensätze und berechnet statistische Kennwerte wie Mittelwert und Varianz.
**API-Funktionen:**
- `analyze_temperature_data(data)` Nimmt eine Liste von Temperaturmessungen auf und gibt Analyseergebnisse zurück.
**Datenstruktur:**
- `AnalysisResult` (JSON) mit Feldern `mean_temperature`, `temperature_variance`
### 3. temperature_log_dataset
- **Art:** json_dataset
- **Zielumgebung:** Mixed
- **Sprache:** JSON
- **Zweck:** Enthält alle aufgezeichneten Temperaturmessungen als Datensatz im JSON-Format.
**Datenstruktur:**
- `TemperatureLog` mit Feldern `timestamp`, `temperature`
---
## Installation & Nutzung
### Voraussetzungen
- Python 3.8 oder höher
- Betriebssystem: Linux (getestet auf Ubuntu/Debian)
### Installation
1. Repository klonen:
`git clone https://git.donau2space.de/Mika/thermal_mapping_innufer`
2. In das Projektverzeichnis wechseln
`cd thermal_mapping_innufer`
3. Abhängigkeiten installieren:
`pip install -r requirements.txt`
### Ausführung
- **Sensorlogger starten:**
`python python_sensor_logger.py`
- **Analyse durchführen:**
`python temperature_data_analysis.py`
Diese Skripte erzeugen bzw. verarbeiten den Datensatz `temperature_log_dataset.json`.
---
## Typische Use-Cases
- Überwachung der nächtlichen Temperaturentwicklung an Gewässern
- Erstellung von Thermalkarten auf Basis gemessener Daten
- Datenvorbereitung für maschinelles Lernen im Umweltkontext
- Vergleich verschiedener Sensorstandorte entlang des Flussufers
---
## Struktur & Erweiterbarkeit
Das System ist modular aufgebaut und kann durch zusätzliche Sensorquellen oder Analysefunktionen erweitert werden. Die Nutzung standardisierter JSON-Datenstrukturen erlaubt einfache Integration in bestehende Datenanalyse-Pipelines.
Mögliche Erweiterungen:
- Unterstützung weiterer Sensortypen
- Erweiterung des Analysemoduls um Zeitreihenmodelle
- Automatisierte Visualisierung der Datensätze
- Export in CSV oder Datenbankintegration
---
## Lizenz
Dieses Projekt steht unter der **MIT-Lizenz**.
Nutzung, Modifikation und Weitergabe sind unter Beibehaltung des Lizenzhinweises gestattet.