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.4.0

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.4.0
File Size Uploaded Provenance Actions
mikeio-3.4.0.tar.gz 134.9 kB With provenance Details for mikeio-3.4.0.tar.gz

Built distribution (wheel)

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

Total release size: 299.3 kB

Release files / mikeio-3.4.0.tar.gz

Download URL mikeio-3.4.0.tar.gz
Size 134.9 kB
Tags Source
SHA-256 checksum
How to use checksums
eb57b8cd8756179f34e085563c054c69115675005068e0780b7b3f41915a78c6
BLAKE2b-256 checksum
How to use checksums
4843a28ced56aa1ac9162f4f73599288edb94636d0fec5e5b4d8271507427985
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 Nov 4, 2026.

Transparency log

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

Download URL mikeio-3.4.0-py3-none-any.whl
Size 164.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6ec4d17685e0729349b95a87bdd9de39308727617a7e9ae220960784be48db47
BLAKE2b-256 checksum
How to use checksums
92af1cf49bb33ca0dc5cb0f30760f94f67d7b058470829e277a93080acf536af
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 Nov 4, 2026.

Transparency log

Security for mikeio 3.4.0

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.4.0.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 Nov 4, 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.4.0 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