Part CheckGeometry: Difference between revisions
(improvements in style and wording) |
(Marked this version for translation) |
||
(41 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--> |
||
If you want to enable the extra BOP (BOP= Boolean OPerations) checks then 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: |
===Skip settings page=== <!--T:76--> |
||
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. |
|||
<!--T:77--> |
|||
</translate> |
|||
If ticked, subsequent invocations of the tool skip showing the {{MenuCommand|Settings}} task panel. |
|||
===Run BOP check=== <!--T:78--> |
|||
[[File:PartCheckGeometry.png]] |
|||
<!--T:7--> |
|||
<translate> |
|||
If ticked, additionally a Boolean OPerations (BOP) check is performed. {{Version|0.19}} |
|||
== |
===Log errors=== <!--T:79--> |
||
*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 |
|||
<!--T:80--> |
|||
If ticked, any errors found are also logged in the [[Report_view|report view]]. {{Version|0.19}} |
|||
<!--T: |
==Shape Content== <!--T:81--> |
||
[[Image:GeometryCheck_Errors.jpg]] |
|||
<!--T:82--> |
|||
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 |
|||
<!--T: |
==Notes== <!--T:83--> |
||
{{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}} |
|||
<!--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}} |
|||
⚫ | |||
* 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--> |
|||
⚫ | |||
{{Docnav |
|||
|[[Part_RefineShape|RefineShape]] |
|||
|[[Part_Defeaturing|Defeaturing]] |
|||
|[[Part_Workbench|Part]] |
|||
|IconL=Part_RefineShape.svg |
|||
|IconR=Part_Defeaturing.svg |
|||
|IconC=Workbench_Part.svg |
|||
}} |
|||
</translate> |
</translate> |
||
⚫ | |||
⚫ |
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
- 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. 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.
- 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