PartDesign AdditiveHelix
|
|
| Menu location |
|---|
| Part Design → Create an additive feature → Additive helix |
| Workbenches |
| PartDesign |
| Default shortcut |
| None |
| Introduced in version |
| 0.19 |
| See also |
| PartDesign SubtractiveHelix |
Description[edit | edit source]
The Additive Helix tool creates a solid by sweeping a selected sketch or 2D object along a helix path.

The profile (B), is swept around axis (A) in order to produce the solid helix (C).
Usage[edit | edit source]
- Select the sketch to be swept into a helix. A face on the existing solid can alternatively be used.
- There are several ways to invoke the tool:
- Press the
Additive helix button.
- Select the Part Design → Create an additive feature →
Additive helix option from the menu.
- Press the
- Set the Helix parameters (see next section).
- Inspect the Helix in the view window, to ensure that the parameters do not result in a self intersecting helix.
- Press OK.
Options[edit | edit source]
When creating an Additive Helix, the Helix parameters dialogue offers several parameters specifying how the sketch should be swept.

Axis[edit | edit source]
This option specifies the axis about which the sketch is to be swept.
- Normal sketch axis: selects the normal of the sketch that runs through the sketch origin as axis. introduced in 0.20
- Vertical sketch axis: selects the vertical sketch axis. This is the default for new helices.
- Horizontal sketch axis: selects the horizontal sketch axis.
- Construction line: selects a construction line contained in the sketch used by the Helix. 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.
- Base (X/Y/Z) axis: selects the X, Y or Z axis of the Body's Origin;
- Select reference...: allows selection in the 3D view of an edge on the Body, or a datum line.
Mode[edit | edit source]
This controls what parameters will be used to define the helix. The choices are:
- Pitch-Height-Angle: definition via the height per turn and the overall height
- Pitch-Turns-Angle: definition via the height per turn and the number of turns
- Height-Turns-Angle: definition via the overall height and the number of turns
- Height-Turns-Growth introduced in 0.20: definition via the overall height, the number of turns and the growth of the helical radius. So a Height of zero leads to a path in form of a spiral. A Height and Growth of zero to leads to a path in form of a circle.
Pitch[edit | edit source]
The distance between turns in the helix.
Height[edit | edit source]
The height of the helix (center-center).
Turns[edit | edit source]
The number of turns in the helix. Define as Height/Pitch
Cone Angle[edit | edit source]
Angle of the cone that forms a hull around the helix. Allowable range: [-89°, +89°].
Left handed[edit | edit source]
If checked, the turning direction of helix is reversed from default clockwise to counterclockwise.
Reversed[edit | edit source]
If checked, the axis direction of helix is reversed from default.
Update view[edit | edit source]
If checked, the helix will be shown in the view, and updated automatically on every change of the parameters.
Preferences[edit | edit source]
- An additive helix that does not intersect the body will be visible in the preview if Tools → Edit parameters... → BaseApp → Preferences → Mod → PartDesign → AdditiveHelixPreview is set to
true. The default for this preference isfalse. introduced in 0.20
Properties[edit | edit source]
- DataPitch: The axial distance between two turns.
- DataHeight: The total length of the helix (not accounting for the extent of the profile)
- DataTurns: The number of turns (does not need to be a whole number)
- DataLeft Handed: See Left Handed.
- DataReversed: See Reversed.
- DataAngle: The rate at which the radius of the helix increase along the axis. Allowable range: [-89°, +89°].
- DataReference axis: The helix axis
- DataMode: The helix input mode (pitch-height, pitch-turns, turns-height)
- DataOutside: Not used (Used in SubtractiveHelix)
- DataHas Been Edited: If false, the tool will propose an initial value for pitch based on the profile bounding box, so that self intersection is avoided.
- DataRefine: true or false. If set to true, cleans the solid from residual edges left by features. See Part RefineShape for more details.
- DataProfile: Either a sketch containing a closed contour, or a face.
- DataMidplane: Not used.
- DataUp to face: Not used.
- DataAllow multiple face: Not used.
Notes[edit | edit source]
- 0.21 and below: A
ShapeBinder cannot be used for the profile.
- 0.21 and below: When using a
SubShapeBinder for the profile, selecting the binder in the Tree view will fail, instead the binder's face has to be selected in the 3D view.
- Helixes are very difficult for the underlying engine to calculate correctly because the curves involved push floating point precision to its limit. That means that performing further operations on a helix like attempting boolean operations with another object can be very sensitive to small changes. When they fail, they often break the model in surprising ways. To avoid this, you should try to make operations on a helix either clearly overlap (interfere) or clearly not overlap. Exact matches where the surface of the helix is perfectly aligned with the surface of another object are fragile. A thread around a bolt cylinder is an example of this. It may even work initially, and then break later when objects are moved slightly.
Examples[edit | edit source]


- Structure tools: Part, Group
- Helper tools: Create body, Create sketch, Attach sketch, Edit sketch, Validate sketch, Check geometry, Create a shape binder, Create a sub-object(s) shape binder, Create a clone, Create a datum plane, Create a datum line, Create a datum point, Create a local coordinate system
- Modeling tools:
- 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
- Boolean: Boolean operation
- Dress-up tools: Fillet, Chamfer, Draft, Thickness
- Transformation tools: Mirrored, Linear Pattern, Polar Pattern, Create MultiTransform, Scaled
- Extras: Sprocket, Involute gear, Shaft design wizard
- Context menu: Set tip, Move object to other body, Move object after other object, Appearance, Color per face
- Preferences: Preferences, Fine tuning
- 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, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub