Files
dxfmakros/doc/tools.md
T

351 lines
12 KiB
Markdown

- [set\_einfuegepunkt](#set_einfuegepunkt)
- [Aufruf](#aufruf)
- [Datenquellen](#datenquellen)
- [Ablauf](#ablauf)
- [Schalter](#schalter)
- [--boegen](#--boegen)
- [--weichen45](#--weichen45)
- [--weichen90](#--weichen90)
- [--weichenkoerper](#--weichenkoerper)
- [--weichen-parallel](#--weichen-parallel)
- [--delta](#--delta)
- [--dreifachweiche](#--dreifachweiche)
- [--sternweiche](#--sternweiche)
- [--number SIVASNR](#--number-sivasnr)
- [--show-omniflo](#--show-omniflo)
- [Abdeckung](#abdeckung)
- [Uebersicht aller Schalter](#uebersicht-aller-schalter)
- [Umgebungsvariablen](#umgebungsvariablen)
- [set\_koords](#set_koords)
- [Aufruf](#aufruf-1)
- [Datenquellen](#datenquellen-1)
- [Ablauf](#ablauf-1)
- [Schalter](#schalter-1)
- [--k1set](#--k1set)
- [--k2set](#--k2set)
- [--k3set](#--k3set)
- [--k4set](#--k4set)
- [--set-all](#--set-all)
- [--force](#--force)
- [--show-omniflo](#--show-omniflo-1)
- [--test](#--test)
- [--number SIVASNR](#--number-sivasnr-1)
- [Uebersicht K-Zuordnung](#uebersicht-k-zuordnung)
- [Umgebungsvariablen](#umgebungsvariablen-1)
- [attradd](#attradd)
- [Aufruf](#aufruf-2)
- [Datenquellen](#datenquellen-2)
- [Ablauf](#ablauf-2)
- [Konfiguration (attradd.cfg)](#konfiguration-attraddcfg)
- [Schalter](#schalter-2)
- [--number SIVASNR / -n SIVASNR](#--number-sivasnr---n-sivasnr)
- [--dry-run / -d](#--dry-run---d)
- [Umgebungsvariablen](#umgebungsvariablen-2)
Diese Werkzeuge ermöglichen die massenhafte Aufbereitung von einzelnen dxf Dateien mit Omniflo Bögen und Weichen. Sie setzen automatisiert die Einfügepunkte, die Koordinatensysteme und die Attribugte der jeweiligen Datei korrekt. Anwendbarauf 2D und 3D Dateien, wenn in 3D die 2D Kurven als Skelett enthalten sind.
# set_einfuegepunkt
Setzt den Einfuegepunkt (`$INSBASE`) von Omniflo DXF-Dateien anhand geometrischer Kriterien an die richtige Stelle
## Aufruf
```
bin\set_einfuegepunkt.bat [--schalter] [--number SIVASNR]
```
Das Batch-Skript ruft `setenv.bat` auf und startet `lib/set_einfuegepkt.py` mit den uebergebenen Argumenten.
## Datenquellen
| Pfad | Inhalt |
|---|---|
| `data/json/omniflo_boegen.json` | Liste aller Boegen mit Sivasnr, ProfilTyp, Radius, KurvenWinkel etc. |
| `data/json/omniflo_weichen.json` | Liste aller Weichen mit Sivasnr, ProfilTyp, WeichenTyp, KurvenWinkel etc. |
| `data/omniflo/*.dxf` | Die DXF-Quelldateien (je Sivasnr eine Datei) |
Die JSON-Dateien liefern die IDs (Sivasnr) und Metadaten zur Filterung. Die DXF-Dateien enthalten die Geometrie (Linien, Boegen), aus der der Einfuegepunkt berechnet wird.
## Ablauf
1. JSON-Datei einlesen und nach Schalter-Kriterien filtern
2. Fuer jede gefilterte Sivasnr die DXF-Datei aus `data/omniflo/` laden
3. Einfuegepunkt gemaess Typ-Kriterium geometrisch berechnen
4. `$INSBASE` im DXF-Header setzen und Datei nach `results/` speichern
## Schalter
### --boegen
Alle Eintraege aus `omniflo_boegen.json` (27 Items, KurvenWinkel 22.5/45/67.5/90/180).
**Kriterium:** Schnittpunkt der Tangenten am Anfangs- und Endpunkt der Bogenkurve. Bei 180-Grad-Boegen wird der Mittelpunkt zwischen Start und Ende verwendet.
Hier die Bögen:
![Boegen](images/einfuegepunkte-boegen.png).
### --weichen45
Einzel-, Doppel- und Dreiwegeweichen mit KurvenWinkel 45 (32 Items).
**Kriterium:** Schnittpunkt der laengsten vertikalen Linie mit der Tangente am oberen Bogenpunkt. Bei mehreren Boegen wird der mit dem hoechsten Y-Wert gewaehlt.
### --weichen90
Einzel-, Doppel- und Dreiwegeweichen mit KurvenWinkel 90 (24 Items).
**Kriterium:** Wie `--weichen45`.
### --weichenkoerper
Alle Weichen mit KurvenWinkel 22.5 (8 Items: Einzel-/Doppel-/Dreiwegeweiche).
**Kriterium:** Schnittpunkt der laengsten Diagonale mit der laengsten vertikalen Linie (Konvergenzpunkt aller Linien).
### --weichen-parallel
Einzel-, Doppel- und Dreiwegeweichen mit KurvenWinkel 0, ohne Sternweiche (8 Items).
**Kriterium:** Wie `--weichenkoerper`.
### --delta
Deltaweichen (1 Item).
**Kriterium:** Mittelpunkt der laengsten horizontalen Linie.
### --dreifachweiche
Dreifachweichen (6 Items).
**Kriterium:** Mittelpunkt der laengsten horizontalen Linie.
### --sternweiche
Sternweiche (1 Item).
**Kriterium:** Zentrum, berechnet als Mittelpunkt der laengsten horizontalen Linie (entspricht dem Schnittpunkt der horizontalen und vertikalen Mittelachse).
### --number SIVASNR
Optionaler Filter: nur die angegebene 9-stellige Sivasnr verarbeiten. Kombinierbar mit jedem Typ-Schalter.
### --show-omniflo
Erzeugt eine Uebersichts-DXF (`results/omniflo_uebersicht.dxf`) mit allen Omniflo-Elementen. Die Elemente werden in Reihen nach Typ gruppiert angezeigt. Jedes Element erhaelt:
- Den Dateinamen als Beschriftung oberhalb
- Ein rotes Kreuz am Einfuegepunkt
Hier die Weichen
![Weichen](images/einfuegepunkte-weichen.png).
Hier die erzeugte [dxf Datei der Einfügepunkte als Beispiel](dxf/omniflo_uebersicht.dxf) des letzte Laufs
## Abdeckung
Alle 107 Items (27 Boegen + 80 Weichen) sind exklusiv genau einem Schalter zugeordnet. Keine Ueberlappungen, keine Luecken.
## Uebersicht aller Schalter
| Schalter | Items | WeichenTyp | KurvenWinkel | Einfuegepunkt-Kriterium |
|---|---|---|---|---|
| `--boegen` | 27 | - | 22.5, 45, 67.5, 90, 180 | Tangentenschnittpunkt am Bogen (180: Mittelpunkt) |
| `--weichen45` | 32 | Einzel-, Doppel-, Dreiwegeweiche | 45 | Tangente oberer Bogenpunkt x laengste Vertikale |
| `--weichen90` | 24 | Einzel-, Doppel-, Dreiwegeweiche | 90 | Tangente oberer Bogenpunkt x laengste Vertikale |
| `--weichenkoerper` | 8 | Einzel-, Doppel-, Dreiwegeweiche | 22.5 | Laengste Diagonale x laengste Vertikale |
| `--weichen-parallel` | 8 | Einzel-, Doppel-, Dreiwegeweiche | 0 | Laengste Diagonale x laengste Vertikale |
| `--dreifachweiche` | 6 | Dreifachweiche | 90 | Mittelpunkt laengste Horizontale |
| `--delta` | 1 | Deltaweiche | 90 | Mittelpunkt laengste Horizontale |
| `--sternweiche` | 1 | Sternweiche | 0 | Zentrum (Mittelpunkt laengste Horizontale) |
| **Gesamt** | **107** | | | |
## Umgebungsvariablen
Werden durch `bin/setenv.bat` gesetzt:
| Variable | Verwendung |
|---|---|
| `DXFM_DATA` | Pfad zu `data/` (JSON + DXF Quelldateien) |
| `DXFM_RESULTS` | Pfad zu `results/` (Ausgabe) |
---
# set_koords
Setzt Koordinatensystem-Bloecke (K1, K2, K3, K4) in Omniflo DXF-Dateien. Jeder Block enthaelt drei Linien vom Ursprung: rot (X-Achse, Laenge 1), gruen (Y-Achse, Laenge 2), blau (Z-Achse, Laenge 3).
## Aufruf
```
python lib/set_koords.py [--schalter] [--number SIVASNR] [--force]
```
## Datenquellen
| Pfad | Inhalt |
|---|---|
| `data/json/omniflo_boegen.json` | Liste aller Boegen mit Sivasnr, ProfilTyp etc. |
| `data/json/omniflo_weichen.json` | Liste aller Weichen mit Sivasnr, ProfilTyp etc. |
| `data/omniflo/*.dxf` / `results/*.dxf` | DXF-Quelldateien (bevorzugt aus results/, Fallback data/omniflo/) |
## Ablauf
1. JSON-Daten und SWITCH_FILTERS (aus utils.py) laden
2. Fuer jede gefilterte Sivasnr die DXF-Datei laden
3. Kx-Position geometrisch berechnen (abhaengig von Typ und Schalter)
4. Block-Referenz mit korrekter Rotation einfuegen und DXF nach `results/` speichern
## Schalter
### --k1set
K1 an alle Boegen und Weichen setzen.
- **Boegen:** Beginn der obersten horizontalen Linie. x rechts, y oben, z aus Zeichenebene (rz=0).
- **Weichen:** Beginn der untersten vertikalen Linie. x oben, y links, z aus Zeichenebene (rz=90).
### --k2set
K2 an alle Boegen und Weichen setzen (linker Bogenzweig). Nutzt dieselben SWITCH_FILTERS wie set_einfuegepkt.py.
- **Boegen:** Position am anderen Ende der Kette (Gerade-Bogen-Gerade). x tangential zur Linie, zur Bogenmitte zeigend. 180-Grad-Sonderfall: rz=0.
- **Weichen (weichen45, weichen90, weichen_parallel):** Folgt dem Bogenzweig bis zum Ende. x tangential, bei Doppelweichen: linker Zweig.
- **Weichenkoerper:** Ende der linken langen Diagonale.
- **Dreifach-/Delta-/Sternweiche:** Linkes Ende der laengsten horizontalen Linie.
### --k3set
K3 an Weichen mit 2+ Boegen setzen (rechter Zweig). Gleiche Logik wie K2, aber rechter Ast (groesstes x). Nur bei: Doppelweichen, Dreiwegeweichen, Dreifachweiche, Delta, Stern, Weichenkoerper Doppel/Dreiwege.
### --k4set
K4 an Weichen setzen (oberes Ende der K1-Linie). Rotation wie K1 (rz=90). Kein K4 bei: Boegen, Doppelweiche, Dreifachweiche, Deltaweiche.
### --set-all
Alle Koordinatensysteme (K1-K4) in einem Durchgang setzen.
### --force
Bestehende Kx ueberschreiben (sonst skip wenn vorhanden). Duplikate werden immer bereinigt (letztes bleibt).
### --show-omniflo
Erzeugt eine Uebersichts-DXF (`results/koords_uebersicht.dxf`) mit allen Omniflo-Elementen und farbigen Kreuzen an den K-Positionen:
| Koordinatensystem | Farbe |
|---|---|
| K1 | rot |
| K2 | orange |
| K3 | gelb |
| K4 | gruen |
So sehen in der Übersicht die Markierungen von K1 bis K4 aus:![Markierungen über K1, .. K4](images/omniflo-setkoords1.png)
Hier eine Übersicht wie die gesamte Datei aussieht
![Übersicht](images/omniflo-setkoords2.png)
Hier die erzeugte [dxf Datei mit den Koordinatensystemen](dxf/koords_uebersicht.dxf) als Beispiel des letzte Laufs
### --test
Erzeugt Testdatei (`results/ks_test.dxf`) mit 4 Koordinatensystemen und verifiziert das Ruecklesen.
### --number SIVASNR
Nur die angegebene 9-stellige Sivasnr verarbeiten. Kombinierbar mit jedem Schalter.
## Uebersicht K-Zuordnung
| K | Boegen | Weichen | Weichenkoerper | Dreifach/Delta/Stern |
|---|---|---|---|---|
| K1 | Oberste H-Linie (rz=0) | Unterste V-Linie (rz=90) | Unterste V-Linie (rz=90) | Unterste V-Linie (rz=90) |
| K2 | Anderes Kettenende | Linker Bogenzweig | Linke Diagonale | Linkes H-Linienende |
| K3 | - | Rechter Bogenzweig (2+ Boegen) | Rechte Diagonale (2+ Diag.) | Rechtes H-Linienende |
| K4 | - | Oberes K1-Linienende | Oberes K1-Linienende | Sternweiche: ja |
## Umgebungsvariablen
| Variable | Verwendung |
|---|---|
| `DXFM_DATA` | Pfad zu `data/` (JSON + DXF Quelldateien) |
| `DXFM_RESULTS` | Pfad zu `results/` (Ausgabe) |
---
# attradd
Fuegt Attribute (ATTDEF) zu allen Omniflo DXF-Dateien hinzu. Die Attribut-Tags und deren Werte werden ueber eine Konfigurationsdatei gesteuert.
## Aufruf
```
python lib/attradd.py [--number SIVASNR] [--dry-run]
```
## Datenquellen
| Pfad | Inhalt |
|---|---|
| `cfg/attradd.cfg` | Attribut-Konfiguration (Tags und Quellfelder je Elementtyp) |
| `data/json/omniflo_boegen.json` | Liste aller Boegen mit Metadaten |
| `data/json/omniflo_weichen.json` | Liste aller Weichen mit Metadaten |
| `data/omniflo/*.dxf` | DXF-Quelldateien |
## Ablauf
1. Konfiguration aus `cfg/attradd.cfg` lesen
2. JSON-Daten laden und Lookup-Tabelle (Sivasnr -> Typ + Eintrag) erstellen
3. Fuer jede Sivasnr die DXF-Datei oeffnen, bestehende ATTDEFs entfernen
4. Neue ATTDEFs gemaess Config einfuegen (Layer `ATTRIB`, unterhalb der Geometrie)
5. Ergebnis nach `results/omniflo/` speichern
## Konfiguration (attradd.cfg)
Die Config-Datei ist im INI-Format mit Abschnitten je Elementtyp:
```ini
[bogen]
BESCHR = ProfilTyp
ARTINR = Sivasnr
TEILEART = "Omniflo Kurve"
LAYER = "A-OF-Bogen"
RADIUS = Radius
WINKEL = KurvenWinkel
SIVASNR_TEF = SivasnrTEF
[weiche]
BESCHR = ProfilTyp
ARTINR = Sivasnr
TEILEART = "Omniflo Weiche"
LAYER = "A-OF-Weiche"
WEICHENTYP = WeichenTyp
WINKEL = KurvenWinkel
RADIUS = Breite
SIVASNR_TEF = SivasnrTEF
```
Quellwerte koennen sein:
- **JSON-Feldname** (z.B. `ProfilTyp`) - Wert wird aus dem JSON-Eintrag gelesen
- **Fester Text** in Anfuehrungszeichen (z.B. `"Omniflo Kurve"`)
- **Platzhalter** `{sivasnr}` - wird durch die Sivasnr ersetzt
## Schalter
### --number SIVASNR / -n SIVASNR
Nur die angegebene Sivasnr verarbeiten.
### --dry-run / -d
Nur anzeigen welche Attribute gesetzt wuerden, ohne DXF-Dateien zu schreiben.
## Umgebungsvariablen
| Variable | Verwendung |
|---|---|
| `DXFM_DATA` | Pfad zu `data/` (JSON + DXF Quelldateien) |
| `DXFM_CFG` | Pfad zu `cfg/` (attradd.cfg) |
| `DXFM_RESULTS` | Pfad zu `results/` (Ausgabe nach `results/omniflo/`) |
Alle drei haben Fallback auf relative Pfade vom Projektverzeichnis.