Streamline your MIKE+ workflows

Python version Full test PyPI version OS Downloads

AI / Agents

Skills
llms.txt
llms-full.txt

Developers

Ryan Walter Murray

Wen Wu

DHI Group

Copyright holder

Community

Code of conduct
Full license Apache-2.0

Meta

Requires: Python >=3.12
Provides-Extra: dev, test
Package Info

MIKE+Py is an open-source Python package for interacting with MIKE+ model databases (.sqlite files). It enables automation of modelling tasks, programmatic data manipulation, scenario management, and simulation execution, enhancing the reproducibility and efficiency of MIKE+ workflows.

Installation

MIKE+Py can be installed from PyPI using uv (or pip):

uv pip install mikeplus

Note
Use of MIKE+Py requires a valid MIKE+ license.

To install a version compatible with a specific MIKE+ release year (e.g., MIKE+ 2025):

uv pip install mikeplus==2025.*

Quick Start

Here are a couple of quick examples to get you started:

Open a database and read table data into a Pandas DataFrame:

import mikeplus as mp

with mp.open("your_model.sqlite") as db:
    db.tables.msm_Node.to_dataframe()

Open a database and run the active simulation setup:

import mikeplus as mp

with mp.open("your_model.sqlite") as db:
    db.run()

Key Features

  • Database Interaction: Programmatically open, create, and manage MIKE+ .sqlite databases.
  • Data Manipulation: Read and modify model data stored in various tables using a fluent API that supports Pandas DataFrames.
  • Scenario Management: Access, create, activate, and delete scenarios and alternatives.
  • Simulation Execution: Run MIKE+ simulations for different modules (CS, EPANET, SWMM) directly from Python.
  • Automation: Automate repetitive tasks such as parameter updates, scenario comparisons, and batch simulations.
  • Tools Integration: Programmatic access to some MIKE+ GUI tools.

Documentation

Comprehensive documentation is available at: https://dhi.github.io/mikepluspy/

Caution: Work with Database Copies

MIKE+Py directly modifies the .sqlite database file. There is no undo functionality within MIKE+Py for changes made to the database.

It is strongly recommended to always work on a copy of your MIKE+ database, not the original, to prevent accidental data loss or corruption.

Compatibility Issues

There are known compatibility issues when using MIKE+Py alongside other DHI libraries (e.g. MIKE IO, MIKE IO 1D, ModelSkill).

  • MIKE IO is not fully supported in the same Python process as MIKE+Py. MIKE+Py warns when both are loaded; import MIKE IO before MIKE+Py, or use separate processes if you run into problems.
  • Importing MIKE IO 1D before MIKE+Py is not supported and will cause errors.

The following is the suggest import order which works for most use cases, but could still run into issues:

import mikecore
import mikeio
import modelskill as ms
import mikeplus as mp
import mikeio1d