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.0rc4-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f67bbec653063e5b008c48c68032cbda60bb58a0ba096fc61c8b2843f06242e2 |
|
MD5 | 8b82ce50e2ba8d5dd250224b649fc545 |
|
BLAKE2b-256 | 1fda453c8668c0e1bd8a6530e6bb95523ac22dd5ea082e670d108a530e404082 |
Hashes for mni2mz3-1.0.0rc4-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 66ee893b119c4ff0438f8a2c48532e8755b00c496823d28f2748a7c5d4e69d11 |
|
MD5 | 921ef4211664f45f3abc2339f18b236e |
|
BLAKE2b-256 | 37ea9ee7e5ef503f81041790298ad213765c3d6b6f407bcc08bd4cb9746c4bcf |
Hashes for mni2mz3-1.0.0rc4-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7ca0c382531734c17b1a52fdee143b27ceb6994bffd7594643da4d5400981aa7 |
|
MD5 | f5afa42d2655e7c1f7776fc3cfd8b19c |
|
BLAKE2b-256 | 5497b256fe59083d86fdc6b2553dd21e8a08e6d6cafa1890f693c5357cf8ef7c |
Hashes for mni2mz3-1.0.0rc4-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4f335686720dd4a279c58343b07e9c174ce6ba3bbf5bcb0233dd46564813be9f |
|
MD5 | a2e4ad4302690b6ffddbad410f2e5a3d |
|
BLAKE2b-256 | 91db1fe73bb18558291e53b4570ce7fa51578b79560854516b068253f46a8373 |
Hashes for mni2mz3-1.0.0rc4-py3-none-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a981913aafd6c596ab65c0902cac77d0acd5583a7f62829059105ac94f16ff74 |
|
MD5 | 0dcec3909daa8acfb76be0ed1ce75d79 |
|
BLAKE2b-256 | bc732dc7d00e2857267fbb9acac37462dc9d6e1fe3879be7fdba8663a8b93e5f |
Hashes for mni2mz3-1.0.0rc4-py3-none-macosx_10_7_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c57307b1e94e663ee987306e182a7c4d7fa71c027f0ec717bca2d18b7063f4fb |
|
MD5 | 61752f2c6f91a0e7681dbf1037395f8e |
|
BLAKE2b-256 | dbd1493693e89491249eb65d58d81fd06ae2b2b0366650156c3336f23865e31a |