PoissonRecon

Adaptive Multigrid Solvers (Version 18.76)

links compilation executables library usage changes

---

This code-base was born from the Poisson Surface Reconstruction code. It has evolved to support more general adaptive finite-elements systems:

• in spaces of arbitrary dimension,
• discretized using finite-elements of arbitrary degree,
• involving arbitrary function derivatives,
• with both point-wise and integrated constraints.

---

LINKS

Papers: [Kazhdan, Bolitho, and Hoppe, 2006], [Agarwala, 2007] [Calakli and Taubin, 2011], [Crane, Weischedel, and Wardetzky, 2013], [Kazhdan and Hoppe, 2013], [Kazhdan and Hoppe, 2018], [Kazhdan, Chuang, Rusinkiewicz, and Hoppe, 2020] [Kazhdan and Hoppe, 2023]
Executables: Win64
Source Code: ZIP GitHub
Older Versions: V18.75, V18.74, V18.73, V18.72, V18.71, V18.70, V18.60, V18.55, V18.50, V18.42, V18.41, V18.40, V18.35, V18.31, V18.30, V18.20, V18.10, V18.05, V18.04, V18.03, V18.02, V18.01, V18.00, V17.00, V16.10, V16.09, V16.08, V16.07, V16.06, V16.05, V16.04, V16.03, V16.02, V16.01, V15.10, V15.03, V15.02, V15.01, V15.00, V14.02, V14.01, V14.00, V13.99, V13.80, V13.74, V13.73, V13.72, V13.71, V13.70, V13.61, V13.60, V13.50, V13.00, V12.00, V11.02, V11.01, V11.00, V10.07, V10.06, V10.05, V10.04, V10.03, V10.02, V10.01, V10.00, V9.011, V9.01, V9.0, V8.0, V7.0, V6.13a, V6.13, V6.12, V6.11, V6.1, V6, V5.71, V5.6, V5.5a, V5.1, V5, V4.51, V4.5, V4, V3, V2, V1

---

COMPILATION

• For efficiency, the code is designed to compile for the specific FEM degree and boundary condition specified in PoissonRecon.h. (Specifically, DEFAULT_FEM_DEGREE is set to 1 and DEFAULT_FEM_BOUNDARY is set to Neumann.) You can change the default values in PoissonRecon.h. You can also compile the code so that it supports varying FEM degrees and boundary conditions by #undef-ing FAST_COMPILE pre-processor definition in PreProcess.h. However, this will make the compilation significantly slower.
• By default, the implementation assumes that all indexing can be done with 32-bit integers. If you are reconstructing large scenes and need more bits for indexing, you should enable the BIG_DATA flag in PreProcessor.h. Note that if the generated mesh has more primitives than can be indexed by a 32-bit integer, the output .ply file will store the integers using 64-bit precision (designated by the long long type) instead of the standard 32-bit precision (designated by the int type). Note that this is not a standard format and software like MeshLab may not be able to read the file.
• The distributed PSR code uses sockets for communication between the client and the server. These are supported in a cross-platform way via Boost. (The code was developed and tested under Boost version 1.80.0.)
  
• To support reading/writing images, the code requires installation of the zlib, png, and jpg libraries. Source code for these is included for compilation using Visual Studios. The Makefile assumes that the header files can be found in /usr/local/include/ and that the library files can be found in /usr/local/lib/.
• In version 18.76, the default implementation of JPEG has been replaced to use libjpeg-turbo. You can revert to the earlier implementation by #undef-ing the USE_JPEG_TURBO pre-processor definition in PreProcessor.h. (In Visual Studios, you will also need to change "JPEG-turbo.lib" to "JPEG.lib" in the project propeties window: Configuration Properties -> Linker -> Input -> Additional Dependencies.)

---

EXECUTABLES

PoissonRecon: Reconstructs a triangle mesh from a set of oriented 3D points by solving a Poisson system (solving a 3D Laplacian system with positional value constraints) [Kazhdan, Bolitho, and Hoppe, 2006], [Kazhdan and Hoppe, 2013],