Files
solidcraft/tests/kernel-cases/threads/602-fillet-hex-head-beside-modelled-thread/expected.json
T
jyvikoandClaude Opus 5.5 366b90597f Threads start at the end meant and stop clear of a shoulder
A thread of some length ran from "the end of the face nearest the pick", a coin toss for a
pick in the middle (rig 602's 4 mm thread meant for the free bottom end ran at the head end,
cutting 1.17 mm into the hex), and every thread end at a face end got a one-pitch overrun,
which at a shoulder gouged the material past it (ladder 06/004 cut 0.9% of its volume out of
the collar).

- kernel: material_in_ring, the exact intersection of a body with a ring about a cylinder
  face's axis, by an SMLib boolean.
- doc: a face end is free when no material lies past it, over the span the groove's one-pitch
  overrun reaches beyond its first pitch, within the radii the groove cuts (a cap, a chamfer
  the groove runs out through, a counterbore). At a free end the groove runs out as before; at
  a closed one (a shoulder, a head, a blind hole's bottom) it stops with its widest part clear
  of it; inside the face it stops square.
- doc: a thread of some length starts at the end nearest `from`, else at the face's only free
  end, else at the end the pick lies within a third of the face of; a pick in the middle of a
  face whose ends are alike is refused, naming `from`. A length as long as the face runs the
  whole face. `up_to` a plane or a point's place along the axis. New fields `from`, `up_to`
  default to none, so saved threads keep their meaning where it was not a coin toss.
- engine: solid.thread takes extent (full|length|up_to), from and up_to.
- ladder 06/003 (now with `from`), 004 and 007 are graded by volume and centre of mass in
  closed form (a square stop inside material removes exactly length/P turns, the section being
  symmetric); rig 602's method says why the thread is at the bottom, tolerance 0.02%.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 02:28:52 -04:00

28 lines
2.0 KiB
JSON

{
"sources": [
"tangency-labs/solidcraft#602",
"tangency-labs/solidcraft#618"
],
"what": "rounding the top edges of a hex head on a shaft with a modelled thread (it froze the app)",
"source": "analytic",
"method": "ISO 68-1 basic profile: H = P sqrt3/2, basic depth 5H/8. External groove (the space between teeth): a trapezoid P/4 wide at the root radius d/2 - 5H/8, widening by 2 tan30 per unit of radius to 7P/8 at d/2. Internal groove: P/8 wide at the major radius d/2, widening to 3P/4 at the minor radius, cut only where there is material (r >= hole radius). Pappus: volume per turn = 2 pi A rc (A the trapezoid area, rc its centroid radius from the axis); a helical sweep of L/P turns removes exactly (L/P) x that, where each end of the thread is a free end or lies inside material. Shaft D5 h=10 plus a hexagonal head of apothem a=2 (area 2 sqrt3 a^2 = 13.8564), h=3. M5 (P=0.8) over 4 mm from the free bottom end (5 turns): 5 x 2.84480. The pick (z=5) is mid-face: the thread starts at the face's only free end. The top end (z=10) is not free: the hex's corners (2.3094 mm out) lie past the M5 root (2.0670 mm), in the groove's way, so the groove never reaches the head (it used to, from the head end, cutting 1.17 mm into it and clipping its corners into the groove's flank); the stop at z=4 is square inside the shaft, removing exactly 4/P turns (the section is symmetric about its centre line). The six top edges rounded R=r=0.3 with the vertical edges left sharp: the section at depth y below the top is a hexagon of apothem a - d(y), d = r - sqrt(r^2 - (r-y)^2); removed = 2 sqrt3 int (2 a d - d^2) dy = 2 sqrt3 [2 a r^2 (1 - pi/4) - r^3 (5/3 - pi/2)] = 0.25866. V = pi 2.5^2 10 + 41.5692 - 5 x 2.84480 - 0.25866 = 223.4361 mm3. Tolerance 0.02%: the groove is SMLib's exact screw sweep (a groove run from the head end instead removes 0.2 mm3 of the head, 0.09%).",
"outcome": "solid",
"body_count": 1,
"volume_mm3": 223.4361,
"tolerance": {
"rel": 0.0002
},
"bbox": {
"min": [
-2.5,
-2.5,
0
],
"max": [
2.5,
2.5,
13
]
}
}