MVox is a tool for generating finite element meshes from image data.
Clone the repository using Git:
git clone https://github.com/benzwick/mvox.git
MVox can be configured and installed using the CMake build system.
MVox depends on the MFEM and ITK libraries which must be installed first.
For instructions on how to install MFEM see https://github.com/mfem/mfem/blob/master/INSTALL.
For use with MVox it is sufficient to configure MFEM with the default options.
For instructions on how to install ITK see https://itk.org/Wiki/ITK/Source#Linux_Package_Distributions.
For example, to install ITK on Ubuntu 22.04:
sudo apt-get install libinsighttoolkit4-dev
Configure and make MVox in the
../build
build directory relative to the
./mvox
source directory:
cd ..
mkdir build
cd build
cmake -DMFEM_DIR=/opt/mfem/mfem-4.4 ../mvox
make
make install
The MFEM_DIR
variable is optional
and can be used to specify the location
of the MFEM library.
MVox is a CLI program.
For instructions on how to use MVox type mvox --help
.
TODO: Example scripts and input data files can be found in the examples directory.
To create a mesh and symmetric tensors grid function:
mvox -imask brain_mask.nrrd -iattr label.nrrd -itensor dti.nrrd -omesh mesh.mesh -sym -otensor dti.gf.gz
To view a tensor components using GLVis:
glvis -m mesh.mesh -g dti.gf.gz -gc 0
MVox is free software: you can redistribute it and/or modify it under the terms of the BSD 3-Clause License. See file LICENSE for details.
If you use MVox for your research, please consider adding the following citation:
- Zwick, B.F. (2020) MVox Mesh Voxelizer. Available at: https://github.com/benzwick/mvox
BibTeX:
@Misc{zwick_2020_mvox,
author = {Benjamin F. Zwick},
title = {{MVox} {M}esh {V}oxelizer},
howpublished = {\url{https://github.com/benzwick/mvox}},
year = 2020
}