Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
54 commits
Select commit Hold shift + click to select a range
ccee980
Add robustness analysis and red test suite for known bugs
claude Oct 23, 2026
0fd5bba
Fix robustness bugs found by the red test suite
claude Oct 23, 2026
a202b66
Update robustness analysis and add assessment of the old custom version
claude Oct 23, 2026
9129022
Add per-segment split control (locked segments)
claude Oct 23, 2026
7a5ea33
Harden noding and refinement against the GEOS robustness corpus
claude Oct 24, 2026
3e8142e
Add SnapTolerance for data precision, fix snap cycles in noder
claude Oct 24, 2026
78e69c3
Fix aCute refinement: dropped bad triangles, area constraints, reloca…
claude Oct 24, 2026
b44665e
Noder: crossings merged into an endpoint don't split (or retire) the …
claude Oct 24, 2026
41d4910
Docs: quality refinement fixes, ALKIS/DGM results, safety net and ben…
claude Oct 24, 2026
9b8b21b
aCute: reuse work arrays, cheaper neighbor lookup, skip stars of fixe…
claude Oct 24, 2026
311f651
Reuse bad triangle queue entries
claude Oct 24, 2026
fe1ca2c
Check encroachment before inserting a refinement vertex
claude Oct 24, 2026
d292f51
Refine at segments that must not be split; upstream issue tests
claude Oct 24, 2026
41af60f
Fix bugs found in review: IO, predicates range, log, mesh, pool, geom…
claude Oct 24, 2026
311d417
Fix bugs found in review: quality refinement, noding, converter, voro…
claude Oct 24, 2026
59d6696
Docs: class-by-class review results
claude Oct 24, 2026
1117f3d
Add grid snap rounding, wedge merging and terrain simplification
claude Oct 24, 2026
f8ef504
Grid mode: project splits onto input segment; bound wedge merging
claude Oct 24, 2026
88fbb16
Grid mode: don't drop triangles near grid-unsplittable subsegments
claude Oct 24, 2026
0b4fa3d
TerrainSimplifier: error bound for any Delaunay triangulation
claude Oct 24, 2026
28f28f6
Corpus: classify bad triangles; docs: what remains is grid-limited
claude Oct 24, 2026
9e3dc6a
Benchmarks: grid and wedge scenarios on ALKIS tiles
claude Oct 24, 2026
cb3eb62
Grid mode: skip relocation search, snap only vertices off the grid
claude Oct 24, 2026
211ee5f
Reduce allocations: inline triangle fields, predicate workspaces
claude Oct 24, 2026
fa298f0
SubSegment: inline fields instead of arrays (like Triangle)
claude Oct 24, 2026
3188939
Use InlineArray for triangle and subsegment fields on .NET 8+
claude Oct 24, 2026
661ea3f
Merge pull request #1 from HarmenGrosseDeters/claude/awesome-pascal-e…
HarmenGrosseDeters Oct 24, 2026
6bb8b7d
aCute star walk: stop at two triangles sharing two edges
claude Oct 25, 2026
a1c2e15
Tests with standard CDT benchmark data
claude Oct 25, 2026
29f4bc7
Noder: snap rounding as last resort; corpus: CDT inputs, Natural Earth
claude Oct 25, 2026
a1424df
Add switchable field layout for net48 (TriangleLayout=Fields|Arrays)
claude Oct 25, 2026
cf7da22
Add optional Steiner point reduction and ODT smoothing after refinement
claude Oct 25, 2026
8420718
Corpus harness: options for Steiner reduction, smoothing and conforming
claude Oct 25, 2026
8805f7d
Docs: corpus evaluation of Steiner reduction/smoothing and pooling me…
claude Oct 25, 2026
27b52d5
Faster area refinement: no aCute relocation for triangles that are on…
claude Oct 25, 2026
79db9dd
Degenerate hole rings as segments; public fixtures corpus; comparison…
claude Oct 25, 2026
7ad34bb
Docs: corrected fixture comparison counts
claude Oct 25, 2026
fe454f5
Prototype of index-based triangle storage; corpora for CGAL and Natur…
claude Oct 25, 2026
60b8347
Docs: Natural Earth lakes timeout is the corpus check, not the mesher
claude Oct 25, 2026
b00975c
Encroachment pre-check marks cavity triangles instead of using a set
claude Oct 25, 2026
6c43e03
aCute: fast path for half-planes that don't cut the polygon; stop at …
claude Oct 25, 2026
795f1df
Predicate micro-benchmarks (BenchmarkDotNet) and analysis
claude Oct 25, 2026
afd0deb
Index-based triangle storage (stage 1)
claude Oct 25, 2026
e13e48a
Index storage: flat Otri (pool, index, orient), index checks for the …
claude Oct 25, 2026
83cfd6f
Merge pull request #3 from HarmenGrosseDeters/claude/awesome-pascal-e…
HarmenGrosseDeters Oct 25, 2026
2db8eba
Fix solution build with triangle handles: rendering index buffer, exa…
claude Oct 25, 2026
383acc5
CI: Build und Tests im Release-Modus
claude Oct 25, 2026
80983fc
CI: Build und Tests im Release-Modus
claude Oct 25, 2026
1572a47
Merge pull request #2 from HarmenGrosseDeters/claude/index-struktur
HarmenGrosseDeters Oct 25, 2026
b36c531
Merge remote-tracking branch 'origin/master' into claude/awesome-pasc…
claude Oct 25, 2026
16bcdee
Korpus: Steiner-Limit per TRIANGLE_CORPUS_STEINER einstellbar
claude Oct 25, 2026
13a9760
Doku: weitere Natural-Earth-Ebenen ausgewertet
claude Oct 25, 2026
32d4869
Regressionstests mit harten Fällen aus externen Daten
claude Oct 25, 2026
0b1b934
Prädikate: exakt auch bei Unter- und Überlauf
claude Oct 25, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions .github/workflows/dotnet.yml
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,12 @@ jobs:
run: dotnet restore Triangle.sln
working-directory: ./src
- name: Build
run: dotnet build Triangle.sln --no-restore
run: dotnet build Triangle.sln --no-restore -c Release
working-directory: ./src
- name: Test
run: dotnet test Triangle.sln --no-build --verbosity normal
run: dotnet test Triangle.sln --no-build -c Release --verbosity normal --filter "TestCategory!=KnownBug"
working-directory: ./src
- name: Known bugs (red tests, expected to fail)
run: dotnet test Triangle.sln --no-build -c Release --verbosity normal --filter "TestCategory=KnownBug"
working-directory: ./src
continue-on-error: true
96 changes: 96 additions & 0 deletions docs/Alter-Stand-Bewertung.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
# Bewertung des alten, angepassten Stands

Gegenstand: `HarmenGrosseDeters/Triangle.Net-Old-Custom` (TriangleLib, früher Triangle.NET-Stand
um 2012/13 mit `InputGeometry`, `Primitives.cs`, `Carver.cs`) plus eigene Erweiterungen.
Verglichen mit diesem Fork nach den Robustheits-Fixes.

## Kurzfazit

* **Fallback auf den alten Stand bringt nichts.** In einem Differenztest (600 Eingaben × 3 Varianten)
(Details unten) gab es **keinen einzigen Fall, in dem der alte Stand ein gültiges Netz liefert
und der neue nicht**. Umgekehrt scheitert der alte Stand bei kreuzenden Bruchkanten in
~30 % der Fälle, davon etwa ein Drittel **still** mit invertierten Dreiecken oder NaN-Flächen.
Als Fallback eingesetzt, würde er also vor allem Fehler einschleppen, die ohne
Validierung nicht auffallen.
* **Dein Wrapper schaltet die exakte Arithmetik ab** (`Behavior.NoExact = true` in
`TriangulierenV2.cs`). Damit verlieren Shewchuks Prädikate jede Robustheitsgarantie. Das
sollte auf keinen Fall übernommen werden.
* Von den fachlichen Erweiterungen lohnen sich **gesperrte Kanten** und eine
**Iterations-/Fehlerberichterstattung**. Höheninterpolation und das Retten verworfener
Dreiecke lassen sich besser außerhalb der Bibliothek lösen (siehe unten).

## Differenztest alt ↔ neu

Alter Stand mit Stubs für die RWE-Typen gebaut (`Punkt`, `Dreieck`, `PointInPolygon`,
`QuadTree`) und so konfiguriert wie `TriangulierenV2` (`ConformingDelaunay`, `Quality`,
`MinAngle`), einmal mit `NoExact = true` (wie im Wrapper) und einmal mit exakter Arithmetik.
Jede Triangulierung in eigenem Prozess; geprüft: keine flachen/invertierten Dreiecke (exakt),
Gesamtfläche korrekt. Je 100 zufällige Eingaben.

| Szenario | alt, NoExact (Wrapper) | alt, exakt | neu |
|----------|------------------------|------------|-----|
| 15 Integer-Segmente, ohne Qualität | 67 OK · 22 Exception · **10 still ungültig** · 1 Endlosschleife | 71 OK · 18 Exception · **10 still ungültig** · 1 Endlosschleife | **100 OK** |
| dto., 20° | 66 OK · 24 Exception · **9 still ungültig (NaN/invertiert)** · 1 Timeout | 69 OK · 30 Exception · **1 still ungültig** | **100 OK** |
| dto. mit UTM-Offset (3,5e5), ohne Qualität | 73 OK · 15 Exception · **12 still ungültig** | 71 OK · 15 Exception · **14 still ungültig** | **100 OK** |
| dto. mit UTM-Offset, 20° | 71 OK · 18 Exception · **11 still ungültig** | 68 OK · 31 Exception · 1 Timeout | **100 OK** |
| Nicht kreuzende Bruchkanten + 300 Punkte, Gauß-Krüger (5,6e6), 20° | 98 OK · **2 still ungültig** | 99 OK · **1 still ungültig** | **100 OK** |
| Parallele Bruchkanten 0,1 mm Abstand, ohne Qualität | 100 OK | 100 OK | **100 OK** |
| dto., 20° | terminiert nicht (ohne `maxIterationen`) | – | **OK** (mit Steiner-Limit) |

Auffällig: Selbst **ohne jede Kreuzung** (realistische Bruchkanten in Gauß-Krüger-Koordinaten)
liefert der alte Stand in 1–2 % der Fälle still ein Netz mit invertierten Dreiecken.

## Die Anpassungen im Einzelnen

| Anpassung | Wo | Bewertung | Empfehlung |
|-----------|----|-----------|------------|
| `Behavior.NoExact = true` | `TriangulierenV2.cs:186` | Schaltet die exakten Prädikate ab, also genau den Mechanismus, der Triangle robust macht. Wahrscheinlich eine wesentliche Ursache der früheren Gleitkomma-Probleme. | **Nicht übernehmen.** |
| Abbruchzähler in `ScoutSegment`/`ConstrainedEdge` (`ScoutSegmentInfinityLoopException` bei 1000 Rekursionen) | `Mesh.cs:2440`, `:2770` | Richtige Idee (StackOverflow → Exception). | **Erledigt**, besser gelöst: Schleife statt Rekursion plus Schrittzähler, und durch das Noding tritt der Fall praktisch nicht mehr auf. |
| Eigene Exception-Typen mit Koordinaten (`TopologicalInconsistencyException`, `RanOutOfPrecisionException`, …) | `Exceptions/` | Diagnostisch wertvoll (wo im Gelände ist das Problem?), aber an `Rwe.Core.Model.Entities.Punkt` gebunden und 8 fast identische Klassen. | **Konzept übernehmen:** *eine* `TriangulationException` mit `Point`-Property und Fehlerart als Enum. Klein. |
| Gesperrte Kanten (`GesperrteKanten`, `NoBisect = 3`): Bruchkanten dürfen nicht geteilt werden, andere Segmente schon | `Mesh.cs:267`, `Quality.cs:328/351`, `Mesh.cs:1125/2071` | Fachlich sinnvoll (Bruchkanten im DGM unverändert lassen). Der neue Stand kennt nur `SegmentSplitting` 0/1/2 global. | **Portieren**, aber sauberer: über das Segment-Label statt Index-Lookup, z. B. `ConstraintOptions.CanSplitSegment = label => …`. Mittel. Hinweis: Nicht teilbare Segmente heben die Winkelgarantie auf; daher immer mit Steiner-Limit kombinieren. |
| `maxIterationen` (globale Grenze) | `Quality.cs:1103` | Schutz gegen Endlosverfeinerung. | **Vorhanden:** `QualityOptions.SteinerPoints` + `CancellationToken`. |
| `anzahlOk` (Dreieck höchstens n-mal neu einreihen), Rückgabe von `schlechteDreiecke`/`problematischeDreiecke`, `maxOK` | `Quality.cs:594`, `:1118`, `:1148–1190` | Nützlich, um bei gesperrten Kanten nicht endlos am selben Dreieck zu arbeiten und dem Aufrufer zu melden, wo die Qualität nicht erreicht wurde. | **Teilweise portieren:** Pro-Dreieck-Limit zusammen mit gesperrten Kanten; die Liste der schlechten Dreiecke kann man auch nachträglich über die Winkel ermitteln (`QualityMeasure`), ohne die Bibliothek zu ändern. |
| Höhe (Z) neuer Punkte aus der **ursprünglichen** Triangulierung per QuadTree statt `xi`/`eta` | `Mesh.cs:556`, `Quality.cs:956` | Inhaltlich richtig, denn die Original-Interpolation extrapoliert, wenn der neue Punkt außerhalb des Dreiecks liegt. Aber: **feste Fallback-Höhen 211.0 bzw. 199.0** bei Fehlschlag → stillschweigend falsche Höhen. | **Nicht in die Bibliothek.** Besser: erst ohne Qualität triangulieren (Referenz-TIN), dann mit Qualität; Z der neuen Punkte danach per `TriangleQuadTree` im Referenz-TIN interpolieren. Kein Treffer = Fehler, keine Magic Numbers. Der neue Stand braucht dafür kein `USE_Z`. |
| `pruefeDreieckExtern` / `FehlerhaftVerworfeneDreiecke`: beim Löcherschneiden „versehentlich“ entfernte Dreiecke wieder hinzufügen | `Carver.cs:200`, `Mesh.cs:3083` | Workaround für ein Symptom: Wenn Bruchkanten einen Innenring „öffnen“ oder kreuzen, ist das Loch nicht geschlossen und die Infektion beim Carving läuft aus. Die geretteten Dreiecke gehören dann nicht zur Topologie des Netzes. | **Nicht übernehmen.** Ursache beheben: Das Noding hält Ringe jetzt auch bei kreuzenden Bruchkanten geschlossen. Robuster: Innenringe über **Regionen** (Label) statt Lochpunkte markieren und die Dreiecke danach per Label filtern; dann gibt es kein Auslaufen mehr. |
| Lochpunkt-Bestimmung im Wrapper (Schwerpunkt der ersten konvexen Ecke, die innen liegt) | `TriangulierenV2.cs:671` | Kann bei schmalen/konkaven Ringen fehlschlagen; dann fehlt das Loch. | Neu: `Contour.FindInteriorPoint()` bzw. Regionen-Ansatz. |
| aCute-Puffer 500 → 1500 Punkte | `NewLocation.cs:2089` | Sinnvoll. Der neue Stand hat 500 und bricht bei Überlauf aCute ab (Issue #58); dann greift jetzt der neue Rückfall auf den Umkreismittelpunkt. | **Optional übernehmen** (dynamische Größe). Klein. |
| Rundung der Ergebnis-Koordinaten (cm) und Zuordnung neuer Punkte zu Bruchkanten/Ringen mit 1 cm Toleranz | `TriangulierenV2.cs:307`, `:376–487` | Nachbearbeitung im Aufrufer. Achtung: Durch das Runden **nach** der Triangulierung können Dreiecke kippen. | Im Aufrufer belassen; nach dem Runden Orientierung prüfen. Besser: Eingabe vorher auf das Zielraster runden, dann ist die Triangulierung exakt auf dem Raster. |

## Rolle des Clipper-Wrappers

`Core.Wrapper.ClipperLibrary` rechnet in Ganzzahlkoordinaten (Faktor 10⁵ bzw. 10¹) mit Clippers
exakter Arithmetik:

* In `TriangleLib` wird nur `PointInPolygon<T>` genutzt (Ring- und Innenringtests in
`pruefeDreieckExtern`, Lochpunkt im Wrapper). Ergebnis `Innen`/`Auf`/`Außen`.
* `GlaettePolygone` (`Clipper.SimplifyPolygon`, entfernt Eigenschnitte) und `BereinigePolygone`
(`Clipper.CleanPolygon`, entfernt Fast-Kollinearitäten) sind faktisch Snap-Rounding
**pro Ring**. Kreuzungen **zwischen** Bruchkanten untereinander und zwischen Bruchkanten und
Ringen behandeln sie nicht. Genau diese Fälle haben im alten Stand die Fehler erzeugt, und
genau sie löst jetzt der `SegmentNoder` im Fork.

Die Clipper-Vorverarbeitung der Ringe kann bleiben; sie schadet nicht.

## Empfohlene Architektur statt Fallback

```
Eingabe ──► (Clipper: Ringe bereinigen, wie bisher)
──► Fork: Triangulate(poly, constraints, quality{SteinerPoints, ggf. CanSplitSegment})
│ (Noding/Snapping intern, exakte Prädikate, thread-sicher)
├─ MeshValidator.IsConsistent(mesh) ── ok ──► Z aus Referenz-TIN interpolieren
└─ Exception / inkonsistent
├─► Retry 1: QualityOptions.UseLegacyRefinement = true (ohne aCute)
├─► Retry 2: Eingabe auf gröberes Raster runden (z. B. 1 mm), erneut
└─► Fehler mit Koordinate melden (TriangulationException)
```

Der alte Stand kommt in dieser Kette nicht mehr vor. Falls du ihn für eine Übergangszeit
trotzdem parallel betreiben willst, dann nur **mit** Validierung des Ergebnisses
(Orientierung aller Dreiecke, Fläche) und mit `NoExact = false`.

## Nebenbefund zum Repository

Im alten Repository liegen `bin/` und `obj/` mit eingecheckt, darunter interne
Binärbibliotheken (`Rwe.Core.*`) und Drittanbieter-DLLs (z. B. Oracle, PdfSharp). Falls das
Repository nicht privat ist oder geteilt wird, sollten diese Verzeichnisse entfernt und per
`.gitignore` ausgeschlossen werden.
Loading