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-1.0.0rc1-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 632b3ea22beabd75a8c4daaebbd64bb431ab8063dd2384022a96a24821f8b634 |
|
MD5 | f9c0c1a728194701a2ab4d07fb32468f |
|
BLAKE2b-256 | 5f67b9398ad8e3a21d667267918b4aa8a4e27edd2b18881e04505a98b93c21f8 |
Hashes for mni2mz3-1.0.0rc1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6817ec3753b382533de63246c9790d007df0da7de1e478233ac981f74e5ac321 |
|
MD5 | 7004e9b96b1b7ff0778a670c01bff063 |
|
BLAKE2b-256 | 21e42346a8af71c451c09516d68499ea5678643b6fb650bf7ae63ae87caac36e |
Hashes for mni2mz3-1.0.0rc1-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d61ef134fd5a2f15c1b7eecbaf382a9d8fcdfacff5d369eba2431ab2cebc1e80 |
|
MD5 | 26f1bae1159714b041b7371623a6c141 |
|
BLAKE2b-256 | 7c38f09617511be6c0592b346f58476e175294576aaf0a341798f61556e5d650 |
Hashes for mni2mz3-1.0.0rc1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3b4348ffde9ea6eac6b51c443bd492cc228ea0d3d43c26bcbfdc7f39fc125629 |
|
MD5 | 64a4bf249e8f17253da19ddc671d5635 |
|
BLAKE2b-256 | 684a6d643837cd2c34c134e71ce65e5c3254d5c13ec72034d356da8b511715b1 |
Hashes for mni2mz3-1.0.0rc1-py3-none-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fc06378391c693945c486594d5cf4ba4db0871cdf8d67fd398037166b01842b4 |
|
MD5 | a5f185a1146416e717edb1860bdaa2ad |
|
BLAKE2b-256 | b1257e452547253afd1b37059bff4a96e2d9b4479f9fa83669a8afdf85ab0339 |
Hashes for mni2mz3-1.0.0rc1-py3-none-macosx_10_7_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 76125ffa0c21f6ab311a6c04d5e2158c6a6502e533efc8706601b6c166a1469e |
|
MD5 | 46c08dc8f77512e36cfa43b77699a9b5 |
|
BLAKE2b-256 | 48780c42fe31ebfcb5fbece111b09e4e45869c3ab491e571794a3a0c99761023 |