Mettre à jour un sous-réseau (Utility Network)

Résumé

Met à jour les informations sur le sous-réseau dans la table Subnetworks, la classe d’entités SubnetLine et les diagrammes système de sous-réseau pour les sous-réseaux spécifiés. De plus, certains attributs sont créés ou mis à jour pour les entités de sous-réseau. Un enregistrement pour tout nouveau sous-réseau sera généré, les enregistrements de tout sous-réseau effacé seront supprimés ; la forme et les informations de tout sous-réseau modifié seront actualisées.

En savoir plus sur la procédure de mise à jour des sous-réseaux

Utilisation

  • Si une géodatabase d’entreprise est utilisée, les conditions suivantes doivent être remplies :

    • Le réseau de distribution doit être inscrit en tant que branche versionnée.
    • Le réseau de distribution en entrée doit provenir d’un service de réseau de distribution.
    • Si cet outil est exécuté sur la version par défaut, la géométrie, l’attribut d’un nom de sous-réseau et les champs propagés de la classe d’entités SubnetLine sont mis à jour sur place. S’il est exécuté sur une version nommée, le comportement par défaut (sans événements) limite la mise à jour aux entités et aux objets modifiés dans la version. Le mode de mise à jour peut être modifié pour que les événements soient utilisés (avec événements). Cette option exécute le comportement de la géodatabase et peut être définie dans la configuration du sous-réseau pour la version par défaut et les versions nommées. En savoir plus sur le mode de mise à jour utilisé par l’outil Mettre à jour un sous-réseau

  • Cet outil crée ou met à jour les diagrammes de réseau pour les sous-réseaux actualisés si un modèle de diagramme a été spécifié lors de la configuration de la définition du sous-réseau.

  • Toute mise à jour doit être enregistrée avant d’exécuter l’outil.

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

  • Il n’existe aucune zone à valider sectionnant les entités de sous-réseau.

Syntaxe

arcpy.un.UpdateSubnetwork(in_utility_network, domain_network, tier, {all_subnetworks_in_tier}, {subnetwork_name}, {continue_on_failure}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators})
ParamètreExplicationType de données
in_utility_network

Réseau de distribution qui contient le sous-réseau.

Utility Network; Utility Network Layer
domain_network

Réseau de domaine contenant le sous-réseau.

String
tier

Niveau contenant le sous-réseau.

String
all_subnetworks_in_tier
(Facultatif)

Détermine si tous les sous-réseaux figurant dans le niveau sont mise à jour. Pour mettre à jour un sous-ensemble de sous-réseaux dans le niveau, utilisez le paramètre subnetwork_name.

  • ALL_SUBNETWORKS_IN_TIERMet à jour tous les sous-réseaux figurant dans le niveau. Cet option utilise un traitement asynchrone pour mettre à jour les sous-réseaux utilisant le système UtilityNetworkTools de service de géotraitement. Ce service est réservé aux tâches de géotraitement du réseau de distribution et bénéficie d’un paramètre de délai d’expiration plus long par défaut. Il s’agit de l’option par défaut.
  • SPECIFIC_SUBNETWORKMet à jour seulement les sous-réseaux spécifiés par le paramètre subnetwork_name.
Boolean
subnetwork_name
(Facultatif)

Nom des sous-réseaux à mettre à jour. Si tous les sous-réseaux sont mis à jour à l’aide du paramètre all_subnetworks_in_tier, ce paramètre est ignoré.

String
continue_on_failure
(Facultatif)

Indique s’il convient d’arrêter ou non le processus lorsque la mise à jour d’un sous-réseau échoue lors de la mise à jour de plusieurs sous-réseaux.

  • CONTINUE_ON_FAILURELa mise à jour des sous-réseaux se poursuit après l’échec.
  • STOP_ON_FAILURELa mise à jour des sous-réseaux s’interrompt en cas d’échec. Il s’agit de l’option par défaut.
Boolean
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—Choisissez pour filtrer par n’importe quel attribut de réseau.
  • Operator : Choisissez un nombre de différents 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 : définissez 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 options d’interruption 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_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 type d’interruption conditionnelle 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.
Remarque :

Ce paramètre est uniquement disponible via Python.

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 entre plusieurs fonctions de calcul différentes.
  • Attribute—Choisissez pour filtrer par n’importe quel attribut de réseau.
  • Operator : Choisissez un nombre de différents opérateurs.
  • Value : définissez une valeur spécifique du type d’attribut en entrée susceptible, si découverte, d’entraîner l'arrêt.
  • Use Local Values : calculez les valeurs dans chaque sens par rapport à la valeur globale générale ; par exemple, pour une interruption de fonction calculant la somme de Shape length 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 va plus loin.

  • TRUEUtilisez les valeurs locales.
  • FALSEUtilisez les valeurs globales. Il s’agit de l’option par défaut.

Les valeurs possibles pour les 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.
  • ADDAjoutez les valeurs.
  • SUBTRACTSoustrayez les valeurs. Les contrôleurs de sous-réseau et les types de traçages de boucles ne prennent pas en charge la fonction de soustraction.

Considérons, par exemple, une entité de point de début dont la valeur est 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction Minimum, le résultat est de 20, le maximum est de 30, la somme est de 50, la moyenne est de 25, le nombre est de 2, et la différence est de -10.

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).
Remarque :

Ce paramètre est uniquement disponible via Python.

Value Table
include_barriers
(Facultatif)

Spécifie si les entités d’interruption de traversabilité 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 traversabilité sont incluses dans les résultats de la recherche de parcours. Il s’agit de l’option par défaut.
  • EXCLUDE_BARRIERSLes interruptions de traversabilité ne sont pas incluses dans les résultats du traçage.
Remarque :

Ce paramètre est uniquement disponible via Python et ModelBuilder.

Boolean
traversability_scope
(Facultatif)

Spécifie le 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 parcours lorsque DEVICESTATUS est égal à Open avec la portée de traversabilité réglée sur les tronçons uniquement, alors le parcours ne s’interrompt pas même s’il détecte un dispositif ouvert. En effet, DEVICESTATUS 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_EDGESAppliquez la traversabilité aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • JUNCTIONS_ONLYAppliquez la traversabilité aux jonctions uniquement.
  • EDGES_ONLYAppliquez la traversabilité aux tronçons uniquement.
Remarque :

Ce paramètre est uniquement disponible via Python et ModelBuilder.

String
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value],...]
(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 encodé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 apparier 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 à la valeur nulle et non l’inverse (c’est-à-dire que la phase A n’est pas appariée à la valeur nulle 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.

Les valeurs possibles pour les propagateurs function 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 valeurs operator du propagateur 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).
Remarque :

Ce paramètre est uniquement disponible via Python et ModelBuilder.

Value Table

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 UpdateSubnetwork (fenêtre Python)

Mettez à jour un sous-réseau spécifique nommé RMT004.

import arcpy
arcpy.UpdateSubnetwork_un("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "SPECIFIC_SUBNETWORK", "RMT004", 
                          "CONTINUE_ON_FAILURE")
Exemple 2 d’utilisation de l’outil UpdateSubnetwork (fenêtre Python)

Mettez à jour tous les sous-réseaux figurant dans le niveau Medium Voltage.

import arcpy
arcpy.UpdateSubnetwork_un("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "ALL")

Environnements

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

Informations de licence

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

Rubriques connexes