中文 English

pymatio

快速、紧凑的 mat 文件读取器，在 2MiB 大小内完成 MAT5/MAT7.3 的读入，摆脱巨大的 scipy 和 h5py 依赖。基于 matio 的 Python 绑定。

Fast, compact MAT file reader supporting MAT5/MAT7.3 formats within a 2MiB footprint. Eliminates dependency on bulky scipy and h5py. Based on Python binding for matio.

背景

Python 中始终没有一个一站式读取 mat 文件的库，mat5 总是依赖 scipy.io, mat7.3 总是依赖 h5py，h5py 直接读取 mat 文件又需要很多手动转换，有一个 mat73 转换，但是核心逻辑是纯 Python 写的，又非常慢。

恰巧 C 中有一个库 matio，我就想用 pybind11 nanobind 做一个绑定。

安装

uv add pymatio

# or use pip
pip install pymatio

样例

import pymatio as pm

print(pm.get_library_version())
print(pm.loadmat('file.mat'))

对开发者

常规构建流程

git clone https://github.com/myuanz/pymatio && cd pymatio
uv sync --dev --no-install-project
# or use cmake 
cmake -S . -B build -G Ninja
cmake --build build

# for test data
git submodule update --init --recursive

zlib、hdf5 等基础依赖将自动下载并构建，无需系统预先安装.

Windows 编译工具链

Windows 通常没有自带的构建工具链, 你可以参考 此页, 下载Microsoft C++ Build Tools, 按照图片示例构建推荐的工具链, 点击安装. 只要完成这一步就够了, 不需要再往下安装 Rust.

路线

• 打包为 whl 文件
• 添加关于构建成功的基本测试
• 添加 cibuildwheel 打包 whl
• Github Action
• 编译扩展时自动处理虚拟环境
• 完成 loadmat
• 完成 savemat
• 自由线程 whl
• 导入 scio 的测试
• 导入 mat73 的测试
• 导入 matio 的测试
• 添加 types