Ajouter un attribut de réseau (Utility Network)

Synthèse

Ajoute un attribut de réseau à un réseau de distribution.

Un attribut de réseau est une valeur issue des attributs des entités correspondantes sur le réseau et est enregistré dans la topologie de réseau. Les attributs de réseau sont utilisés par une analyse de traçage pour gérer la manière dont le réseau peut être traversé. Alors qu’un attribut de réseau n’est associé qu’à un seul attribut d’une classe d'entités, un réseau de distribution peut avoir un nombre illimité d’attributs de réseau. Les attributs de réseau peuvent être également utilisés en tant que pondérations pour gérer la traversabilité et pour modéliser le coût des chemins dans le réseau.

Utilisation

  • Un attribut réseau ne peut être associé qu'à un attribut sur une classe d'entités ; toutefois, il peut être associé à plusieurs classes d'entités.

  • Si une géodatabase d’entreprise est utilisée, le compte de portail ArcGIS Enterprise connecté doit correspondre au propriétaire du propriétaire du réseau technique du portail.

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

  • Si une géodatabase d’entreprise est utilisée, cet outil doit être connecté à la version par défaut, au moment de son exécution.

  • Si une géodatabase d’entreprise est utilisée, le paramètre Input Utility Network (Réseau technique en entrée) doit provenir d’une connexion de base de données établie en tant que propriétaire du réseau technique de la base de données.

  • Cet outil peut être utilisé avec l’outil Définir un attribut de réseau, qui est utilisé pour attribuer l'attribut de réseau à un champ de classe d’entités dans le réseau de distribution.

  • La table suivante liste les types d'attribut réseau et leurs paramètres :

    Type d'attributEn ligneRépartisAccepte les valeurs nullesSubstitution

    Courte

    CocheCoche

    Longue

    CocheCocheCoche

    (Hors ligne uniquement)

    Double

    CocheCoche

    Date

    Coche

Paramètres

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

Le réseau de distribution d'entrée où l'attribut réseau est ajouté.

Utility Network; Utility Network Layer
Nom de l’attribut

Nom de l’attribut de réseau à ajouter au réseau de distribution.

String
Type d'attribut

Spécifie le type de données de l’attribut de réseau.

  • Court (petit entier)Type Court (petit entier)
  • Long (grand entier)Type Long (grand entier)
  • Double (double précision)Type Double (double précision)
  • DateType de données
String
En ligne
(Facultatif)

Spécifie si l'attribut de réseau sera conservé en ligne ou pas. Les attributs de réseau en ligne sont un peu plus efficaces, mais le nombre de bits pour les attributs en ligne est limité à 28 pour le réseau de distribution. Les attributs de réseau les plus souvent utilisés (par exemple, la phase des réseaux électriques, la pression des réseaux de distribution de gaz et d'eau) doivent être stockés en ligne, si possible. La taille des bits est déterminée par le paramètre de domaine. Les attributs en ligne ne sont compatibles qu'avec les attributs de réseau d’entiers.

  • Cochée—L'attribut sera ajouté en interne à la topologie, rendant la récupération beaucoup plus efficace.
  • Non cochée : L'attribut sera stocké dans un tableau externe, et la récupération exigera un appel au tableau de pondérations externes. Il s’agit de l’option par défaut.
Boolean
Répartis
(Facultatif)

Spécifie si l’attribut de réseau sera réparti sur plusieurs tronçons appartenant à la même entité.

Les attributs de réseau présentant une propriété de répartition peuvent être attribués à des champs de classe d’entités linéaires ou jonctions, mais seules les entités linéaires permettent le comportement réparti.

Par exemple, avec l’attribut de réseau shape_length, si une entité linéaire est constituée de cinq éléments de tronçon, et si la longueur totale de cette entité linéaire est de 100 pieds, cet attribut sera réparti sur tous les tronçons, de 20 pieds chacun. La distribution de la valeur dépend du pourcentage le long de chaque tronçon par rapport au point d’origine de l’entité d’origine.

  • Activé : l’attribut de réseau est réparti.
  • Désactivé : l’attribut de réseau n’est pas réparti. Il s’agit de l’option par défaut.
Boolean
Nom du domaine
(Facultatif)

Domaine avec lequel l’attribut de réseau doit être associé. Ce paramètre est requis lorsque l’option In Line (En ligne) est cochée. Ce domaine est utilisé pour déterminer le nombre de bits à allouer à l'attribut en ligne et doit être une valeur de type codée. Par exemple, le domaine LifeCycleStatusDomain (0, Unknown | 1, In-Service | 2, Proposed | 3, Abandoned) a quatre entrées, ce qui signifie que 2 bits sont nécessaires pour enregistrer l'attribut en ligne. Le domaine de la valeur codée doit avoir des codes séquentiels commençant par 0.

String
Est réinscriptible
(Facultatif)
Remarque :

Ce paramètre n’est pas utilisé et toute valeur saisie sera ignorée pour la publication actuelle. La fonctionnalité de ce paramètre est en cours de développement et sera applicable dans une prochaine publication.

Spécifie si un attribut de réseau a une table de remplacement externe à partir de laquelle la topologie de réseau lit et réinscrit (ou remplace) la valeur actuelle stockée dans la topologie. Ceci peut servir pour les données en temps réel en entrée depuis les systèmes externes, comme la position actuelle dans le cas d’une valeur électrique ou de pression pour le gaz. Par exemple, un système SCADA avançant les positions de commutation mises à jour du Device A (Dispositif A) vers la table de remplacement de l’attribut de réseau DeviceStatus, que le moteur de topologie utilise ensuite pour remplacer sa valeur actuelle du statut du dispositif pour le Device A (Dispositif A) avec la valeur de remplacement.

  • Activé : la valeur actuelle stockée dans la topologie est remplacée.
  • Désactivé : la valeur actuelle stockée dans la topologie n’est pas remplacée. Il s’agit de l’option par défaut.
Boolean
Accepte les valeurs nulles
(Facultatif)

Précise si l’attribut de réseau accepte les valeurs nulles.

  • Activé : l’attribut de réseau est compatible avec les valeurs nulles.
  • Désactivé : l’attribut de réseau n’est pas compatible avec les valeurs nulles. Il s’agit de l’option par défaut.

Boolean
Substitution
(Facultatif)

Précise si l’attribut de réseau doit être utilisé en substitution. Les attributs de réseau de substitution permettent d’utiliser une valeur substituée plutôt que des valeurs d'attribut de réseau bitset à propager dans une opération de traçage.

  • Activé : l’attribut de réseau est utilisé en substitution.
  • Désactivé : l’attribut de réseau n’est pas utilisé en substitution. Il s’agit de l’option par défaut.

Boolean
Attribut de réseau à substituer
(Facultatif)

Attribut de réseau utilisé pour substitution. Les substitutions sont encodées selon le nombre de bits dans l'attribut de réseau en cours de propagation. L'attribut de réseau doit être en ligne et un type de champ entier inférieur ou égal à 8 bits.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Réseau de distribution actualisé

Réseau technique actualisé.

Utility Network

arcpy.un.AddNetworkAttribute(in_utility_network, attribute_name, attribute_type, {is_inline}, {is_apportionable}, {domain}, {is_overridable}, {is_nullable}, {is_substitution}, {network_attribute_to_substitute})
NomExplicationType de données
in_utility_network

Le réseau de distribution d'entrée où l'attribut réseau est ajouté.

Utility Network; Utility Network Layer
attribute_name

Nom de l’attribut de réseau à ajouter au réseau de distribution.

String
attribute_type

Spécifie le type de données de l’attribut de réseau.

  • SHORTType Court (petit entier)
  • LONGType Long (grand entier)
  • DOUBLEType Double (double précision)
  • DATEType de données
String
is_inline
(Facultatif)

Spécifie si l'attribut de réseau sera conservé en ligne ou pas. Les attributs de réseau en ligne sont un peu plus efficaces, mais le nombre de bits pour les attributs en ligne est limité à 28 pour le réseau de distribution. Les attributs de réseau les plus souvent utilisés (par exemple, la phase des réseaux électriques, la pression des réseaux de distribution de gaz et d'eau) doivent être stockés en ligne, si possible. La taille des bits est déterminée par le paramètre de domaine. Les attributs en ligne ne sont pas compatibles qu'avec les attributs de réseau d’entiers.

  • INLINEL'attribut sera ajouté en interne à la topologie, rendant la récupération plus efficace.
  • NOT_INLINEL'attribut sera stocké dans un tableau externe, et la récupération exigera un appel au tableau de pondérations externes. Il s’agit de l’option par défaut.
Boolean
is_apportionable
(Facultatif)

Spécifie si l’attribut de réseau sera réparti sur plusieurs tronçons appartenant à la même entité.

Par exemple, avec l’attribut de réseau shape_length, si une entité linéaire est constituée de cinq éléments de tronçon, et si la longueur totale de cette entité linéaire est de 100 pieds, cet attribut sera réparti sur tous les tronçons, de 20 pieds chacun. La distribution de la valeur dépend du pourcentage le long de chaque tronçon par rapport au point d’origine de l’entité d’origine.

  • APPORTIONABLEL’attribut de réseau est réparti.
  • NOT_APPORTIONABLEL’attribut de réseau n’est pas réparti. Il s’agit de l’option par défaut.
Boolean
domain
(Facultatif)

Domaine avec lequel l’attribut de réseau doit être associé. Ce paramètre est requis lorsque is_inline est True. Ce domaine est utilisé pour déterminer le nombre de bits à allouer à l'attribut en ligne et doit être une valeur de type codée. Par exemple, le domaine LifeCycleStatusDomain (0, Unknown | 1, In-Service | 2, Proposed | 3, Abandoned) a quatre entrées, ce qui signifie que 2 bits sont nécessaires pour enregistrer l'attribut en ligne. Le domaine de la valeur codée doit avoir des codes séquentiels commençant par 0.

String
is_overridable
(Facultatif)

Remarque :

Ce paramètre n’est pas utilisé et toute valeur saisie sera ignorée pour la publication actuelle. La fonctionnalité de ce paramètre est en cours de développement et sera applicable dans une prochaine publication.

Spécifie si un attribut de réseau a une table de remplacement externe à partir de laquelle la topologie de réseau lit et réinscrit (ou remplace) la valeur actuelle stockée dans la topologie. Ceci peut servir pour les données en temps réel en entrée depuis les systèmes externes, comme la position actuelle dans le cas d’une valeur électrique ou de pression pour le gaz. Par exemple, un système SCADA avançant les positions de commutation mises à jour du Device A (Dispositif A) vers la table de remplacement de l’attribut de réseau DeviceStatus, que le moteur de topologie utilise ensuite pour remplacer sa valeur actuelle du statut du dispositif pour le Device A (Dispositif A) avec la valeur de remplacement.

  • OVERRIDELa valeur actuelle stockée dans la topologie est remplacée.
  • NOT_OVERRIDABLELa valeur actuelle stockée dans la topologie n’est pas remplacée. Il s’agit de l'option par défaut.
Boolean
is_nullable
(Facultatif)

Précise si l’attribut de réseau accepte les valeurs nulles.

  • NULLABLEL’attribut de réseau est compatible avec les valeurs nulles.
  • NOT_NULLABLEL’attribut de réseau n’est pas compatible avec les valeurs nulles. Il s’agit de l’option par défaut.
Boolean
is_substitution
(Facultatif)

Précise si l’attribut de réseau doit être utilisé en substitution. Les attributs de réseau de substitution permettent d’utiliser une valeur substituée plutôt que des valeurs d'attribut de réseau bitset à propager dans une opération de traçage.

  • SUBSTITUTIONL’attribut de réseau est utilisé en substitution.
  • NOT_SUBSTITUTIONL’attribut de réseau n’est pas utilisé en substitution. Il s’agit de l’option par défaut.
Boolean
network_attribute_to_substitute
(Facultatif)

Attribut de réseau utilisé pour substitution. Les substitutions sont encodées selon le nombre de bits dans l'attribut de réseau en cours de propagation. L'attribut de réseau doit être en ligne et un type de champ entier inférieur ou égal à 8 bits.

String

Sortie obtenue

NomExplicationType de données
out_utility_network

Réseau technique actualisé.

Utility Network

Exemple de code

Exemple 1 d'utilisation de l'outil AddNetworkAttribute (fenêtre Python)

Ajoute un attribut de réseau intitulé Device Status(Statut de dispositif) avec un attribut de type Court.

import arcpy
arcpy.AddNetworkAttribute_un("Utility Network", "Device Status", "SHORT", 
                             "INLINE", "NOT_APPORTIONABLE", "", 
                             "ElectricDistributionDeviceStatus", 
                             "NOT_OVERRIDABLE")
Exemple 2 d'utilisation de l'outil AddNetworkAttribute (fenêtre Python)

Ajoutez un attribut de réseau à utiliser pour substitution.

import arcpy
arcpy.AddNetworkAttribute_un("Utility Network", 
                             "Phases", "LONG", "NOT_INLINE", 
                             "NOT_APPORTIONABLE", 
                             "ElectricDistributionDeviceStatus", "", 
                             "NOT_NULLABLE", "SUBSTITUTION", 
                             "Phases current")

Environnements

Cas particuliers

Informations de licence

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

Rubriques connexes