Brain imaging surface mesh file format converter
Project description
mni2mz3
Converts a file from MNI polygonal surface mesh format (.obj
*) or
vertex-wise data (e.g. curvature, cortical thickness, *.txt
)
to Surf-Ice MZ3 (.mz3
).
Useful for visualizing surfaces using Surf-Ice or NiiVue.
[!WARNING] *Not to be confused with Wavefront .obj, which is a different spec but with the same file extension.
Installation
There are many ways to install and use mni2mz3
. Linux, Mac, and Windows are supported.
Using ChRIS
The easiest way to run mni2mz3
is on ChRIS, no installation needed.
Simply upload your data to a feed in https://app.chrisproject.org, then run pl-mni2common
.
Using Apptainer
pl-mni2common
is a ChRIS plugin wrapper for mni2mz3
, which means you can
use its container image to run mni2mz3
.
apptainer run docker://ghcr.io/fnndsc/pl-mni2common:latest mni2mz3 input.obj output.mz3
Call the wrapper script mni2mz3
instead to do bulk processing on an input directory.
apptainer run docker://ghcr.io/fnndsc/pl-mni2common:latest mni2mz3 inputdir/ outputdir/
Using cargo-binstall
cargo binstall mni2mz3
Using pip
pip install mni2mz3
Manual Download
Select and download the right binary for your architecture and OS from GitHub Releases: https://github.com/FNNDSC/mni2mz3/releases/latest
Compile From Source
Install Rust, then run
cargo install mni2mz3
Usage
# convert mesh
mni2mz3 surface_81920.obj surface.mz3
# convert data
mni2mz3 thickness.txt thickness.mz3
To do bulk conversions, use the ChRIS plugin wrapper.
Details
- Output file will be gzip compressed.
- For surfaces, only triangle meshes are supported.
- For data, only 32-bit single-precision "float" is supported.
Testing
It is recommended to install cargo-nextest.
cargo nextest run
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for mni2mz3-0.1.1-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b8cec6bd68a2dd1125c481decfe47a7eabe83159310ccca9d40f7189e0f365ba |
|
MD5 | 4f242fbe812cb23693059c2c20348b71 |
|
BLAKE2b-256 | 9c382c5eaea1531291b180462a3b21d5221e6ae790f92c64af855ffa9151f13a |
Hashes for mni2mz3-0.1.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9cc2a5092c080eacef894252bff57296db917d84b59bdbec6faa97addc1ffb57 |
|
MD5 | ac3263016c552343c3418b1393c71d8f |
|
BLAKE2b-256 | cfc7b3a548049d531fde3f188c066657a3d556e7da3e679a377d30d13993f0ec |
Hashes for mni2mz3-0.1.1-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 10bf8efeed8ea269b4c5fe1a7d9c03bcde78e418c0cb3ca6814e90d099649392 |
|
MD5 | 4dba2d4738e6cb8a1d96d4656d684901 |
|
BLAKE2b-256 | f19519c638e8285549ae84487cd31998609d94d4f1dfdbfc05fbee9ff6b65cf6 |
Hashes for mni2mz3-0.1.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5c324bc251e31e3250844c7df9e9efe271c8cbfacc67c6fea91401cce9fff187 |
|
MD5 | acbbb04ec735a7aa8dac89a5dd36ad2a |
|
BLAKE2b-256 | 6536449bbc6e144830d31f1ad27210db242cfdc932f79a55862cfdc373ae32f0 |
Hashes for mni2mz3-0.1.1-py3-none-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9c754d8501f268e2e73ce21e523cef0360f845615996f67f120fbd7a4ab40501 |
|
MD5 | 337db24b9fd7eb3f4b148c31a5bd6591 |
|
BLAKE2b-256 | 11a3b244b3b61b2fa375899d7a19b1190b0deb4b4e7636253ae2e308c03d95cd |
Hashes for mni2mz3-0.1.1-py3-none-macosx_10_7_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7f3b12a7d6b813e64c410b97b506292fee6551be39728298632bcffe79d961ec |
|
MD5 | 24f327d4015fd9cfcb3aabba90b761b1 |
|
BLAKE2b-256 | 2cb45e10757b431427f3b5fb0bceaaeca279221704e22cd58f4f096b5b1a1918 |