Part CheckGeometry: Difference between revisions

From FreeCAD Documentation
(next comes a new feature)
(Marked this version for translation)
(22 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:10-->
<!--T:10-->
{{Docnav
{{Docnav
|[[Part_RefineShape|RefineShape]]
|[[Part_RefineShape|RefineShape]]
|[[Part_Defeaturing|Defeaturing]]
|[[Part_MakeFace|Make face from wires]]
|[[Part_Module|Part]]
|[[Part_Workbench|Part]]
|IconL=Part_RefineShape.svg
|IconL=Part_RefineShape.svg
|IconR=Part_MakeFace.svg
|IconR=Part_Defeaturing.svg
|IconC=Workbench_Part.svg
|IconC=Workbench_Part.svg
}}
}}
Line 15: Line 16:
|Name=Part CheckGeometry‏‎
|Name=Part CheckGeometry‏‎
|MenuLocation=Part → Check geometry
|MenuLocation=Part → Check geometry
|Workbenches=[[Part_Module|Part]]
|Workbenches=[[Part_Workbench|Part]]
|SeeAlso=
}}
}}


==Description== <!--T:3-->
==Description== <!--T:73-->

The {{Button|[[Image:Part_CheckGeometry.svg|16px]] [[Part_CheckGeometry|Part CheckGeometry]]}} tool runs a verification and reports if geometry is a valid solid.
<!--T:3-->
The {{Button|[[Image:Part_CheckGeometry.svg|16px]] [[Part_CheckGeometry|Part CheckGeometry]]}} tool runs a verification and reports if geometry is a valid solid. The tool checks if the [https://en.wikipedia.org/wiki/Boundary_representation Boundary representation] (BRep or [[Glossary#B|B-rep]]) of the model is valid.


==Usage== <!--T:4-->
==Usage== <!--T:4-->
Line 27: Line 29:
# Select a part (beware to select the whole part and not just a face to check for valid solid)
# Select a part (beware to select the whole part and not just a face to check for valid solid)
# Invoke the tool by either:
# Invoke the tool by either:
#* Finding the {{Button|[[Image:Part_CheckGeometry.svg|16px]]}} button available in the Part workbench Boolean toolbar.
#* Clicking on the {{Button|[[Image:Part_CheckGeometry.svg|16px]] [[Part_CheckGeometry|CheckGeometry]]}} button available in the Part workbench toolbar.
#* Using the {{MenuCommand|Part → [[Image:Part_CheckGeometry.svg|16px]] Check geometry}} entry from the top menu.
#* Using the {{MenuCommand|Part → [[Image:Part_CheckGeometry.svg|16px]] Check geometry}} entry from the top menu.
# The {{MenuCommand|Settings}} task panel opens, unless {{MenuCommand|Skip settings page}} is enabled. See [[#Options|Options]] for more information. Click {{Button|Run check}}.


<!--T:72-->
<!--T:72-->
Results will be reported in the [[Task_panel|Task panel]].
Results will be reported in the [[Task_panel|Task panel]]. If the check produced errors: click in the report on a specific error message and the corresponding geometric object (edge, face, etc.) will be highlighted in the [[3D_view|3D view]].


==Activate additional BOP check== <!--T:6-->
==Options== <!--T:75-->


<!--T:7-->
===Skip settings page=== <!--T:76-->
The function CheckGeometry checks if the [https://en.wikipedia.org/wiki/Boundary_representation Boundary representation] (BRep or [[Glossary#B|B-rep]]) of the model is valid. Additionally to this BRep check, it is possible to have an additional BOP (BOP= Boolean OPerations) check.


<!--T:71-->
<!--T:77-->
If ticked, subsequent invocations of the tool skip showing the {{MenuCommand|Settings}} task panel.
Beginning with version 0.19 there is a settings panel in the CheckGeometry results with a checkbox for toggling this on or off. For users of earlier versions, to activate the BOP check follow these steps :
# Use the menu {{menuCommand|Tools → Edit parameters... → Preferences → Mod → Part → CheckGeometry}}
# In the right pane double right-click on the ''RunBOPCheck'' parameter to change its value to '''true'''
# Click {{Button|Save to disk}}, close and restart.
See the screenshot below.


<!--T:8-->
===Run BOP check=== <!--T:78-->
If the parameter or folder does not exist, create it by:
# Right-clicking on '''Part''' and choosing {{KEY|Add sub-group}}
# Name the sub-group {{incode|CheckGeometry}}
# Make sure the feshly created sub-group {{incode|CheckGeometry}} is selected
# Right-clicking in the right (empty) window and choosing {{KEY|New Boolean Item}}
# Name the new Boolean item {{incode|RunBOPCheck}} and make sure it is set to ''True''
# Press the {{Button|Save to disk}} button
# Close and restart.


<!--T:7-->
</translate>
If ticked, additionally a Boolean OPerations (BOP) check is performed. {{Version|0.19}}

===Log errors=== <!--T:79-->


<!--T:80-->
[[File:PartCheckGeometry.png]]
If ticked, any errors found are also logged in the [[Report_view|report view]]. {{Version|0.19}}


==Shape Content== <!--T:81-->
<translate>


<!--T:82-->
==Run check and interpret results== <!--T:9-->
In addition to detecting potential geometry errors, this tool shows a range of properties regarding the selected object:
# Select within the [[Tree_view|tree view]] one or more objects to check
* Checked object
# Press the [[Image:Part_CheckGeometry.svg|24px]] [[Part_CheckGeometry|CheckGeometry]] button.
* Shape type
#: Result: A report will display on the left side of the screen showing the result of the scan ({{VersionPlus|0.19}} any errors found are also logged in the [[Report_view|report view]] if logging is enabled in preferences)
* Number of geometric entities: vertices, edges, wires, faces, shells, solids, compsolids, compounds, total shapes
# If the scan turned up errors: click in the report window on a specific error message and the corresponding geometric object (edge/face ...) will be highlighted in the [[3D_view|3D view]]
* Geometric and mass properties:
#: '''Note:''' At the moment FreeCAD has no automatic repair methods for solids, so you need to look at the steps used in FreeCAD to model this specific geometry and try to fix the error yourself
** Area
** Volume
** Mass
** Length
** Center of mass
** Orientation
** Symmetry axis
** Symmetry point
** Moments
** First axis of inertia
** Second axis of inertia
** Third axis of inertia
** Radius of gyration
** Global placement


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


<!--T:11-->
<!--T:84-->
* [[App_Link|App Link]] objects linked to the appropriate object types and [[App_Part|App Part]] containers with the appropriate visible objects inside can also be checked using this tool. For [[App_Link|App Links]] the shape of the linked object is checked. For [[App_Part|App Part]] containers the visible objects within are checked as compounds. {{Version|0.20}}
[[Image:GeometryCheck_Errors.jpg]]
* FreeCAD has no methods to automatically repair geometry. If faults are detected the steps involved to create the model need to be examined and fixed manually.




Line 77: Line 86:
{{Docnav
{{Docnav
|[[Part_RefineShape|RefineShape]]
|[[Part_RefineShape|RefineShape]]
|[[Part_Defeaturing|Defeaturing]]
|[[Part_MakeFace|Make face from wires]]
|[[Part_Module|Part]]
|[[Part_Workbench|Part]]
|IconL=Part_RefineShape.svg
|IconL=Part_RefineShape.svg
|IconR=Part_MakeFace.svg
|IconR=Part_Defeaturing.svg
|IconC=Workbench_Part.svg
|IconC=Workbench_Part.svg
}}
}}
Line 87: Line 96:
{{Part Tools navi{{#translation:}}}}
{{Part Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 16:38, 6 May 2022

Part CheckGeometry‏‎

Menu location
Part → Check geometry
Workbenches
Part
Default shortcut
None
Introduced in version
-
See also
None

Description

The Part CheckGeometry tool runs a verification and reports if geometry is a valid solid. The tool checks if the Boundary representation (BRep or B-rep) of the model is valid.

Usage

  1. Select a part (beware to select the whole part and not just a face to check for valid solid)
  2. Invoke the tool by either:
    • Clicking on the CheckGeometry button available in the Part workbench toolbar.
    • Using the Part → Check geometry entry from the top menu.
  3. The Settings task panel opens, unless Skip settings page is enabled. See Options for more information. Click Run check.

Results will be reported in the Task panel. If the check produced errors: click in the report on a specific error message and the corresponding geometric object (edge, face, etc.) will be highlighted in the 3D view.

Options

Skip settings page

If ticked, subsequent invocations of the tool skip showing the Settings task panel.

Run BOP check

If ticked, additionally a Boolean OPerations (BOP) check is performed. introduced in version 0.19

Log errors

If ticked, any errors found are also logged in the report view. introduced in version 0.19

Shape Content

In addition to detecting potential geometry errors, this tool shows a range of properties regarding the selected object:

  • Checked object
  • Shape type
  • Number of geometric entities: vertices, edges, wires, faces, shells, solids, compsolids, compounds, total shapes
  • Geometric and mass properties:
    • Area
    • Volume
    • Mass
    • Length
    • Center of mass
    • Orientation
    • Symmetry axis
    • Symmetry point
    • Moments
    • First axis of inertia
    • Second axis of inertia
    • Third axis of inertia
    • Radius of gyration
    • Global placement

Notes

  • App Link objects linked to the appropriate object types and App Part containers with the appropriate visible objects inside can also be checked using this tool. For App Links the shape of the linked object is checked. For App Part containers the visible objects within are checked as compounds. introduced in version 0.20
  • FreeCAD has no methods to automatically repair geometry. If faults are detected the steps involved to create the model need to be examined and fixed manually.