MetaIO
Read
MetaImages
(.mha or .mhd)
and
NIFTI
images (.nii or .nii.gz)
and write .mha images
in python with minimal dependencies.
Bonus: provides a custom MHA-like format when size matters: .metaq.
Installation
Available on pypi.org: pip install tiny-metaio.
Usage
Writing a MHA file
>>> import metaio
>>> img = metaio.MetaImage([[0, 1], [42, 43]], spacing=[1, 2])
>>> img.save("some-name.mha")
Reading a MHA file
>>> img = metaio.read("some-name.mha")
>>> img.spacing
array([1., 2.])
>>> img.data
array([[ 0, 1],
[42, 43]])
>>> img.direction
array([1., 0., 0., 1.])
>>> img.origin
array([0., 0.])
Custom format
Integers
Integers are stored without loss in a very compact way.
>>> from pathlib import Path
>>> import numpy as np
>>> img = metaio.MetaImage([[-5] * 1000, [2] * 1000])
>>> img.save("some-name.mha")
>>> Path("some-name.mha").stat().st_size
16246
>>> img.save_compact("some-name.metaq")
>>> round(Path("some-name.metaq").stat().st_size / Path("some-name.mha").stat().st_size, 2)
0.09
>>> np.all(metaio.read("some-name.metaq").data == img.data)
np.True_
Floats
You need to specify a range of values covered by the quantization. Values outside this ranges will be clipped. A loss of precision is expected. NaNs will be implicitly converted to zero.
>>> img = metaio.MetaImage([[-0.5, 1], [2.5, 5]])
>>> img.save_compact("some-name.metaq", min_=0, max_=2.5)
>>> metaio.read("some-name.metaq").data
array([[0. , 1. ],
[2.5, 2.5]], dtype=float32)
Additionally, if some values do not matter, you can specify a mask for further compression.
The mask must be a binary array of the same shape as the image.
Values where the mask is False will not be stored at all and restored as NaN on dequantization.
>>> img = metaio.MetaImage([[-0.5, 1], [2.5, 5]])
>>> img.save_compact("some-name.metaq", min_=0, max_=2.5, mask=img.data <= 2.5)
>>> metaio.read("some-name.metaq").data
array([[0. , 1. ],
[2.5, nan]], dtype=float32)
Command-line interface
A command-line interface is available to convert supported input format to a MHA.
$ metaio /path/to/input.metaq /path/to/output.mha
Philosophy
numpyas only runtime dependency.- idiomatic python.
- similar behavior than SimpleITK's
GetArrayFromImage,GetImageFromArray,GetDirection,GetOrigin,GetSpacing,ReadImage,WriteImage.
Why should I use this over SimpleITK?
If you just need the IO parts and do not want the large SimpleITK package, or if you need to efficiently store some large MetaImage-like data, this package might be for you.
If you do not care about having SimpleITK as a dependency for your project, this package is not for you.
Metadata
Release files for tiny-metaio 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tiny_metaio-0.4.0.tar.gz | 62.3 kB | Without provenance | Details for tiny_metaio-0.4.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tiny_metaio-0.4.0-py3-none-any.whl | Python 3 | none | any | Details for tiny_metaio-0.4.0-py3-none-any.whl |
Total release size: 79.0 kB
Release files / tiny_metaio-0.4.0.tar.gz
| Download URL | tiny_metaio-0.4.0.tar.gz |
|---|---|
| Size | 62.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
edd15a22d14638d05ae961126284c8899c1156db9adb1c6cd70ab3fa15539250
|
|
BLAKE2b-256 checksum How to use checksums |
ec1a863015abaed4fa7ad3da21db8fa7ceb50732c2290bb3f62f0a61aae3667f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / tiny_metaio-0.4.0-py3-none-any.whl
| Download URL | tiny_metaio-0.4.0-py3-none-any.whl |
|---|---|
| Size | 16.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4b7d4d959470c735876ef9e304a6a7bebb713aa4393b2c1fc5e3a29966c9bde8
|
|
BLAKE2b-256 checksum How to use checksums |
645645ed0a93bf9f83e261d633eea6d07092dbc505f97a72bf81dcfdaf302a02
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for tiny-metaio 0.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.