Skip to main content

logo

MIKE IO: input/output of MIKE files in Python

Python version Full test PyPI version OS Downloads License: BSD-3-Clause

Read, write and manipulate dfs0, dfs1, dfs2, dfs3, dfsu and mesh files.

MIKE IO facilitates common data processing workflows for MIKE files using Python.

Requirements

  • Windows or Linux operating system
  • Python x64 3.12 - 3.15
  • (Windows) VC++ redistributables (already installed if you have MIKE)

Installation

pip install mikeio

⚠️ Don't use conda to install MIKE IO! The version on conda-forge is several major versions behind.

Getting started

Read a file into a Dataset — a collection of named DataArrays sharing time and geometry:

>>> import mikeio
>>> ds = mikeio.read("HD2D.dfsu")
>>> ds
<mikeio.Dataset>
title: Output 1
dims: (time:9, element:884)
time: 1985-08-06 07:00:00 - 1985-08-07 03:00:00 (9 records)
geometry: Dfsu2D (884 elements, 529 nodes)
items:
  0:  Surface elevation <Surface Elevation> (meter)
  1:  U velocity <u velocity component> (meter per sec)
  2:  V velocity <v velocity component> (meter per sec)
  3:  Current speed <Current Speed> (meter per sec)

Select an item and extract a time series at a point:

>>> da = ds["Surface elevation"]
>>> da.sel(x=606200, y=6905480)
<mikeio.DataArray>
name: Surface elevation
dims: (time:9)
time: 1985-08-06 07:00:00 - 1985-08-07 03:00:00 (9 records)
geometry: GeometryPoint2D(x=606202.7806372638, y=6905474.639383219)
values: [0.4595, 0.807, ..., -0.6322]

Convert to pandas, or write the result back to a dfs file:

>>> df = mikeio.read("da_diagnostic.dfs0").to_dataframe()
>>> ds.to_dfs("output.dfsu")

See the user guide for more.

Where can I get help?

Testing

MIKE IO is tested extensively, with an overall statement coverage of ~95%. The test suite runs on every pull request against Python 3.12 and 3.15, and on a schedule on both Linux and Windows.

uv run pytest --cov=mikeio

Contributing

Contributions are welcome — see CONTRIBUTING.md. Key architectural decisions are documented as ADRs.

License

BSD-3-Clause

Metadata

Release files for mikeio 3.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mikeio 3.3.1
File Size Uploaded Provenance Actions
mikeio-3.3.1.tar.gz 134.2 kB With provenance Details for mikeio-3.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mikeio 3.3.1
File Interpreter ABI Platform Actions
mikeio-3.3.1-py3-none-any.whl Python 3 none any Details for mikeio-3.3.1-py3-none-any.whl

Total release size: 298.1 kB

Release files / mikeio-3.3.1.tar.gz

Download URL mikeio-3.3.1.tar.gz
Size 134.2 kB
Tags Source
SHA-256 checksum
How to use checksums
6f49af8330a8540dfcbcd5e52610e8945417f5d4fe80001eb83aa255d32de288
BLAKE2b-256 checksum
How to use checksums
f194f3cbbbae0c3a5f4e49d07b1b6ab7b084f3b4a19f5ede2f3ab2e0be23cb2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.

Transparency log

Release files / mikeio-3.3.1-py3-none-any.whl

Download URL mikeio-3.3.1-py3-none-any.whl
Size 163.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
405083b2635360efd2db6b392a928e447b2d322d19fd9a4e48f595dc03fa3fe9
BLAKE2b-256 checksum
How to use checksums
7ea263308086fd297161270cecadd744e4114ee6b90c6d95c222b95af9da5e1a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.

Transparency log

Security for mikeio 3.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for mikeio-3.3.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.3.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page