Surface Meshes
Surface meshes are one of the core structures in Polyscope. In addition to simply displaying the mesh, Polyscope can show any number of scalar, vector,color, and other kinds of quantities associated with the vertices/faces/etc of the mesh.
Polyscope does not impose any requirements on the meshes visualized. They may be polygonal or nonmanifold, and all faces need not have the same degree. As always, try clicking on the vertices or faces of a mesh see the data associated with that mesh element.
Registering a surface mesh
Example: registering a mesh
import numpy as np
import polyscope as ps
ps.init()
vertices = np.random.rand(100, 3) # (V,3) vertex position array
faces = np.random.randint(0, 100, size=(250,3)) # (F,3) array of indices
# for triangular faces
# visualize!
ps_mesh = ps.register_surface_mesh("my mesh", vertices, faces)
ps.show()
Surface meshes are registered with Polyscope by passing the location of each vertex in the mesh, as well as the vertex indices for each face.
register_surface_mesh(name, vertices, faces, enabled=None, color=None, edge_color=None, smooth_shade=None, edge_width=None, material=None)
Add a new surface mesh structure to Polyscope.
name
string, a name for the structurevertices
, anNx3
numpy float array of vertex locations (orNx2
for 2D)faces
, anFxD
numpy integer array of faces, as 0-based indices in to the vertices array, OR a plain python list-of-lists of indices (or really, anything twice-iterable which yields integers). The latter option enables meshes where not all faces have the same degree.
Additional optional keyword arguments:
enabled
boolean, is the structure enabled initiallycolor
float 3-tuple, default color values for the mesh as rgb in [0,1]edge_color
float 3-tuple, default color values for edges of the mesh as rgb in [0,1] (be sure to setedge_width
too)edge_width
float, width of edges in rendered mesh; default sets0
to disable edges,1
is a reasonable value to enablesmooth_shade
boolean, ifTrue
use smooth shading (default:False
for flat shading)material
string, name of material to use for the mesh
if not specified, these optional parameters will assume a reasonable default value, or a persistant value if previously set.
2D vertex positions are also supported, see 2D data.
Element ordering
Polyscope quantities are ordered arrays of data, but not everone can agree on the ordering of elements in a mesh. See indexing conventions.
The default ordering is probably the same as yours for data on vertices, faces, and corners. However, data on edges and halfedges is much more likely to require setting an ordering.
Updating a mesh
The locations of the vertices in a mesh can be updated with the member function update_vertex_positions(newPositions)
. All quantities will be preserved. Changing the connectivity or element counts in a mesh is not supported, you will need to register a new mesh (perhaps with the same name to overwrite).
SurfaceMesh.update_vertex_positions(newPos)
Update the vertex positions in a surface mesh structure. newPos
must be valid input as to initially construct the vertex positions, with the same number of vertices.
Options
Parameter | Meaning | Getter | Setter | Persistent? |
---|---|---|---|---|
enabled | is the structure enabled? | bool is_enabled() |
set_enabled(newVal) |
yes |
surface color | the color of the mesh | get_color() |
set_color(val) |
yes |
edge color | the color of the edges of the mesh | get_edge_color() |
set_edge_color(val) |
yes |
edge width | how thick to draw mesh edges, use 0. to disable and 1. for reasonable edges |
get_edge_width() |
set_edge_width(val) |
yes |
shade smooth | use smooth shading along faces or simple flat faces | get_smoooth_shade() |
set_smooth_shade(isSmooth) |
yes |
material | material for structure | get_material() |
set_material(newVal) |
yes |
Example: set options which affect the appearance of the mesh
import numpy as np
import polyscope as ps
vertices = np.random.rand(100, 3) # (V,3) vertex position array
faces = np.random.randint(0, 100, size=(250,3)) # (F,3) array of indices
# for triangular faces
ps_mesh = ps.register_surface_mesh("my mesh", vertices, faces)
ps_mesh.set_enabled(False) # disable
ps_mesh.set_enabled() # default is true
ps_mesh.set_color((0.3, 0.6, 0.8)) # rgb triple on [0,1]
ps_mesh.set_edge_color((0.8, 0.8, 0.8))
ps_mesh.set_edge_width(1.0)
ps_mesh.set_smooth_shade(True)
ps_mesh.set_material("candy")
# alternately:
ps.register_surface_mesh("my mesh2", vertices, faces, enabled=False,
color=(1., 0., 0.), edge_color=((0.8, 0.8, 0.8)),
edge_width=1.0, smooth_shade=True,
material='candy')