Skip to content

PyADM1ODE Documentation

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

Open In Colab: Basic Digester Open In Colab: Complex Plant

  • Quick Start

    Get started in minutes with your first biogas plant simulation

    Quickstart Guide

  • User Guide

    Learn about the components, substrates, and applications

    User Guide

  • Model & Theory

    Details on ADM1 implementation, architecture, and validation

    Model & Theory

  • Examples

    Real-world examples from basic to advanced plants

    Examples

What is PyADM1ODE?

PyADM1ODE is a comprehensive Python framework for agricultural biogas plant modeling that combines:

  • Scientific accuracy: Based on IWA's ADM1 model, the international standard for anaerobic digestion.
  • Modular architecture: Mix and match components (digesters, CHP units, pumps, mixers) to build any plant configuration.
  • Real-world applicability: Validated with data from operating biogas plants.
  • Python ecosystem: Integrates with NumPy, SciPy, Pandas, and visualization libraries.

Quick Example

Build and simulate a complete biogas plant in just a few lines:

from pyadm1.configurator import BiogasPlant, PlantConfigurator
from pyadm1.substrates import Feedstock

# Create plant
feedstock = Feedstock(feeding_freq=48)
plant = BiogasPlant("My Biogas Plant")
configurator = PlantConfigurator(plant, feedstock)

# Add digester (automatically creates gas storage)
configurator.add_digester(
    digester_id="main_digester",
    V_liq=2000.0,              # 2000 m³ liquid volume
    V_gas=300.0,               # 300 m³ gas headspace
    T_ad=308.15,               # 35°C mesophilic
    Q_substrates=[15, 10, 0, 0, 0, 0, 0, 0, 0, 0]  # Corn silage + manure
)

# Add CHP and heating (automatically creates flare)
configurator.add_chp("chp_main", P_el_nom=500.0)
configurator.add_heating("heating_main", target_temperature=308.15)

# Connect components
configurator.auto_connect_digester_to_chp("main_digester", "chp_main")
configurator.auto_connect_chp_to_heating("chp_main", "heating_main")

# Simulate
plant.initialize()
results = plant.simulate(duration=30, dt=1/24, save_interval=1.0)

# Analyze
final = results[-1]["components"]["main_digester"]
print(f"Biogas: {final['Q_gas']:.1f} m³/d")
print(f"Methane: {final['Q_ch4']:.1f} m³/d")
print(f"pH: {final['pH']:.2f}")

Community and Support

License

PyADM1ODE is open-source software licensed under the MIT License.