weiterführung der Doku mit v.a. Hinweisen zur Layouterstellung.

This commit is contained in:
2025-07-07 12:44:05 +02:00
parent 6b0b3fea04
commit ef9a07c40e
+84 -17
View File
@@ -4,8 +4,8 @@
- [Installation](#installation)
- [Schnellstart und Vewendung des Programms](#schnellstart-und-vewendung-des-programms)
- [Standardmäßige Ausgabe des Programms](#standardmäßige-ausgabe-des-programms)
- [.dxf-Datei: dxfdatei\_cables.dxf](#dxf-datei-dxfdatei_cablesdxf)
- [Excel-Datei: xxx\_cables.xlsx](#excel-datei-xxx_cablesxlsx)
- [.dxf-Datei: *dxfdatei*\_cables.dxf](#dxf-datei-dxfdatei_cablesdxf)
- [Excel-Datei: *dxfdatei*\_cables.xlsx](#excel-datei-dxfdatei_cablesxlsx)
- [Anpassung des Verhaltens des Programms:](#anpassung-des-verhaltens-des-programms)
- [Verwendete Konfigurationsdateien](#verwendete-konfigurationsdateien)
- [Zusammenfassung und Struktur der Konfigurationsdateien](#zusammenfassung-und-struktur-der-konfigurationsdateien)
@@ -25,7 +25,12 @@
- [kabel.cfg](#kabelcfg)
- [Kabelgruppen (Beispiel: `[WD_Q]`, `[WD_I]`, `[WF_B]`)](#kabelgruppen-beispiel-wd_q-wd_i-wf_b)
- [Sensorspezifische Gruppen](#sensorspezifische-gruppen)
- [`[Sivasnummern]`](#sivasnummern)
- [bezeichner.cfg](#bezeichnercfg)
- [Anwenderhinweise zur Layouterstellung](#anwenderhinweise-zur-layouterstellung)
- [Verwendung der Layer](#verwendung-der-layer)
- [Zeichnen von Kabeltrassen](#zeichnen-von-kabeltrassen)
- [Attribute der Blöcke (Bauteile)](#attribute-der-blöcke-bauteile)
- [Positionierung von Bauteilen](#positionierung-von-bauteilen)
- [Detaillierte Informationen zum Programmablauf und Code-Struktur](#detaillierte-informationen-zum-programmablauf-und-code-struktur)
- [Zweck des Programms](#zweck-des-programms)
- [Allgemeiner Programmablauf](#allgemeiner-programmablauf)
@@ -96,17 +101,16 @@ In den Ordner auf dem Desktop in dem das Kabeltool liegt werden nach Beendigung
| Dateiname | Details |
|---------------------------|---------------------------------------------------------------------------------------------------|
| `dxfdatei_cables.dxf` | `.dxf`-Datei, **nur mit Kabelwegen** (z.B. für Import ins Original-Layout als eigenes Layer) |
| `dxfdatei_reduziert.dxf` | `.dxf`-Datei mit **Kabelwegen und zusätzlich** Kabeltrassen, Sensoren, Aktoren und Unterverteilern (in Beabeitung) |
| `dxfdatei_cables.dxf` | `.dxf`-Datei, **mit Kabelwegen** (z.B. für Import ins Original-Layout als eigenes Layer) und gezeichneten Racks (ggf. in 3D) |
| `dxfdatei_cables.xlsx` | **Excel-Datei** mit Kabellängen, Längenübersicht und Fehler-Übersicht |
| `dxfdatei_positions` | **Zwischendatei** (nicht für Endnutzer bestimmt) |
| `dxfdatei_todraw` | **Zwischendatei** (nicht für Endnutzer bestimmt) |
### .dxf-Datei: dxfdatei_cables.dxf
### .dxf-Datei: *dxfdatei*_cables.dxf
Die standardmäßig erstellte und abgelegte Ausgabedatei `dxfdatei_cables.dxf` enthält die Kabelwege aller während des Programmablaufs behandelten Kabelverbindungen und kann beispielsweise als neues Layer in die .dxf-Datei der Anlage importiert werden. Neben den Kabelwegen werden auch die Kurzbezeichnungen (z.b. MA0060, BG3240, ...) sowie die Kürzel der Unterverteiler auf jeweils separaten Layern in die Zeichnungsdatei exportiert und ermöglichen damit die in sich schlüssige Verwendung dieser Datei.
Die standardmäßig erstellte und abgelegte Ausgabedatei `dxfdatei_cables.dxf` enthält die Kabelwege aller während des Programmablaufs behandelten Kabelverbindungen und kann beispielsweise als neues Layer in die .dxf-Datei der Anlage importiert werden. Neben den Kabelwegen werden auch die Kurzbezeichnungen (z.b. MA0060, BG3240, ...) sowie die Kürzel der Unterverteiler auf jeweils separaten Layern in die Zeichnungsdatei exportiert und ermöglichen damit die in sich schlüssige Verwendung dieser Datei. Desweiteren werden die von dem Programm erkannten Kabeltrassen eingezeichnet und nummeriert. Sofern diese im Ursprungslayout dreidimensional angelegt wurden, wird auch das in der Ausgabe berücksichtigt.
### Excel-Datei: xxx_cables.xlsx
### Excel-Datei: *dxfdatei*_cables.xlsx
Die standardmäßig erstellte und abgelegte Ausgabedatei `dxfdatei_cables.xlsx` enthält im fehlerfreien Fall zwei Worksheets:
@@ -314,16 +318,9 @@ Diese Datei enthält die **SIVAS-Nummern je Kabellänge und -typ**, sowie die **
---
#### `[Sivasnummern]`
**Was?** Menschlich lesbare Bezeichnungen der SIVAS-Nummern.
### bezeichner.cfg
| SIVAS-Nr. | Bezeichnung |
|-----------|----------------------------------|
| 722001303 | M12 St-0°/ M8 Bu-0° 5m |
| 726001041 | Patchkabel 2xRJ45 1,0m |
| 725000015 | 4G1,5mm², Steuerleitung |
---
Hier muss noch kurz gesagt werden, was in dieser steht. Wie das mit missing geht, SIVAS Abfrage usw....
**Hinweis:**
Die Einträge in den `.cfg`-Dateien müssen **laufend gepflegt** werden, wenn sich:
@@ -333,6 +330,76 @@ Die Einträge in den `.cfg`-Dateien müssen **laufend gepflegt** werden, wenn si
Nur so kann eine korrekte automatische Kabelberechnung und Zuordnung gewährleistet werden.
# Anwenderhinweise zur Layouterstellung
Im nachfolgenden Abschnitt sind die **wichtigsten** Punkte zur Erstellung der Layoutzeichnungen aufgeführt. Die Beachtung dieser Hinweise stellt sicher, dass die automatische Auswertung durch das Programm fehlerfrei und zuverlässig erfolgen kann.
Dieser Abschnitt ist durch die Fachabteilung regelmäßig zu pflegen und analog zu Konfigurationsdateien stets aktuell zu halten.
## Verwendung der Layer
- **Erfasst werden ausschließlich Elemente auf Layern**, die in der Konfigurationsdatei (`cfg`) unter dem jeweiligen Abschnitt (`GetPos-Layer_...`) aufgeführt sind.
- Nicht konfigurierte Layer oder falsch benannte Layer werden vollständig ignoriert.
- Für jede Objektklasse (z.B. Racks, Sensoren, Unterverteiler) sollte ein eigener dedizierter Layer verwendet werden.
- Layer-Namen dürfen **keine Sonderzeichen oder Leerzeichen** enthalten, und sollten **eindeutig** benannt sein.
## Zeichnen von Kabeltrassen
- **Verbindungspunkte von Racks sollten präzise aneinander gezeichnet werden**, idealerweise mit Fangmodi (Snapping) im CAD.
- Das Programm erkennt und verbindet nahe beieinanderliegende Racks automatisch, jedoch nur mit begrenzter Toleranz.
- Eine saubere Planung der Trassengeometrie erleichtert die automatische Graphenerstellung erheblich.
- **2D-Kabeltrassen (LWPOLYLINE)** sollten verwendet werden für Strecken in einer Ebene bzw. auf einer Höhe
- **3D-Trassenführung** bei Höhendifferenzen (z.B entlang von Förderern) erfolgt in drei Schritten:
1. Untere Ebene als `LWPOLYLINE` mit Z=0.
2. Obere Ebene als `LWPOLYLINE` mit Z=Erhebung (über DXF-Attribut `Erhebung`).
3. Verbindung über `3DPOLYLINE`, welche die Steigung darstellt.
## Attribute der Blöcke (Bauteile)
- **Pro Bauteil darf nur ein Block vorhanden sein.** Alle relevanten Informationen (z.B. Artikelnummer, Bezeichner, Position) müssen diesem einen Block als Attribute zugeordnet sein.
- **Keine übereinanderliegenden Blöcke!**
- In der Vergangenheit wurden häufig zwei Blöcke übereinandergelegt, um Kabel- und Sensorinformationen zu trennen. Dies ist künftig nicht mehr zulässig.
- **Beispiel für frühere Aufteilung (nicht mehr erlaubt):**
- *Rahmen innen* (Angaben zum Kabel):
- A:
- B: Kabel-ID
- C: lange Nummer (?)
- ArtiNr: Kabelartikelnummer
- Beschr: Kabelname (SIVAS)
- Menge, Position, Gruppe, Etikette, Auflöse, etc.
- *Rahmen außen* (Angaben zum Bauteil selbst):
- A:
- B: Bauteil-Kurzbezeichnung
- C: lange Nummer (?)
- ArtiNr: Sensorartikelnummer
- Beschr: Kurzbeschreibung
- sowie gleiche Attribute wie oben.
- *Text*
- IO: Bauteil-Kurzbezeichnung
- id
- VERW
- BEZEICHNUNG
- TEXT-D, TEXT-E, TEXT-ES, TEXT-F
- SPS
- **In Zukunft**:
- Ein einziger Block enthält alle Informationen des Bauteils.
- Die Informationen zu den benötigten Kabeln werden **allein** vom Kabeltool bereitgestellt
- Die konkrete Struktur der Attribute wird noch festgelegt (To Be Defined).
- Ziel ist es, sowohl die Verarbeitung im System als auch die manuelle Pflege im Layout zu vereinfachen.
## Positionierung von Bauteilen
- In Zukunft wird das Attribut `REALE_POSITION` eingeführt. Damit kann die **exakte physische Einbauposition** eines Bauteils (z.B. Sensors) unabhängig von der tatsächlichen Platzierung des Blocks im Layout definiert werden.
- Ermöglicht eine saubere, leserliche Platzierung der Blöcke im Plan z.B. seitlich der Anlage (dort wo Platz ist)
- Der Block selbst kann damit **optisch gut positioniert**, aber technisch korrekt ausgewertet werden.
- Bauteile ohne `REALE_POSITION` werden standardmäßig an der **gezeichneten Blockposition** verortet.
- **Anbindung an Kabeltrassen erfolgt immer zur nächstgelegenen Rack-Geometrie** im definierten Toleranzbereich.
- Wird ein Block zu weit entfernt vom Rack gezeichnet (bzw. `REALE_POSITION` liegt zu weit weg), erfolgt **keine automatische Verbindung**.
- Die maximale Toleranz ist über die Konfiguration (`tol_connect`) steuerbar.
- Es ist daher darauf zu achten, dass Bauteile (bzw. deren reale Positionen) **räumlich korrekt und in sinnvoller Nähe** zu den Kabeltrassen platziert sind.
# Detaillierte Informationen zum Programmablauf und Code-Struktur
## Zweck des Programms