PyADM1ODE
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
A comprehensive Python framework for modeling, simulating, and optimizing agricultural biogas plants based on the Anaerobic Digestion Model No. 1 (ADM1).
PyADM1ODE
PyADM1ODE ist ein Python-Framework zur Modellierung, Simulation und Optimierung von landwirtschaftlichen Biogasanlagen basierend auf dem Anaerobic Digestion Model No. 1 (ADM1).
Projektstruktur
PyADM1ODE/
├── data/ # Datenbanken (Substrate, Anfangszustände)
├── docs/ # Dokumentationsquellen (DE/EN)
├── examples/ # Anwendungsbeispiele & Jupyter Notebooks
├── pyadm1/ # Quellcode des Frameworks
│ ├── components/ # Anlagenkomponenten (Fermenter, BHKW, etc.)
│ ├── configurator/ # Anlagenbau und Konfiguration
│ ├── core/ # ADM1-Kern (Gleichungen, Solver, Parameter)
│ ├── simulation/ # Simulations-Engine und Parallelisierung
│ └── substrates/ # Substratmanagement und Feedstock-Berechnung
├── tests/ # Unit- und Integrationstests
├── mkdocs.yml # Konfiguration der Dokumentation
└── pyproject.toml # Projekt-Metadaten und Abhängigkeiten
Hauptmerkmale
- Modulare Architektur: Komponentenbasierter Aufbau von Biogasanlagen (Fermenter, BHKW, Pumpen, Rührwerke, etc.).
- Wissenschaftlich fundiert: Implementierung des ADM1da-Modells für realistische Simulationen landwirtschaftlicher Anlagen.
- Einfache Konfiguration: Programmatische Konfiguration oder über JSON-Dateien.
- Gasstrecke in vier Durchläufen: Speicher, Verbraucher und Fackeln werden in jedem Zeitschritt mit dem Gas berechnet, das tatsächlich ankommt.
- Bilingualität: Vollständige Dokumentation in Deutsch und Englisch.
Erweiterungen der Toolbox
Für weiterführende Aufgaben wie Parameterkalibrierung und Zustandsschätzung stehen spezialisierte Ökosystem-Erweiterungen zur Verfügung:
- PyADM1ODE Calibration: Parameterkalibrierung für Biogasanlagenmodelle. Ermöglicht die Anpassung von ADM1-Parametern an historische Messdaten (Initialkalibrierung) sowie die fortlaufende Online-Rekalibrierung im Betrieb inklusive Sensitivitäts- und Identifizierbarkeitsanalysen.
- PyADM1ODE Estimate: Zustandsschätzung für Biogasanlagen im Live-Betrieb basierend auf laufenden Sensordaten. Nutzt Verfahren wie den Unscented Kalman Filter (UKF), Deep-Learning-Ensembles und Sensor-Fusion, um nicht direkt messbare Anlagenzustände als Grundlage für Regelungen und Fütterungsempfehlungen zu schätzen.
Dokumentation
Die vollständige Dokumentation finden Sie unter dgaida.github.io/PyADM1ODE.
Schnellstart
Interaktive Beispiele (Google Colab)
Probieren Sie PyADM1ODE direkt im Browser aus:
Minimalbeispiel
from pyadm1 import BiogasPlant
from pyadm1.configurator import PlantConfigurator
from pyadm1.substrates import Feedstock
# Setup
feedstock = Feedstock(feeding_freq=48)
plant = BiogasPlant("Meine Biogasanlage")
configurator = PlantConfigurator(plant, feedstock)
# Komponenten hinzufügen
configurator.add_digester("main_digester", V_liq=2000, V_gas=300, Q_substrates=[15, 10, 0, 0, 0, 0, 0, 0, 0, 0])
configurator.add_chp("chp1", P_el_nom=500)
# Verbinden und simulieren
configurator.auto_connect_digester_to_chp("main_digester", "chp1")
plant.initialize()
results = plant.simulate(duration=30, dt=1/24)
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe LICENSE für Details.
Kontakt
Daniel Gaida
- E-Mail: [email protected]
- GitHub: @dgaida
- Institution: TH Köln - University of Applied Sciences
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found