[FEAT] Werkzeuge zum Auslesen fremder Zeichnungen und der VF-Eingabe-Journale

Grundlage fuer reproduzierbare Nachbau-Testfaelle aus echten Projekt-
zeichnungen (HundM05).

- lib/vf_journal_export.py (neu): liest die Eingabe-Journale der VF_n-Bloecke
  aus der XDATA (App SSG_VF_EDIT, Marker "linienzug") und schreibt sie als
  Frage-Antwort-Protokoll im Schema von tests/testdata/linienzug_tests.json -
  Gegenstueck zu vfl-entry->string, ohne ezdxf (reine Gruppencode-Lesung).
  Optional --csv fuer Strecken-ID und Erwartungswerte je Kette.
- lib/extract_polylines.py (neu): LWPOLYLINE-Objekte als JSON, inkl.
  OCS->Welt-Umrechnung fuer gekippte Ebenen (Handles, Segment-/Gesamtlaengen).
- lib/dxf_scan_components.py: erkennt jetzt zusaetzlich, ob ein Block ein
  2D-Schema oder ein 3D-Modell ist (TYPEN_3D, ist_3d_block/darstellung_von) -
  eine Anlagenzeichnung enthaelt beides. Dazu Sensor-Erfassung,
  Zwillings-Zusammenfuehrung und Hoehenschaetzung aus der Umgebung.
- lib/dxf_abbild.py: gibt die erkannte Darstellung je Element mit aus.
- tests/test_vf_journal_grammatik.py (neu): prueft den Journal-Dekoder gegen
  handgebaute Journale - ohne CAD und ohne die grosse DXF. Deckt die zwei
  Zweige ab, die in den echten Ketten nicht vorkommen: Glied "Linie-VF" und
  eine VF-Einheit mit gewinkeltem Erstkoerper (dort fragt vfl-vf-einheit
  KEINE Separator-/Endpunkt-Fragen vorab, anders als beim horizontalen).
- data/polylines.md, tests/testdata/hundm05_linienzug_polylines.json:
  ausgewertete Streckenzuege der Quellzeichnung.
- .gitignore: die Quellzeichnungen selbst (data/polylines.dxf 124 MB,
  data/polylines.dwg, tests/HM5.dwg) bleiben draussen - eingecheckt ist die
  Auswertung, nicht die Zeichnung.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-03 10:13:56 +02:00
parent 0015d6aa5b
commit bbc9e9b9f9
8 changed files with 1651 additions and 39 deletions
+168
View File
@@ -0,0 +1,168 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
test_vf_journal_grammatik.py - Prueft den Journal-Dekoder in
lib/vf_journal_export.py gegen handgebaute Journale.
Warum: der Dekoder ist die ZWEITE Implementierung der Linienzug-Grammatik
(erste ist der Bau-Ablauf in Lisp/vf_linienzug.lsp selbst). Nur wenn beide
dieselbe Frage-Reihenfolge kennen, laesst sich ein Journal aus einer echten
Zeichnung verlustfrei in das Testdatenschema zuruecklesen
(tests/testdata/hundm05.json).
Die 5 echten HundM-Ketten deckten zwei Zweige NICHT ab, weil ihre Daten sie
nicht enthalten:
- Glied "Linie-VF" ("Neue Linie: Ab/Auf VF")
- eine VF-Einheit mit GEWINKELTEM Erstkoerper - dort stellt
vfl-vf-einheit KEINE Separator-/Endpunkt-Frage vorab (das tut nur
vfl-baue-horizontal-koerper beim horizontalen Erstkoerper, winkel1=0)
Genau diese beiden Faelle sichern die Tests hier ab. Laeuft ohne CAD und ohne
die grosse DXF - die Journale stehen als Token-Listen im Test.
"""
import os
import sys
import pytest
sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "lib"))
import vf_journal_export as vje
def _journal(*tokens):
"""Token-Liste in die Rohform bringen, in der das Journal in der XDATA
steht: "ART:wert", verbunden mit dem Trenner (die zwei Zeichen "^J" -
ein echter Zeilenumbruch wuerde die zeilenweise DXF-Lesung brechen)."""
return vje.TRENNER.join(tokens)
PRAEAMBEL_OHNE_AS = ("PT:0.0,0.0,5000.0", "REAL:5000.0", "STR:2")
ES_GLIED = ("STEP:ES", "STR:90", "STR:1")
def _dekodiere(*tokens):
j = vje.Journal(_journal(*tokens))
out = j.dekodiere() # wirft, wenn Tokens uebrig bleiben
return out
def _typen(eintraege):
return [e["typ"] for e in eintraege]
def _labels(eintraege):
return [e["wert"] for e in eintraege if e["typ"] == "step"]
class TestHorizontalVF:
"""Kontrollfall: VF-Einheit mit horizontalem Erstkoerper. Dieser Zweig
kommt in den echten HundM-Ketten vor und muss unveraendert bleiben."""
TOKENS = PRAEAMBEL_OHNE_AS + (
"STEP:Horizontal-VF",
"STR:3", # erste Sektion, 4 Optionen: 3 = Horizontal-VF
"DL:8000.0",
"REAL:0.0", # gesnappte Fahrtrichtung (nur erstes Segment)
"STR:2", # GF-Verteilung: alles am Einlauf
"STR:2", # Separator VOR dem horizontalen Stueck? Nein
"STR:2", # Separator NACH dem horizontalen Stueck? Nein
"STR:1", # Endpunkt des Foerderers? Ja, nur Motorstation
"STR:1", # Kettenende? Ja, Separator + ES
) + ES_GLIED
def test_dekodiert_vollstaendig(self):
eintraege = _dekodiere(*self.TOKENS)
assert _labels(eintraege) == ["Horizontal-VF", "ES"]
assert _typen(eintraege)[:3] == ["point_abs", "real", "string"]
def test_separatorfragen_vorhanden(self):
"""Der horizontale Erstkoerper fragt Separator vor/nach - das ist der
Unterschied zum gewinkelten Erstkoerper."""
kommentare = " | ".join(e["kommentar"] for e in
_dekodiere(*self.TOKENS))
assert "Separator VOR" in kommentare
assert "Separator NACH" in kommentare
class TestLinieVF:
"""Der bis dahin fehlende Zweig: Glied "Linie-VF" mit gewinkeltem
Erstkoerper der VF-Einheit."""
TOKENS = PRAEAMBEL_OHNE_AS + (
"STEP:Linie-VF",
"STR:2", # erste Sektion, 4 Optionen: 2 = Neue Linie Ab/Auf VF
"DL:12000.0",
"REAL:0.0", # gesnappte Fahrtrichtung
"REAL:3000.0", # Zielhoehe des Linienendpunkts
# keine Winkelwahl: nur ein Kandidat war gueltig
"STR:2", # GF-Verteilung: alles am Einlauf
# KEINE Separator-/Endpunktfrage vorab
"STR:1", # Endpunkt des Foerderers? Ja, nur Motorstation
"STR:1", # Kettenende? Ja, Separator + ES
) + ES_GLIED
def test_dekodiert_vollstaendig(self):
eintraege = _dekodiere(*self.TOKENS)
assert _labels(eintraege) == ["Linie-VF", "ES"]
def test_keine_separatorfragen(self):
"""Ein gewinkelter Erstkoerper wird ohne Frage gebaut. Wuerde der
Dekoder hier - wie vor dem Fix - horizontal_koerper() aufrufen,
verschluckte er die Endpunkt-Antwort als Separator-Antwort und liefe
aus den Tokens heraus."""
kommentare = " | ".join(e["kommentar"] for e in
_dekodiere(*self.TOKENS))
assert "Separator VOR" not in kommentare
assert "Zielhoehe" in kommentare
def test_winkelwahl_optional(self):
"""vfl-waehle-winkel fragt nur bei mehreren gueltigen Kandidaten -
dann steht ein INT im Journal, sonst nicht."""
mit_wahl = list(self.TOKENS)
mit_wahl.insert(mit_wahl.index("REAL:3000.0") + 1, "INT:2")
eintraege = _dekodiere(*mit_wahl)
assert [e["typ"] for e in eintraege].count("int") == 1
def test_vario_kurve_in_der_einheit(self):
tokens = PRAEAMBEL_OHNE_AS + (
"STEP:Linie-VF",
"STR:2",
"DL:12000.0",
"REAL:0.0",
"REAL:3000.0",
"STR:2", # GF-Verteilung
"STR:2", # Endpunkt? Nein, weiterbauen
"STR:2", # Naechstes in der VF-Einheit: Vario-Kurve
"STEP:Vario-Kurve",
"INT:90",
"STR:1", # Seite links
"STR:1", # Variante aussen
"STR:1", # Endpunkt? Ja, nur Motorstation
"STR:2", # Kettenende? Nein, weiterbauen
"STR:2", # Separator an dieser Stelle? Nein
"STEP:Linie",
"STR:5", # Folge-Sektion, 5 Optionen: 5 = Linie bis Ende
"DL:4000.0",
"REAL:3000.0", # Zielhoehe am Kettenende
) + ES_GLIED
eintraege = _dekodiere(*tokens)
assert _labels(eintraege) == ["Linie-VF", "Vario-Kurve", "Linie", "ES"]
class TestFehlerfaelle:
"""Der Dekoder darf nicht raten: fehlende oder ueberzaehlige Tokens sind
ein Fehler, kein stiller Teilerfolg."""
def test_unbekanntes_glied(self):
with pytest.raises(ValueError):
_dekodiere(*(PRAEAMBEL_OHNE_AS + ("STEP:Gibtsnicht", "STR:1")))
def test_tokens_uebrig(self):
with pytest.raises(ValueError):
_dekodiere(*(TestLinieVF.TOKENS + ("STR:1",)))
def test_journal_zu_kurz(self):
with pytest.raises(ValueError):
_dekodiere(*TestLinieVF.TOKENS[:-1])
+124
View File
@@ -0,0 +1,124 @@
[
{
"handle": "CA",
"layer": "Z-6",
"geschlossen": false,
"elevation": -271.7589,
"extrusion": [-0.0, -0.0436, -0.9991],
"anzahl_punkte": 5,
"punkte_ocs": [
[8608.0283, -5622.4633],
[8608.1795, -6230.2512],
[9758.1665, -6230.2507],
[9758.1805, -5392.918],
[9752.5609, -1913.0356]
],
"punkte_welt": [
[8608.046, 5628.9379, 26.4861],
[8608.1991, 6236.1483, 0.0],
[9758.1861, 6236.1442, 0.0],
[9758.1975, 5399.607, 36.4891],
[9752.5669, 1923.0303, 188.1348]
],
"segment_laengen": [0.0, 607.7879, 1149.987, 837.3327, 3479.887],
"gesamtlaenge": 6074.9945
},
{
"handle": "CD",
"layer": "Z-6",
"geschlossen": false,
"elevation": 199.7371,
"extrusion": [0.0, 0.0, 1.0],
"anzahl_punkte": 6,
"punkte_ocs": [
[4927.0558, 1205.361],
[4932.563, 7060.2017],
[7106.355, 7060.2017],
[7106.1386, 4645.5146],
[6189.1673, 2991.5761],
[6176.2696, 1205.361]
],
"punkte_welt": [
[4927.0558, 1205.361, 199.7371],
[4932.563, 7060.2017, 199.7371],
[7106.355, 7060.2017, 199.7371],
[7106.1386, 4645.5146, 199.7371],
[6189.1673, 2991.5761, 199.7371],
[6176.2696, 1205.361, 199.7371]
],
"segment_laengen": [0.0, 5854.8433, 2173.7921, 2414.6871, 1891.1237, 1786.2617],
"gesamtlaenge": 14120.7078
},
{
"handle": "8BA1",
"layer": "Z-6",
"geschlossen": false,
"elevation": -2636.2483,
"extrusion": [-0.0, -0.0436, -0.9991],
"anzahl_punkte": 5,
"punkte_ocs": [
[12892.9127, -5519.3396],
[12893.0639, -6127.1274],
[14043.0509, -6127.1269],
[14043.0649, -5289.7943],
[14037.4453, -1809.9118]
],
"punkte_welt": [
[12892.9303, 5628.9379, 2393.2232],
[12893.0835, 6236.1483, 2366.7371],
[14043.0705, 6236.1442, 2366.7371],
[14043.0818, 5399.607, 2403.2263],
[14037.4513, 1923.0303, 2554.8719]
],
"segment_laengen": [0.0, 607.7879, 1149.987, 837.3327, 3479.887],
"gesamtlaenge": 6074.9945
},
{
"handle": "8BCF",
"layer": "Z-6",
"geschlossen": false,
"elevation": -2636.2489,
"extrusion": [-0.0, -0.0436, -0.9991],
"anzahl_punkte": 5,
"punkte_ocs": [
[17202.5751, -4259.1639],
[17203.0502, -6127.1409],
[18353.0372, -6127.1404],
[18353.0512, -5289.8078],
[18347.4315, -1809.9253]
],
"punkte_welt": [
[17202.5888, 4369.9458, 2448.1395],
[17203.0698, 6236.1483, 2366.7371],
[18353.0568, 6236.1442, 2366.7371],
[18353.0681, 5399.607, 2403.2263],
[18347.4376, 1923.0303, 2554.8719]
],
"segment_laengen": [0.0, 1867.9771, 1149.987, 837.3327, 3479.887],
"gesamtlaenge": 7335.1837
},
{
"handle": "8BFD",
"layer": "Z-6",
"geschlossen": false,
"elevation": -2536.3444,
"extrusion": [-0.0, -0.0436, -0.9991],
"anzahl_punkte": 5,
"punkte_ocs": [
[21481.2117, -5523.7243],
[21481.3629, -6131.5121],
[22631.3499, -6131.5116],
[22631.3639, -5294.179],
[22625.7443, -1814.2965]
],
"punkte_welt": [
[21481.2293, 5628.9379, 2293.2232],
[21481.3825, 6236.1483, 2266.7371],
[22631.3695, 6236.1442, 2266.7371],
[22631.3808, 5399.607, 2303.2263],
[22625.7503, 1923.0303, 2454.8719]
],
"segment_laengen": [0.0, 607.7879, 1149.987, 837.3327, 3479.887],
"gesamtlaenge": 6074.9945
}
]