PartDesign Groove: Difference between revisions

Latest revision as of 10:29, 6 April 2024

Other languages:

Hole

Subtractive loft

PartDesign

Menu location
PartDesign Groove
Part Design → Create a substractive feature → Groove
Workbenches
PartDesign
Default shortcut
None
Introduced in version
-
See also
PartDesign Revolution

Description

The Groove tool revolves a selected sketch or profile about a given axis, cutting out material from the support .

Above: sketch (A) is revolved around axis (B); resulting groove on solid (C) is shown right.

Usage

Select a single sketch or one or more faces from the Body.
Press the Groove button.
Set the Groove parameters, see Options below.
Press the OK button.

Options

When creating a groove, or after double-clicking an existing groove in the Tree view, the Groove parameters task panel is shown. It offers the following settings:

Type

introduced in version 0.22

Type offers five different ways of specifying the angle of the groove:

Dimension

Enter a numeric value for the Angle of the groove. With the option Symmetric to plane the groove will extend half the given angle to either side of the sketch or face.

Through all

The groove will extend up to the last face of the support it encounters in its direction. With the option Symmetric to plane the groove will cut through all material in both directions.

To first

The groove will extend up to the first face of the support it encounters in its direction.

Up to face

The groove will extend up to a face. Press the Face button and select a face or a datum plane from the Body.

Two dimensions

This allows to enter a second angle in which the groove should extend in the opposite direction. The directions can be switched by checking the Reversed option.

Axis

Specifies the axis of the groove:

Vertical sketch axis: selects the vertical sketch axis.
Horizontal sketch axis: selects the horizontal sketch axis.
Construction line: selects a construction line from the sketch used by the groove. The dropdown list will contain an entry for each construction line. The first construction line will be labelled Construction line 1.
Base (X/Y/Z) axis: selects the X, Y or Z axis of the Body's origin.
Select reference...: allows the selection of a straight edge or a datum line from the Body.

Note that when changing the axis, the Reversed option may be (un)checked automatically.

Angle

Defines the angle of the groove. This option is only available if Type is Dimension or Two dimensions. Angles larger than 360° are not possible. Nor are negative values, use the Reversed option instead.

Symmetric to plane

Check this option to extend the groove half the given angle to either side of the sketch or face, if Type is Dimension, or Through all if that is the Type.

Reversed

Reverses the direction of the groove.

2nd angle

introduced in version 0.22

Defines the angle of the groove in the opposite direction. This option is only available if Type is Two dimensions and Angle is smaller than 360°.

Properties

Data

Groove

DataType (Enumeration)
DataBase (Vector): (read-only)
DataAxis (Vector): (read-only)
DataAngle (Angle)
DataAngle2 (Angle)
DataUp To Face (LinkSub)
DataReference Axis (LinkSub)

Part Design

DataRefine (Bool)

Sketch Based

DataProfile (LinkSub)
DataMidplane (Bool)
DataReversed (Bool)
DataAllow Multi Face (Bool)

Notes

A ShapeBinder cannot be used for the profile.
When using a SubShapeBinder for the profile, selecting the binder in the Tree view will fail, instead the binder's face has to selected in the 3D view.

Hole

Subtractive loft

PartDesign

Structure tools: Part, Group
Helper tools: Create body, Create sketch, Edit sketch, Map sketch to face

Modeling tools
- Datum tools: Create a datum point, Create a datum line, Create a datum plane, Create a local coordinate system, Create a shape binder, Create a sub-object(s) shape binder, Create a clone
- Additive tools: Pad, Revolution, Additive loft, Additive pipe, Additive helix, Additive box, Additive cylinder, Additive sphere, Additive cone, Additive ellipsoid, Additive torus, Additive prism, Additive wedge
- Subtractive tools: Pocket, Hole, Groove, Subtractive loft, Subtractive pipe, Subtractive helix, Subtractive box, Subtractive cylinder, Subtractive sphere, Subtractive cone, Subtractive ellipsoid, Subtractive torus, Subtractive prism, ‎Subtractive wedge

Transformation tools: Mirrored, Linear Pattern, Polar Pattern, Create MultiTransform, Scaled
Dress-up tools: Fillet, Chamfer, Draft, Thickness
Boolean: Boolean operation

Extras: Migrate, Sprocket, Involute gear, Shaft design wizard
Context menu: Set tip, Move object to other body, Move object after other object, Appearance, Color per face

User documentation

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

Addons: Addon Manager, External workbenches, Scripting and macros

Hubs: User hub, Power users hub, Developer hub

@@ Line 1: / Line 1: @@
 <languages/>
 <translate>
 <!--T:21-->
 {{Docnav
@@ Line 7: / Line 8: @@
 |[[PartDesign_Workbench|PartDesign]]
 |IconL=PartDesign_Hole.svg
-|IconC=Workbench_PartDesign.svg
 |IconR=PartDesign_SubtractiveLoft.svg
+|IconC=Workbench_PartDesign.svg
 }}
@@ Line 14: / Line 15: @@
 {{GuiCommand
 |Name=PartDesign Groove
-|MenuLocation=PartDesign → Groove
+|MenuLocation=Part Design → Create a substractive feature → Groove
 |Workbenches=[[PartDesign_Workbench|PartDesign]]
+|SeeAlso=[[PartDesign_Revolution|PartDesign Revolution]]
 }}
@@ Line 33: / Line 35: @@
 <!--T:8-->
-# Select the sketch to be revolved.
+# Select a single sketch or one or more faces from the Body.
+# Press the {{Button|[[Image:PartDesign_Groove.svg|16px]] [[PartDesign_Groove|Groove]]}} button.
-#: A face on the existing solid can alternatively be used. {{VersionPlus|0.17}}
+# Set the Groove parameters, see [[#Options|Options]] below.
-#: The sketch must be mapped to the planar face of an existing solid or Part Design feature, or an error message will appear. {{VersionMinus|0.16}}
-# Press the {{KEY|[[Image:PartDesign_Groove.svg|24px]] '''Groove'''}} button.
+# Press the {{Button|OK}} button.
-# Set the Groove parameters (see next section).
-# Press {{KEY|OK}}.
 ==Options== <!--T:3-->
 <!--T:9-->
-When creating a groove, the '''Groove parameters''' dialogue offers several parameters specifying how the sketch should be revolved.
+When creating a groove, or after double-clicking an existing groove in the [[Tree_view|Tree view]], the '''Groove parameters''' task panel is shown. It offers the following settings:<!--The 0.22 dev version wrongly shows "Revolution parameters"-->
+<!--T:10-->
-{|
-| [[Image:partdesign_groove_parameters.png|left]]
+[[Image:partdesign_groove_parameters.png|frame|left]]
-|
-===Axis === <!--T:10-->
+===Type=== <!--T:27-->
+<!--T:28-->
+{{Version|0.22}}
+<!--T:29-->
+Type offers five different ways of specifying the angle of the groove:
+====Dimension==== <!--T:30-->
+<!--T:31-->
+Enter a numeric value for the '''Angle''' of the groove. With the option '''Symmetric to plane''' the groove will extend half the given angle to either side of the sketch or face.
+====Through all==== <!--T:32-->
+<!--T:33-->
+The groove will extend up to the last face of the support it encounters in its direction. With the option '''Symmetric to plane''' the groove will cut through all material in both directions.
+====To first==== <!--T:34-->
+<!--T:35-->
+The groove will extend up to the first face of the support it encounters in its direction.
+====Up to face==== <!--T:36-->
+<!--T:37-->
+The groove will extend up to a face. Press the {{Button|Face}} button and select a face or a [[PartDesign_Plane|datum plane]] from the Body.
+====Two dimensions==== <!--T:38-->
+<!--T:39-->
+This allows to enter a second angle in which the groove should extend in the opposite direction. The directions can be switched by checking the '''Reversed''' option.
+===Axis === <!--T:40-->
+<!--T:41-->
+Specifies the axis of the groove:
 <!--T:11-->
-This option specifies the axis about which the sketch is to be revolved.
+* '''Vertical sketch axis''': selects the vertical sketch axis.
-* '''Vertical sketch axis''': selects the vertical sketch axis .
 * '''Horizontal sketch axis''': selects the horizontal sketch axis.
-* '''Sketch axis''': selects a construction line contained in the sketch used by the Groove. The first construction line created in the sketch will be labelled ''Sketch axis 0''. The drop down list will contain one custom sketch axis for each construction line. {{VersionMinus|0.16}}
+* '''Construction line''': selects a construction line from the sketch used by the groove. The dropdown list will contain an entry for each construction line. The first construction line will be labelled ''Construction line 1''.
+* '''Base (X/Y/Z) axis''': selects the X, Y or Z axis of the Body's origin.
-* '''Construction line''': selects a construction line contained in the sketch used by the Groove. The drop down list will contain an entry for each construction line. The first construction line created in the sketch will be labelled ''Construction line 1''. {{VersionPlus|0.17}}
-* '''Base (X/Y/Z) axis''': selects the X, Y or Z axis of the Body's Origin; {{VersionPlus|0.17}}
+* '''Select reference...''': allows the selection of a straight edge or a [[PartDesign_Line|datum line]] from the Body.
-* '''Select reference...''': allows selection in the 3D view of an edge on the Body, or a [[PartDesign Line|datum line]]. {{VersionPlus|0.17}}
+<!--T:42-->
+Note that when changing the axis, the '''Reversed''' option may be (un)checked automatically.
 ===Angle === <!--T:12-->
 <!--T:13-->
-This controls the angle through which the groove is to be formed, e.g. 360° would be a full, contiguous revolution. It is not possible to specify negative angles (use the '''Reversed''' option instead) or angles greater than 360° .
+Defines the angle of the groove. This option is only available if '''Type''' is '''Dimension''' or '''Two dimensions'''. Angles larger than 360° are not possible. Nor are negative values, use the '''Reversed''' option instead.
 ===Symmetric to plane === <!--T:14-->
 <!--T:15-->
+Check this option to extend  the groove half the given angle to either side of the sketch or face, if '''Type''' is '''Dimension''', or '''Through all''' if that is the '''Type'''.
-If checked, the groove will extend half of the specified angle in both directions from the sketch plane .
 ===Reversed === <!--T:16-->
 <!--T:17-->
+Reverses the direction of the groove.
-If checked, the direction of revolution is reversed from default clockwise to counterclockwise .
-|}
+===2nd angle=== <!--T:43-->
+<!--T:44-->
+{{Version|0.22}}
+<!--T:45-->
+Defines the angle of the groove in the opposite direction. This option is only available if '''Type''' is '''Two dimensions''' and '''Angle''' is smaller than 360°.
 == Properties == <!--T:18-->
-<!--T:19-->
+===Data=== <!--T:46-->
-Below are properties which can be defined after creation of the feature. Data properties ''Base'' and ''Axis'' are uneditable .
-<!--T:20-->
+<!--T:47-->
+{{TitleProperty|Groove}}
-* {{PropertyData|Angle}}: angle of rotation. See [[#Angle|Angle]] .
-* {{PropertyData|Label}}: label given to the operation, can be changed at convenience.
+<!--T:48-->
-* {{PropertyData|Midplane}}: true or false. See [[#Symmetric to plane|Symmetric to plane]].
-* {{PropertyData|Reversed}}: true or false. See [[#Reversed|Reversed]].
+* {{PropertyData|Type|Enumeration}}
+* {{PropertyData|Base|Vector}}: (read-only)
-* {{PropertyData|Refine}}: true or false. If set to true, cleans the solid from residual edges left by features. See [[Part RefineShape]] for more details. {{VersionPlus|0.17}}
+* {{PropertyData|Axis|Vector}}: (read-only)
+* {{PropertyData|Angle|Angle}}
+* {{PropertyData|Angle2|Angle}}
+* {{PropertyData|Up To Face|LinkSub}}
+* {{PropertyData|Reference Axis|LinkSub}}
+<!--T:49-->
+{{TitleProperty|Part Design}}
+<!--T:50-->
+* {{PropertyData|Refine|Bool}}
+<!--T:51-->
+{{TitleProperty|Sketch Based}}
+<!--T:52-->
+* {{PropertyData|Profile|LinkSub}}
+* {{PropertyData|Midplane|Bool}}
+* {{PropertyData|Reversed|Bool}}
+* {{PropertyData|Allow Multi Face|Bool}}
+== Notes == <!--T:25-->
+<!--T:26-->
+* A [[File:PartDesign_ShapeBinder.svg|16px]] [[PartDesign_ShapeBinder|ShapeBinder]] cannot be used for the profile.
+* When using a [[File:PartDesign_SubShapeBinder.svg|16px]] [[PartDesign_SubShapeBinder|SubShapeBinder]] for the profile, selecting the binder in the [[Tree_view|Tree view]] will fail, instead the binder's face has to selected in the [[3D_view|3D view]].
@@ Line 95: / Line 163: @@
 |[[PartDesign_Workbench|PartDesign]]
 |IconL=PartDesign_Hole.svg
-|IconC=Workbench_PartDesign.svg
 |IconR=PartDesign_SubtractiveLoft.svg
+|IconC=Workbench_PartDesign.svg
 }}