Meshes Properties
This page documents the properties available for meshes in VRGS. These properties appear in the Properties panel when an object of this type is selected.
triangulated meshes
Properties available for triangulated meshes objects:
Colour Scale Bar
Property name: Colour Scale Bar
Description Show the Colour Scale Bar
What it does
Show the Colour Scale Bar
Show Contours
Property name: Show Contours
Description Show the surface contours
What it does
Show the surface contours
LCPD
Property name: LCPD
Description Show the Isochore conditional probability data
What it does
Show the Isochore conditional probability data
Show Mesh
Property name: Show Mesh
Description Show Mesh
What it does
Show Mesh
Show Nodes
Property name: Show Nodes
Description Show Nodes
What it does
Show Nodes
Show Normals
Property name: Show Normals (in Mesh Structure)
Description Draw each vertex normal as a short line: cyan where it faces up, orange where it faces down, fading from base to tip
What it does
Draws each vertex normal as a short line in the Vulkan 3D view, from the vertex along the
normal the shading uses, so it follows Reverse Normals. An up-facing normal is cyan
and a down-facing one orange, and each line fades from a light base to a strong tip, so a
single line also shows its direction. Up and down go by the normal's Z. A mesh with more
than 2 million vertices shows every k-th normal, so the count stays at about 2 million.
Normal Colour does not affect these lines. Off by default. The OpenGL view draws
every vertex's normal as a plain line, without the colours.
When to use it
Use it to check that a surface's normals are consistent. A flipped patch reads as a block
of the wrong colour among its neighbours. On a steep face, where up and down are close,
read the direction along the lines rather than the colour. If the whole mesh is the wrong
way round, tick Reverse Normals or use
Reverse Winding.
Show Triangles
Property name: Show Triangles
Description Show Triangles
What it does
Show Triangles
Show Bounding Box
Property name: Show Bounding Box
Description Show the surface contours
What it does
Show the surface contours
Show Grid
Property name: Show Grid
Description Show the bounding box grid on the mesh
What it does
Show the bounding box grid on the mesh
Name
Property name: Name
Description Name of the surface
What it does
Name of the surface
File
Property name: File
Description Name of the surface file
What it does
Name of the surface file
Vertices
Property name: Vertices
Description Number of Vertices
What it does
Number of Vertices
Triangles
Property name: Triangles
Description Number of Triangles
What it does
Number of Triangles
Convergence
Property name: Convergence
Description Target Convergence (use a smaller number to improve convergence)
What it does
Target Convergence (use a smaller number to improve convergence)
Contour Interval
Property name: Contour Interval
Description Contour Step
What it does
Contour Step
Normal Length
Property name: Normal Length (in Mesh Structure)
Description Length of each normal line; 0 sizes it to the mesh
What it does
The length of each Show Normals line, in model units. 0, the default, makes it
0.5 % of the mesh's bounding-box diagonal: short enough not to bury the surface, long
enough to read at the model's scale.
When to use it
Raise it to read the normals from further away, or lower it on a densely sampled mesh
whose lines run into one another.
Attribute Min
Property name: Attribute Min
Description Specifies the minimum attribute value for colour scaling
What it does
Specifies the minimum attribute value for colour scaling
Attribute Max
Property name: Attribute Max
Description Specifies the maximum attribute value for colour scaling
What it does
Specifies the maximum attribute value for colour scaling
X Contour Interval
Property name: X Contour Interval
Description Contour Step
What it does
Contour Step
Y Contour Interval
Property name: Y Contour Interval
Description Contour Step
What it does
Contour Step
Z Contour Interval
Property name: Z Contour Interval
Description Contour Step
What it does
Contour Step
Font Size
Property name: Font Size
Description Font size for bounding box axes
What it does
Font size for bounding box axes
Normal Colour
Property name: Normal Colour
Description Specifies the normal color
What it does
Specifies the normal color
Contour Color
Property name: Contour Color
Description Specifies the default contour color
What it does
Specifies the default contour color
X Grid Color
Property name: X Grid Color
Description Specifies the default X Grid color
What it does
Specifies the default X Grid color
Y Grid Color
Property name: Y Grid Color
Description Specifies the default Y Grid color
What it does
Specifies the default Y Grid color
Use Attribute Filters
Property name: Use Attribute Filters (the Filters group)
Description Apply the Attribute Filters
What it does
Switches on the filters of the mesh's attributes, but only those whose own Use
Filter is ticked. Under Filters, each attribute has a group with its Use
Filter and Invert Filter boxes and its Filter Minimum and Filter Maximum.
These are the same settings as on the attribute's own property page (see Attributes
Properties). A ticked attribute
takes out the triangles whose value lies outside its window, or inside it with Invert
Filter. A triangle attribute is read at the triangle itself, a vertex attribute at
each of the triangle's corners. A null (no value) counts as outside the window. So while
it is ticked, an attribute that is empty over part of the mesh takes that part out: for
example, Patch Dip after a filtered run of Grow Planar Patches. An attribute with
Use Filter unticked takes nothing out, however its window is set.
The filtered triangles are left out of:
- Grow Planar Patches and Auto Structural Mapping, which do not grow on them. Filters on the patch layers themselves (Patches, Patch Colour, Patch Dip and the rest) are ignored. A run replaces those layers, so their old windows would only confine the new run to the old patches.
- Every export of the mesh (right-click it → Export), in any format: the file holds only the triangles the filters keep. The points-only formats, ASCII Points Only and ASCII Petrel Points and Attributes, leave out a point when a ticked vertex attribute filters it, and when ticked triangle attributes filter every triangle that uses it. See Getting Data In and Out.
The box does not hide triangles in the 3D view. When it leaves triangles or points out of an export, the Messages panel says how many, which is the only sign that the file holds part of the mesh. To see an attribute's window on the mesh, tick that attribute's own Use Filter. The Vulkan view then colours the values inside the window and shows the texture outside it. A point cloud's Use Attribute Filters follows the same rule: only the attributes with Use Filter ticked count. Off by default.
When to use it
Use it to confine a patch extraction, or an export, to part of the mesh chosen by
attribute value. For example, tick Use Filter on the vertex Dip attribute with
its window at 60 to 90, then tick this box, and Grow Planar Patches works on the steep
faces only, and an export writes only those faces. Untick the box to bring every
triangle back without losing the windows you set.
Tetrahedral Mesh
Properties available for Tetrahedral Mesh objects:
Tetrahedral Mesh - Name
Property name: Name
Description Name of the Mesh
What it does
Name of the Mesh
Tetrahedral Mesh - Nodes
Property name: Nodes
Description Number Of Nodes
What it does
Number Of Nodes
Tetrahedral Mesh - Tetrahedra
Property name: Tetrahedra
Description Number Of Tetrahedra
What it does
Number Of Tetrahedra
Mesh Group
Properties available for Mesh Group objects:
Mesh Group - Name
Property name: Name
Description Group Name
What it does
Group Name
MeshGraphNetwork
Properties available for MeshGraphNetwork objects:
MeshGraphNetwork - Name
Property name: Name
Description Name of the Graph Network
What it does
Name of the Graph Network
MeshGraphNetwork - Display Style
Property name: Display Style
Description Display style for object
What it does
Display style for object
MeshGraphNetwork - Weight
Property name: Weight
Description Tracking Weight
What it does
Tracking Weight