DHI/mikeio：读取、写入并操作 dfs0、dfs1、dfs2、dfs3、d

项目介绍

DHI/mikeio 是一个托管在 GitHub 上的开源项目，主要使用 Python 编写，采用 BSD 3-Clause "New" or "Revised" License 许可证，目前获得 184 个 Star、63 次 Fork。

仓库全名: DHI/mikeio

README 摘要

MIKE IO: input/output of MIKE files in Python 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 :warning: Don't use conda to install MIKE IO! The version on…

完整内容见 GitHub 原始 README 或本页。

常见问题

mikeio 用什么语言开发？

主要使用 Python 编写，采用 BSD 3-Clause "New" or "Revised" License 许可证，目前有 184 个 Star。

mikeio 可以免费商用吗？

如何获取 mikeio 的源码？

可以直接克隆仓库：git clone https://github.com/DHI/mikeio.git，默认分支为 main；安装与运行步骤见仓库 README。

mikeio 最近还在维护吗？

仓库最近一次更新为 1 天前，当前有 74 个未关闭 Issue；Star 数为 184，可作为社区活跃度的参考。

关于

GitHub 原始描述（英文）

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

dfs dhi input-output python

BSD 3-Clause "New" or "Revised" License
184 Stars
63 Forks
10 Watching

描述取自 GitHub 官方 API，保持仓库作者书写的原文。

简要分析

热度分

320

价值分

126

活跃状态

活跃

GitHub

语言占比

Jinja

Just

Python

Release

Release 3.5.06 天前
Release 3.4.01 周前
Release 3.3.12 周前
Release 3.3.09月10日
Release 3.2.06月25日

贡献者

MIKE IO: input/output of MIKE files in Python

Python version Downloads

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

:warning: 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?

Documentation - https://dhi.github.io/mikeio/
For AI coding assistants - llms.txt, an index of the current documentation
General help, new ideas and feature requests - GitHub Discussions
Bugs - GitHub Issues

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

暂无评论

mikeio