header

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

Lyon, M., Bommes, D. and Kobbelt, L. 2016. HexEx: Robust Hexahedral Mesh Extraction. ACM Trans. Graph.

Nieser, M., Reitebuch, U. and Polthier, K. 2011. CubeCover - Parameterization of 3D Volumes. The Eurographics Association and Blackwell Publishing Ltd.

Feedback

We are grateful for feedback! Please send suggestions, patches, bug reports, questions and comments to us.

Disclaimer Home Visual Computing institute RWTH Aachen University