Part CheckGeometry: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(Marked this version for translation)
(36 intermediate revisions by 9 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:10-->
<!--T:10-->
{{Docnav
{{Docnav|[[Part RefineShape|Refine shape]]|[[Std Measure Menu|Measure]]|[[Part_Module|Part]]|IconL=Part RefineShape.png|IconC=Workbench_Part.svg|IconR=Part_Measure_Linear.svg}}
|[[Part_RefineShape|RefineShape]]
|[[Part_Defeaturing|Defeaturing]]
|[[Part_Workbench|Part]]
|IconL=Part_RefineShape.svg
|IconR=Part_Defeaturing.svg
|IconC=Workbench_Part.svg
}}


<!--T:2-->
<!--T:2-->
{{GuiCommand
{{GuiCommand|Name=Part CheckGeometry‏‎|MenuLocation=Part → Check geometry|Workbenches=[[Part Workbench|Part]]|SeeAlso=}}
|Name=Part CheckGeometry‏‎
|MenuLocation=Part → Check geometry
|Workbenches=[[Part_Workbench|Part]]
}}


==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-->


<!--T:5-->
<!--T:5-->
# Select a part (beware to select the whole part and not just a face to check for valid solid)
The tool is available in the Part workbench under Part menu or with the button in the Boolean toolbar.
# Invoke the tool by either:
Select a part (beware to select the whole part and not just a face to check for valid solid) then launch the tool.
#* Clicking on the {{Button|[[Image:Part_CheckGeometry.svg|16px]] [[Part_CheckGeometry|CheckGeometry]]}} button available in the Part workbench toolbar.
You will see results in the Task panel.
#* 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-->
==Activate additional BOP check== <!--T:6-->
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]].


<!--T:7-->
==Options== <!--T:75-->
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-->
===Skip settings page=== <!--T:76-->
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-->
<!--T:77-->
If ticked, subsequent invocations of the tool skip showing the {{MenuCommand|Settings}} task panel.
If the parameter or folder does not exist, you can create it by
# right-clicking on '''Part''' and choosing '''Add sub-group'''
# naming the sub-group '''CheckGeometry'''
# making sure the just created sub-group ''CheckGeometry'' is selected
# right-clicking in the right (empty) window and choosing '''New Boolean Item'''
# naming the new Boolean item "RunBOPCheck" and make sure it is set to '''true'''
# clicking {{Button|Save to disk}}, close and restart.


===Run BOP check=== <!--T:78-->


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


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


<!--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 in the tree view one or more objects you like to check
* Checked object
*click on [[Image:Part_CheckGeometry.png|32px]]
* Shape type
*you will get a report on the left side of the screen showing the result of the scan (beginning in version 0.19 any errors found are also logged in the [[Std_Panels|report view]])
* Number of geometric entities: vertices, edges, wires, faces, shells, solids, compsolids, compounds, total shapes
*if your scan turned up errors you may click in the report window on a specific error message and the corresponding geometric object (edge/face ...) will be highlighted in the 3D view
* Geometric and mass properties:
*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.




<!--T:12-->
<!--T:12-->
{{Docnav
{{Docnav|[[Part RefineShape|Refine shape]]|[[Std Measure Menu|Measure]]|[[Part_Module|Part]]|IconL=Part RefineShape.png|IconC=Workbench_Part.svg|IconR=Part_Measure_Linear.svg}}
|[[Part_RefineShape|RefineShape]]

|[[Part_Defeaturing|Defeaturing]]
<!--T:13-->
|[[Part_Workbench|Part]]
{{Part Tools navi}}
|IconL=Part_RefineShape.svg

|IconR=Part_Defeaturing.svg
<!--T:14-->
|IconC=Workbench_Part.svg
{{Userdocnavi}}
}}


</translate>
</translate>
{{Part Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

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.