How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/baratilab/mechanical-engineering-skills --skill tolerance-stackupBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Tolerance Stack-up
Workflow
- Define the gap. Name the gap being studied and its spec (LSL / USL). Draw the loop in text:
Housing face → bore bottom (+) → bearing (−) → spacer (−) → gear hub (−) → gap.
- Build the chain CSV (
scripts/example_chain.csvshows the format). Rules:
- Go around the loop in one direction; dimensions pointing the "positive" way are
+1, the rest-1. - Enter unequal tolerances as
plus/minus(both positive numbers). The script handles mean shift. dist:normalfor controlled processes (setcpk),uniformfor unknown processes or purchased parts with no data.- Convert GD&T to ± equivalents first: position Ø0.2 → ±0.1 radial; flatness/parallelism add as their own rows.
- Run:
python scripts/stackup.py chain.csv --lsl 0.10 --usl 0.60 --out stack- Interpret
- Worst-case OK → done; tolerances can be loosened.
- Worst-case fails but RSS / MC passes → acceptable for high volume if the processes really are in control; state the predicted ppm.
- MC reject > 2700 ppm (beyond ±3σ) → redesign: tighten the top 1–2 contributors only, or add an adjustment (shim, slotted hole).
- Recommend tolerance reallocation: tighten the contributors with the largest
pct_rssfirst; loosen the ones under 5%.
Output format
- Loop diagram (text) and the chain table
- Results table: Nominal | Worst-case min/max | RSS min/max | MC ±3σ | Reject ppm
- Contributor chart (
stack_contrib.png) and histogram (stack_hist.png) - 2–3 concrete recommendations
Limits
1-D linear stacks only. For 2-D/3-D stacks (angular errors, chains with rotation), linearize with sensitivity coefficients: enter direction as the partial derivative ∂gap/∂xᵢ instead of ±1, and say so in the report.