Skip to content

PyADM1ODE Calibration

PyPI version Python versions License: MIT Documentation Interrogate Open In Colab

Parameter calibration for PyADM1ODE biogas plant models.

Fits ADM1 parameters to measured plant data, either once from a historical window or continuously during operation.

What it does

  • Initial calibration: global search over a historical window, with a train/test split.
  • Online recalibration: bounded parameter updates, triggered by prediction variance.
  • Analysis: sensitivity and identifiability, so you can tell which parameters the data actually resolves.
  • Data: CSV and database sources behind one schema file, plus validation, outlier removal and gap filling.

Contents

Page Content
Getting Started Prerequisites and the core concepts
Installation pip, conda, Docker
Configuration Parameters, bounds, optimizers, database
Usage The two workflows in code
Tutorials Notebook series 00 to 06
Examples Runnable scripts
API Reference Classes and functions
Architecture Modules and data flow

Quickstart

from pyadm1ode_calibration import Calibrator, MeasurementData

measurements = MeasurementData.from_csv("plant_data.csv")
calibrator = Calibrator(plant)          # plant: a pyadm1 BiogasPlant

result = calibrator.run_initial_calibration(
    measurements=measurements,
    parameters=["k_dis", "k_hyd_ch"],
    objectives=["Q_ch4", "pH"],
)

if result.success:
    calibrator.apply_calibration(result)

Citation

If you use PyADM1ODE_calibration in your research, please cite:

@software{pyadm1_calibration,
  author = {Gaida, Daniel},
  title = {PyADM1ODE\_calibration: Parameter Calibration Framework for Biogas Plant Models},
  year = {2026},
  url = {https://github.com/dgaida/PyADM1ODE_calibration}
}