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 à celui du propriétaire du réseau de distribution 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 pour pouvoir être exécuté.

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

  • Cet outil peut être utilisé avec l’outil Définir un attribut de réseau, qui affecte 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

    Court

    CocheCoche

    Long

    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 (Entier 16 bits)Le champ est de type court.
  • Long (Entier 32 bits)Le champ est de type long.
  • Double (Virgule flottante 64 bits)Le champ est de type réel double.
  • DateLe champ est de type date.
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 de réseau en ligne définis par l’utilisateur est limité à 25 pour le réseau de distribution. Stockez 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) 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 (court, long).

  • 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 mètres, cet attribut sera réparti sur tous les tronçons, de 20 mètres 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 sera associé. Ce paramètre est requis lorsque l’option 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é dans la version actuelle et toute valeur fournie sera ignorée. La fonctionnalité de ce paramètre est en cours de développement et sera applicable dans une prochaine publication.

Indique si la valeur actuelle stockée dans la topologie sera remplacée à l’aide d’une table de remplacement externe. Ce paramètre peut servir, par exemple, pour saisir des données en temps réel provenant de 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 à utiliser comme 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 mis à jour

Réseau de distribution mis à jour.

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.

  • SHORTLe champ est de type court.
  • LONGLe champ est de type long.
  • DOUBLELe champ est de type réel double.
  • DATELe champ est de type date.
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 de réseau en ligne définis par l’utilisateur est limité à 25 pour le réseau de distribution. Stockez 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) 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 (court, long).

  • 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 mètres, cet attribut sera réparti sur tous les tronçons, de 20 mètres 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 sera associé. Ce paramètre est requis lorsque is_inline est INLINE. 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é dans la version actuelle et toute valeur fournie sera ignorée. La fonctionnalité de ce paramètre est en cours de développement et sera applicable dans une prochaine publication.

Indique si la valeur actuelle stockée dans la topologie sera remplacée à l’aide d’une table de remplacement externe. Ce paramètre peut servir, par exemple, pour saisir des données en temps réel provenant de 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 à utiliser comme 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 de distribution mis à jour.

Utility Network

Exemple de code

Exemple 1 d’utilisation de la fonction 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.un.AddNetworkAttribute("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.un.AddNetworkAttribute("Utility Network", 
                             "Phases", "LONG", "NOT_INLINE", 
                             "NOT_APPORTIONABLE", 
                             "ElectricDistributionDeviceStatus", "", 
                             "NOT_NULLABLE", "SUBSTITUTION", 
                             "Phases current")

Informations de licence

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

Rubriques connexes