Single-line diagram (SLD)

À propos des schémas unifilaires

Un schéma unifilaire (également appelé schéma monoligne) représente le système d'alimentation électrique d'un bâtiment ou d'un poste de transformation à l'aide d'une seule ligne représentant les trois phases d'un système alternatif triphasé. Les équipements — transformateurs, disjoncteurs, jeux de barres, moteurs, charges — sont représentés avec des symboles normalisés, et le chemin du flux de puissance les relie de haut en bas, de la source à la charge. Les ingénieurs électriciens, les planificateurs de réseaux et les gestionnaires d'installations utilisent les SLD comme document de référence principal pour tout projet de système d'alimentation : c'est le premier livrable de toute demande de raccordement, étude d'arc électrique ou dossier de mise en service.

Schematex suit les conventions de symboles graphiques de la IEEE Std 315 (ANSI Y32.2) pour les équipements, étendues avec la notation de configuration d'enroulement IEC 60617 pour les variantes de transformateurs. Cette page documente ce que le parseur accepte aujourd'hui.

1. Votre premier schéma unifilaire

Le SLD le plus simple : une source réseau, un transformateur, un disjoncteur et une charge.

Quatre règles couvrent 80 % des usages :

1. Commencez par sld, suivi éventuellement d'un titre entre guillemets.
2. Déclarez chaque élément d'équipement sous la forme id = typeNœud [attributs] — un par ligne.
3. Connectez les éléments avec from -> to, en ajoutant optionnellement [cable: "…", label: "…"].
4. Les identifiants peuvent contenir des lettres, des chiffres, des tirets bas et des tirets — mais doivent commencer par une lettre.

Les commentaires peuvent commencer par #, // ou %% de style Mermaid sur leur propre ligne.

2. Types de nœuds

Une ligne de nœud est id = typeNœud [clé: valeur, …]. Le type de nœud détermine le symbole dessiné.

2.1 Sources

2.2 Transformateurs

2.3 Jeux de barres et nœuds

2.4 Coupure et protection

2.5 Protection et surveillance

2.6 Charges et équipements

2.7 Comptage

3. Attributs de nœud

Les attributs sont écrits dans […] après le type de nœud, séparés par des virgules.

Exemple avec tous les attributs courants :

xfmr = transformer_dy [
  label: "Main Transformer",
  voltage: "13.8kV/480V",
  rating: "1000 kVA",
  impedance: "5.75%Z"
]

Le bloc d'attributs peut s'étendre sur plusieurs lignes — le parseur joint les lignes jusqu'à ce que le ] soit équilibré.

4. Connexions

Une ligne de connexion est idSource -> idCible, suivie éventuellement de [cable: "…", label: "…"].

bus1 -> cb1
bus1 -> cb1 [cable: "3#2/0 AWG"]
bus1 -> cb1 [cable: "3#2/0 AWG", label: "Feeder A"]

Règles :

• Les deux identifiants doivent être déclarés avant ou après la connexion — toutes les connexions sont validées à la fin de l'analyse.
• Seul -> (orienté, de la source vers la charge) est accepté. Le sens de la connexion est utilisé pour la mise en page.
• Un identifiant de nœud inconnu génère SLDParseError: Connection references unknown node "…".

5. Étiquettes et commentaires

• Titre : sld "Substation One-Line" — première ligne uniquement.
• Étiquette de nœud : id = type [label: "…"] — le nom d'affichage.
• Étiquette de connexion : A -> B [label: "…"] — apparaît le long de la ligne de connexion.
• Annotation de câble : A -> B [cable: "3#2/0 AWG, 200ft"] — spécification du conducteur.
• Commentaires : # en début de ligne. Le # en ligne sur la même ligne qu'un nœud ou une connexion est également supprimé.
• Alias résidentiels : le vocabulaire IEC / REBT tel que mcb, rcd, rcbo, rccb, pia, iga, main_switch, consumer_unit, distribution_board, panel et panelboard est accepté en entrée et mappé sur les primitives SLD existantes.

6. Mots réservés et échappement

Réservés en début de ligne : sld (en-tête).

Jeton opérateur — évitez -> dans les identifiants de nœuds. Les identifiants peuvent contenir [A-Za-z][A-Za-z0-9_-]* — les tirets sont valides (par exemple CB-101 est un identifiant légal).

Bloc d'attributs — les crochets […] peuvent s'étendre sur plusieurs lignes physiques. Le parseur joint les lignes de continuation jusqu'à ce que la profondeur des crochets atteigne zéro.

Les identifiants dupliqués génèrent SLDParseError: Duplicate node id "…".

7. Erreurs courantes

8. Grammaire (EBNF)

document      = header NEWLINE ( blank | comment | node-def | connection )*

header        = "sld" ( WS quoted-string )? NEWLINE
quoted-string = '"' any-char-but-quote* '"'

node-def      = id WS "=" WS node-type ( WS "[" attr-list "]" )? NEWLINE
node-type     = "utility" | "generator" | "solar" | "wind" | "ups"
              | "transformer" | "transformer_dy" | "transformer_yd"
              | "transformer_yy" | "transformer_dd"
              | "autotransformer" | "transformer_3winding"
              | "bus" | "bus_tie" | "hub"
              | "breaker" | "breaker_vacuum" | "switch" | "switch_load"
              | "ground_switch" | "ats" | "recloser" | "sectionalizer"
              | "fuse" | "fuse_cl"
              | "ct" | "pt" | "relay" | "surge_arrester" | "ground_fault"
              | "motor" | "load" | "capacitor_bank" | "harmonic_filter" | "vfd"
              | "watthour_meter" | "demand_meter"
              | residential-alias

residential-alias
              = "mcb" | "mccb" | "rcd" | "rcbo" | "rccb"
              | "differential" | "diferencial" | "pia" | "iga"
              | "main_switch" | "isolator" | "disconnector"
              | "consumer_unit" | "distribution_board" | "panel" | "panelboard"

attr-list     = attr ( "," attr )*
attr          = key ":" WS quoted-string

connection    = id WS "->" WS id ( WS "[" conn-attrs "]" )? NEWLINE
conn-attrs    = conn-attr ( "," conn-attr )*
conn-attr     = "cable" ":" WS quoted-string
              | "label" ":" WS quoted-string

id            = [A-Za-z] [A-Za-z0-9_-]*
key           = [A-Za-z] [A-Za-z0-9_]*
comment       = ( "#" | "//" | "%%" ) any NEWLINE

Le bloc d'attributs […] peut s'étendre sur plusieurs lignes physiques — le parseur joint les lignes de continuation jusqu'à ce que la profondeur des crochets revienne à zéro.

Source faisant autorité : src/diagrams/sld/parser.ts. En cas de divergence avec le parseur, le parseur a la priorité — veuillez ouvrir un ticket.

9. Conformité aux normes

Les SLD Schematex suivent les conventions de symboles graphiques de la IEEE Std 315 (ANSI Y32.2) pour les équipements de coupure, les transformateurs et les sources. Les variantes de configuration d'enroulement des transformateurs (transformer_dy, transformer_yy, etc.) utilisent la notation Δ/Y de l'IEC 60617. Les numéros de dispositifs de relais de protection suivent l'ANSI/IEEE C37.2.

Ce qui est implémenté aujourd'hui :

• ✅ Tous les types de sources : réseau, groupe électrogène, solaire, éolien, UPS
• ✅ Six variantes de transformateurs plus autotransformateur et transformateur à trois enroulements
• ✅ Jeu de barres, couplage de jeu de barres, hub
• ✅ Alias du vocabulaire résidentiel IEC / REBT mappés sur les primitives canoniques
• ✅ Ensemble complet de coupure : disjoncteur, disjoncteur à vide, sectionneur, interrupteur de charge, sectionneur de mise à la terre, ATS, réenclencheur, sectionnaliseur, fusible, fusible limiteur de courant
• ✅ Protection et surveillance : TC, TP, relais (avec numéro de dispositif ANSI), parafoudre, détecteur de défaut à la terre
• ✅ Équipements de charge : moteur, charge, batterie de condensateurs, filtre harmonique, variateur de fréquence
• ✅ Comptage : compteur d'énergie, compteur de puissance de pointe
• ✅ Connexions orientées avec annotations de câble et d'étiquette
• ✅ Attributs de nœud label, voltage, rating, device ; données de plaque signalétique arbitraires
• ⏳ Coupure de jeu de barres avec indicateur d'état ouvert/fermé
• ⏳ Zones de protection (lignes de délimitation en pointillés encadrant le relais + TC)
• ⏳ Blocs d'étiquettes d'arc électrique (énergie incidente, niveau EPI, distance de travail)
• ⏳ Bandes par niveau de tension (bandes horizontales colorées automatiques par niveau en kV)

Références :

• IEEE Std 315-1975 / ANSI Y32.2-1975 — Graphic Symbols for Electrical and Electronics Diagrams
• IEC 60617:2025 (BS 3939) — Graphical symbols for diagrams
• ANSI/IEEE C37.2 — Electrical Power System Device Function Numbers

10. Exemples associés

11. Feuille de route

Prévu — pas encore analysable. N'utilisez pas ces éléments dans le DSL généré aujourd'hui ; le parseur les rejettera ou les ignorera.

• État ouvert/fermé du couplage de jeu de barres — bus_tie avec un attribut ouvert/fermé explicite pour que le symbole s'affiche dans la bonne position de coupure.
• Zones de protection — un bloc zone: ou boundary: qui dessine un rectangle en pointillés autour d'un ensemble de nœuds (relais + TC + disjoncteur) pour indiquer une zone de protection.
• Blocs d'annotation d'arc électrique — arc_flash: [incident_energy: "8 cal/cm²", ppe: "2", distance: "18in"] selon l'IEEE 1584.
• Bandes par niveau de tension — ombrage horizontal automatique par niveau de tension en kV ; les nœuds sont placés automatiquement dans leur niveau de tension.
• Connexion bidirectionnelle (<->) — pour les chemins de couplage de jeu de barres ou normalement ouverts où la direction est indéfinie.

Suivez les tickets GitHub si vous avez besoin de l'une de ces fonctionnalités plus tôt.