Beschreibung von Claude für das PRojekt ergänzt, da in zukunft mit python gearbeitet wird

2026-06-01 11:07:13 +02:00
parent 732daedadd
commit 35e4e707aa
3 changed files with 34 additions and 1250 deletions
@@ -59,6 +59,40 @@ Werden via `bin/setenv.bat` gesetzt. Wichtigste:
 - Komponentendaten (Masse, Sivas-IDs) liegen als JSON in `data/json/`
 - Sprache im Code und Kommentaren: Deutsch

+## Python-Bibliotheken
+
+### PyRx-Module (`lib/elemente/`) - laufen innerhalb BricsCAD via PyRx
+
+Abhaengigkeiten: PyRx (`PyRx`, `PyDb`, `PyGe`, `PyEd`), `wx` (wxPython fuer Dialoge).
+
+| Modul | Beschreibung |
+|---|---|
+| `elemente/utils.py` | Gemeinsame Hilfsfunktionen: Block-Pfad, Nummernvergabe (`component_next_number`), Layer/Textstil anlegen, DWG-Bloecke laden, Block mit Attributen einfuegen |
+| `elemente/kreisel.py` | ILS Kreisel komplett in Python. Befehle: `KreiselInsert`, `KreiselConnect`, `KreiselRedraw`, `KreiselQuick`, `KreiselEdit`, `KreiselParams`, `KreiselLabelSetup`, `KreiselLabelPos`, `KreiselLabelHoehe`. Enthaelt `KreiselEditDialog` (wxPython, ersetzt `kreisel_edit.dcl`) |
+| `elemente/eckrad.py` | ILS Eckrad in Python. Befehle: `ILS_Eckrad`, `EckradEdit`. Enthaelt `EckradEditDialog` (wxPython) |
+| `elemente/dblclick.py` | Dispatcher `SSG_BLOCKEDIT` fuer Rechtsklick-Bearbeitung. Erkennt KREISEL_*/ECKRAD_* Bloecke und oeffnet passenden wx-Dialog, sonst BEDIT |
+
+### Standalone-Skripte (`lib/`) - laufen extern mit ezdxf
+
+Abhaengigkeiten: `ezdxf`, Standard-Library. Benoetigen Umgebungsvariablen (`DXFM_DATA`, `DXFM_RESULTS`, `DXFM_CFG`).
+
+| Skript | Beschreibung |
+|---|---|
+| `omniflo_utils.py` | Gemeinsame Hilfsfunktionen fuer Omniflo-Skripte: `ROW_GROUPS` (Reihen-Gruppierung), `SWITCH_FILTERS` (Schalter-Filter), `build_row_layout`, `import_element_as_block`, `draw_cross`, `load_omniflo_data` |
+| `set_einfuegepkt.py` | Setzt `$INSBASE` (Einfuegepunkt) in Omniflo-DXF-Dateien. Schalter je Typ: `--boegen`, `--weichen45`, `--weichen90`, `--weichenkoerper`, `--weichen-parallel`, `--delta`, `--dreifachweiche`, `--sternweiche`, `--show-omniflo` |
+| `set_koords.py` | Setzt Koordinatensystem-Bloecke (K1-K4) in Omniflo-DXF-Dateien. Schalter: `--k1set` bis `--k4set`, `--set-all`, `--force`, `--show-omniflo`, `--test`, `--number` |
+| `attradd.py` | Fuegt ATTDEF-Attribute zu Omniflo-DXF-Dateien hinzu. Liest Konfiguration aus `cfg/attradd.cfg`. Schalter: `--number`, `--dry-run` |
+| `export_sivas.py` | Erzeugt Sivas-Export-CSV mit Summierungszeilen (ILS Automation, Omniflo Sum). Aufruf: `python export_sivas.py <export_raw.json> <data_dir> <output.csv>` |
+| `export_csv.py` | Erzeugt einfache Item-Liste als CSV (ohne Summierung). Aufruf: `python export_csv.py <export_raw.json> <data_dir> <output.csv>` |
+| `testpycall.py` | Testskript fuer LISP-Python-Aufruf via CALLPYTHON |
+
+### Typische Verarbeitungskette (Omniflo-DXF)
+
+1. `attradd.py` - Attribute zu Quell-DXFs hinzufuegen
+2. `set_einfuegepkt.py` - Einfuegepunkte berechnen und setzen
+3. `set_koords.py` - Koordinatensysteme (K1-K4) setzen
+4. `export_sivas.py` / `export_csv.py` - Export aus Zeichnung
+
 ## Entwicklungsstand

 Siehe `doc/Entwicklungsplan.md` fuer Meilensteinplanung und Aufwandsschaetzung.
@@ -1,53 +0,0 @@
-// ============================================================
-// kreisel_edit.dcl - Kreisel Parameter bearbeiten
-// Erlaubt das Aendern von Abstand, Hoehe, Ausrichtung,
-// Drehrichtung, Typ und Name eines bestehenden Kreisels.
-// ============================================================
-
-kreisel_edit : dialog {
-  label = "Kreisel bearbeiten";
-
-  : column {
-
-    : edit_box {
-      key = "name";
-      label = "Kreiselname:";
-      edit_width = 30;
-    }
-
-    : row {
-      : edit_box {
-        key = "abstand";
-        label = "Abstand (mm):";
-        edit_width = 10;
-      }
-      : edit_box {
-        key = "hoehe";
-        label = "Hoehe (mm):";
-        edit_width = 10;
-      }
-    }
-
-    : popup_list {
-      key = "ausrichtung";
-      label = "Ausrichtung:";
-      width = 30;
-    }
-
-    : row {
-      : popup_list {
-        key = "drehrichtung";
-        label = "Motordrehrichtung:";
-        width = 16;
-      }
-      : popup_list {
-        key = "kreiselart";
-        label = "Typ:";
-        width = 16;
-      }
-    }
-
-  }
-
-  ok_cancel;
-}