Ajouter une règle (Utility Network)

Synthèse

Ajoute une règle de réseau à un réseau de distribution.

Toutes les règles de réseau créées dans un réseau de distribution sont basées sur les classes du réseau de domaine et du réseau de structure aux niveaux du groupe de ressources et du type de ressources. Elles vous permettent d’identifier les types d’entités ou d’objets qui peuvent se connecter ou s’associer. Ces règles sont définies selon des pratiques métier et sont utilisées conjointement avec des restrictions d’entités, qui restreignent les relations valides entre les classes, afin de gérer l’exactitude des ressources d’un réseau.

En savoir plus sur les restrictions d’entités et les règles de réseau

Utilisation

Paramètres

ÉtiquetteExplicationType de données
Réseau de distribution en entrée

Réseau de distribution auquel la règle sera ajoutée.

Utility Network; Utility Network Layer
Type de règle

Spécifie le type de règle qui sera créé.

  • Connectivité jonction-jonctionUne règle de connectivité jonction-jonction est créée pour permettre à des entités ponctuelles ou des objets jonction de se connecter via une association de connectivité.
  • InclusionUne règle d’inclusion est créée dans laquelle les paramètres d’origine correspondent au conteneur et les paramètres de destination correspondent au contenu d’une association d’inclusion.
  • Dépendance structurelleUne règle de dépendance structurelle est créée dans laquelle les paramètres d’origine correspondent aux entités ou objets de structure et les paramètres de destination correspondent aux entités ou objets de dépendance dans une association de dépendance structurelle.
  • Connectivité jonction-tronçonUne règle de connectivité jonction-tronçon est créée pour permettre à des entités ponctuelles et linéaires de se connecter par le biais de la coïncidence géométrique (les entités se trouvent au même emplacement x,y,z), ou pour permettre à un objet tronçon de se connecter à des entités ponctuelles ou des objets jonction via une association de connectivité.
  • Connectivité tronçon-jonction-tronçonUne règle de connectivité tronçon-jonction-tronçon est créée pour permettre à une ligne de se connecter à une extrémité d’une entité ponctuelle, ou permettre à un objet tronçon de se connecter à une autre ligne ou un autre objet tronçon via une entité ponctuelle ou un objet jonction.
String
De la table

Classe d’entités du réseau de distribution ou objet non spatial d’origine qui est inclus dans la règle.

Les règles d’association d’inclusion et de dépendance structurelle exigent que l’entité de réseau conteneur ou de structure figure dans ce paramètre.

Lors de la création de règles de connectivité jonction-tronçon et tronçon-jonction-tronçon, ce paramètre doit référencer la jonction ou l’objet jonction.

String
Groupe de ressources De

Un groupe de ressources pour la valeur du paramètre Table d’origine auquel la règle s'appliquera.

String
Type de ressources De

Un type de ressources pour la valeur du paramètre Table d’origine auquel la règle s'appliquera.

String
Table de destination

Classe d’entités du réseau de distribution ou objet non spatial de destination qui est inclus dans la règle.

Les règles d’association d’inclusion et de dépendance structurelle exigent que l’entité de réseau de contenu ou de dépendance figure dans ce paramètre.

Lors de la création de règles de connectivité jonction-tronçon et tronçon-jonction-tronçon, le paramètre De la table doit référencer la jonction ou l’objet jonction.

String
Groupe de ressources A

Un groupe de ressources pour la valeur du paramètre Table de destination auquel la règle s'appliquera.

String
Type de ressources A

Un type de ressources pour la valeur du paramètre Table de destination auquel la règle s'appliquera.

String
Terminal d'origine
(Facultatif)

Terminal De auquel la règle s'appliquera. Il s’agira d’une borne dans la valeur du paramètre Table d’origine. Lors de la création d’une règle de connectivité pour un objet appareil ou jonction doté de bornes à connecter à une autre entité de réseau, le côté de la borne de départ à connecter doit être spécifié, par exemple la borne du côté supérieur d’un transformateur.

Ce paramètre est obligatoire si le type de ressource possède des bornes. Il est inactif lorsque la règle d’association d’inclusion ou de dépendance structurelle est spécifiée dans le paramètre Type de règle.

String
Terminal de destination
(Facultatif)

Terminal A auquel la règle s'appliquera. Il s’agira d’une borne dans la valeur du paramètre Table de destination. Lors de la création d’une règle de connectivité pour un objet appareil ou jonction à connecter à une autre entité de réseau dotée de bornes, le côté de la borne d’arrivée à connecter doit être spécifié, par exemple, la borne du côté inférieur d’un transformateur.

Ce paramètre est obligatoire si le type de ressource possède des bornes. Il est inactif pour les types de règle d’association d’inclusion ou de dépendance structurelle.

String
Via une table
(Facultatif)

Objet ou classe d’entités du réseau de distribution de jonction auxquels la règle s’applique. Ce paramètre est disponible uniquement lorsque le paramètre Type de règle est défini sur Connectivité tronçon-jonction-tronçon, car trois classes sont nécessaires pour participer à la connectivité tronçon-jonction-tronçon.

String
Groupe de ressources Via
(Facultatif)

Un groupe de ressources de la valeur du paramètre Via une table auquel la règle s’appliquera. Ce paramètre n’est disponible que lorsque le paramètre Type de règle est défini sur Connectivité tronçon-jonction-tronçon.

String
Type de ressources Via
(Facultatif)

Un type de ressources de la valeur du paramètre Via une table auquel la règle s’appliquera. Ce paramètre n’est disponible que lorsque le paramètre Type de règle est défini sur Connectivité tronçon-jonction-tronçon.

String
Terminal Via
(Facultatif)

La borne de la valeur du paramètre Via une table auquel la règle s’appliquera. Ce paramètre n’est disponible que lorsque le paramètre Type de règle est défini sur Connectivité tronçon-jonction-tronçon.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Réseau de distribution mis à jour

Réseau de distribution mis à jour.

Utility Network

arcpy.un.AddRule(in_utility_network, rule_type, from_class, from_assetgroup, from_assettype, to_class, to_assetgroup, to_assettype, {from_terminal}, {to_terminal}, {via_class}, {via_assetgroup}, {via_assettype}, {via_terminal})
NomExplicationType de données
in_utility_network

Réseau de distribution auquel la règle sera ajoutée.

Utility Network; Utility Network Layer
rule_type

Spécifie le type de règle qui sera créé.

  • JUNCTION_JUNCTION_CONNECTIVITYUne règle de connectivité jonction-jonction est créée pour permettre à des entités ponctuelles ou des objets jonction de se connecter via une association de connectivité.
  • CONTAINMENTUne règle d’inclusion est créée dans laquelle les paramètres d’origine correspondent au conteneur et les paramètres de destination correspondent au contenu d’une association d’inclusion.
  • STRUCTURAL_ATTACHMENTUne règle de dépendance structurelle est créée dans laquelle les paramètres d’origine correspondent aux entités ou objets de structure et les paramètres de destination correspondent aux entités ou objets de dépendance dans une association de dépendance structurelle.
  • JUNCTION_EDGE_CONNECTIVITYUne règle de connectivité jonction-tronçon est créée pour permettre à des entités ponctuelles et linéaires de se connecter par le biais de la coïncidence géométrique (les entités se trouvent au même emplacement x,y,z), ou pour permettre à un objet tronçon de se connecter à des entités ponctuelles ou des objets jonction via une association de connectivité.
  • EDGE_JUNCTION_EDGE_CONNECTIVITYUne règle de connectivité tronçon-jonction-tronçon est créée pour permettre à une ligne de se connecter à une extrémité d’une entité ponctuelle, ou permettre à un objet tronçon de se connecter à une autre ligne ou un autre objet tronçon via une entité ponctuelle ou un objet jonction.
String
from_class

Classe d’entités du réseau de distribution ou objet non spatial d’origine qui est inclus dans la règle.

Les règles d’association d’inclusion et de dépendance structurelle exigent que l’entité de réseau conteneur ou de structure figure dans ce paramètre.

Lors de la création de règles de connectivité jonction-tronçon et tronçon-jonction-tronçon, ce paramètre doit référencer la jonction ou l’objet jonction.

String
from_assetgroup

Un groupe de ressources pour la valeur du paramètre from_class à laquelle la règle s’appliquera.

String
from_assettype

Un type de ressources pour la valeur du paramètre from_class auquel la règle s'appliquera.

String
to_class

Classe d’entités du réseau de distribution ou objet non spatial de destination qui est inclus dans la règle.

Les règles d’association d’inclusion et de dépendance structurelle exigent que l’entité de réseau de contenu ou de dépendance figure dans ce paramètre.

Lors de la création de règles de connectivité jonction-tronçon et tronçon-jonction-tronçon, le paramètre from_class doit référencer la jonction ou l’objet jonction.

String
to_assetgroup

Un groupe de ressources pour la valeur du paramètre to_class à laquelle la règle s’appliquera.

String
to_assettype

Un type de ressources pour la valeur du paramètre to_class auquel la règle s'appliquera.

String
from_terminal
(Facultatif)

Terminal De auquel la règle s'appliquera. Il s’agira d’une borne dans la valeur du paramètre from_class. Lors de la création d’une règle de connectivité pour un objet appareil ou jonction doté de bornes à connecter à une autre entité de réseau, le côté de la borne de départ à connecter doit être spécifié, par exemple la borne du côté supérieur d’un transformateur.

Ce paramètre est obligatoire si le type de ressource possède des bornes. Il est ignoré pour les types de règle d’inclusion ou de dépendance structurelle.

String
to_terminal
(Facultatif)

Terminal A auquel la règle s'appliquera. Il s’agira d’une borne dans la valeur du paramètre to_class. Lors de la création d’une règle de connectivité pour un objet appareil ou jonction à connecter à une autre entité de réseau dotée de bornes, le côté de la borne d’arrivée à connecter doit être spécifié, par exemple, la borne du côté inférieur d’un transformateur.

Ce paramètre est obligatoire si le type de ressource possède des bornes. Il est ignoré pour les types de règle d’inclusion ou de dépendance structurelle.

String
via_class
(Facultatif)

Classe d'entités du réseau technique de jonction ou table à laquelle la règle s'appliquera. Ce paramètre ne peut être spécifié que lorsque le paramètre rule_type est défini sur EDGE_JUNCTION_EDGE_CONNECTIVITY, car trois classes sont nécessaires pour participer à une connectivité tronçon-jonction-tronçon.

String
via_assetgroup
(Facultatif)

Un groupe de ressources de la valeur du paramètre via_class auquel la règle s’appliquera. Ce paramètre ne peut être spécifié que lorsque le paramètre rule_type est défini sur EDGE_JUNCTION_EDGE_CONNECTIVITY.

String
via_assettype
(Facultatif)

Un type de ressources de la valeur du paramètre via_class auquel la règle s’appliquera. Ce paramètre ne peut être spécifié que lorsque le paramètre rule_type est défini sur EDGE_JUNCTION_EDGE_CONNECTIVITY.

String
via_terminal
(Facultatif)

La borne de la valeur du paramètre via_class auquel la règle s’appliquera. Ce paramètre ne peut être spécifié que lorsque le paramètre rule_type est défini sur EDGE_JUNCTION_EDGE_CONNECTIVITY.

String

Sortie obtenue

NomExplicationType de données
out_utility_network

Réseau de distribution mis à jour.

Utility Network

Exemple de code

Exemple 1 d’utilisation de l’outil AddRule (fenêtre Python)

Cet exemple génère une règle d’association de connectivité jonction-jonction pour permettre au côté de chargement des disjoncteurs de circuit de se connecter au côté supérieur des transformateurs dans un réseau de distribution électrique.

import arcpy
arcpy.un.AddRule("Distribution Network", "JUNCTION_JUNCTION_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Transformer", "High")
Exemple 2 d’utilisation de l’outil AddRule (fenêtre Python)

Cet exemple génère une règle de connectivité jonction-tronçon pour permettre au côté charge des disjoncteurs de se connecter aux lignes de moyenne tension dans un réseau de distribution électrique.

import arcpy
arcpy.un.AddRule("Utility Network", "JUNCTION_EDGE_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Medium Voltage", 
                 "Single Phase Overhead")
Exemple 3 d’utilisation de l’outil AddRule (fenêtre Python)

Cet exemple de script crée une règle d'association d’inclusion pour permettre à un boîtier de jonction de contenir un coude.

import arcpy
arcpy.un.AddRule("Electric Network", "CONTAINMENT", "StructureJunction", 
                 "JunctionBox", "Junction Box", "ElectricDistributionDevice", 
                 "Fuse", "Underground Single Phase Load Break Elbow")
Exemple 4 d'utilisation de l'outil AddRule (fenêtre Python)

Cet exemple de script génère une règle d'association de dépendance structurelle pour permettre à un commutateur d’être structurellement relié à un pôle.

import arcpy
arcpy.un.AddRule("Electric Network", "STRUCTURAL_ATTACHMENT", 
                 "StructureJunction", "Pole", "Wood", 
                 "ElectricDistributionDevice", "Switch", 
                 "Overhead Low Voltage Single Phase Disconnect")

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

  • Basic: Non
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes