mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2026-09-20 07:14:13 +02:00
Add the wire/cable catalogue manual (EN/FR/DE), pending PR #936
Documents the catalogue added by PR #936, in English, French and German, each carrying the "Status: pending" notice until that PR merges. Written as a cable manual rather than a wire one, because the data model is a cable model: wirespec.h defines isCable() as numCores > 1, and the per-core colours and sections, outer diameter, shield type and cable family all exist because a cable has several differing cores. A single-core wire is the degenerate case. Every factual claim was checked against the source rather than the PR description: the menu entry and dock behaviour (qetdiagrameditor.cpp), the database path and its being global rather than per project (wirecataloguedb.cpp), the fifteen IEC 60757 colours (iec60757.cpp), the search matching section and core count as text, and what assigning a core writes to a conductor, including the dashed shield and the green-yellow bicolour pair (conductorpropertieswidget.cpp). That check corrected one thing. The PR describes the terminal strip's Cable column as a stub returning an empty string; what is actually there is Cable and CableWire declared as column enums with no data source at all. The page says the latter. The page leads with what the feature is not, because conductors.md states that QElectroTech has no cable object and that remains true: assigning a catalogue entry copies values onto one conductor, and the Cable field it fills is read by nothing. Linked both ways with each language's conductors page, and added to the sidebar under Guides.
ispyisail
+2
@@ -22,6 +22,8 @@
|
||||
|
||||
**[Conductors](conductors)** — wire properties, what feeds which export, and cables
|
||||
|
||||
**[Wire & cable catalogue](cable_catalogue)** — cable types, IEC 60757 core colours, assigning a core to a conductor
|
||||
|
||||
**[Printing and exporting](printing_and_export)** — paper, PDF, images, and what each path does differently
|
||||
|
||||
**[Linking elements](element_linking)** — master, slave, terminal
|
||||
|
||||
@@ -0,0 +1,231 @@
|
||||
> **Status: ausstehend.** Alles auf dieser Seite beschreibt
|
||||
> [PR #936](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/936),
|
||||
> der noch nicht zusammengeführt ist. Nichts davon funktioniert, solange das
|
||||
> nicht geschehen ist — prüfen Sie den PR, bevor Sie etwas davon in Ihrem
|
||||
> eigenen Build ausprobieren. Dieser Hinweis verschwindet, sobald er
|
||||
> gemerged ist.
|
||||
|
||||
# Leitungs- und Kabelkatalog
|
||||
|
||||
Ein Katalog von **Kabel- und Leitungstypen** — Herstellerreferenzen, Querschnitte,
|
||||
Aderzahl, Aderfarben, Schirmung, Spannungs- und Temperaturangaben —, den Sie
|
||||
einmal aufbauen und aus dem Sie anschließend beim Einrichten von Leitern
|
||||
schöpfen.
|
||||
|
||||
Es geht um die Dateneingabe, nicht ums Zeichnen. Ohne Katalog wird ein Leiter,
|
||||
der Ader 3 eines vieradrigen CAN-Kabels führt, von Hand eingerichtet: Farbe
|
||||
wählen, Querschnitt eintippen, Beschriftung eintippen — und das für jeden Leiter
|
||||
dieses Kabels auf jedem Folio erneut, wobei die Einheitlichkeit allein vom
|
||||
Gedächtnis abhängt. Mit einem Katalogeintrag wählen Sie das Kabel, dann die Ader,
|
||||
und Farbe, Querschnitt und Beschriftung werden aus dem Eintrag übernommen.
|
||||
|
||||
Trotz des Wortes „Leitung" im Namen ist das Datenmodell ein **Kabelmodell**. Eine
|
||||
einadrige Leitung ist lediglich der Sonderfall mit einer einzigen Ader:
|
||||
|
||||
```cpp
|
||||
bool isCable() const { return numCores > 1; }
|
||||
```
|
||||
|
||||
Alles Übrige — Farben je Ader, Querschnitte je Ader, Außendurchmesser, Schirmart,
|
||||
Kabelfamilie — existiert, weil ein Kabel mehrere, voneinander verschiedene Adern
|
||||
besitzt.
|
||||
|
||||
---
|
||||
|
||||
## Was es nicht ist
|
||||
|
||||
Bitte lesen, bevor Sie einen Arbeitsablauf darauf aufbauen.
|
||||
|
||||
QElectroTech hat weiterhin **kein Kabelobjekt**. Dieser Katalog erzeugt keines.
|
||||
Einem Leiter einen Katalogeintrag zuzuweisen kopiert Werte *auf diesen Leiter*;
|
||||
es fasst keine Leiter zu einem Kabel zusammen, prüft keine Aderzahl und erzeugt
|
||||
keine Kabelauswertung.
|
||||
|
||||
| Was man erwarten könnte | Was tatsächlich passiert |
|
||||
|---|---|
|
||||
| Das Zuweisen eines Kabels erzeugt ein Kabel, dem seine Leiter gehören | Es wird nichts erzeugt. Jeder Leiter wird einzeln eingerichtet. |
|
||||
| Das Feld **Kabel** verknüpft die Leiter miteinander | Es speichert die Kabelkennung als freien Text. Nichts liest sie — siehe [Leiter → Hinweis zu Kabeln](conductors-DE). |
|
||||
| Die Klemmenleiste zeigt Kabel- und Aderspalten | Die Klemmenleiste deklariert zwar Spalten `Cable` und `CableWire`, aber nichts befüllt sie mit einem Wert. Siehe Diskussion [#934](https://github.com/qelectrotech/qelectrotech-source-mirror/discussions/934). |
|
||||
| Die Aderzahl wird geprüft | Nichts prüft, ob Sie für ein vieradriges Kabel tatsächlich vier Leiter verwendet haben. |
|
||||
|
||||
Der Katalog macht das Einrichten von Leitern also einheitlich und schnell. Er ist
|
||||
keine Kabelverwaltung, und die Felder, die er füllt, sind die gewohnten
|
||||
Leiterfelder, die es schon immer gab.
|
||||
|
||||
---
|
||||
|
||||
## Das Bedienfeld öffnen
|
||||
|
||||
**Ansicht → Catalogue de fils et câbles.**
|
||||
|
||||
Das Bedienfeld ist ein Dock auf der rechten Seite und **standardmäßig
|
||||
ausgeblendet** — der Menüeintrag blendet es ein oder aus. Es lässt sich nach
|
||||
links verschieben oder als eigenes Fenster lösen.
|
||||
|
||||
---
|
||||
|
||||
## Wo der Katalog gespeichert wird
|
||||
|
||||
Eine einzelne SQLite-Datei im Anwendungsdatenverzeichnis des Benutzers:
|
||||
|
||||
```
|
||||
<AppDataLocation>/wirecatalogue.sqlite
|
||||
```
|
||||
|
||||
Zwei Folgen, die man von Anfang an kennen sollte:
|
||||
|
||||
- **Der Katalog ist global, nicht projektbezogen.** Alle Projekte auf dem Rechner
|
||||
sehen denselben Katalog. Er steckt nicht in der `.qet`-Datei: Ein auf einem
|
||||
anderen Rechner geöffnetes Projekt findet die zugrunde liegenden Einträge nicht
|
||||
wieder, sondern nur die bereits auf seine Leiter kopierten Werte.
|
||||
- **Er ist nicht Teil der Projektsicherung.** Sichern Sie ihn getrennt, oder
|
||||
halten Sie die Stammfassung als CSV (siehe unten) unter Versionsverwaltung.
|
||||
|
||||
---
|
||||
|
||||
## Was ein Eintrag enthält
|
||||
|
||||
| Gruppe | Felder |
|
||||
|---|---|
|
||||
| Identität | `wireId` (der Schlüssel, z. B. `W31`), Herstellername und -nummer, Lieferantenname und -nummer, Familie (z. B. `CAN_Cable`) |
|
||||
| Physik | Nennquerschnitt mm², Außendurchmesser mm, Isolationsdurchmesser mm, Aderzahl |
|
||||
| Je Ader | Farben (Grundfarbe plus bis zu zwei Kennstreifen), Querschnitt mm² — `0` bedeutet „Nennquerschnitt verwenden" |
|
||||
| Schirmung | Schirm vorhanden, Schirmart (`Braid`, `Foil`, `Both`) |
|
||||
| Kennwerte | Spannung V, Temperatur °C, flexibel ja/nein |
|
||||
| Sonstiges | Hauptfarbe, freie Notizen |
|
||||
|
||||
Die Querschnitte je Ader sind es, die einen einzigen Eintrag ein gemischtes Kabel
|
||||
beschreiben lassen — eine Leistungsader mit 4 mm² neben Signaladern mit 0,5 mm².
|
||||
|
||||
---
|
||||
|
||||
## Aderfarben: IEC 60757
|
||||
|
||||
Farben werden als IEC-60757-Namen gespeichert, nicht als RGB-Werte. Jede hat ein
|
||||
zweibuchstabiges Kürzel, und eine Ader kann eine Grundfarbe plus bis zu zwei
|
||||
Kennstreifen tragen.
|
||||
|
||||
| Name | Kürzel | | Name | Kürzel |
|
||||
|---|---|---|---|---|
|
||||
| Schwarz | `BK` | | Weiß | `WH` |
|
||||
| Braun | `BN` | | Rosa | `PK` |
|
||||
| Rot | `RD` | | Türkis | `TQ` |
|
||||
| Orange | `OG` | | Gold | `GD` |
|
||||
| Gelb | `YE` | | Silber | `SR` |
|
||||
| Grün | `GN` | | Violett | `VT` |
|
||||
| Blau | `BU` | | Grau | `GY` |
|
||||
| **Grün-Gelb** | `GNYE` | | | |
|
||||
|
||||
**Grün-Gelb ist ein Paar, keine Farbe**, und wird gesondert behandelt — siehe
|
||||
unten. Genau die Speicherung als ein einzelner RGB-Wert machte einen Schutzleiter
|
||||
zuvor von einem grünen Leiter ununterscheidbar.
|
||||
|
||||
---
|
||||
|
||||
## Suchen
|
||||
|
||||
Das Suchfeld vergleicht einen einzelnen Begriff in einer Abfrage mit:
|
||||
|
||||
- der Leitungskennung
|
||||
- Herstellername und -nummer
|
||||
- Lieferantenname und -nummer
|
||||
- der Hauptfarbe
|
||||
- dem **Querschnitt**, als Text verglichen
|
||||
- der **Aderzahl**, als Text verglichen
|
||||
|
||||
Die letzten beiden sind wichtig. Die Eingabe `2.5` findet alle Einträge mit
|
||||
2,5 mm², und `4` findet vieradrige Kabel — unabhängig davon, wie die Einträge
|
||||
heißen. Verglichen wird auf Teilzeichenketten: `2.5` findet daher auch `12.5`.
|
||||
|
||||
---
|
||||
|
||||
## Eine Ader einem Leiter zuweisen
|
||||
|
||||
Das ist der Teil, den Sie am häufigsten verwenden werden.
|
||||
|
||||
1. Öffnen Sie die Eigenschaften eines Leiters (Doppelklick auf den Leiter).
|
||||
2. Wechseln Sie auf den Reiter **Affecter un fil**.
|
||||
3. Filtern oder suchen Sie das Kabel und wählen Sie es aus.
|
||||
4. Bei einem mehradrigen oder geschirmten Eintrag wählen Sie im Auswahlfeld,
|
||||
**welche Ader** es sein soll. Einadrige, ungeschirmte Einträge brauchen das
|
||||
nicht.
|
||||
5. Drücken Sie **Affecter à ce conducteur**.
|
||||
|
||||
Was dabei auf den Leiter geschrieben wird:
|
||||
|
||||
| Leiterfeld | Wert |
|
||||
|---|---|
|
||||
| Farbe | die IEC-60757-Farbe dieser Ader |
|
||||
| Querschnitt | der Querschnitt dieser Ader, ersatzweise der Nennquerschnitt des Eintrags |
|
||||
| Beschriftung | eine Zeichenkette aus Aderbezeichnung, Querschnitt und Farbe |
|
||||
| Kabel | die `wireId` des Eintrags — gespeichert, aber von nichts gelesen |
|
||||
|
||||
Jeder Leiter stellt somit **eine Ader** dar. Ein vieradriges Kabel zwischen zwei
|
||||
Schaltschränken sind vier Leiter, jeder einer anderen Ader desselben Eintrags
|
||||
zugewiesen.
|
||||
|
||||
### Der Schirm
|
||||
|
||||
Bei einem geschirmten Eintrag enthält die Aderauswahl zusätzlich den Eintrag
|
||||
**Schirm**, damit der Schirm wie jede andere Ader gezeichnet und aufgelegt werden
|
||||
kann. Wird er gewählt, erhält der Leiter eine **gestrichelte** Linienart und das
|
||||
grün-gelbe Paar.
|
||||
|
||||
### Grün-gelbe Leiter
|
||||
|
||||
Das Zuweisen einer grün-gelben Ader nähert das Paar nicht durch eine einzelne
|
||||
Farbe an. Der Leiter wird auf den in QElectroTech bereits vorhandenen
|
||||
**Zweifarb-Modus** umgestellt:
|
||||
|
||||
- Farbe 1 — Grün, `#00a651`
|
||||
- Farbe 2 — Gelb, `#ffd700`
|
||||
|
||||
Ein Schutzleiter wird dadurch als Schutzleiter gezeichnet, mit derselben
|
||||
Zweifarb-Unterstützung, über die jeder Leiter seit jeher verfügt.
|
||||
|
||||
---
|
||||
|
||||
## CSV-Import und -Export
|
||||
|
||||
Das Bedienfeld exportiert den Katalog als CSV und liest ihn wieder ein. Der
|
||||
vorgeschlagene Exportname ist `wirecatalogue.csv`.
|
||||
|
||||
Felder werden bei Bedarf in Anführungszeichen gesetzt, und ein solches Feld darf
|
||||
Zeilenumbrüche enthalten — eine mehrzeilige Notiz übersteht also den Hin- und
|
||||
Rückweg.
|
||||
|
||||
Das ist der praktische Weg, um:
|
||||
|
||||
- einen Katalog zwischen Rechnern zu übertragen, da die Datenbank global und
|
||||
benutzerbezogen ist
|
||||
- die Stammliste unter Versionsverwaltung zu halten und die lokale Datenbank als
|
||||
Zwischenspeicher zu behandeln
|
||||
- den Katalog in einer Tabellenkalkulation aufzubauen und in einem Zug zu laden
|
||||
|
||||
---
|
||||
|
||||
## Einschränkungen
|
||||
|
||||
Als Tatsachen genannt, nicht als Entschuldigung:
|
||||
|
||||
- Der Katalog ist **global je Benutzer**, nicht projektbezogen, und wird nicht in
|
||||
der `.qet`-Datei gespeichert.
|
||||
- Das Feld **Kabel**, das er füllt, wird heute von nichts gelesen.
|
||||
- Nichts prüft, ob die zugewiesenen Leiter zur Aderzahl des Eintrags passen.
|
||||
- Die Zuweisung erfolgt **je Leiter**; es gibt keine Aktion „dieses Kabel auf
|
||||
diese sechs Leiter anwenden".
|
||||
- Die Katalogdatenbank wird beim Erzeugen des Docks geöffnet, nicht bei der
|
||||
ersten Verwendung.
|
||||
- Die Oberfläche ist französisch, entsprechend der Quellsprache von
|
||||
QElectroTech.
|
||||
|
||||
---
|
||||
|
||||
## Siehe auch
|
||||
|
||||
- **[Leiter](conductors-DE)** — die Felder, die hier befüllt werden, und warum
|
||||
das Kabelfeld nichts speist
|
||||
- **[Klemmenleisten](terminal_strips)** — wo Adern auf echten Klemmen landen
|
||||
- **[Automatische Nummerierung](autonumbering)** — das Formelfeld, das sich die
|
||||
Beschriftung mit der Leiternummerierung teilt
|
||||
- **[Variablen und Formeln](variables-DE)** — `%f`, `%{label}` und die übrigen
|
||||
@@ -0,0 +1,229 @@
|
||||
> **Statut : en attente.** Tout ce qui figure sur cette page décrit la
|
||||
> [PR #936](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/936),
|
||||
> qui n'est pas encore fusionnée. Rien de ce qui suit ne fonctionne tant
|
||||
> qu'elle n'est pas intégrée — consultez la PR avant d'essayer quoi que ce
|
||||
> soit sur votre propre compilation. Cette note disparaîtra une fois la
|
||||
> fusion faite.
|
||||
|
||||
# Catalogue de fils et câbles
|
||||
|
||||
Un catalogue de **types de câbles et de fils** — références fabricant, sections,
|
||||
nombre de brins, couleurs des brins, blindages, tensions et températures
|
||||
admissibles — que vous constituez une fois et dans lequel vous puisez ensuite
|
||||
pour paramétrer vos conducteurs.
|
||||
|
||||
L'objectif est la saisie, pas le dessin. Sans catalogue, un conducteur portant le
|
||||
brin 3 d'un câble CAN quatre brins se paramètre à la main : choisir la couleur,
|
||||
saisir la section, saisir un label, et recommencer pour chaque conducteur de ce
|
||||
câble sur chaque folio, en comptant sur sa mémoire pour rester cohérent. Avec une
|
||||
fiche de catalogue, vous choisissez le câble, puis le brin, et la couleur, la
|
||||
section et le label sont renseignés depuis la fiche.
|
||||
|
||||
Malgré le mot « fil » dans le nom, le modèle de données est un modèle de
|
||||
**câble**. Un fil unifilaire n'est que le cas particulier à un seul brin :
|
||||
|
||||
```cpp
|
||||
bool isCable() const { return numCores > 1; }
|
||||
```
|
||||
|
||||
Tout le reste — couleurs par brin, sections par brin, diamètre extérieur, type de
|
||||
blindage, famille de câble — existe parce qu'un câble possède plusieurs brins
|
||||
qui diffèrent.
|
||||
|
||||
---
|
||||
|
||||
## Ce que ce n'est pas
|
||||
|
||||
À lire avant de bâtir une méthode de travail dessus.
|
||||
|
||||
QElectroTech n'a toujours **aucun objet câble**. Ce catalogue n'en crée pas.
|
||||
Affecter une fiche à un conducteur recopie des valeurs *sur ce conducteur* ; cela
|
||||
ne regroupe pas les conducteurs en câble, ne contrôle pas le nombre de brins et
|
||||
ne produit aucun rapport de câbles.
|
||||
|
||||
| Ce à quoi on pourrait s'attendre | Ce qui se passe réellement |
|
||||
|---|---|
|
||||
| Affecter un câble crée un câble qui possède ses conducteurs | Rien n'est créé. Chaque conducteur est paramétré individuellement. |
|
||||
| Le champ **Câble** relie les conducteurs entre eux | Il enregistre l'identifiant du câble en texte libre. Rien ne le lit — voir [Conducteurs → Note sur les câbles](conductors-FR). |
|
||||
| Le bornier affiche des colonnes câble et brin | Le bornier déclare bien des colonnes `Cable` et `CableWire`, mais rien ne leur fournit de valeur. Voir la discussion [#934](https://github.com/qelectrotech/qelectrotech-source-mirror/discussions/934). |
|
||||
| Le nombre de brins est vérifié | Rien ne vérifie que vous avez bien utilisé quatre conducteurs pour un câble à quatre brins. |
|
||||
|
||||
Le catalogue rend donc le paramétrage des conducteurs cohérent et rapide. Ce
|
||||
n'est pas de la gestion de câbles, et les champs qu'il remplit sont les champs de
|
||||
conducteur habituels, qui existaient déjà.
|
||||
|
||||
---
|
||||
|
||||
## Ouvrir le panneau
|
||||
|
||||
**Affichage → Catalogue de fils et câbles.**
|
||||
|
||||
Le panneau est un dock situé à droite, **masqué par défaut** — l'entrée de menu
|
||||
l'affiche ou le masque. Il peut être déplacé à gauche ou détaché en fenêtre
|
||||
flottante.
|
||||
|
||||
---
|
||||
|
||||
## Où le catalogue est stocké
|
||||
|
||||
Un fichier SQLite unique, dans votre répertoire de données applicatives :
|
||||
|
||||
```
|
||||
<AppDataLocation>/wirecatalogue.sqlite
|
||||
```
|
||||
|
||||
Deux conséquences à connaître d'emblée :
|
||||
|
||||
- **Le catalogue est global, pas propre au projet.** Tous les projets de la
|
||||
machine voient le même catalogue. Il n'est pas embarqué dans le fichier
|
||||
`.qet` : un projet ouvert sur une autre machine n'y retrouvera pas les fiches
|
||||
d'origine, seulement les valeurs déjà recopiées sur ses conducteurs.
|
||||
- **Il n'est pas dans la sauvegarde du projet.** Sauvegardez-le séparément, ou
|
||||
gardez la copie de référence en CSV (voir plus bas) sous gestion de version.
|
||||
|
||||
---
|
||||
|
||||
## Ce que contient une fiche
|
||||
|
||||
| Groupe | Champs |
|
||||
|---|---|
|
||||
| Identité | `wireId` (la clé, p. ex. `W31`), nom et référence fabricant, nom et référence fournisseur, famille (p. ex. `CAN_Cable`) |
|
||||
| Physique | section nominale mm², diamètre extérieur mm, diamètre d'isolant mm, nombre de brins |
|
||||
| Par brin | couleurs (couleur de base plus jusqu'à deux traceurs), section mm² — `0` signifie « utiliser la section nominale » |
|
||||
| Blindage | présence d'un blindage, type (`Braid`, `Foil`, `Both`) |
|
||||
| Caractéristiques | tension V, température °C, souple oui/non |
|
||||
| Divers | couleur principale, notes en texte libre |
|
||||
|
||||
Les sections par brin sont ce qui permet à une seule fiche de décrire un câble
|
||||
mixte — un brin de puissance en 4 mm² à côté de brins de signal en 0,5 mm².
|
||||
|
||||
---
|
||||
|
||||
## Couleurs des brins : CEI 60757
|
||||
|
||||
Les couleurs sont conservées sous forme de noms CEI 60757, et non de valeurs RVB.
|
||||
Chacune possède un code à deux lettres, et un brin peut porter une couleur de base
|
||||
plus jusqu'à deux traceurs.
|
||||
|
||||
| Nom | Code | | Nom | Code |
|
||||
|---|---|---|---|---|
|
||||
| Noir | `BK` | | Blanc | `WH` |
|
||||
| Brun | `BN` | | Rose | `PK` |
|
||||
| Rouge | `RD` | | Turquoise | `TQ` |
|
||||
| Orange | `OG` | | Or | `GD` |
|
||||
| Jaune | `YE` | | Argent | `SR` |
|
||||
| Vert | `GN` | | Violet | `VT` |
|
||||
| Bleu | `BU` | | Gris | `GY` |
|
||||
| **Vert-jaune** | `GNYE` | | | |
|
||||
|
||||
**Le vert-jaune est une paire, pas une couleur**, et il est traité à part — voir
|
||||
plus bas. C'est le fait de le stocker comme une seule valeur RVB qui rendait
|
||||
auparavant un conducteur de protection indiscernable d'un conducteur vert.
|
||||
|
||||
---
|
||||
|
||||
## Rechercher
|
||||
|
||||
Le champ de recherche compare un terme unique, en une seule requête, à :
|
||||
|
||||
- l'identifiant de fil
|
||||
- le nom et la référence fabricant
|
||||
- le nom et la référence fournisseur
|
||||
- la couleur principale
|
||||
- la **section**, comparée comme du texte
|
||||
- le **nombre de brins**, comparé comme du texte
|
||||
|
||||
Ces deux derniers points comptent. Saisir `2.5` retrouve toutes les fiches en
|
||||
2,5 mm², et `4` retrouve les câbles à quatre brins, quel que soit leur nom. La
|
||||
comparaison porte sur une sous-chaîne : `2.5` retrouve donc aussi `12.5`.
|
||||
|
||||
---
|
||||
|
||||
## Affecter un brin à un conducteur
|
||||
|
||||
C'est la partie que vous utiliserez le plus.
|
||||
|
||||
1. Ouvrez les propriétés d'un conducteur (double-clic sur le conducteur).
|
||||
2. Allez dans l'onglet **Affecter un fil**.
|
||||
3. Filtrez ou recherchez le câble, puis sélectionnez-le.
|
||||
4. Pour une fiche multibrins ou blindée, choisissez **quel brin** dans le
|
||||
sélecteur. Les fiches unifilaires non blindées n'en ont pas besoin.
|
||||
5. Appuyez sur **Affecter à ce conducteur**.
|
||||
|
||||
Ce qui est alors écrit sur le conducteur :
|
||||
|
||||
| Champ du conducteur | Valeur |
|
||||
|---|---|
|
||||
| Couleur | la couleur CEI 60757 de ce brin |
|
||||
| Section | la section de ce brin, à défaut la section nominale de la fiche |
|
||||
| Label | une chaîne composée de la référence du brin, de la section et de la couleur |
|
||||
| Câble | le `wireId` de la fiche — enregistré, et lu par rien |
|
||||
|
||||
Chaque conducteur représente donc **un brin**. Un câble à quatre brins entre deux
|
||||
armoires, ce sont quatre conducteurs, chacun affecté à un brin différent de la
|
||||
même fiche.
|
||||
|
||||
### Le blindage
|
||||
|
||||
Pour une fiche blindée, le sélecteur de brin comporte une entrée **Blindage**
|
||||
supplémentaire, afin que l'écran puisse être dessiné et raccordé comme n'importe
|
||||
quel autre brin. En le choisissant, le conducteur prend un style de trait
|
||||
**tireté** et la paire vert-jaune.
|
||||
|
||||
### Conducteurs vert-jaune
|
||||
|
||||
Affecter un brin vert-jaune n'approxime pas la paire par une couleur unique. Le
|
||||
conducteur passe en mode **bicolore**, qui existe déjà dans QElectroTech :
|
||||
|
||||
- couleur 1 — vert, `#00a651`
|
||||
- couleur 2 — jaune, `#ffd700`
|
||||
|
||||
Un conducteur de protection est donc dessiné comme un conducteur de protection,
|
||||
avec la prise en charge bicolore dont tout conducteur dispose depuis toujours.
|
||||
|
||||
---
|
||||
|
||||
## Import et export CSV
|
||||
|
||||
Le panneau exporte le catalogue en CSV et le réimporte. Le nom d'export par
|
||||
défaut est `wirecatalogue.csv`.
|
||||
|
||||
Les champs sont mis entre guillemets lorsque nécessaire, et un champ entre
|
||||
guillemets peut contenir des retours à la ligne — une note sur plusieurs lignes
|
||||
survit donc à un aller-retour.
|
||||
|
||||
C'est la manière pratique de :
|
||||
|
||||
- déplacer un catalogue d'une machine à l'autre, puisque la base est globale et
|
||||
propre à l'utilisateur
|
||||
- conserver la liste de référence sous gestion de version et traiter la base
|
||||
locale comme un cache
|
||||
- constituer le catalogue dans un tableur et le charger en une fois
|
||||
|
||||
---
|
||||
|
||||
## Limites
|
||||
|
||||
Énoncées comme des faits, non comme des excuses :
|
||||
|
||||
- Le catalogue est **global par utilisateur**, pas propre au projet, et n'est pas
|
||||
stocké dans le fichier `.qet`.
|
||||
- Le champ **Câble** qu'il remplit n'est lu par rien aujourd'hui.
|
||||
- Rien ne vérifie que les conducteurs affectés correspondent au nombre de brins
|
||||
de la fiche.
|
||||
- L'affectation se fait **par conducteur** ; il n'existe pas d'action
|
||||
« appliquer ce câble à ces six conducteurs ».
|
||||
- La base du catalogue est ouverte à la construction du dock, et non à la
|
||||
première utilisation.
|
||||
|
||||
---
|
||||
|
||||
## Voir aussi
|
||||
|
||||
- **[Conducteurs](conductors-FR)** — les champs que ceci renseigne, et pourquoi
|
||||
le champ Câble n'alimente rien
|
||||
- **[Borniers](terminal_strips)** — là où les brins aboutissent sur de vraies
|
||||
bornes
|
||||
- **[Numérotation automatique](autonumbering)** — le champ formule que le label
|
||||
partage avec la numérotation des conducteurs
|
||||
- **[Variables et formules](variables-FR)** — `%f`, `%{label}` et les autres
|
||||
+219
@@ -0,0 +1,219 @@
|
||||
> **Status: pending.** Everything on this page describes
|
||||
> [PR #936](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/936),
|
||||
> not yet merged. Nothing here works until that lands — check the PR
|
||||
> before trying any of this against your own build. This page will drop
|
||||
> this notice once it does.
|
||||
|
||||
# Wire & cable catalogue
|
||||
|
||||
A catalogue of **cable and wire types** — part numbers, cross-sections, core
|
||||
counts, core colours, shields, voltage and temperature ratings — that you build
|
||||
once and then draw from when setting up conductors.
|
||||
|
||||
The point is data entry, not drawing. Without it, a conductor carrying core 3 of
|
||||
a four-core CAN cable is set up by hand: pick the colour, type the section, type
|
||||
a label, and do it again for every conductor of that cable on every folio,
|
||||
getting it consistent by memory. With a catalogue entry, you pick the cable, pick
|
||||
the core, and the colour, section and label are filled in from the record.
|
||||
|
||||
Despite "wire" in the name, the data model is a **cable** model. A single-core
|
||||
wire is the degenerate case of one core:
|
||||
|
||||
```cpp
|
||||
bool isCable() const { return numCores > 1; }
|
||||
```
|
||||
|
||||
Everything else — per-core colours, per-core sections, outer diameter, shield
|
||||
type, cable family — exists because a cable has several cores that differ.
|
||||
|
||||
---
|
||||
|
||||
## What this is not
|
||||
|
||||
Read this before building a workflow on it.
|
||||
|
||||
QElectroTech still has **no cable object**. This catalogue does not create one.
|
||||
Assigning a catalogue entry to a conductor copies values *onto that conductor*;
|
||||
it does not group conductors into a cable, count cores against the record, or
|
||||
report on cables.
|
||||
|
||||
| You might expect | What actually happens |
|
||||
|---|---|
|
||||
| Assigning a cable creates a cable that owns its conductors | Nothing is created. Each conductor is set up individually. |
|
||||
| The **Cable** field ties conductors together | It records the cable id as free text. Nothing reads it — see [Conductors → A note on cables](conductors). |
|
||||
| The terminal strip shows cable and core columns | The terminal strip has `Cable` and `CableWire` columns declared, but nothing supplies them with a value. See discussion [#934](https://github.com/qelectrotech/qelectrotech-source-mirror/discussions/934). |
|
||||
| Core counts are checked | Nothing verifies that you used four conductors for a four-core cable. |
|
||||
|
||||
So the catalogue makes conductor set-up consistent and fast. It is not cable
|
||||
management, and the fields it fills are the ordinary conductor fields that were
|
||||
always there.
|
||||
|
||||
---
|
||||
|
||||
## Opening the panel
|
||||
|
||||
**Display → Catalogue de fils et câbles.**
|
||||
|
||||
The panel is a dock on the right-hand side, and it is **hidden by default** —
|
||||
the menu entry toggles it. It can be moved to the left dock area or floated.
|
||||
|
||||
---
|
||||
|
||||
## Where the catalogue is stored
|
||||
|
||||
One SQLite file, in your user application-data directory:
|
||||
|
||||
```
|
||||
<AppDataLocation>/wirecatalogue.sqlite
|
||||
```
|
||||
|
||||
Two consequences worth knowing up front:
|
||||
|
||||
- **The catalogue is global, not per project.** Every project on that machine
|
||||
sees the same catalogue. It is not carried inside the `.qet` file, so a
|
||||
project opened on another machine will not find the entries it was built
|
||||
from — only the values already copied onto its conductors.
|
||||
- **It is not in your project backup.** Back it up separately, or keep the
|
||||
master copy as a CSV (below) under version control.
|
||||
|
||||
---
|
||||
|
||||
## What an entry records
|
||||
|
||||
| Group | Fields |
|
||||
|---|---|
|
||||
| Identity | `wireId` (the key, e.g. `W31`), manufacturer name and part number, supplier name and part number, family (e.g. `CAN_Cable`) |
|
||||
| Physical | nominal cross-section mm², outer diameter mm, insulation diameter mm, number of cores |
|
||||
| Per core | colours (base plus up to two tracers), cross-section mm² — `0` means "use the nominal section" |
|
||||
| Screening | has shield, shield type (`Braid`, `Foil`, `Both`) |
|
||||
| Ratings | voltage V, temperature °C, flexible yes/no |
|
||||
| Other | primary colour, free-text notes |
|
||||
|
||||
Per-core sections are what let one record describe a mixed cable — a power core
|
||||
at 4 mm² alongside signal cores at 0.5 mm².
|
||||
|
||||
---
|
||||
|
||||
## Core colours: IEC 60757
|
||||
|
||||
Colours are held as IEC 60757 names, not RGB. Each has a two-letter code, and a
|
||||
core may carry a base colour plus up to two tracer stripes.
|
||||
|
||||
| Name | Code | | Name | Code |
|
||||
|---|---|---|---|---|
|
||||
| Black | `BK` | | White | `WH` |
|
||||
| Brown | `BN` | | Pink | `PK` |
|
||||
| Red | `RD` | | Turquoise | `TQ` |
|
||||
| Orange | `OG` | | Gold | `GD` |
|
||||
| Yellow | `YE` | | Silver | `SR` |
|
||||
| Green | `GN` | | Violet | `VT` |
|
||||
| Blue | `BU` | | Grey | `GY` |
|
||||
| **Green-Yellow** | `GNYE` | | | |
|
||||
|
||||
**Green-Yellow is a pair, not a colour**, and it is handled specially — see
|
||||
below. Storing it as one RGB value is what previously made a protective
|
||||
conductor indistinguishable from a plain green one.
|
||||
|
||||
---
|
||||
|
||||
## Searching
|
||||
|
||||
The search box matches a single term against, in one query:
|
||||
|
||||
- wire id
|
||||
- manufacturer name and part number
|
||||
- supplier name and part number
|
||||
- primary colour
|
||||
- **cross-section**, matched as text
|
||||
- **number of cores**, matched as text
|
||||
|
||||
The last two matter. Typing `2.5` finds every 2.5 mm² entry, and `4` finds
|
||||
four-core cables, regardless of what the entries are called. Matching is a
|
||||
substring match, so `2.5` also matches `12.5`.
|
||||
|
||||
---
|
||||
|
||||
## Assigning a core to a conductor
|
||||
|
||||
This is the part you will use most.
|
||||
|
||||
1. Open a conductor's properties (double-click the conductor).
|
||||
2. Go to the **Affecter un fil** tab.
|
||||
3. Filter or search for the cable, and select it.
|
||||
4. For a multi-core or shielded entry, choose **which core** from the core
|
||||
selector. Single-core, unshielded entries do not need this.
|
||||
5. Press **Affecter à ce conducteur**.
|
||||
|
||||
What that writes to the conductor:
|
||||
|
||||
| Conductor field | Value |
|
||||
|---|---|
|
||||
| Colour | that core's IEC 60757 colour |
|
||||
| Section | that core's section, falling back to the entry's nominal section |
|
||||
| Label | a generated string combining core reference, section and colour |
|
||||
| Cable | the entry's `wireId` — stored, and read by nothing |
|
||||
|
||||
Each conductor therefore represents **one core**. A four-core cable running
|
||||
between two cabinets is four conductors, each assigned a different core of the
|
||||
same entry.
|
||||
|
||||
### The shield
|
||||
|
||||
For a shielded entry the core selector carries an extra **Shield** entry, so the
|
||||
screen can be drawn and terminated like any other core. Choosing it gives the
|
||||
conductor a **dashed** line style and the green-yellow pair.
|
||||
|
||||
### Green-yellow conductors
|
||||
|
||||
Assigning a green-yellow core does not approximate the pair with one colour. It
|
||||
switches the conductor to QElectroTech's existing **bicolour** mode:
|
||||
|
||||
- colour 1 — green, `#00a651`
|
||||
- colour 2 — yellow, `#ffd700`
|
||||
|
||||
So a protective conductor is drawn as a protective conductor, using the same
|
||||
bicolour support any conductor has always had.
|
||||
|
||||
---
|
||||
|
||||
## CSV import and export
|
||||
|
||||
The panel exports the catalogue to CSV and imports it back. The default export
|
||||
name is `wirecatalogue.csv`.
|
||||
|
||||
Fields are quoted where needed, and a quoted field may contain line breaks — a
|
||||
multi-line note survives a round trip.
|
||||
|
||||
This is the practical way to:
|
||||
|
||||
- move a catalogue between machines, since the database is per-user and global
|
||||
- keep the master list in version control and treat the local database as a cache
|
||||
- build the catalogue in a spreadsheet and load it in one go
|
||||
|
||||
---
|
||||
|
||||
## Limitations
|
||||
|
||||
Stated as fact, not apology:
|
||||
|
||||
- The catalogue is **global per user**, not per project, and is not stored in
|
||||
the `.qet` file.
|
||||
- The **Cable** field it fills is read by nothing today.
|
||||
- Nothing checks that the conductors you assign match the record's core count.
|
||||
- Core assignment is **per conductor**; there is no "apply this cable to these
|
||||
six conductors" action.
|
||||
- The catalogue database is opened when the dock is constructed, not on first
|
||||
use.
|
||||
- The interface is French, in line with the rest of QElectroTech's source
|
||||
language.
|
||||
|
||||
---
|
||||
|
||||
## See also
|
||||
|
||||
- **[Conductors](conductors)** — the fields this writes into, and why the Cable
|
||||
field feeds nothing
|
||||
- **[Terminal strips](terminal_strips)** — where cores land on real terminals
|
||||
- **[Auto-numbering](autonumbering)** — the formula field the label shares with
|
||||
wire numbering
|
||||
- **[Variables & formulas](variables)** — `%f`, `%{label}` and the rest
|
||||
@@ -227,3 +227,4 @@ Beide gelten je Projekt und dürfen ausgeschaltet bleiben.
|
||||
- **[Klemmleisten](terminal_strips)** — wo Leiter auf echte Klemmen treffen
|
||||
- **[Suchen & Ersetzen](search_and_replace)** — viele Leiter auf einmal ändern
|
||||
- **[Kommandozeilenreferenz](cli_reference)** — die obigen Exporte
|
||||
- **[Leitungs- und Kabelkatalog](cable_catalogue-DE)** — Kabeltypen, und was eine Zuweisung hier einträgt
|
||||
|
||||
@@ -240,3 +240,4 @@ Les deux sont propres au projet, et les deux peuvent rester désactivés.
|
||||
- **[Chercher & remplacer](search_and_replace)** — modifier beaucoup de
|
||||
conducteurs d'un coup
|
||||
- **[Référence de la ligne de commande](cli_reference)** — les exports ci-dessus
|
||||
- **[Catalogue de fils et câbles](cable_catalogue-FR)** — types de câbles, et ce qu'une affectation écrit ici
|
||||
|
||||
@@ -239,3 +239,4 @@ Both are per project, and both are toggles you can leave off.
|
||||
- **[Search & Replace](search_and_replace)** — changing many conductors at once
|
||||
- **[CLI reference](cli_reference)** — the export commands above
|
||||
- **[Mouse modifiers](mouse_modifiers)** — Ctrl while dragging, and the rest
|
||||
- **[Wire & cable catalogue](cable_catalogue)** — cable types, and what assigning one writes here
|
||||
|
||||
Reference in New Issue
Block a user