Skip to content

Commit c6e54ed

Browse files
scottconverseclaude
andcommitted
docs: address v0.3 review nits
- README/MANUAL: document tq_ph_dims and tq_ph_size_for - REFERENCES: tighten rounded-fillet derivation (rr=H/6, rc=H/12); align Phillips cruciform wording with the code (two crossed full-width wings) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 57264cc commit c6e54ed

3 files changed

Lines changed: 11 additions & 9 deletions

File tree

MANUAL.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -248,7 +248,9 @@ tq_phillips_tip(size=2, shank_d, length); // driver-bit
248248
```
249249
`drive` selects the head recess: `"hex"` (default), `"phillips"`, or `"none"`.
250250
The Phillips form is a clean-room printable approximation (see REFERENCES),
251-
sized by PH number; `tq_ph_size_for(d)` maps a diameter to a PH number.
251+
sized by PH number. Helper functions: `tq_ph_size_for(d)` maps a screw diameter
252+
to a PH number (0–4), and `tq_ph_dims(size)` returns `[arm_reach_mm,
253+
wing_width_mm]` for that PH number.
252254

253255
### Child-difference convenience wrappers
254256
Apply to `children()`; each cuts its hole at position `at` (default origin, axis +Z):

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -249,6 +249,7 @@ tq_wood_screw(d,length,pitch,head="countersunk"|"pan",point=true,...);
249249
250250
// drives, auger, relief (v0.3)
251251
tq_phillips_drive(size,depth); tq_phillips_tip(size,shank_d,length);
252+
tq_ph_dims(size) -> [arm_reach,wing_width]; tq_ph_size_for(d) -> PH number;
252253
tq_auger(d,length,pitch,flight,taper=0,...); tq_auger_hole(d,length,pitch,flight,through=true,...);
253254
tq_relief_groove(d,width,depth);
254255

REFERENCES.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -34,13 +34,11 @@ H = (sqrt(3)/2) · P = 0.8660254 · P
3434
| Rounded crest radius (this lib) | `≈ 0.072·P` | 0.072·P |
3535

3636
**Derivation of the rounded fillet radii** (used by `profile="rounded"`,
37-
`_tq_table_round`). The root fillet is the standard UNR/ISO value
38-
`rr ≈ 0.1443·P` — i.e. the radius of a circle tangent to both 60° flanks that
39-
fits the `H/4` root truncation: `(H/4)/(1/sin60° − 1)`-class geometry gives
40-
`≈ H/6 = 0.866·P/6 = 0.1443·P`. The crest fillet is taken at **half** that,
41-
`rc = rr/2 ≈ 0.0722·P`, matching the crest truncation being half the root
42-
truncation (`H/8` vs `H/4`). Both follow from the 60° triangle and `H`; neither
43-
is copied from any library.
37+
`_tq_table_round`). The root fillet uses the standard UNR/ISO-class rounded-root
38+
value `rr ≈ H/6 = 0.866·P/6 = 0.1443·P`. The crest fillet is taken at **half**
39+
that, `rc = rr/2 = H/12 ≈ 0.0722·P`, mirroring the crest truncation (`H/8`) being
40+
half the root truncation (`H/4`). Both are expressed directly in terms of the
41+
60° triangle height `H`; neither is copied from any library.
4442

4543
Standards:
4644

@@ -112,7 +110,8 @@ for sizes outside its table.
112110
1:16 taper (≈1.79° per side); `taper` lets you reproduce any linear taper, but
113111
this library does not implement NPT's specific truncated profile.
114112
- **Phillips (cross) recess** (`tq_phillips_drive`, `drive="phillips"`). The
115-
cruciform recess concept (a central point plus four 90°-spaced wings that taper
113+
cruciform recess concept (a central point plus two crossed full-width wings —
114+
each spanning both arms of one axis — forming the four-armed cross, tapering
116115
toward the tip) is described by **ISO 4757** (cross recesses for screws) and
117116
the ANSI Type I Phillips standard. tq-threads builds an **approximate, clean-room**
118117
cruciform from OpenSCAD primitives (a tapered core + two crossed hulled wings)

0 commit comments

Comments
 (0)