PyADM1ODE
dgaida/PyADM1ODE
Simulação e otimização de biogás agrícola com ADM1
Ver no GitHubFramework Python completo para modelagem, simulação e otimização de plantas de biogás agrícolas baseado no Modelo de Digestão Anaeróbica No. 1 (ADM1). Implementa arquitetura modular com componentes reutilizáveis (fermentadores, geradores, bombas, agitadores) e resolvedor numérico robusto. Suporta configuração programática e via JSON, com documentação bilíngue completa.
Instalação
npx convez-ai dgaida/PyADM1ODE1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Simulação dinâmica de plantas de biogás agrícolas
- Otimização de parâmetros operacionais e configurações de biorreatores
- Análise de fluxos de gás e balanços de massa em digestão anaeróbica
- Pesquisa acadêmica em engenharia de biogás
Veredito

MCP server especializado e bem estruturado para simulação científica de biodigestores. Excelente cobertura de testes, documentação bilíngue e modularidade, mas restrito a nicho acadêmico/industrial específico de energia renovável agrícola.
README
A tradução para o português deste README ainda está na fila.
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)
│ ├── dlls/ # Integrierte C#-DLLs für Physico-Chemicals
│ ├── 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.
- Drei-Pass-Simulation: Realistische Modellierung von Gasflüssen und Pufferspeichern.
- Bilingualität: Vollständige Dokumentation in Deutsch und Englisch.
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: daniel.gaida@th-koeln.de
- GitHub: @dgaida
- Institution: TH Köln - University of Applied Sciences