Skip to content

DRAFT: amend 2003–2005 JTS PDFs against #7 curve stack - #46

Merged
cursor[bot] merged 2 commits into
feature/sfa-curve-rgrfrom
cursor/amend-jts-guides-curve-7ba1
Aug 16, 2026
Merged

DRAFT: amend 2003–2005 JTS PDFs against #7 curve stack#46
cursor[bot] merged 2 commits into
feature/sfa-curve-rgrfrom
cursor/amend-jts-guides-curve-7ba1

Conversation

@grootstebozewolf

@grootstebozewolf grootstebozewolf commented Aug 16, 2026

Copy link
Copy Markdown
Owner

Draft only. Base is feature/sfa-curve-rgr (PR #7 @ 8e39e39a). Do not merge this into #7. Do not retarget master.

Replaces the three in-tree 2003–2005 PDFs in place (same paths). No product code. Source of truth is the #7 tree only. #45 is not a source.

What each PDF now says that the 2003–2005 copies did not:

doc/JTS Developer Guide.pdf

  • Curve types on this tree: CircularString, CompoundCurve, CurvePolygon (plus MultiCurve / MultiSurface). Opt-in CurveGeometryFactory — default factory throws; constructors do not linearise.
  • WKT: CurveWKTReader / CurveWKTWriter. Core WKTReader still rejects SQL-MM keywords.
  • WKB 8–12 read in core; write via CurveWKBWriter; a bare WKBWriter.write still emits type 2 (CircularString / CompoundCurve) or 3 (CurvePolygon).
  • Overlay type is OverlayNGCurve (never OverlayNGCurved). No public noder. Closed-form constructions: certified discs and the single-arc hull. Open-arc buffer is BufferOp on chords.
  • D-HF via 0ca71b (on SFA/SQL-MM curve awareness: Curve rename, arc-aware operations, OverlayNGCurve ratchet (#1195 RGR series) #7): public DiscreteHausdorffDistance closed-form for two pairs only — single-arc CircularString → single-segment LineString, apex √949/6 − 7/6 ≈ 3.967641; two circular discs. MultiSurface unwrap of one disc is the same pair. Public DHD still sees chords in general. fail() stays. Densify is not the laser. Fréchet still open.
  • Licence is JTS dual EPL-2.0 + EDL-1.0.

doc/JTS TestBuilder & TestRunner User Guide.pdf

doc/JTS Technical Specs.pdf

  • Concrete CircularString / CompoundCurve / CurvePolygon and a WKB 8–12 table (read in core; write via CurveWKBWriter; bare writer still 2/3).
  • Disc hull and single-arc hull as the closed-form hulls on this tree.
  • OverlayNG for linear; OverlayNGCurve for the curve subset; no public noder.
  • D-HF section with the two-pair lock from 0ca71b above.
  • No clothoid DOI.
Open in Web Open in Cursor 

cursoragent and others added 2 commits August 16, 2026 15:50
Replace the three in-tree guides in place so they no longer describe a
linear-only JTS. Content is checked against feature/sfa-curve-rgr @
8e39e39. No product code. Draft only; do not merge into #7.

Co-authored-by: Jeroen Bloemscheer <grootstebozewolf@users.noreply.github.com>
Keep only what is on feature/sfa-curve-rgr @ 8e39e39. D-HF closed
form is the two pairs from 0ca71b. Do not name #41#45 or Bar 2.

Co-authored-by: Jeroen Bloemscheer <grootstebozewolf@users.noreply.github.com>
@cursor
cursor Bot marked this pull request as ready for review August 16, 2026 15:59
@cursor
cursor Bot merged commit bafaa84 into feature/sfa-curve-rgr Aug 16, 2026
4 checks passed
cursor Bot pushed a commit that referenced this pull request Aug 16, 2026
Replace the #46 binary-amended PDFs with pdflatex output. Sources
live under doc/latex. Curve claims match feature/sfa-curve-rgr HEAD
(H-CC hull, A/B colours, WKB export honesty, TB-IN, stadium MIC,
LEC, clothoid extras). D-HF two-pair lock stays 0ca71b. Named
figure holes are empty 4:3 slots. Do not merge.

Co-authored-by: Jeroen Bloemscheer <grootstebozewolf@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants