Home

Geogram documentation

Geogram is a programming library with geometric algorithms. It has geometry-processing functionalities (reconstruction, parameterization, remeshing, ...). It also has lower-level algorithm (Delaunay/Voronoi, geometric search, solving linear systems...). See the list of mini-tutorials below.

Geogram contains the main results in Geometry Processing from the former ALICE Inria project, that is, more than 30 research articles published in ACM SIGGRAPH, ACM Transactions on Graphics, Symposium on Geometry Processing and Eurographics. It was supported by two grants from the European Research Council (ERC): GOODSHAPE and VORPALINE.

Geogram project on github

Compiling

• Instructions for Linux
• Instructions for Windows
• Instructions for OS/X
• Instructions for MingW/plain Makefile
• Instructions for Emscripten

Releases

• Latest release

Programmer's reference manual

• All classes and functions

Mini tutorials and example programs

• User documentation
  • Vorpaview mesh viewer
• The geometry processing pipeline
  • Overview
  • Surface reconstruction from pointset
  • Remeshing
  • Parameterization and texturing
• Geometric algorithms and data structures
  • 2D Delaunay triangulations
  • 3D Delaunay triangulations
  • Mesh data structure
  • Raytracing, Ambient Occlusion and AABBs
  • Manifold Harmonics
• Technicalities
  • OpenNL: Solving linear systems
  • GLUP: 3D Graphics without the headache
  • Developping an application with a GUI
  • DevOps

References

• Projects and publications with geogram
• Third-party libraries
• Keynote Eurographics presentation on geogram.
• Graphite, an experimental 3D modeler built around geogram.

How does it compare to other geometry-processing libraries ?

There exists other libraries for geometric computing / geometry processing, such as:

• CGAL
• libIGL

It is difficult to compare different "swiss army knives" that have a completely different set of blades. The specificity of Geogram as compared to these generic libraries is that it is targeted towards some specific scenari with no compromise concerning performance and memory consumption. For instance, Geogram's 3D triangulation can be applied to pointsets with hundred millions points that we use in our research in cosmology, where the data structures used by other library would not fit in memory. This comes at the expense of less genericity (for instance, CGAL has a function to remove a point from a 3D Delaunay triangulation that Geogram does not have).

Another difference is the programming style and the design choices: Geogram is not a header-only library and makes a moderate use of modern C++ programming. This difference is rather a question of programmer's taste.

Geogram comes "with batteries installed" (nearly no external dependancies) and is easy to compile. It does not depend on BOOST (that we find too heavy, again it is a question of taste).

Geogram works under Linux/Windows/Mac/Android/Emscripten. Emscripten lets you compile programs and include them in webpages, see examples here.