FreeCAD Logo FreeCAD 1.0
  • English Afrikaans Arabic Belarusian Catalan Czech German Greek Spanish Spanish Basque Finnish Filipino French Galician Croatian Hungarian Indonesian Italian Japanese Kabyle Korean Lithuanian Dutch Norwegian Bokmal Polish Portuguese Portuguese Romanian Russian Slovak Slovenian Serbian Swedish Turkish Ukrainian Valencian Vietnamese Chinese Chinese
  • Features
  • Download
  • Blog
  • Documentation
    Documentation index Getting started Users documentation The FreeCAD manual Workbenches documentation Python coding documentation C++ coding documentation Tutorials Frequently asked questions Privacy policy About FreeCAD
  • Contribute
    How to help Sponsor Report a bug Make a pull request Jobs and funding Contribution guidelines Developers handbook Translations
  • Community
    Code of conduct Forum The FPA GitHub GitLab Codeberg Mastodon Matrix IRC IRC via Webchat Gitter Discord Reddit Twitter Facebook LinkedIn Calendar
  • ♥ Donate

Donate

$
SEPA Information
Please set up your SEPA bank transfer to:
Beneficiary: The FreeCAD project association
IBAN: BE04 0019 2896 4531
BIC/SWIFT: GEBABEBBXXX
Bank agency: BNP Paribas Fortis
Address: Rue de la Station 64, 1360 Perwez, Belgium

While Stripe doesn't support monthly donations, you can still become a sponsor! Simply make a one-time donation equivalent to 12 months of support, and you'll gain access to the corresponding sponsoring tier. It's an easy and flexible way to contribute.

If you are not sure or not able to commit to a regular donation, but still want to help the project, you can do a one-time donation, of any amount.

Choose freely the amount you wish to donate one time only.

You can support FreeCAD by sponsoring it as an individual or organization through various platforms. Sponsorship provides a steady income for developers, allowing the FPA to plan ahead and enabling greater investment in FreeCAD. To encourage sponsorship, we offer different tiers, and unless you choose to remain anonymous, your name or company logo will be featured on our website accordingly.

from 1 USD / 1 EUR per month. You will not have your name displayed here, but you will have helped the project a lot anyway. Together, normal sponsors maintain the project on its feet as much as the bigger sponsors.

from 25 USD / 25 EUR per month. Your name or company name is displayed on this page.

from 100 USD / 100 EUR per month. Your name or company name is displayed on this page, with a link to your website, and a one-line description text.

from 200 USD / 200 EUR per month. Your name or company name and logo displayed on this page, with a link to your website and a custom description text. Companies that have helped FreeCAD early on also appear under Gold sponsors.

Instead of donating each month, you might find it more comfortable to make a one-time donation that, when divided by twelve, would give you right to enter a sponsoring tier. Don't hesitate to do so!

Choose freely the amount you wish to donate each month.

Please inform your forum name or twitter handle as a notein your transfer, or reach to us, so we can give you proper credits!

Additive Pipe
Additive Box
PartDesign

PartDesign AdditiveHelix

Menu location
Part Design → Additive Features → Additive Helix
Workbenches
PartDesign
Default shortcut
None
Introduced in version
0.19
See also
PartDesign SubtractiveHelix

Description

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

  1. Select the sketch to be swept into a helix. A face on the existing solid can alternatively be used.
  2. There are several ways to invoke the tool:
    • Press the Additive Helix button.
    • Select the Part Design → Additive Features → Additive Helix option from the menu.
  3. Set the Helix parameters (see next section).
  4. Inspect the Helix in the view window, to ensure that the parameters do not result in a self intersecting helix.
  5. Press OK.

Options

When creating an Additive Helix, the Helix Parameters dialogue offers several parameters specifying how the sketch should be swept.

Axis

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.
  • 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

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

The distance between turns in the helix.

Height

The height of the helix (center-center).

Turns

The number of turns in the helix. Define as Height/Pitch

Cone Angle

Angle of the cone that forms a hull around the helix. Allowable range: [-89°, +89°].

Left handed

If checked, the turning direction of helix is reversed from default clockwise to counterclockwise.

Reversed

If checked, the axis direction of helix is reversed from default.

Recompute on change

If checked, the helix will be shown in the view, and updated automatically on every change of the parameters.

Properties

  • 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

  • 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

Example helix using a B-spline in the sketch
Example helix where the helix axis is normal to the sketch plane resulting in a "Pad with twist" effect.


Additive Pipe
Additive Box
PartDesign

This page is retrieved from https://wiki.freecad.org/PartDesign_AdditiveHelix

Get in touch!
Forum GitHub Mastodon Matrix IRC Gitter.im Discord Reddit Twitter Facebook LinkedIn

© The FreeCAD Team. Homepage image credits (top to bottom): ppemawm, r-frank, epileftric, regis, rider_mortagnais, bejant.

This project is supported by: , KiCad Services Corp. and other sponsors

GitHubImprove this page on GitHub