convez.ai
MCP ServerDados & AnalyticsAvançado
dgaida

PyADM1ODE

dgaida/PyADM1ODE

Simulação e otimização de biogás agrícola com ADM1

Ver no GitHub
BomPluginScore · de 0 a 100

Framework 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/PyADM1ODE

1 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

Estrelas
6
Forks
1
Acompanhando
1
Saúde
57%
Último commit
há 3 semanas
Versão
—
Issues abertas
1
Contribuidores
4

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

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)
│   ├── 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:

  • 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

Ver o original no GitHub

Bom para

Relacionados