First, make sure you have installed an git client on your system. If your system is a Debian-based GNU/Linux system (such as Ubuntu, Knoppix etc), you can install git by
sudo apt-get install git-coreif you are using a Redhat-based GNU/Linux system (such as Fedora, CentOS etc), you can do this by
su -c 'yum install git-core'If your operating system is Windows, we recommend you installing TortoiseGit.
The latest iso2mesh software can be checked out from our github site using the following command
git clone https://github.com/fangq/iso2mesh
or click on "this link" to download a zip package.
After checking out the code, you need to set up the path based on the installation instructions. Then you can start matlab or octave, and run the example scripts under the sample directory.
Please fork iso2mesh on github.
Particularly, the 3D meshing tool, tetgen, is licensed under a non-free license: it can be freely used, modified, redistributed only for research and academic purposes, any commercial utility of tetgen requires a permission from its original author. iso2mesh calls tetgen in the background to produce 3D mesh, that means if anyone needs to uses the 3D mesh produced by iso2mesh in a commercial product, you MUST contact the author of tetgen to get permission. Processing binary images and produce surfaces are not subject to this limitation.
In additional to the licenses, if you use this tool in your research, we are greatly appreciated if you can add iso2mesh to your references:
Qianqian Fang and David Boas, "Tetrahedral mesh generation from volumetric binary and gray-scale images," Proceedings of IEEE International Symposium on Biomedical Imaging 2009, pp. 1142-1145, 2009
If you used cgalsurf or cgalmesh options in your mesh preparation, you should also acknowledge CGAL publications. If you generated your mesh with the tetgen module in iso2mesh instead of CGAL mesher, you may need to acknowledge tetgen in your publications, you can find more references from this link.