fluoreszenz_unter_beton/README.md
2026-02-22 03:07:07 +00:00

82 lines
No EOL
3.6 KiB
Markdown
Raw Permalink 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.

# Fluoreszenz unter Beton
## Überblick
Experiment „fluoreszenz_unter_beton“ zur Erfassung und Analyse von Fluoreszenzsignalen der Donau mithilfe eines USB-Spektrometers. Die Datenerfassung und -korrektur erfolgt über Python-Logger-Skripte. Das Ziel ist die zuverlässige Protokollierung, Glättung und Bereinigung von Messreihen zur weiteren wissenschaftlichen Auswertung.
**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.
**Link zum Artikel:** [https://donau2space.de/fluoreszenz-unter-beton-lichtsignale-der-donau/](https://donau2space.de/fluoreszenz-unter-beton-lichtsignale-der-donau/)
**Git Repository:** [https://git.donau2space.de/Mika/fluoreszenz_unter_beton](https://git.donau2space.de/Mika/fluoreszenz_unter_beton)
## Inhalt des Repositories
### 1. logger_script
- **Art:** python_script
- **Ziel:** linux-userspace
- **Sprache:** Python
- **Zweck:** Erfassung von Fluoreszenzsignalen über ein Spektrometer, kontinuierliches Logging in JSON-Struktur.
**API-Funktionen:**
- `start_logging(duration)` Startet den Messvorgang für eine definierte Dauer und erzeugt Logeinträge.
- `flush_buffer()` Leert den internen Puffer und schreibt Daten vollständig in das Zielverzeichnis.
- `moving_avg(data, window)` Berechnet gleitende Mittelwerte zur Glättung von Datenreihen.
**Datenstruktur:**
- `log_entry` (JSON): Felder `timestamp`, `intensity`
### 2. data_analysis
- **Art:** python_script
- **Ziel:** linux-userspace
- **Sprache:** Python
- **Zweck:** Verarbeitung, Rauschunterdrückung und Korrektur der aufgezeichneten Fluoreszenzdaten.
**API-Funktionen:**
- `correct_flourescence(raw_data)` Führt Korrekturen der gemessenen Werte auf Basis kalibrierter Referenzkurven durch.
- `substract_reference(data, reference)` Entfernt Referenzsignale, um die Netto-Fluoreszenz zu bestimmen.
**Datenstruktur:**
- `data_point` (JSON): Felder `intensity`, `background_noise`
### 3. experiment_documentation
- **Art:** doc_only
- **Ziel:** mixed
- **Sprache:** Textdokumentation
- **Zweck:** Enthält Aufbauanweisungen, Sicherheitsrichtlinien und Hintergrundinformationen zum Experiment.
## Installation & Nutzung
### Voraussetzungen
- Linux-Umgebung mit Python ≥ 3.8
- USB-Spektrometer-Treiber installiert
- Schreibrechte im Arbeitsverzeichnis
### Installation
1. Repository klonen:
`git clone https://git.donau2space.de/Mika/fluoreszenz_unter_beton.git`
2. In das Projektverzeichnis wechseln:
`cd fluoreszenz_unter_beton`
3. Abhängigkeiten installieren:
`pip install -r requirements.txt`
### Ausführung
- Logger starten:
`python logger_script.py --duration 60`
- Datenanalyse durchführen:
`python data_analysis.py --input logs/data.json --output results/`
## Typische Use-Cases
- Echtzeitüberwachung von Fluoreszenzsignalen unter wechselnder Wassertrübung.
- Nachträgliche Signalanalyse zur Bestimmung von chemischen Veränderungen.
- Test von Glättungs- und Korrekturalgorithmen für Messreihen.
- Kalibrierung neu angeschlossener Spektrometer.
## Struktur & mögliche Erweiterungen
- Modularer Aufbau ermöglicht zusätzliche Datenauswertefunktionen.
- Integration weiterer Sensortypen (z.B. Temperatur- oder pH-Logger) über einheitliche API-Schnittstellen.
- Erweiterbar um visuelle Dashboards zur Darstellung in Echtzeit.
## Lizenz
Dieses Projekt steht unter der **MIT-Lizenz**.
Die Inhalte wurden automatisch erstellt. Verwendung erfolgt ohne Gewähr und auf eigenes Risiko.