Skip to content

A prototyping-oriented UI for geometric algorithms

License

Notifications You must be signed in to change notification settings

connorzl/polyscope

 
 

Repository files navigation

Polyscope

Polyscope is a C++ viewer and user interface for the rapid prototyping and debugging of geometric algorithms in 3D geometry processing, scientific computing, and computer graphics/vision. The lofty objective of Polyscope is to offer a useful visual interface to your data via a single line of code.

Polyscope uses a paradigm of structures and quantities. A structure is a geometric object in the scene, such as a surface mesh or point cloud. A quantity is data associated with a structure, such as a scalar function or a vector field.

The following structures and quantities are supported (or planned):

  • Surface meshes
    • Scalar functions (on vertices, faces, edges, halfedges, or corners)
    • Vector fields (extrinsic or embedded in the surface, symmetric, etc)
    • Distance functions
    • Subsets of mesh elements
    • Parameterizations
  • Point clouds
    • Scalar functions
    • Vector functions
  • Camera views
    • RGB images
    • Scalar images
  • Ray sets
  • Volume meshes
  • Octrees

When any of these structures and quantities are registered, Polyscope displays them in an interactive 3D scene, handling boilerplate concerns such as toggling the display of various data, colormapping data and editing maps, providing "picking" support to click in the scene and display numerical quantities, and generating histograms of scalar values.

A simple workflow for visualizing data in Polyscope looks like:

#include "polyscope.h"

// Initialize polyscope
polyscope::init();

// Register a surface mesh structure
polyscope::registerSurfaceMesh("my mesh", meshGeometry);

// Add a scalar and a vector function to the mesh
polyscope::getSurfaceMesh("my mesh")->addQuantity("my_scalar", scalarQuantity);
polyscope::getSurfaceMesh("my mesh")->addQuantity("my_vector", vectorQuantity);

// Show the gui
polyscope::show();

The last line creates a UI window allowing you to inspect and visualize the data! For details on the API, see the documentation.


Development of this software was funded in part by NSF Award 1717320, an NSF graduate research fellowship, and gifts from Adobe Research and Autodesk, Inc.

About

A prototyping-oriented UI for geometric algorithms

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 89.6%
  • C 8.9%
  • Other 1.5%