PyADM1ODE

mcp
Security Audit
Warn
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.

SUMMARY

A comprehensive Python framework for modeling, simulating, and optimizing agricultural biogas plants based on the Anaerobic Digestion Model No. 1 (ADM1).

README.md

PyADM1ODE

PyPI version
Documentation Status
License: MIT
codecov
Code Quality
Tests
CodeQL
Code style: black
Ruff
Version
Maintenance
Last commit
Python
Docs

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:

  • Basis-Fermenter: Open In Colab
  • Zweistufige Anlage: Open In Colab

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

Reviews (0)

No results found