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.0rc2-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 541ace7c2b8036a36e2c8c6f9593b7b4cf8f65439234af540c738226bdd94059 |
|
MD5 | 5c4691e668f4b52a7b2e63fbe9fc9588 |
|
BLAKE2b-256 | 616214b0774b61ea8be7439c463dccefe104075af9a3b7e5653a45f9d722a5aa |
Hashes for mni2mz3-1.0.0rc2-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 63f1391dbb077afaf9aa7f5d66f73293fe649c62c26cc01b7a45689d50c4afe3 |
|
MD5 | 7b54bf25140d2687561c743074144ae4 |
|
BLAKE2b-256 | 9cc601546ba56ee4c2de7e4a3d1554adfdd6e5474925cc854ab182d904b46b9a |
Hashes for mni2mz3-1.0.0rc2-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3cf54e9df575a3352db0a2a80c69808c623b14eb7f3fceb2aeffc56ca9ef3f21 |
|
MD5 | 9e14bcbd5325d7eb5f1629db01064496 |
|
BLAKE2b-256 | 6e67551528c902e2b2586a7bd007b820e928166ab4648382a15d31305c5e6128 |
Hashes for mni2mz3-1.0.0rc2-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c73faa7780720b271a66dbd7974aec83dd6d8e1a055cae8777eb769c31513391 |
|
MD5 | 6c773ab74d60cd55d051a400805a1e1e |
|
BLAKE2b-256 | 863e5f37c4d6f95212a50bd7308e6439d80f047e8b06c941bb9b44720b7b8570 |
Hashes for mni2mz3-1.0.0rc2-py3-none-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ff5daddae50c5da44fbfe57b0d432d4958e01b3a268885b775103f5edd36cdae |
|
MD5 | c42f92d7abecc788d61268ffa356b81f |
|
BLAKE2b-256 | dc6bba1bb451044bc8828a5aa5755a9996fe4099ac4455e600403ebb4745d19c |
Hashes for mni2mz3-1.0.0rc2-py3-none-macosx_10_7_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a384c8a6599e8e3271d3ed539a77ddcc39a3eafd1ad8801b757f4fe5b8b69e5e |
|
MD5 | 518a0dff47829f5759a75aade40e464f |
|
BLAKE2b-256 | 87a707378a0faf2ebc0fde81ee033f7c8b0508d43e26e69488f92b34015a578f |