Ajouter une configuration de borne (Utility Network)

Synthèse

Ajoute une configuration de borne à un réseau de distribution existant.

Les entités de réseau équipées de bornes nécessitent des contraintes qui définissent la configuration valide de la connectivité interne du dispositif et de l’objet de jonction. Cet outil permet d’ajouter une nouvelle configuration de borne à un réseau de distribution. Celle-ci peut, par la suite, être attribuée à une classe au niveau du groupe de ressources ou du type de ressource à l’aide de l’outil Définir la configuration de borne.

Utilisation

  • Les bornes sont configurées sur un dispositif ou un objet de jonction en attribuant une configuration de borne. Une seule configuration de borne peut être attribuée à chacun des types de ressource prenant en charge les bornes.

  • Les bornes sur une entité ou un objet possèdent un paramètre de direction. Elles peuvent être définies comme directionnelles (un seul sens de circulation est autorisé) ou bidirectionnelles (les deux sens de circulation sont autorisés).

  • Vous devez indiquer au minimum 2 bornes et au maximum 8 bornes. Les noms des bornes doivent être descriptifs, par exemple côté supérieur ou côté source.

  • Pour les entités dotées de trois ou quatre bornes, vous pouvez définir des chemin valides. Ceci est conçu pour gérer les dispositifs de commutation complexes pour lesquels vous devez contraindre les chemins de flux entre des paires de bornes. Par exemple, pour un dispositif à quatre bornes avec des bornes nommées A, B, C et D, vous pouvez autoriser le flux de A vers B et C, mais pas de A vers D.

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

  • Lorsque vous utilisez une géodatabase d’entreprise, tenez compte des exigences suivantes :

    • Cet outil doit être connecté à la version par défaut pour pouvoir être exécuté.
      • Aucune autre session connectée à la version par défaut ne pourra exécuter d’opérations de validation ou d’activation au cours de l’opération d’activation.
    • 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 de portail ArcGIS Enterprise connecté doit être celui du propriétaire du réseau de distribution du portail.

Paramètres

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

Réseau de distribution en entrée auquel la configuration de borne sera ajoutée.

Utility Network; Utility Network Layer
Nom

Nom de la configuration de borne.

String
Direction

Indique la direction de la configuration de borne. Un modèle de traversabilité directionnel implique que le flux pour la borne concernée ne circule que dans un seul sens. Dans un modèle de traversabilité bidirectionnel, la borne autorise un flux dans les deux sens.

  • DirectionnelUn seul sens de circulation est autorisé.
  • BidirectionnelLes deux sens de circulation sont autorisés.
String
Bornes
(Facultatif)

Nom et sens de circulation de chaque borne directionnelle. Vous devez indiquer au minimum 2 bornes et au maximum 8 bornes. Le nom de chaque borne ne peut pas comporter plus de 32 caractères. Ce paramètre est requis si le paramètre Direction a pour valeur Directionnel.

  • Nom : indique le nom de la borne.
  • En amont : indique si la borne se trouve en amont ou en aval.
    • Activé : la borne se trouve en amont.
    • Désactivé : la borne se trouve en aval.
Value Table
Bornes
(Facultatif)

Nom de chaque borne bidirectionnelle. Vous devez indiquer au minimum 2 bornes et au maximum 8 bornes. Le nom de chaque borne ne peut pas comporter plus de 32 caractères. Ce paramètre est requis si le paramètre Direction a pour valeur Bidirectionnel (traversability_model = "BIDIRECTIONAL" dans Python).

Value Table
Chemin(s) valide(s)
(Facultatif)

Nom(s) et chemin(s) valide(s) de la configuration de borne. En mode de traversabilité bidirectionnelle, ce paramètre est obligatoire si vous possédez trois ou quatre bornes. Si vous utilisez la traversabilité directionnelle, une seule borne en amont permet d’obtenir une configuration valide. Les chemins valides doivent être créés de façon à indiquer le ou les chemins, au sein d’un dispositif ou d’un objet de jonction, qu’une ressource peut emprunter. Donnez un nom à chaque chemin valide et attribuez-leur une valeur.

  • Nom : nom du chemin valide.
  • Valeur : valeur du chemin valide.
    • Tous : saisissez la valeur Tous pour créer une option indiquant que tous les chemins sont valides.
    • Aucun : saisissez la valeur Aucun pour créer une option indiquant qu’aucun chemin n’est valide.
    • Paire(s) de bornes : saisissez une paire de bornes ou un ensemble de paires de bornes. Saisissez une seule paire de bornes en spécifiant le chemin d’une borne à une autre, en les séparant par un tiret, par exemple, A-B. Saisissez un ensemble de paires de bornes en les séparant par une virgule, par exemple, A-B, A-C.
Value Table
Chemin par défaut
(Facultatif)

Chemin par défaut des configurations valides. Il sera attribué aux nouvelles entités dont le type de ressource possède cette configuration de borne. Si aucun chemin valide n’a été indiqué, le chemin par défaut Tous est utilisé.

  • TousTous les chemins sont valides. Il s’agit de l’option par défaut.
  • AucunAucun chemin n’est valide.
String

Sortie obtenue

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

Réseau de distribution mis à jour.

Utility Network

arcpy.un.AddTerminalConfiguration(in_utility_network, terminal_configuration_name, traversability_model, {terminals_directional}, {terminals_bidirectional}, {valid_paths}, {default_path})
NomExplicationType de données
in_utility_network

Réseau de distribution en entrée auquel la configuration de borne sera ajoutée.

Utility Network; Utility Network Layer
terminal_configuration_name

Nom de la configuration de borne.

String
traversability_model

Indique la direction de la configuration de borne. Un modèle de traversabilité directionnel implique que le flux pour la borne concernée ne circule que dans un seul sens. Dans un modèle de traversabilité bidirectionnel, la borne autorise un flux dans les deux sens.

  • DIRECTIONALUn seul sens de circulation est autorisé.
  • BIDIRECTIONALLes deux sens de circulation sont autorisés.
String
terminals_directional
[[name, upstream],...]
(Facultatif)

Nom et sens de circulation de chaque borne directionnelle. Vous devez indiquer au minimum 2 bornes et au maximum 8 bornes. Le nom de chaque borne ne peut pas comporter plus de 32 caractères. Ce paramètre est requis si le paramètre traversability_model a pour valeur DIRECTIONAL.

  • Name : indique le nom de la borne.
  • Upstream : indique si la borne se trouve en amont ou en aval.
    • True : la borne se trouve en amont.
    •  False : la borne se trouve en aval.
Value Table
terminals_bidirectional
[[name],...]
(Facultatif)

Nom de chaque borne bidirectionnelle. Vous devez indiquer au minimum 2 bornes et au maximum 8 bornes. Le nom de chaque borne ne peut pas comporter plus de 32 caractères. Ce paramètre est requis si le paramètre Direction a pour valeur Bidirectionnel (traversability_model = "BIDIRECTIONAL" dans Python).

Value Table
valid_paths
[[Name, [Value]],...]
(Facultatif)

Nom(s) et chemin(s) valide(s) de la configuration de borne. En mode de traversabilité bidirectionnelle, ce paramètre est obligatoire si vous possédez trois ou quatre bornes. Si vous utilisez la traversabilité directionnelle, une seule borne en amont permet d’obtenir une configuration valide. Les chemins valides doivent être créés de façon à indiquer le ou les chemins, au sein d’un dispositif ou d’un objet de jonction, qu’une ressource peut emprunter. Donnez un nom à chaque chemin valide et attribuez-leur une valeur.

  • Nom : nom du chemin valide.
  • Valeur : valeur du chemin valide.
    • Tous : saisissez la valeur Tous pour créer une option indiquant que tous les chemins sont valides.
    • Aucun : saisissez la valeur Aucun pour créer une option indiquant qu’aucun chemin n’est valide.
    • Paire(s) de bornes : saisissez une paire de bornes ou un ensemble de paires de bornes. Saisissez une seule paire de bornes en spécifiant le chemin d’une borne à une autre, en les séparant par un tiret, par exemple, A-B. Saisissez un ensemble de paires de bornes en les séparant par une virgule, par exemple, A-B, A-C.
Value Table
default_path
(Facultatif)

Chemin par défaut des configurations valides. Il sera attribué aux nouvelles entités dont le type de ressource possède cette configuration de borne. Si aucun chemin valide n’a été indiqué, le chemin par défaut All est utilisé.

  • ALLTous les chemins sont valides. Il s’agit de l’option par défaut.
  • NONEAucun chemin n’est valide.
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 la fonction AddTerminalConfiguration (fenêtre Python)

Ajouter une configuration de borne bidirectionnelle à trois bornes.

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config1', 
                                  'BIDIRECTIONAL', None, 'A;B;C', 
                                  'Top A-B;Bottom A-C', 'Top')
Exemple 2 d’utilisation de la fonction AddTerminalConfiguration (fenêtre Python)

Ajouter une configuration de borne directionnelle à trois bornes.

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config2', 
                                  'DIRECTIONAL', 'A true;B true;C false', None, 
                                  'Top A-B;Bottom A-C', 'Bottom')
Exemple 3 d’utilisation de la fonction AddTerminalConfiguration (fenêtre Python)

Ajouter une configuration de borne directionnelle à trois bornes. Les chemins valides sont indiqués à l’aide d’un ensemble de paires de bornes.

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config3', 
                                  'DIRECTIONAL', 'A true;B false;C false', None, 
                                  "AB A-B;ABAC 'A-B;A-C'", 'AB')

Environnements

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

Informations de licence

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

Rubriques connexes