Ajouter la configuration du terminal (Utility Network)

Résumé

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

Des entités équipées de bornes nécessitent des contraintes qui définissent la configuration valide de la connectivité interne du périphérique ou de l’objet de jonction. Cet outil permet d’ajouter une nouvelle configuration de bornes à un réseau de distribution qui peut, par la suite, être affectée à une classe au niveau du groupe de ressources ou du type de ressources au moyen de l’outil Set Terminal Configuration (Définir la configuration de bornes).

Utilisation

  • Les bornes sont configurées sur un périphérique ou un objet de jonction en affectant 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é possèdent un paramètre de direction. Elles peuvent être définies comme directionnelles (un seul sens de flux est autorisé) ou bidirectionnelles (les deux sens de flux sont autorisés).

  • Vous devez indiquer au minimum 2 bornes et au maximum 8 bornes. Le nom de la borne doit être une description pertinente, 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 configurations 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, dans un dispositif à quatre bornes avec des bornes nommées A, B, C et D, vous pouvez autoriser le flux de A à B et C, mais pas de A à D.

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

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

Syntaxe

AddTerminalConfiguration(in_utility_network, terminal_configuration_name, traversability_model, {terminals_directional}, {terminals_bidirectional}, {valid_paths}, {default_path})
ParamètreExplicationType de données
in_utility_network

Réseau technique auquel la configuration des bornes sera ajoutée.

Utility Network; Utility Network Layer
terminal_configuration_name

Nom de la configuration des bornes.

String
traversability_model

Indique la direction de la configuration des bornes. 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.

  • DIRECTIONALSeul un sens de flux est autorisé.
  • BIDIRECTIONALLes deux sens sont autorisés.
String
terminals_directional
[[name, upstream],...]
(Facultatif)

Nom et sens de circulation de chaque borne. 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 : indiquez 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 chacune des bornes bidirectionnelles. 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 Directionality (Direction) a pour valeur Bidirectional (Bidirectionnel) (traversability_model = "BIDIRECTIONAL" dans Python).

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

Nom(s) du ou des chemins valides de la configuration des bornes. En mode de traversabilité bidirectionnelle, ce paramètre est obligatoire si vous possédez deux bornes ou plus. Si vous utilisez la traversabilité directionnelle, une seule borne en amont permet de satisfaire une configuration valide. Les chemins valides doivent être définis de façon à indiquer le ou les chemins, au sein d’un périphérique ou d’un objet de jonction, qu’une ressource peut parcourir. Donnez un nom à chaque chemin valide et attribuez une valeur.

  • Name (Nom) : nom du chemin valide.
  • Value (Valeur)  : valeur du chemin valide.
    • All (Tous) : tous les chemins sont valides.
    • None (Aucun) : aucun chemin n’est valide.
    • Terminal pair (Paire de bornes) : désigne un chemin unique reliant une borne à une autre, par exemple, A-B.
    • Collection of terminal pairs (Ensemble de paires de bornes) : désigne un ensemble de chemins uniques reliant une borne à une autre, 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 ressources possède cette configuration de borne. Si aucune configuration valide n’a été spécifiée, la configuration par défaut ALL est utilisée.

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

Sortie dérivée

NomExplicationType de données
out_utility_network

Réseau technique actualisé.

Utility Network

Exemple de code

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

Ajoute une configuration de borne bidirectionnelle à trois bornes.

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

Ajoute une configuration de borne directionnelle à trois bornes.

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config2', 
                                  'DIRECTIONAL', 'A true;B true;C false', 
                                  'Top A-B;Bottom A-C', 'Bottom')

Environnements

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

Informations de licence

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

Rubriques connexes