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 |