A diagnostic compound for visualizing and analyzing mesh geometry and properties.

Outputs an array of objects representing geometry that can be output to visualize mesh properties.

There are several parameter sections that allows users to configure the analysis. Each parameter section is explained below.

Inputs

mesh

The mesh input port accepts the mesh being analyzed.

probe_geometry

This geometry can be used to limit the parts of the mesh that are visualized. The probe geometry is assumed to be a water-tight mesh, with no self-intersections. Faces of the input mesh that lie outside of the probe_geometry are culled away before the visualization data is generated. This is useful when the amount of visualization data generated is large and overlaps with each other.

Points Section

This parameter section controls the visualization of point properties of the mesh.

display_points

Displays the points as circles.

point_tag

An auto port that is interpreted as a point tag. array, array, and a string are acceptable types that can be plugged in here. See interpret_auto_port_as_component_tag for more information.

display_point_ids

Displays the id values of each point.

highlight_tagged_points

When checked, the points specified by the point_tag are highlighted. This is only enabled if display_points is also enabled.

display_only_tagged_points

When checked, only the points specified by the point_tag are shown. This is only enabled if display_points is also enabled.

Colors Section

point_color

The color of the displayed points.

highlighted_point_color

The color to display highlighted points.

Adjacency Section

This parameter section controls the visualization of the adjacency (neighborhood) information of the mesh.

display_face_edges

Display the face edges of each face. Each face edge consists of two face vertices; a starting face vertex and an ending face vertex. The arrows of the faces edges point from the starting face vertex to the ending face vertex.

display_face_edge_neighbors

Display the twins of each face edge drawn as arrows between face edges. For most meshes each face edge will be adjacent to exactly one other face edge. Face edges along border edges will not be adjacent to any other face edges, and no arrows will be drawn for these edges. Face edges that are adjacent to more than one other face edge are called non-manifold edges. In these cases the arrows are arranged in a daisy-chain with the each face edge pointing to the next adjacent face edge, and the last face edge pointing back to the first. Enable the display_border_edges and the display_nonmanifold_edges to visualize the border and nonmanifold edges respectively.

display_point_face_neighbors

Displays arrows for each point to the face vertices that reference that point. The number of arrows emanating from each point is called the degree or the valence of the vertex. Constructing meshes with high valence points is generally discouraged.

Colors Section

point_face_neighbor_color

The color of the point face neighbor arrows.

face_edge_color

The color the face edges.

face_edge_neighbor_color

The color of the face edge neighbor arrows.

Face Edges

display_non_manifold_edges

Display any non-manifold edges of the mesh. Non-manifold edges are ones that are adjacent to more that two faces. Constructing meshes with non-manifold edges should be avoided.

display_border_edges

Display any border edges of the mesh. Border edges are edges that are adjacent to only one face. Meshes with no border edges are called water-tight meshes.

display_edges

Display the edges of the mesh.

Colors Section

non_manifold_edge_color

The color of the non-manifold edges.

border_edge_color

The color of the border edges.

edge_color

The color of the edges.

Face Vertices

display_face_vertex_ids

Displays the ids of the face vertices. When enabled the mesh is displayed in shrunken mode. In this mode the faces are detached from each other, and scaled down. This is to better visualize the face vertex values of each face.

face_shrink_amount

The amount to shrink the faces in shrunken mode.

Faces

display_faces

Displays the faces of the mesh.

display_face_ids

Displays the face ids of each face, located at the centroid of the face.

face_tag

An auto port that is interpreted as a face tag. array, array, and a string are acceptable types that can be plugged in here. See interpret_auto_port_as_component_tag for more information.

highlight_tagged_faces

Will highlight any tagged faces when a face_tag value is given.

display_only_tagged_faces

Will cull any untagged faces, if a face_tag value is given.

highlighted_face_color

The color to display highlighted faces.

Normals

display_face_vertex_normals

Display face vertex normals. They are generated for the mesh if this is enabled, but no face_vertex_normal property exists on the input mesh.

display_vertex_normals

Display vertex normals. They are generated for the mesh if this is enabled, but no point_normal property exists on the input mesh.

display_face_normals

Display face normals. They are generated for the mesh if this is enabled, but no face_normal property exists on the input mesh.

normal_length_multiplier

Normals are drawn with arrows. The length of the arrows corresponds to the length of the normals' geo property in the mesh. They usually have a length of 1. This multiplier can be used to make the arrows longer or shorter to make them easier to see on very large and very small meshes.

Colors Section

point_normal_color

The color of the arrow strands that represent the point normals.

face_vertex_normal_color

The color of the arrow strands that represent the face vertex normals.

face_normal_color

The color of the arrow strands that represent the face normals.

Diagnostic Geo

strand_thickness_multiplier

Some diagnostic geometry, such as edges, are output as strands. The thickness of the strands is determined by the average edge length of the faces of the mesh, so that meshes with smaller faces have thinner strands. This multiplier can be used to modulate the strand thickness.

arrow_thickness_multiplier

Some diagnostic geometry, such as normals, are output as arrow strands. The thickness of the arrows is determined by the average edge length of the faces of the mesh, so that meshes with smaller haces have thinner arrows. This multiplier can be used to modulate the arrow thickness.

id_offset

Offsets the display of point/face ids along the surface normals for better visibility.

Outputs

diagnostic_geo

An array of diagnostic geometries that represent the visualization data enabled by the user. This array will contain a mix of point, strand and mesh geometries.