Configurer la définition de sous-réseau (Utility Network)

Résumé

Définit les propriétés d’un tier de classes de réseau pour un sous-réseau dans un réseau de distribution.

Les types d’entités participant à un tier peuvent être limités en définissant les types de ressources valides à partir du périphérique, de la ligne, de la jonction, de l’objet de tronçon et des classes d’objets jonction. La définition des types de ressources valides contribue à l’application de l’exactitude des données en limitant les types d’entités pouvant participer à un sous-réseau pour un niveau spécifique.

Les paramètres de configuration permettent de définir des propriétés lors de l’exécution d’un traçage sur le sous-réseau.

En savoir plus sur la définition d’un sous-réseau

En savoir plus sur la gestion d’un sous-réseau

En savoir plus sur la recherche de parcours du réseau de distribution

Utilisation

  • Cet outil permet de définir et de modifier la définition du sous-réseau du tier. Pour corriger les valeurs de la définition du sous-réseau du tier, modifiez les valeurs de paramètre et exécutez une nouvelle fois l’outil.

  • 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 :

Syntaxe

arcpy.un.SetSubnetworkDefinition(in_utility_network, domain_network, tier_name, support_disjoint_subnetwork, {valid_devices}, {valid_subnetwork_controller}, {valid_lines}, {aggregated_line}, {diagram_template}, {summaries}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {update_structure_features}, {update_container_features}, {edit_mode_for_default_version}, {edit_mode_for_named_version}, {valid_junctions}, {valid_junction_objects}, {valid_junction_object_subnetwork_controller}, {valid_edge_objects}, {manage_subnetwork_isdirty}, {include_containers}, {include_content}, {include_structures}, {validate_locatability})
ParamètreExplicationType de données
in_utility_network

Réseau de distribution en entrée contenant le sous-réseau du tier.

Utility Network; Utility Network Layer
domain_network

Classes de réseau contenant le tier.

String
tier_name

Nom du niveau qui contient le sous-réseau.

String
support_disjoint_subnetwork

Détermine si le tier en entrée prend en charge les sous-réseaux disjoints. Les sous-réseaux disjoints sont plusieurs sous-réseaux appartenant au même tier et possèdent le même nom de sous-réseau, mais ne sont pas traversables. Cette option est disponible uniquement pour les niveaux des réseaux de domaine avec une définition de niveau partitionné. Les tiers dans des classes de réseau avec une définition de tier hiérarchique ont toujours cette propriété de tier définie sur SUPPORT_DISJOINT pour prendre en charge les sous-réseaux disjoints.

  • SUPPORT_DISJOINT Le tier en entrée prend en charge les sous-réseaux disjoints.
  • NO_DISJOINTLe tier en entrée ne prend pas en charge les sous-réseaux disjoints. Il s’agit de l’option par défaut.
Boolean
valid_devices
[valid_devices,...]
(Facultatif)

Paires de groupe/types d’actifs considérés comme des périphériques valides pour le sous-réseau.

String
valid_subnetwork_controller
[valid_subnetwork_controller,...]
(Facultatif)

Paires de groupe/types d’actifs considérés comme des contrôleurs de sous-réseaux de périphériques valides dans le sous-réseau.

String
valid_lines
[valid_lines,...]
(Facultatif)

Paires de groupe/types d’actifs considérés comme des lignes valides pour le sous-réseau.

String
aggregated_line
[aggregated_line,...]
(Facultatif)

Lignes valides dont la géométrie sera agrégée pour générer les entités SubnetLine. Cette liste est un sous-ensemble des valeurs spécifiées dans le paramètre valid_lines (Lignes valides).

String
diagram_template
[diagram_template,...]
(Facultatif)

Les modèles servent à générer des diagrammes système de sous-réseaux pour chaque sous-réseau.

String
summaries
[[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value, Summary Attribute],...]
(Facultatif)

Ce paramètre définit le champ de synthèse pour stocker les résultats de fonction lors de l’insertion ou de la mise à jour des entités SubnetLine.

Les composants de synthèse sont les suivants :

  • Function : choisissez une des fonctions de calcul.
  • Attribute : filtrez par un attribut de réseau défini dans le système.
  • Filter Name : filtrez les résultats de fonction par nom d’attribut.
  • Filter Operator : choisissez un des opérateurs.
  • Filter Type : choisissez un nombre de types de filtre.
  • Filter Value—Fournit une valeur spécifique de l’attribut de filtrage en entrée.
  • Summary Attribute : champ de la classe d’entités SubnetLine qui reste dans le résultat de la fonction. Selon la fonction et le type d’attribut de réseau sélectionnés, seul le type d’attributs de sous-réseau ajouté par l’utilisateur pouvant s’appliquer sera valide pour ce paramètre. Si la classe d’entités SubnetLine ne contient pas de champ de stockage du résultat de synthèse, vous pouvez utiliser l’outil Ajouter un champ pour en créer un. Un champ peut uniquement prendre en charge le résultat d’une synthèse. Par conséquent, chaque synthèse nécessite son propre champ dans la classe d’entités SubnetLine. Consultez la matrice suivante de types de champs valides pour les différentes fonctions : Matrice des types de champs valides pour le champ Attribut de synthèse basé sur la fonction choisie

Les options de la valeur Function de synthèse sont les suivantes :

  • AVERAGEMoyenne des valeurs en entrée.
  • COUNTNombre d’entités.
  • MAXMaximum des valeurs en entrée.
  • MINMinimum des valeurs en entrée.
  • ADDSomme des valeurs en entrée.
  • SUBTRACTDifférence des valeurs en entrée. Les contrôleurs de sous-réseau et les types de traçages de boucles ne prennent pas en charge la fonction de soustraction.

Les options de la valeur Filter Operator de synthèse sont les suivantes :

  • IS_EQUAL_TOL’attribut est égal à la valeur.
  • DOES_NOT_EQUALL’attribut est différent de la valeur.
  • IS_GREATER_THANL’attribut est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOL’attribut est supérieur ou égal à la valeur.
  • IS_LESS_THANL’attribut est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération Et bit à bit où tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • DOES_NOT_INCLUDE_THE_VALUESOpération Et bit à bit où tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit où au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • DOES_NOT_INCLUDE_ANYOpération Et bit à bit où aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

Les options de la valeur Filter Type de synthèse sont les suivantes :

  • SPECIFIC_VALUEFiltrez en fonction d’une valeur spécifique.
  • NETWORK_ATTRIBUTEFiltrez en fonction d’un attribut de réseau.

En savoir plus sur les opérateurs bit à bit

Value Table
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Facultatif)

Définit une interruption conditionnelle de traversabilité sur les entités en fonction d’une comparaison avec un attribut de réseau ou vérifie une chaîne de catégorie. Une interruption conditionnelle utilise un attribut de réseau, un opérateur et un type, ainsi qu’une valeur attributaire. Par exemple, arrêtez un traçage lorsque l’attribut Device Status d’une entité est égal à la valeur spécifique de Open. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. En cas d’utilisation de plusieurs attributs, vous pouvez définir une condition Et ou une condition Ou à l’aide du paramètre Combine using (Combiner en utilisant).

Les composants d’interruptions conditionnelles sont les suivants :

  • Name : filtrez par n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez un des opérateurs.
  • Type : Choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le paramètre name.
  • Value—Fournit une valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Combine Using—Définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez les combiner à l’aide d’une condition Et ou d’une condition Ou.

Les valeurs d’interruptions conditionnelles operator sont les suivantes :

  • IS_EQUAL_TOL’attribut est égal à la valeur.
  • DOES_NOT_EQUALL’attribut est différent de la valeur.
  • IS_GREATER_THANL’attribut est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOL’attribut est supérieur ou égal à la valeur.
  • IS_LESS_THANL’attribut est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération Et bit à bit où tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • DOES NOT INCLUDE_THE_VALUESOpération Et bit à bit où tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit où au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • DOES_NOT_INLCUDE_ANYOpération Et bit à bit où aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

En savoir plus sur les opérateurs bit à bit

Les options des valeurs Type d’interruptions conditionnelles sont les suivantes :

  • SPECIFIC_VALUEFiltrez en fonction d’une valeur spécifique.
  • NETWORK_ATTRIBUTEFiltrez en fonction d’un attribut de réseau.

Les valeurs Combine Using sont les suivantes :

  • ANDCombinez les interruptions conditionnelles.
  • ORUtilisez ce paramètre si l’une des interruptions conditionnelles est satisfaite.

En savoir plus sur l’utilisation de plusieurs expressions conditionnelles

Value Table
function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(Facultatif)

Définit l’interruption de traversabilité sur les entités en fonction d’une fonction. Les interruptions fonctionnelles peuvent être utilisées pour effectuer des actions comme limiter la distance que le traçage peut parcourir depuis le point de départ, ou définir une valeur maximale à laquelle arrêter un traçage. Par exemple, la longueur de chaque ligne parcourue est ajoutée à la distance totale parcourue jusqu’ici. Lorsque la distance totale parcourue atteint la valeur spécifiée, le traçage s’arrête.

Les composants d’interruptions de fonctions sont les suivants :

  • Function : choisissez une des fonctions de calcul.
  • Attribute : filtrez par un attribut de réseau défini dans le système.
  • Operator : choisissez un des opérateurs.
  • Value : définissez une valeur spécifique du type d’attribut en entrée qui, en cas d’identification, entraînera l’arrêt.
  • Use Local Values : calcule les valeurs dans chaque sens par rapport à la valeur globale générale. C’est le cas, par exemple, pour une interruption de fonction calculant la somme d’une longueur de forme dans laquelle le traçage s’arrête si la valeur est supérieure ou égale à 4. Dans le cas général, après avoir traversé deux tronçons d’une valeur de 2, vous avez déjà atteint une somme de longueur de forme égale à 4 de sorte que la recherche de parcours s’arrête. Lorsque des valeurs locales sont utilisées, celles-ci changent le long de chaque chemin et le traçage se poursuit.

Les valeurs des options function d’interruptions de fonctions sont les suivantes :

  • AVERAGEMoyenne des valeurs en entrée.
  • COUNTNombre d’entités.
  • MAXMaximum des valeurs en entrée.
  • MINMinimum des valeurs en entrée.
  • ADDSomme des valeurs en entrée.
  • SUBTRACTDifférence des valeurs en entrée.Les contrôleurs de sous-réseau et les types de traçages de boucles ne prennent pas en charge la fonction de soustraction.

Les valeurs des options operator d’interruptions de fonctions sont les suivantes :

  • IS_EQUAL_TOL’attribut est égal à la valeur.
  • DOES_NOT_EQUALL’attribut est différent de la valeur.
  • IS_GREATER_THANL’attribut est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOL’attribut est supérieur ou égal à la valeur.
  • IS_LESS_THANL’attribut est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération Et bit à bit où tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • DOES_NOT_INCLUDE_THE_VALUESOpération Et bit à bit où tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit où au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • DOES_NOT_INCLUDE_ANYOpération Et bit à bit où aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

En savoir plus sur les opérateurs bit à bit

Les options de la valeur Use Local Values d’interruptions de fonctions sont les suivantes :

  • TRUEUtilisez les valeurs locales.
  • FALSEUtilisez les valeurs globales. Il s’agit de l’option par défaut.
Value Table
include_barriers
(Facultatif)

Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la recherche de parcours. Les interruptions de traversabilité sont facultatives même si elles ont été prédéfinies dans la définition de sous-réseau.

  • INCLUDE_BARRIERSLes interruptions de capacité à être traversé sont incluses dans les résultats de traçage. Il s’agit de l’option par défaut.
  • EXCLUDE_BARRIERSLes interruptions de capacité à être traversé ne sont pas incluses dans les résultats de traçage.
Boolean
traversability_scope
(Facultatif)

Type de traversabilité à appliquer. La portée de traversabilité détermine si la traversabilité est appliquée aux jonctions, tronçons, ou aux deux. Si, par exemple, une interruption conditionnelle est définie pour arrêter le traçage lorsque le paramètre Device Status (État du périphérique) est réglé sur Open (Ouvert), avec la portée de capacité à être traversé réglée sur les tronçons uniquement, le traçage ne s’interrompt pas même s’il détecte un périphérique ouvert. En effet, l’état du périphérique ne s’applique qu’aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou non les jonctions, les tronçons, voire les deux.

  • BOTH_JUNCTIONS_AND_EDGESLa capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • JUNCTIONS_ONLYLa capacité à être traversé s’applique uniquement aux jonctions.
  • EDGES_ONLYLa capacité à être traversé s’applique uniquement aux tronçons.
String
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value, Propagated Attribute],...]
(Facultatif)

Spécifie les attributs de réseau à propager ainsi que la façon dont cette propagation devra être effectuée pendant un traçage. Les attributs de classe propagés désignent les valeurs clés sur les contrôleurs de sous-réseau qui sont distribuées au reste des entités dans le sous-réseau. Par exemple, dans un modèle de distribution électrique, vous pouvez propager la valeur de phase.

Les composants de propagateurs sont les suivants :

  • Attribute : filtrez par un attribut de réseau défini dans le système.
  • Substitution Attribute : utilisez une valeur substituée au lieu de valeurs attributaires de réseau bitset. Les substitutions sont codées selon le nombre de bits dans l’attribut de réseau en cours de propagation. Une substitution est un appariement de chaque bit en phase avec un autre bit. Par exemple, pour la phase AC, une substitution peut mapper le bit A au bit B et le bit C à la valeur nulle. Dans cet exemple, la substitution pour 1010 (Phase AC) est 0000-0010-0000-0000 (512). La substitution capture l’appariement ; vous savez ainsi que la Phase A est appariée à B et que la Phase C est appariée au nul et non l’inverse (c’est-à-dire que la Phase A n’est pas appariée au nul et la Phase C n’est pas appariée à B).
  • Function : choisissez une des fonctions de calcul.
  • Operator : choisissez un des opérateurs.
  • Value : indiquez la valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Propagated Attribute : nom du champ dans la classe de réseau qui sert à stocker le calcul des valeurs propagées. Le type de champ doit être le même que le type de champ de l'attribut réseau sélection pour la valeur Attribute.

Les options de la valeur function des propagateurs sont les suivantes :

  • PROPAGATED_BITWISE_ANDComparez les valeurs entre une entité et la suivante.
  • PROPAGATED_MINObtenez la valeur minimale.
  • PROPAGATED_MAXObtenez la valeur maximale.

Les options de la valeur operator des propagateurs sont les suivantes :

  • IS_EQUAL_TOL’attribut est égal à la valeur.
  • DOES_NOT_EQUALL’attribut est différent de la valeur.
  • IS_GREATER_THANL’attribut est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOL’attribut est supérieur ou égal à la valeur.
  • IS_LESS_THANL’attribut est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération Et bit à bit où tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • DOES_NOT_INCLUDE_THE_VALUESOpération Et bit à bit où tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit où au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • DOES_NOT_INCLUDE_ANYOpération Et bit à bit où aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

En savoir plus sur les opérateurs bit à bit

Remarque :

Ce paramètre est uniquement disponible via Python.

Value Table
update_structure_features
(Facultatif)

Spécifie si la mise à jour du sous-réseau met à jour l’attribut de nom de sous-réseau pris en charge pour les conteneurs de réseau physique.

  • UPDATELes conteneur de réseau physique sont mis à jour. Il s’agit de l’option par défaut.
  • NOT_UPDATELes conteneurs de réseau physique ne sont pas mis à jour.
Remarque :

Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure.

Boolean
update_container_features
(Facultatif)

Spécifie si la mise à jour du sous-réseau met à jour le nom de sous-réseau pris en charge pour les conteneurs de réseau de domaine.

  • UPDATELes conteneurs de réseau de domaine sont mis à jour. Il s’agit de l’option par défaut.
  • NOT_UPDATELes conteneurs de réseau de domaine ne sont pas mis à jour.
Remarque :

Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure.

Boolean
edit_mode_for_default_version
(Facultatif)

Définit le mode de mise à jour pour les mises à jour de sous-réseau sur la version par défaut et avec les géodatabases fichier.

  • WITHOUT_EVENTINGLes événements ne sont pas utilisés dans le cadre des mises à jour de sous-réseau sur la version par défaut et dans une géodatabase fichier. Ce mode de mise à jour actualise le nom du sous-réseau et propage les valeurs en place. Il s’agit de l’option par défaut.
  • WITH_EVENTINGLes événements sont utilisés dans le cadre des mises à jour de sous-réseau sur la version par défaut et dans une géodatabase fichier. Ce mode de mise à jour exécute le comportement de géodatabase (par exemple, les règles attributaires, le suivi de l’éditeur, etc.) lorsque le sous-réseau est mis à jour et met à jour le nom de sous-réseau et les valeurs propagées pour l’ensemble des entités et des objets applicables.
Remarque :

Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure.

String
edit_mode_for_named_version
(Facultatif)

Définit le mode de mise à jour pour les mises à jour de sous-réseau sur une version nommée.

  • WITHOUT_EVENTINGLes événements ne sont pas utilisés dans le cadre des mises à jour de sous-réseau sur les versions nommées. Ce mode de mise à jour met à jour le nom de sous-réseau et les valeurs propagées en place pour les entités et les objets mis à jour dans la version. Il s’agit de l’option par défaut.
  • WITH_EVENTINGLes événements sont utilisés dans le cadre des mises à jour de sous-réseau sur les versions nommées. Ce mode de mise à jour exécute le comportement de géodatabase (par exemple, les règles attributaires, le suivi de l’éditeur, etc.) lorsque le sous-réseau est mis à jour et met à jour le nom de sous-réseau et les valeurs propagées pour l’ensemble des entités et des objets applicables.
Remarque :

Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure et ne s’applique qu’aux géodatabases d’entreprise.

String
valid_junctions
[valid_junctions,...]
(Facultatif)

Paires de groupe/types d’actifs considérés comme des jonctions valides pour le sous-réseau.

Remarque :

Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure.

String
valid_junction_objects
[valid_junction_objects,...]
(Facultatif)

Paires de groupe/types d’actifs considérés comme des objets de jonction valides pour le sous-réseau.

Remarque :

Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure.

String
valid_junction_object_subnetwork_controller
[valid_junction_object_subnetwork_controller,...]
(Facultatif)

Paires de groupe/types d’actifs considérés comme des contrôleurs de sous-réseaux d’objets de jonction valides pour le sous-réseau.

Remarque :

Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure.

String
valid_edge_objects
[valid_edge_objects,...]
(Facultatif)

Paires de groupe/types d’actifs considérés comme des objets de tronçon valides pour le sous-réseau.

Remarque :

Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure.

String
manage_subnetwork_isdirty
(Facultatif)

Indique si l’attribut Is dirty dans la table de sous-réseaux est géré par l’opération de mise à jour du sous-réseau. Si aucun contrôleur de sous-réseau n’est défini pour le tier, ce paramètre utilise l’option par défaut NOT_MANAGE.

  • MANAGEL’attribut Is dirty est géré par l’opération de mise à jour du sous-réseau. Il s’agit de l’option par défaut.
  • NOT_MANAGEL’attribut Is dirty n’est pas géré par l’opération de mise à jour du sous-réseau.
Remarque :

Ce paramètre nécessite un réseau de distribution version 5 ou ultérieure.

Boolean
include_containers
(Facultatif)

Indique si les objets et les entités de conteneur sont inclus dans les résultats de traçage.

  • INCLUDE_CONTAINERS Les objets et les entités de conteneur sont inclus dans les résultats de traçage.
  • EXCLUDE_CONTAINERS Les objets et les entités de conteneur ne sont pas inclus dans les résultats de traçage. Il s’agit de l’option par défaut.

Ce paramètre nécessite un réseau de distribution version 5 ou ultérieure.

Boolean
include_content
(Facultatif)

Indique si le traçage renvoie le contenu des conteneurs dans les résultats.

  • INCLUDE_CONTENT Le contenu des objets et des entités de conteneur est inclus dans les résultats de traçage.
  • EXCLUDE_CONTENT Le contenu des objets et des entités de conteneur n’est pas inclus dans les résultats de traçage. Il s’agit de l’option par défaut.

Ce paramètre nécessite un réseau de distribution version 5 ou ultérieure.

Boolean
include_structures
(Facultatif)

Indique si les objets et les entités de structure sont inclus dans les résultats de traçage.

  • INCLUDE_STRUCTURES Les objets et les entités de structure sont inclus dans les résultats de traçage.
  • EXCLUDE_STRUCTURES Les objets et les entités de structure ne sont pas inclus dans les résultats de traçage. Il s’agit de l’option par défaut.

Ce paramètre nécessite un réseau de distribution version 5 ou ultérieure.

Boolean
validate_locatability
(Facultatif)

Indique si une erreur est renvoyée lors d’un traçage ou d’une opération de mise à jour du sous-réseau si une jonction non spatiale ou des objets de tronçon sont rencontrés sans l’association de contenu, de dépendances ou de connectivité nécessaire dans leur hiérarchie d’associations des objets traversés. Cette option garantit que les objets non spatiaux renvoyés par un traçage ou une opération de mise à jour de sous-réseau peuvent être localisés via une association avec des entités ou d’autres objets pouvant être localisés.

  • VALIDATE_LOCATABILITYUne erreur est renvoyée si une jonction non spatiale ou des objets de tronçon sont rencontrés sans l’association de contenu, de dépendances ou de connectivité nécessaire dans leur hiérarchie d’associations des objets traversés.
  • DO_NOT_VALIDATE_LOCATABILITYLe traçage ne vérifie pas la présence d’objets pouvant être localisés et renvoie des résultats que ce type d’objet soit présent ou non dans la hiérarchie d’associations des objets traversés. Il s’agit de l’option par défaut.
Remarque :

Ce paramètre nécessite un réseau de distribution version 5 ou ultérieure.

Boolean

Sortie dérivée

NomExplicationType de données
out_utility_network

Réseau technique en entrée actualisé.

Utility Network

Exemple de code

Exemple d’utilisation de l’outil SetSubnetworkDefinition (script autonome)

Cet exemple établit la définition du sous-réseau dans un domaine nommé ElectricDistribution.

'''****************************************************************************
Name:        SetSubnetworkDefinition.py
Description: This script sets the subnetwork definition for a tier in a Utility Network
Created by:  Esri
****************************************************************************'''

# Import required modules        
import arcpy

# Set local variables
in_utility_network = "ElectricDistribution"
domain_network = "ElecDist"
tier_name = "Medium Voltage"
support_disjoint_subnetwork = "SUPPORT_DISJOINT"
valid_devices = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered';'NetworkProtector/Unknown';'NetworkProtector/NetworkProtector';'Transformer/Unknown';'Transformer/Buck boost';'Transformer/Single-phase overhead';'Transformer/Single-phase padmounted';'Transformer/Three-phase padmounted';'Transformer/Power';'Transformer/Step';'Transformer/Vault'"
valid_subnetwork_controller = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered'"
valid_lines = "'Busbar/Unknown';'Busbar/Busbar';'Connector/Unknown';'Connector/Connector';'LowVoltage/Unknown';'LowVoltage/Overhead';'LowVoltage/Underground';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground';'IsolatedNeutral/Unknown';'IsolatedNeutral/Concentric neutral';'IsolatedNeutral/Neutral';'SubTransmission/Unknown';'SubTransmission/Overhead';'SubTransmission/Underground'"
aggregated_line = "'Busbar/Unknown';'Busbar/Busbar';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground'"
diagram_template = "Basic"
summaries = ""
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 'Opened' #"
function_barriers = ""
include_barriers = "INCLUDE_BARRIERS"
traversability_scope = "BOTH_JUNCTIONS_AND_EDGES"
propagators = ""

# Run the SetSubnetworkDefinition tool
arcpy.SetSubnetworkDefinition_un(in_utility_network, 
                                 domain_network, 
                                 tier_name, 
                                 support_disjoint_subnetwork, 
                                 valid_devices, 
                                 valid_subnetwork_controller, 
                                 valid_lines, 
                                 aggregated_line, 
                                 diagram_template, 
                                 summaries, 
                                 condition_barriers, 
                                 function_barriers, 
                                 include_barriers, 
                                 traversability_scope, 
                                 propagators)

Environnements

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

Informations de licence

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

Rubriques connexes