Mesh Evaluation: Difference between revisions

From FreeCAD Documentation
No edit summary
mNo edit summary
 
(17 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Page in progress}}

<translate>
<translate>


<!--T:3-->
{{Docnav
{{Docnav
|[[Mesh_RemeshGmsh|Mesh RemeshGmsh]]
|[[Mesh_RemeshGmsh|RemeshGmsh]]
|[[Mesh_EvaluateFacet|Mesh EvaluateFacet]]
|[[Mesh_EvaluateFacet|EvaluateFacet]]
|[[Mesh_Workbench|Mesh]]
|[[Mesh_Workbench|Mesh]]
|IconL=
|IconL=Mesh_RemeshGmsh.svg
|IconR=Mesh_EvaluateFacet.svg
|IconR=Mesh_EvaluateFacet.svg
|IconC=Workbench_Mesh.svg
|IconC=Workbench_Mesh.svg
}}
}}


<!--T:4-->
{{GuiCommand
{{GuiCommand
|Name=Mesh Evaluation
|Name=Mesh Evaluation
|Empty=1
|MenuLocation=Meshes → Analyze → Evaluate and repair mesh...
|MenuLocation=Meshes → Analyze → Evaluate and repair mesh...
|Workbenches=[[Mesh_Workbench|Mesh]]
|Workbenches=[[Mesh_Workbench|Mesh]]
}}
}}


==Description==
==Description== <!--T:5-->


<!--T:6-->
The '''Mesh Evaluation''' command can evaluate and repair mesh objects.
The '''Mesh Evaluation''' command evaluates and repairs a mesh object.


</translate>
</translate>
[[Image:Mesh_Evaluation_dialog.png]]
[[Image:Mesh_Evaluation_dialog.png|300px]]
<translate>
<translate>
<!--T:7-->
{{Caption|The Evaluate & Repair Mesh dialog box with the Folds on surface option enabled}}
{{Caption|The Evaluate & Repair Mesh dialog box with the Folds on surface option enabled}}


==Usage==
==Usage== <!--T:8-->


<!--T:9-->
# Optionally select a single mesh object.
# Optionally select a single mesh object.
# There are several ways to invoke the command:
# Select the {{MenuCommand|Meshes → Analyze → Evaluate and repair mesh...}} option from the menu.
#* 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:
# Optionally press the {{Button|Settings...}} button to change the following settings:
#* {{MenuCommand|Check for non-manifold points}}
#* {{MenuCommand|Check for non-manifold points}}
Line 40: Line 44:
# If you have not yet selected a mesh object: select one from the dropdown list at the top of the dialog box.
# 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.
# 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 automatically checked to indicate that errors were found.
# 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.
# Press any of the {{Button|Analyze}} buttons to start a test.
# Or use the {{Button|Analyze}} button from the {{MenuCommand|All above test together}} option to run all 7 or 8 tests together.
# 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]].
# 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 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 next plan to run all tests together there is no need to do this.
# 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.
# 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.
# 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.
# The {{Button|Refresh}} button does not work properly at this time.


==Notes==
==Notes== <!--T:10-->


<!--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.
* 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==
==Preferences== <!--T:12-->


<!--T:13-->
* The {{MenuCommand|Check for non-manifold points}} setting is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → Mod → Mesh → Evaluation → CheckNonManifoldPoints}}.
* 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|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}}.
* 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
{{Docnav
|[[Mesh_RemeshGmsh|Mesh RemeshGmsh]]
|[[Mesh_RemeshGmsh|RemeshGmsh]]
|[[Mesh_EvaluateFacet|Mesh EvaluateFacet]]
|[[Mesh_EvaluateFacet|EvaluateFacet]]
|[[Mesh_Workbench|Mesh]]
|[[Mesh_Workbench|Mesh]]
|IconL=
|IconL=Mesh_RemeshGmsh.svg
|IconR=Mesh_EvaluateFacet.svg
|IconR=Mesh_EvaluateFacet.svg
|IconC=Workbench_Mesh.svg
|IconC=Workbench_Mesh.svg

Latest revision as of 16:28, 25 November 2023

Mesh Evaluation

Menu location
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

  1. Optionally select a single mesh object.
  2. There are several ways to invoke the command:
  3. The Evaluate & Repair Mesh dialog box opens.
  4. 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
  5. If you have not yet selected a mesh object: select one from the dropdown list at the top of the dialog box.
  6. The dialog contains 7 or 8 (if the Folds on surface option is enabled) test options.
  7. Do not use the checkboxes, they will be checked automatically if errors are found.
  8. Press any of the Analyze buttons to start a test.
  9. Or use the Analyze button from the All above tests together option to run all 7 or 8 tests together.
  10. Errors will be indicated in the dialog box, and also, with yellow and red markers, in the 3D view.
  11. Optionally press one or more Repair buttons to repair the errors that were found.
  12. 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.
  13. Optionally select a different mesh object from the dropdown list to continue testing and repairing.
  14. Press the Close button to close the dialog box and finish the command.
  15. The Refresh button does not work properly at this time.

Notes

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.