Mesh Evaluation: Difference between revisions

Latest revision as of 16:28, 25 November 2023

Other languages:

RemeshGmsh

EvaluateFacet

Mesh

Menu location
Mesh Evaluation
Meshes → Analyze → Evaluate and repair mesh...
Workbenches
Mesh
Default shortcut
None
Introduced in version
-
See also
None

Description

The Mesh Evaluation command evaluates and repairs a mesh object.

The Evaluate & Repair Mesh dialog box with the Folds on surface option enabled

Usage

Optionally select a single mesh object.
There are several ways to invoke the command:
- Press the Evaluate and repair mesh... button.
- Select the Meshes → Analyze → Evaluate and repair mesh... option from the menu.
The Evaluate & Repair Mesh dialog box opens.
Optionally press the Settings... button to change the following settings:
- Check for non-manifold points
- Enable check for folds on surface
- Only consider zero area faces as degenerated
If you have not yet selected a mesh object: select one from the dropdown list at the top of the dialog box.
The dialog contains 7 or 8 (if the Folds on surface option is enabled) test options.
Do not use the checkboxes, they will be checked automatically if errors are found.
Press any of the Analyze buttons to start a test.
Or use the Analyze button from the All above tests together option to run all 7 or 8 tests together.
Errors will be indicated in the dialog box, and also, with yellow and red markers, in the 3D view.
Optionally press one or more Repair buttons to repair the errors that were found.
Optionally press the Reset button to reset all test results. This will reset the dialog and remove the colored markers from the 3D view. If you want to repeat the same test or run all tests together there is no need to do this.
Optionally select a different mesh object from the dropdown list to continue testing and repairing.
Press the Close button to close the dialog box and finish the command.
The Refresh button does not work properly at this time.

Notes

Repairing a mesh can mean that problematic elements are deleted from the mesh resulting in holes. Holes can be closed with the Mesh FillupHoles, Mesh FillInteractiveHole and Mesh AddFacet commands.
See this forum post for an explanation of the mesh data structure. This information may help to understand why a mesh has problems.

Preferences

The Check for non-manifold points setting is stored: Tools → Edit parameters... → BaseApp → Preferences → Mod → Mesh → Evaluation → CheckNonManifoldPoints.
The Enable check for folds on surface setting is stored: Tools → Edit parameters... → BaseApp → Preferences → Mod → Mesh → Evaluation → EnableFoldsCheck.
The Only consider zero area faces as degenerated setting is stored: Tools → Edit parameters... → BaseApp → Preferences → Mod → Mesh → Evaluation → StrictlyDegenerated.

RemeshGmsh

EvaluateFacet

Mesh

Miscellaneous: Import mesh, Export mesh, Create mesh from shape, Regular solid, Unwrap Mesh, Unwrap Face
Modifying: Harmonize normals, Flip normals, Fill holes, Close hole, Add triangle, Remove components, Remove components by hand, Smooth, Refinement, Decimation, Scale

Boolean: Union, Intersection, Difference
Cutting: Cut mesh, Trim mesh, Trim mesh with a plane, Create section from mesh and plane, Cross-sections
Components and segments: Merge, Split by components, Create mesh segments, Create mesh segments from best-fit surfaces

Analyze: Evaluate and repair mesh, Face info, Curvature plot, Curvature info, Check solid mesh, Boundings info
Additional: Import Export Preferences, OpenSCAD Workbench, Mesh Scripting

User documentation

Getting started
Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

Help: Tutorials, Video tutorials
Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web

Addons: Addon Manager, External workbenches, Scripting and macros

Hubs: User hub, Power users hub, Developer hub

@@ Line 1: / Line 1: @@
-{{UnfinishedDocu{{#translation:}}}}
 <languages/>
 <translate>
-<!--T:6-->
+<!--T:3-->
 {{Docnav
+|[[Mesh_RemeshGmsh|RemeshGmsh]]
-|[[Mesh_Scale|Scale]]
-|[[Mesh_EvaluateFacet|Face Info]]
+|[[Mesh_EvaluateFacet|EvaluateFacet]]
 |[[Mesh_Workbench|Mesh]]
-|IconL=
+|IconL=Mesh_RemeshGmsh.svg
 |IconR=Mesh_EvaluateFacet.svg
 |IconC=Workbench_Mesh.svg
 }}
-<!--T:1-->
+<!--T:4-->
 {{GuiCommand
-|Name=Mesh EvaluateRepair‏
+|Name=Mesh Evaluation
+|MenuLocation=Meshes → Analyze → Evaluate and repair mesh...
-|Empty=1
+|Workbenches=[[Mesh_Workbench|Mesh]]
-‎|MenuLocation=Meshes → Analyze → Evaluate & Repair mesh...
-|Workbenches=[[Mesh Workbench|Mesh]]
 }}
-==Description== <!--T:10-->
+==Description== <!--T:5-->
-<!--T:2-->
+<!--T:6-->
+The '''Mesh Evaluation''' command evaluates and repairs a mesh object.
-Evaluates and repairs meshes.
+</translate>
-==Usage== <!--T:11-->
+[[Image:Mesh_Evaluation_dialog.png|300px]]
+<translate>
+<!--T:7-->
+{{Caption|The Evaluate & Repair Mesh dialog box with the Folds on surface option enabled}}
-<!--T:3-->
+==Usage== <!--T:8-->
-# Select mesh in [[Tree view]] or choose {{MenuCommand|Meshes → Analyze → Evaluate & Repair mesh...}} from the Mesh menu. A corresponding dialog menu will pop up.
-# Using the [[Selection view]], change the mesh to be analyzed and repaired.
-# Choose subject to be analyzed by checking appropriate box and clicking on {{Button|Analyze}}
-#* If no problems were found: the text beside the box will change to reflect that.
-#* If problems were found: the option is available to click on {{Button|Repair}} and try a repair of the mesh.
-#* Note: the very last option at the bottom of the dialog "All above tests together", offers the ability to run all the tests in one single sweep.
-:::[[Image:Mesh_EvaluateRepairMesh.jpg]]
-{{Caption|Above: Evaluate & Repair mesh... dialog. Note the final option to run all tests at once.}}
-==Limitations== <!--T:4-->
+<!--T:9-->
+# Optionally select a single mesh object.
+# There are several ways to invoke the command:
+#* Press the {{Button|[[Image:Mesh_Evaluation.svg|16px]] [[Mesh_Evaluation|Evaluate and repair mesh...]]}} button.
+#* Select the {{MenuCommand|Meshes → Analyze → [[Image:Mesh_Evaluation.svg|16px]] Evaluate and repair mesh...}} option from the menu.
+# The {{MenuCommand|Evaluate & Repair Mesh}} dialog box opens.
+# Optionally press the {{Button|Settings...}} button to change the following settings:
+#* {{MenuCommand|Check for non-manifold points}}
+#* {{MenuCommand|Enable check for folds on surface}}
+#* {{MenuCommand|Only consider zero area faces as degenerated}}
+# If you have not yet selected a mesh object: select one from the dropdown list at the top of the dialog box.
+# The dialog contains 7 or 8 (if the {{MenuCommand|Folds on surface}} option is enabled) test options.
+# Do not use the checkboxes, they will be checked automatically if errors are found.
+# Press any of the {{Button|Analyze}} buttons to start a test.
+# Or use the {{Button|Analyze}} button from the {{MenuCommand|All above tests together}} option to run all 7 or 8 tests together.
+# Errors will be indicated in the dialog box, and also, with yellow and red markers, in the [[3D_view|3D view]].
+# Optionally press one or more {{Button|Repair}} buttons to repair the errors that were found.
+# Optionally press the {{Button|Reset}} button to reset all test results. This will reset the dialog and remove the colored markers from the 3D view. If you want to repeat the same test or run all tests together there is no need to do this.
+# Optionally select a different mesh object from the dropdown list to continue testing and repairing.
+# Press the {{Button|Close}} button to close the dialog box and finish the command.
+# The {{Button|Refresh}} button does not work properly at this time.
+==Notes== <!--T:10-->
-==Notes== <!--T:5-->
+<!--T:11-->
+* Repairing a mesh can mean that problematic elements are deleted from the mesh resulting in holes. Holes can be closed with the [[Mesh_FillupHoles|Mesh FillupHoles]], [[Mesh_FillInteractiveHole|Mesh FillInteractiveHole]] and [[Mesh_AddFacet|Mesh AddFacet]] commands.
+* See [https://forum.freecadweb.org/viewtopic.php?f=3&p=533252#p533252 this forum post] for an explanation of the mesh data structure. This information may help to understand why a mesh has problems.
+==Preferences== <!--T:12-->
-<!--T:7-->
+<!--T:13-->
+* The {{MenuCommand|Check for non-manifold points}} setting is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → Mod → Mesh → Evaluation → CheckNonManifoldPoints}}.
+* The {{MenuCommand|Enable check for folds on surface}} setting is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → Mod → Mesh → Evaluation → EnableFoldsCheck}}.
+* The {{MenuCommand|Only consider zero area faces as degenerated}} setting is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → Mod → Mesh → Evaluation → StrictlyDegenerated}}.
+<!--T:14-->
 {{Docnav
+|[[Mesh_RemeshGmsh|RemeshGmsh]]
-|[[Mesh_Scale|Scale]]
-|[[Mesh_EvaluateFacet|Face Info]]
+|[[Mesh_EvaluateFacet|EvaluateFacet]]
 |[[Mesh_Workbench|Mesh]]
-|IconL=
+|IconL=Mesh_RemeshGmsh.svg
 |IconR=Mesh_EvaluateFacet.svg
 |IconC=Workbench_Mesh.svg
@@ Line 57: / Line 81: @@
 {{Mesh Tools navi{{#translation:}}}}
 {{Userdocnavi{{#translation:}}}}
+{{clear}}