STEP-Vorkommensansichten und technische Illustrationen
Diese Fähigkeit steuert dieselbe lokale facts-CLI wie cad-to-facts. Sie erstellt schreibgeschützte OCCT-Ansichten mit verdeckten Linien eines explizit ausgewählten STEP-Vorkommens. Das Quellartefakt wird niemals modifiziert. Das Rendern erfolgt offline und deterministisch; es ruft kein LLM/VLM auf und lädt weder Modell noch Bild hoch.
Implementierter Umfang
facts resolve: exakte Vorkommnis-/Definitionsnamen, Teilzeichenfolgen/Aliase, Pfad, Definition, Wurzel-/Baugruppenart, Zustand und räumliche Beschränkungen der Begrenzungsbox der Welt. Gibtresolved,ambiguous,unresolvedoderfailedzurück; es wählt niemals einen von mehreren Kandidaten anhand der Durchlaufreihenfolge aus.facts orient: sechs Kamerakandidaten und eine optionalerecommended_viewbasierend auf der Heuristik der größten Begrenzungsboxfläche, nach außen von der Baugruppe. Eine Empfehlung hat immersemantic_status=assumed.facts renderauf STEP: ein aktivesoccurrence:N, eine expliziteViewSpecification, eine neue SVG und eine neue zugehörige.view.json-Manifestdatei.- Globalachsen-Kamerapresets und explizite Normal-/Rechtsvektoren, sichtbare/verdeckte Linienausgabe, begrenzte SVG-Punktanzahl, Artefakt-/Snapshot-/Ausgabe-Hashes mit exakter Zielbindung und optionale vom Benutzer ausgewählte oder angenommene Ansichtssemantik.
PNG, Schnitt-/Explosions-/Schattierungsansichten, fotorealistische Ausgabe, Bemaßungsanmerkungen, quellendeklarierte oder funktionale Front-Erkennung und visuelle Inferenz sind nicht implementiert. SVG ist ein Überprüfungs-/Dokumentations-WorkProduct, kein visueller oder geometrischer Gleichheitsbeweis und kein FactSet.
Einrichtung
Verwenden Sie die installierte facts-CLI des Repositorys oder uv run --project /pfad/zu/cad-to-facts facts .... Die Referenzumgebung ist Python 3.13 mit den gesperrten OCCT-Abhängigkeiten. Für das STEP-SVG-Rendering werden kein ODA, Text-zu-CAD, Blender oder Netzwerkdienst verwendet.
Vor dem Rendern auflösen
Schreiben Sie ein TargetSelector-JSON, z.B.:
{"name_contains": "TUER", "is_assembly": false}
Führen Sie dann aus:
facts resolve assembly.step --selector tuer-selector.json
Lesen Sie resolution.status, resolution.complete, resolution.discovery, Kandidaten und Diagnosen. name und name_contains durchsuchen sowohl Vorkommensnamen als auch Teildefinitionsnamen, da einige STEP-Dateien nur PRODUKTnamen deklarieren. Kandidaten name_path und path sind unterschiedlich: Ersterer dient der Anzeige, während Letzterer Snapshot-bezogene Vorkommens-IDs verbindet und die exakte Pfad-Selektorform ist.
resolved: genau ein entdeckter Kandidat; verwenden Sie dessenoccurrence_id.ambiguous: überprüfen Sie die Pfade, Namen und platzierten Begrenzungsboxen der Kandidaten, fügen Sie Beschränkungen hinzu oder bitten Sie den Benutzer, eine Auswahl zu treffen. Wählen Sie niemals stillschweigend den ersten aus.unresolved: Es wurde kein passender Kandidat entdeckt. Dies ist kein Beweis für das Fehlen im Engineering.failed: Der Snapshot konnte nicht gelesen werden; rendern Sie nicht daraus.
complete bedeutet vollständige Vorkommensentdeckung plus eine messbare platzierte Begrenzungsbox für jeden zurückgegebenen Kandidaten. Es bedeutet keine vollständige Formvalidierung, keine Diagnosen, erfolgreiche Auflösung oder globale Eindeutigkeit. Ein mehrdeutiges oder nicht aufgelöstes Ergebnis kann vollständig sein, wenn die Entdeckung vollständig ist. Bei teilweiser oder unbekannter Entdeckung ist die Eindeutigkeit nur entdeckt und complete=false.
Optionale angenommene Frontauswahl
Für ein eindeutig aufgelöstes Ziel gibt facts orient assembly.step --selector selector.json sechs Welt-Begrenzungsbox-Projektionskandidaten zurück. Es wählt nur eine eindeutige Achse mit der größten Fläche aus, deren Vorzeichen weg vom Baugruppenzentrum eindeutig ist. Andernfalls wird ambiguous zurückgegeben und keine Ansicht. Kopieren Sie eine erfolgreiche recommended_view wortwörtlich in eine JSON-Datei zum Rendern; sie hat bereits semantic_intent.basis=assumed. Benennen Sie sie nicht in user_selected um, es sei denn, der Benutzer wählt sie tatsächlich aus, und nennen Sie sie niemals eine quellendeklarierte Front. Begrenzungsbox-Heuristiken können die falsche Dokumentationsseite auswählen, daher legen Sie die Annahme offen.
Ansicht exportieren
Schreiben Sie eine ViewSpecification, z.B. tuer-frontansicht.json:
{
"title": "Türfront",
"camera": {"preset": "front"},
"display": {"show_hidden_lines": false},
"image": {
"width": 1200,
"height": 900,
"padding": 24,
"curve_deflection_mm": 0.1,
"max_points": 200000
},
"semantic_intent": {
"label": "front",
"basis": "user_selected",
"note": "Der Benutzer hat die Außenseite als Front ausgewählt"
}
}
Rendern Sie das aufgelöste Ziel:
facts render assembly.step \
--target occurrence:12 \
--view-spec tuer-frontansicht.json \
--output tuer-front.svg
Dies erstellt tuer-front.svg und tuer-front.view.json. Beide Pfade müssen neu sein; keiner wird überschrieben. Wenn einer bereits existiert, wird kein neues Paar geschrieben. Das Manifest bindet die Artefakt-/Snapshot-Identität, das exakte Ziel, die vollständige Ansichtsspezifikation, den Renderer/die Version, die projizierten Ausdehnungen, die Kanten-/Punktanzahlen, den Bild-SHA-256/die Größe und die Diagnosen. Überprüfen Sie diese Bytes vor der Verwendung nachgelagert.
Auflösung und Rendern lesen die STEP-Datei unabhängig voneinander; das Rendern erzwingt keine vorherige Auflösungs-ID. Bevor Sie sich auf die Auswahl verlassen, vergleichen Sie den artifact.sha256 und snapshot.snapshot_id der Auflösung mit dem artifact.sha256 und snapshot_id des Renderings. Wenn einer abweicht, verwerfen Sie die vorherige Auswahl und lösen Sie erneut auf. Das Manifest zeichnet den tatsächlich gerenderten Snapshot und das Ziel auf.
Kamerasemantik ist nicht Designsematik
Das front-Preset bedeutet nur: Betrachter auf globaler -Y, in Richtung +Y schauend, Bildschirm rechts +X und Bildschirm oben +Z. Es beweist nicht die funktionale Front des Teils. Andere Presets sind in View contract dokumentiert.
Für eine benutzerdefinierte Richtung verwenden Sie explizite normal- und right-Vektoren. normal zeigt vom Modell zum Betrachter; normal × right bestimmt die Bildschirm-oben-Richtung. semantic_intent.basis ist nur:
user_selected: Der Benutzer hat diese Bedeutung bereitgestellt/bestätigt;assumed: eine explizite Agentenannahme, die offengelegt werden muss.
Der aktuelle Vertrag akzeptiert keine declared-Basis: Quellendatei-Frontseitendeklarationen werden nicht extrahiert. Lassen Sie semantic_intent für eine rein geometrische Kamera weg. Verwandeln Sie niemals ein Preset oder eine angenommene Front in eine Behauptung, dass die Quelldesign diese Seite deklariert.
Ehrliche Grenzen
- Entitäts-/Vorkommens-IDs und Pfade sind Snapshot-bezogen, nicht persistent revisionsübergreifend.
- Die Zielauflösung filtert nach deklarierten IDs, Pfaden, Namen/Aliasen, Definition, Wurzel-/Baugruppenart, Zustand und räumlichen Beziehungen der weltweiten Begrenzungsbox. Platzierte Begrenzungsboxen und räumliche Beweise werden zurückgegeben. Richtungsbeziehungen vergleichen Mittelpunkte in einer expliziten Kamera;
nearbenötigt eine explizite Bbox-Lückengrenze. Dies sind keine Kontakt-, Einschluss-, exakten Abstands- oder funktionalen Merkmalsbeweise. Flächen-/Kantenselektoren und Quellcode-made_by-Zuordnung sind nicht implementiert. - Das Auflösen von Geometrie lokalisiert keinen bearbeitbaren Quellparameter. Vorhandene Änderungsbefehle erfordern weiterhin ihre explizite ChangePreparationSpec- und SourceManifest-Nachweise.
- OCCT HLR liefert projizierte Kanten; Kurven werden in SVG-Polylinien diskretisiert.
skipped_edge_countundVIEW_EDGES_NOT_DISCRETIZEDlegen ausgelassene Pfade offen. Die Punktanzahl ist begrenzt, aber die HLR-Laufzeit ist keine allgemeine Garantie für große Baugruppen. Projizierte Ausdehnungen beschreiben die ausgegebene diskretisierte Punktmenge, nicht exakte Quellmaße. - Ein Rendering kann bei teilweiser Entdeckung oder Parser-Diagnosen erfolgreich sein; diese bleiben im Manifest und verhindern Ganzmodell-Vollständigkeitsbehauptungen.
- Lesen Sie niemals Abmessungen aus Pixeln. Verwenden Sie Facts für implementierte Messungen oder semantische PMI für deklarierte Anmerkungswerte.
- Fokussierte Tests verwenden analytische, mit OCCT erstellte STEP-Fixtures. Diese Tests und isolierte Beobachtungen realer Dateien begründen keine Exporteur-Interoperabilität oder allgemeines Rendern großer Baugruppen.
- Senden Sie die Quelle oder das abgeleitete SVG nicht ohne separate Autorisierung an ein externes visuelles Modell.
Siehe View contract für alle Selektor-, Kamera- und Manifestsfelder.