Part CheckGeometry: Difference between revisions
(clarify that BOP is additional) |
(Removed references to V0.19.) |
||
(43 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:73--> |
||
The check geometry tool allows you to verify if you have a valid solid |
|||
⚫ | |||
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--> |
||
⚫ | |||
The tool is available in the Part workbench under Part menu or with the button in the Boolean toolbar. |
|||
# Invoke the tool by either: |
|||
⚫ | |||
#* 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--> |
|||
⚫ | |||
⚫ | |||
<!--T: |
==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: |
===Skip settings page=== <!--T:76--> |
||
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: |
<!--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. |
|||
⚫ | |||
</translate> |
|||
<!--T:7--> |
|||
[[File:PartCheckGeometry.png]] |
|||
If ticked, additionally a Boolean OPerations (BOP) check is performed. |
|||
===Log errors=== <!--T:79--> |
|||
<translate> |
|||
<!--T:80--> |
|||
==Run Check and interpret results== <!--T:9--> |
|||
If ticked, any errors found are also logged in the [[Report_view|report view]]. |
|||
*select in the tree view one or more objects you like to check |
|||
*click on [[Image:Part_CheckGeometry.png|32px]] |
|||
*you will get a report on the left side of the screen showing the result of the scan |
|||
⚫ | |||
*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 |
|||
==Shape Content== <!--T:81--> |
|||
<!--T: |
<!--T:82--> |
||
In addition to detecting potential geometry errors, this tool shows a range of properties regarding the selected object: |
|||
[[Image:GeometryCheck_Errors.jpg]] |
|||
* 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== <!--T:83--> |
|||
<!--T: |
<!--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}} |
|||
{{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}} |
|||
* 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: |
<!--T:12--> |
||
{{Docnav |
|||
⚫ | |||
|[[Part_RefineShape|RefineShape]] |
|||
|[[Part_Defeaturing|Defeaturing]] |
|||
|[[Part_Workbench|Part]] |
|||
|IconL=Part_RefineShape.svg |
|||
|IconR=Part_Defeaturing.svg |
|||
|IconC=Workbench_Part.svg |
|||
}} |
|||
</translate> |
</translate> |
||
⚫ | |||
⚫ |
Latest revision as of 15:49, 20 May 2023
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
- Select a part (beware to select the whole part and not just a face to check for valid solid)
- 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.
- 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.
Log errors
If ticked, any errors found are also logged in the report view.
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.
- Primitives: Box, Cylinder, Sphere, Cone, Torus, Tube, Create primitives, Shape builder
- Creation and modification: Extrude, Revolve, Mirror, Fillet, Chamfer, Make face from wires, Ruled Surface, Loft, Sweep, Section, Cross sections, 3D Offset, 2D Offset, Thickness, Projection on surface, Attachment
- Boolean: Make compound, Explode Compound, Compound Filter, Boolean, Cut, Fuse, Common, Connect, Embed, Cutout, Boolean fragments, Slice apart, Slice, XOR
- Measure: Measure Linear, Measure Angular, Measure Refresh, Clear All, Toggle All, Toggle 3D, Toggle Delta
- 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
- Hubs: User hub, Power users hub, Developer hub