Ajouter une règle (Utility Network)

Résumé

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

Toutes les règles créées dans un réseau technique sont basées sur des classes de réseau aux niveaux du groupe de ressources et du type de ressources et peuvent être utilisées pour contrôler certains comportements dans le réseau technique.

Utilisation

• La topologie du réseau doit être désactivée.

• Si une géodatabase d’entreprise est utilisée, les conditions suivantes doivent être remplies :
  • La valeur du paramètre Input Utility Network (Réseau de distribution en entrée) doit provenir d’une connexion à une base de données établie en tant que propriétaire du réseau de distribution de la base de données.
  • Le compte connecté au portail ArcGIS Enterprise doit être celui du propriétaire du réseau technique.

Syntaxe

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})

Paramètre	Explication	Type de données
in_utility_network	Réseau de distribution auquel la règle sera ajoutée.	Utility Network; Utility Network Layer
rule_type	Type de règle à créer. JUNCTION_JUNCTION_CONNECTIVITY —Crée une règle de connectivité jonction-jonction permettant à deux entités ponctuelles de se connecter via une association de connectivité (les entités sont décalées de façon géométrique). CONTAINMENT —Crée une règle d’inclusion où les paramètres d’origine correspondent au conteneur et où les paramètres de destination correspondent au contenu d’une association d’inclusion. STRUCTURAL_ATTACHMENT —Crée une règle de dépendance structurelle où les paramètres d’origine correspondent aux entités structurelles et où les paramètres de destination correspondent aux entités de dépendance dans une association de dépendance structurelle. JUNCTION_EDGE_CONNECTIVITY —Crée une règle de connectivité tronçon-jonction permettant aux entités tronçon et jonction de se connecter via la coïncidence géométrique (les entités sont au même emplacement x,y,z). EDGE_JUNCTION_EDGE_CONNECTIVITY —Crée une règle de connectivité tronçon-jonction-tronçon permettant à un tronçon de se connecter à l’un ou l'autre côté d’une entité de jonction.	String
from_class	La classe d’entités du réseau technique ou table d’origine qui sera incluse dans la règle. Les règles d’association d’inclusion et de dépendance structurelle exigent que l’entité de conteneur ou de structure figure dans ce paramètre. L’ordre importe peu pour les règles de connectivité jonction-jonction, jonction-tronçon et tronçon-jonction-tronçon.	String
from_assetgroup	Un groupe de ressources pour la from_class à laquelle la règle s'appliquera.	String
from_assettype	Un type de ressources pour la from_class à laquelle la règle s'appliquera.	String
to_class	La classe d’entités du réseau technique ou table de destination qui sera incluse dans la règle. Les règles d’association d’inclusion et de dépendance structurelle exigent que l’entité de contenu ou d’inclusion figure dans ce paramètre. L’ordre importe peu pour les règles de connectivité jonction-jonction, jonction-tronçon et tronçon-jonction-tronçon.	String
to_assetgroup	Un groupe de ressources pour la to_class à laquelle la règle s'appliquera.	String
to_assettype	Spécifie un type de ressources pour to_class à laquelle la règle s'appliquera.	String
from_terminal (Facultatif)	Terminal De auquel la règle s'appliquera. Il s'agira d’un terminal dans la from_class. Lors de la création d'une règle de connectivité pour une entité avec bornes à connecter à une autre entité, le côté de la borne à 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’un terminal dans la to_class. Lors de la création d'une règle de connectivité pour une entité à connecter à une autre entité avec des bornes, le côté de la borne à 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 peut uniquement être spécifié pour la EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type puisque trois classes d'entités ou tables sont nécessaires pour participer à une connectivité tronçon-jonction-tronçon.	String
via_assetgroup (Facultatif)	Un groupe de ressources de la via_class auquel la règle s'appliquera. Ce paramètre peut être spécifié pour la valeur de paramètre EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type.	String
via_assettype (Facultatif)	Un type de ressources de la via_class auquel la règle s'appliquera. Ce paramètre peut être spécifié pour la valeur de paramètre EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type.	String
via_terminal (Facultatif)	Le terminal Dede la via_class à laquelle la règle s'appliquera. Ce paramètre peut être spécifié pour la valeur de paramètre EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type.	String

Sortie dérivée

Nom	Explication	Type de données
out_utility_network	Réseau technique actualisé.	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.AddRule_un("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.AddRule_un("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.AddRule_un("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.AddRule_un("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