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!

InternalInvoluteGear
Gear

FCGear InvoluteGear

Menu location
Gear → Involute Gear
Workbenches
Gear
Default shortcut
None
Introduced in version
v0.16
See also
FCGear CycloideGear

Description

The FCGear InvoluteGear command creates an involute gear wheel with spur gearing by default that can also be transformed into a helical gearing or a double helical gearing.

Due to the favourable meshing ratio and the relatively simple production, involute gearing is the most common tooth form in mechanical engineering. Gear wheels can be found wherever movement and force are to be transferred from one part to another. For example, they can be found in machines, cars, watches or household appliances. The movement is often transferred directly from one gear wheel to the other, but sometimes also via a chain. In addition, the direction of rotation can be changed. It is also possible to change a radial movement into a linear one via an involute rack.

From left to right: Spur gearing, helical gearing, double helical gearing

Usage

  1. Switch to the Gear Workbench.
  2. There are several ways to invoke the command:
    • Press the Involute Gear button in the toolbar.
    • Select the Gear → Involute Gear option from the menu.
  3. Change the gear parameter to the required conditions (see Properties).

Properties

See also: Property View.

An FCGear InvoluteGear object is derived from a Part Feature object and inherits all its properties. It also has the following additional properties:

Data

accuracy

  • Datanumpoints (Integer): Default is 20. Change of the involute profile. Changing the value can lead to unexpected results.
  • Datasimple (Bool): Default is false, true generates a simplified display (without teeth and only a cylinder in pitch diameter).

base

  • Datagear (PythonObject): Python gear object.
  • Dataheight (Length): Default is 5 mm. Value of the gear width.
  • Datamodule (Length): Default is 1 mm. Module is the ratio of the reference diameter of the gear divided by the number of teeth (see Notes).
  • Datanum_teeth (Integer): Default is 15. Number of teeth (see Notes).

computed

  • Dataaddendum_diameter (Length): Default is 17 mm. Outside diameter, measured at the addendum (the tip of the teeth).
  • Dataangular_backlash (Angle): (read-only) The angle by which this gear can turn without moving the mating gear.
  • Datapitch_diameter (Length): Default is 15 mm. The pitch diameter.
  • Dataroot_diameter (Length): (read-only) The root diameter, measured at the foot of the teeth.
  • Datatransverse_pitch (Length): Default is 3.14 mm. The transverse pitch.
  • Datatraverse_module (Length): Default is 1 mm. The traverse module of the generated gear.

fillets

  • Datahead_fillet (Float): Default is 0 mm. A fillet for the tooth-head.
  • Dataroot_fillet (Float): Default is 0 mm. A fillet for the tooth-root.
  • Dataundercut (Bool): Default is false, true changes the profile of the tooth root (see Notes).

helical

  • Datadouble_helix (Bool): Default is false, true creates a double helix gear (see Notes).
  • Datahelix_angle (Angle): Default is 0°. With the helix angle β a helical gear is created – positive value → rotation direction right, negative value → rotation direction left (see Notes).
  • Dataproperties_from_tool (Bool): Default is false. If true and Datahelix_angle is not zero, gear parameters are recomputed internally for the rotated gear.

hole

  • DataAxle_hole (Bool): Default is false. true enables a central hole for an axle.
  • DataAxle_holesize (Length): Default is 10 mm. Diameter of the hole for an axle.
  • Dataoffset_hole (Bool): Default is false, true enables an offset hole.
  • Dataoffset_holeoffset (Length): Default is 10 mm. The offset of the offset hole.
  • Dataoffset_holesize (Length): Default is 10 mm. The diameter of the offset hole.

involute

  • Datapressure_angle (Angle): Default is 20° (see Notes).
  • Datashift (Float): Default is 0. Generates a positive and negative profile shift (see Notes).

tolerance

  • Databacklash (Length): Default is 0. Backlash, also called lash or play, is the distance between the teeth at a gear pair.
  • Dataclearance (Float): Default is 0.25 (see Notes).
  • Datahead (Float): Default is 0. This value is used to change the tooth height.
  • Datareversed_backlash (Bool): true backlash decrease or false (default) backlash increase see Notes).

version

  • Dataversion (String):

Notes

  • Datahelix_angle (beta, β): Changing the helix angle does not change the pitch diameter, or more precise the transverse pitch diameter (dt) since the Datamodule property represents the transverse module (mt) unless the Dataproperties_from_tool property is true. In that case it represents the normal module (mn), and all properties depending on the transverse module in the computed group will be divided by cos β and thus enlarged.
    • Spur gear: β=0∘, cos⁡(β)=1 and mt=mn
    • Helical gear: β>0∘, cos⁡(β)<1 and mt=mncos⁡(β)
    • dt=z⋅mt=z⋅mncos⁡(β)
    However, a helix angle of less than 10° has hardly any advantages over straight teeth.
  • Dataclearance (c): At a gear pair, clearance is the distance between the tooth tip of the first gear and the tooth root of the second gear.
  • Datadouble_helix: Activates double helical gearing if the Datahelix_angle property is larger than 0 (β>0∘).
  • Datamodule (m): Using ISO (International Organization for Standardization) guidelines, Module size is designated as the unit representing gear tooth-sizes.
    • The module multiplied by the number of teeth (z) defines the pitch circle diameter (d): d=m⋅z
    • The module multiplied by Pi (π) defines the pitch (p), the arc distance on the pitch circle between corresponding points of adjacent teeth: p=m⋅π
  • Datashift: Profile shift is not merely used to prevent undercut. It can be used to adjust center distance between two gears. If a positive correction is applied, such as to prevent undercut in a pinion, the tooth thickness at top is thinner.
  • Datanum_teeth (number of teeth, z): If the number of teeth is changed, the pitch diameter (d) also changes.
  • Dataundercut: Undercut is used when the number of teeth of a gear is too small. Otherwise the mating gear will cut into the tooth root. The undercut not only weakens the tooth with a wasp-like waist, but also removes some of the useful involute adjacent to the base circle.
  • Datapressure_angle (α): 20° is a standard value here. The pressure angle is defined as the angle between the line-of-action (common tangent to the base circles) and a perpendicular to the line-of-centers. Thus, for standard gears, 14.5° pressure angle gears have base circles much nearer to the roots of teeth than 20° gears. It is for this reason that 14.5° gears encounter greater undercutting problems than 20° gears. Important: the pressure angle changes with a profile shift. Only change the parameter, if sufficient knowledge of the gear geometry is available.
  • Datareversed_backlash: If there are several gears, pay attention to which gear the parameter is set for.

Limitations

A 2D tooth profile, obtained by setting the Dataheight to zero, cannot be used with features requiring a 2D shape. For example PartDesign Pad and PartDesign AdditiveHelix features do not accept such a profile as base. For technical details, please refer to the related issue on GitHub.

Useful formulas

Standard Spur Gears

Here “standard” refers to those spur gears with no profile shift coefficient (x).

Basic formulas common to internal and external standard spur gears
Symbol Term Formula FCGear Parameter
m Module - module
z Number of Teeth - num_teeth
α Pressure Angle Typically, α=20∘ pressure_angle
d Reference Diameter or Pitch Diameter d=z⋅m pitch_diameter
ha* Addendum Coefficient Typically, ha*=1 ha*=1+head
hf* Dedendum Coefficient Typically, hf*=1.25 hf*=1+clearance
ha Addendum ha=ha*⋅m -
hf Dedendum hf=hf*⋅m -
h Tooth Height or Tooth Depth h=ha+hf
Typically, h=2.25⋅m
-
x Profile Shift Coefficient For standard gears, x=0 shift
Basic formulas specific to external standard spur gears
Symbol Term Formula
da Tip Diameter da=d+2⋅ha

Typically, da=(z+2)⋅m

df Root Diameter df=d−2⋅hf

Typically, df=(z−2.5)⋅m

Basic formulas specific to internal standard spur gears
Symbol Term Formula
da Tip Diameter da=d−2⋅ha

Typically, da=(z−2)⋅m

df Root Diameter df=d+2⋅hf

Typically, df=(z+2.5)⋅m

Basic formulas specific for a pair of external standard spur gears
Symbol Term Formula
a Center Distance a=d1+d22
c Tip and Root Clearance c1=hf2−ha1

c2=hf1−ha2
Typically, c=0.25⋅m

Standard Helical Gears

As above with no profile shifting but the helix angle (β) is taken into account.

Helical and double helical gearing
Symbol Term Formula
mt Transverse Module mt=mncos⁡(β)
mn Normal Module mn=mt⋅cos⁡(β)
pt Transverse Pitch pt=π⋅mt=π⋅mncos⁡(β)
pn Normal Pitch pn=π⋅mn=π⋅mt⋅cos⁡(β)
d Pitch Diameter d=z⋅mt=z⋅mncos⁡(β)
  • Addendum and dedendum are also controlled by the normal module.
  • It depends on the Dataproperties_from_tool property if the Datamodule property is used as normal module or transverse module.

Scripting

Use the power of Python to automate your gear modeling:

import FreeCAD as App
import FreeCADGui as Gui
import freecad.gears.commands
gear = freecad.gears.commands.CreateInvoluteGear.create()
gear.num_teeth = 20
gear.helix_angle = 20
gear.height = 10
gear.double_helix = True
App.ActiveDocument.recompute()
Gui.SendMsgToActiveView("ViewFit")


InternalInvoluteGear
Gear

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

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