libHexEx
libHexEx is an implementation of HexEx [Lyon et al. 2016] distributed under GPLv3.
If you make use of libHexEx in your scientific work, please cite our paper. For your convenience,
you can use the following bibtex snippet:
@article{Lyon:2016:HRH:2897824.2925976,
author = {Lyon, Max and Bommes, David and Kobbelt, Leif},
title = {{H}ex{E}x: Robust Hexahedral Mesh Extraction},
journal = {ACM Trans. Graph.},
year = {2016},
numpages = {11},
url = {http://dx.doi.org/10.1145/2897824.2925976},
doi = {10.1145/2897824.2925976},
acmid = {2925976},
publisher = {ACM},
address = {New York, NY, USA},
keywords = {hex meshing, parametrization, mesh extraction},
}
What is HexEx?
HexEx is a method for robust hex mesh extraction from 3D Integer-Grid Maps with imperfections. (Imperfect) 3D Integer-Grid Maps are what is generated by most state-of-the-art hex meshing methods such as CubeCover [Nieser et al. 2011].
Hex extraction is a complicated task because numerous special cases, ambiguities induced by numerical inaccuracies and limited solver precision, as well as imperfections in the maps pose significant challenges to the hex mesh extractor.
Read our paper if you want to find out why hex extraction is complicated and how we tackle it or skip ahead and download the source code if you don't care about the details and just need results.
Download
You can get the latest version of libHexEx in our GitLab.
Alternatively you can download this command line tool for Windows or for Linux
which reads a tetrahedral mesh and a parametrization from an input file in ASCII format and stores the result
as an OpenVolumeMesh file.
You can download example inputs for the HexEx command line tool here.
License
libHexEx is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your
option) any later version. See http://www.gnu.org/licenses/.
If you make use of libHexEx in scientific work we kindly ask you to cite our
paper. (You can use the bibtex snippet above.)
Contributing
If you encounter an issue/bug/segfault you are more than welcome to report the issue on libHexEx' GitLab page.
Bibliography
Feedback
We are grateful for feedback! Please send suggestions, patches, bug reports, questions and comments to us.
