
ALLTOTET is a program to convert meshes with hexahedra, prisms and pyramids to meshes containing only tetrahedra elements

This program is based in the algorithm described in the article "How to Subdivide Pyramids, Prisms and Hexahedra into Tetrahedra"
written by Julien Dompierre et al. (see the pdf files in the DOC folder) . This algorithm is very fast because no neighbooring 
information regarding the non-tetrahedra elements is needed, so, the subdivision can also be done "on the fly" when the user don't 
need to save the tetrahedra mesh generated.

The name "AllToTet" suggests that this program could subdivide meshes with pyramids, prisms and hexahedra but in this first release, 
only Hex to Tet convertion is implemented. Note that the interested user can easily extend this program to perform Pyr to Tet and 
Pris to Tet conversions following the article cited above. The Hex to tet algorithm is the hardest to be implemented (and it's already done!)

LIMITATIONS: See the section 7 of the article

GENERAL NOTES:

- For some hexahedra combinations, more than one tetrahedra subdivisions are possible, but in this program was considered only the
first subdivision as described in the table 6 of the article. The further possibilities can be used with the nodal coordinates information
in order to decide the best subdivision.

- This distribution is supplied with a test case (example.* files) that can be used to help in the program understanding.

- The TOOLS folder contains some stuffs used during the development of this program:
  + hexas.mac: macro file used to export Ansys meshes;
  + PMVis distribution: PMVis is a nice mesh visualizer very easy to use. Just extract the program to a folder, add in your path and
    execute the example.bat file to see the example.tet mesh. Note that the example.bat is a PMVis command line to load the example.xyz
    and example.tet files.

* * * IMPORTANT NOTE * * *

- Bugs are expected since this is the first release and should be addressed to the author in order to be fixed.

Enjoy!

----------------------------------------------------------------------------------------------------------------------------------------------

AUTHOR     : Renato N. Elias 
MAIL       : rnelias@gmail.com
WEBPAGE    : http://www.nacad.ufrj.br/~rnelias
DATE       : 6th of January, 2006
AFFILIATION: High Performance Computing Center (COPPE/UFRJ) (http://www.nacad.ufrj.br)


All credits to Julien Dompierre et al. by their very didactic paper!

