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.0rc3-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6d16b0a3a97e55c46ce33c90ada2dac575033ff8cd157ad7b42a08355d0edf4e |
|
MD5 | d760e41ecebf41966bbb4bf469aa8e6f |
|
BLAKE2b-256 | f6eaa5052b0468a1e858a1edeb629ecda8fb9d9da897abc4beb68f23ab24eaf2 |
Hashes for mni2mz3-1.0.0rc3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 321ad72f0c51c299e1e68f1ec8a8cdff0ddedc590bd36f65a1094b6eb9598d94 |
|
MD5 | 88f039fd78f004fa529ed1f47e25e501 |
|
BLAKE2b-256 | bd16afb8b968ab7220ce4b1041cd9d0bf79c1b57e6b678a97e75f7f343352cc9 |
Hashes for mni2mz3-1.0.0rc3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 28e1d03c3c3d4c6611f2e50bbef165e2b1efb4ad4366229f244f95fbfd5d7005 |
|
MD5 | 816c2faeb74231796a36e614894e4b26 |
|
BLAKE2b-256 | 6e4bf0f870ab3147211bbc5c34e4583785b318b87ac0525b96fb259bdf1e5257 |
Hashes for mni2mz3-1.0.0rc3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 24c745c11d75bd5bb49fb551a15da96f686755affe1fdf1b295351110ea113da |
|
MD5 | 54426a13261219b06a0b9c170ea6b0a4 |
|
BLAKE2b-256 | c6a87545da7f2ff61a1cd79d1d779726a9a6d3b10d9afb356914e4a2422ac38f |
Hashes for mni2mz3-1.0.0rc3-py3-none-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 42b58fe58990d2dd47959dd393a4a8823791a101a1a54f008a58ab6d4c19be35 |
|
MD5 | 79dce951535c7051c8d695cfc6daade8 |
|
BLAKE2b-256 | b9f34fdcc6feeae6a6c1c6e99554a424aff19fdef64ea791d7634fe96d1cd362 |
Hashes for mni2mz3-1.0.0rc3-py3-none-macosx_10_7_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9db7c74de0f9e32b77c2afa3d06572c22e495ebdfd15ed944c079871cc0bb3bf |
|
MD5 | a1613487a829f35d6793f9504babfd84 |
|
BLAKE2b-256 | 4b917f8b4d6915a7e02bf0ffa0638091de13ae9819f3aee45ef42d0e5a5f62ad |