gear-math

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