https://github.com/myuanz/pymatio
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.
https://github.com/myuanz/pymatio
matio matlab python
Last synced: 21 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/myuanz/pymatio
- Owner: myuanz
- Created: 2023-12-20T16:27:34.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-10-14T07:59:37.000Z (7 months ago)
- Last Synced: 2025-04-23T03:42:31.149Z (28 days ago)
- Topics: matio, matlab, python
- Language: C++
- Homepage:
- Size: 156 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[中文](./README.md) [English](./README_en.md)
# pymatio
快速、紧凑的 mat 文件读取器，在 2MiB 大小内完成 MAT5/MAT7.3 的读入，摆脱巨大的 scipy 和 h5py 依赖。基于 matio 的 Python 绑定。
## 背景
Python 中始终没有一个一站式读取 mat 文件的库，mat5 总是依赖 scipy.io, mat7.3 总是依赖 h5py，h5py 直接读取 mat 文件又需要很多手动转换，有一个 mat73 转换，但是核心逻辑是纯 Python 写的，又非常慢。
恰巧 C 中有一个库 [matio](https://github.com/tbeu/matio)，我就想用 ~~pybind11~~ nanobind 做一个绑定。
## 安装
```
pip install pymatio
```
## 样例
```python
import pymatio as pm
print(pm.get_library_version())
print(pm.loadmat('file.mat'))
```
## 从源代码构建
### 常规构建流程
```bash
git clone https://github.com/myuanz/pymatio && cd pymatio
pip install .
```
zlib、hdf5 等基础依赖将自动下载并构建，无需系统预先安装.
### Windows 编译工具链
Windows 通常没有自带的构建工具链, 你可以参考 [此页](https://learn.microsoft.com/en-us/windows/dev-environment/rust/setup#install-visual-studio-recommended-or-the-microsoft-c-build-tools), 下载`Microsoft C++ Build Tools`, 按照图片示例构建推荐的工具链, 点击安装. 只要完成这一步就够了, 不需要再往下安装 Rust.
## 路线
- [x] 打包为 whl 文件
- [x] 添加关于构建成功的基本测试
- [x] 添加 cibuildwheel 打包 whl
- [x] Github Action
- [x] 编译扩展时自动处理虚拟环境
- [x] 完成 loadmat
- [ ] 完成 savemat
- [ ] 自由线程 whl
- [ ] 导入 scio 的测试和 mat73 的测试
- [x] 添加 types
- [ ] 添加 benchmark
- [ ] With scio
- [ ] With mat73
- [ ] With Free-Thread