| name | gear-math |
| description | Deterministic mechanical gear math for spur, helical, bevel, and worm geometries with CAD-ready dimension outputs. |
| allowed-tools | bash, read, glob, grep |
Overview
Provides formulas and computation steps for standard gear types to output CAD dimensions, ratios, and verification checks. Emphasizes clear assumptions, unit handling, and interference/undercut warnings.
Core Capabilities
- Compute pitch, base, addendum, dedendum, outside, and root diameters
- Determine circular pitch, tooth thickness at pitch, and center distances
- Handle module and diametral pitch conversions
- Provide warnings for undercut/interference and nonstandard geometries
Inputs Checklist
- Units (mm/in)
- Gear type (spur, helical, bevel, worm)
- Module or diametral pitch
- Teeth count(s)
- Pressure angle
- Helix angle (if applicable)
- Shaft angle (bevel)
- Worm starts and lead angle (worm)
- Backlash/tolerance requirements
Scripts
| Script | Purpose | Command |
|---|
scripts/gear_math.py | Compute CAD-ready gear geometry tables | python scripts/gear_math.py --type spur --module 2 --teeth 24 --pressure-angle 20 |
