Ajouter une règle de traçage (Diagramme de réseau)

Synthèse

Ajoute une règle de diagramme à la séquence de règles spécifiée dans un modèle de diagramme pour exécuter automatiquement un traçage sur un réseau de distribution ou un réseau de traces lors de la génération du diagramme. Les entités de réseau et les objets réseau tracés qui en résultent sont utilisés pour créer le contenu des diagrammes.

Pour en savoir plus sur l’utilisation de la règle de traçage en vue de construire des diagrammes

Attention :

Cet outil est un outil de configuration et d’administration.

Remarque :

Cet outil impacte la cohérence des diagrammes existants basés sur le modèle de diagramme en entrée. Tous les diagrammes existants demeurent incohérents et s’ouvrent avec une icône d’avertissement sur la cohérence Diagramme à mettre à jour jusqu’à leur mise à jour.

Utilisation

  • Cet outil n’est pas pris en charge en cas d’utilisation d’un service de réseau de distribution ou de traces. Vous devez utiliser un réseau de distribution ou un réseau de traces dans une géodatabase fichier ou mobile, ou une connexion de base de données à un réseau de distribution ou de traces dans une géodatabase d’entreprise. Lorsque vous utilisez une géodatabase d’entreprise, tenez compte des exigences suivantes :

  • Avec la règle Traçage, exécutez un traçage à partir des éléments du réseau de distribution ou du réseau de traçage actuellement représentés dans un diagramme.

    Selon le type de traçage indiqué, des points de départ peuvent ou doivent être prédéfinis dans le diagramme pour que la règle de traçage soit appliquée :

    • Pour les types de traçage Connected (Connecté), Subnetwork (Sous-réseau), Upstream (En amont), et Downstream (En aval), tous les éléments du réseau de distribution ou du réseau de traçage actuellement représentés dans le diagramme au démarrage de la règle de traçage sont considérés comme les points de départ du traçage, à moins qu’une règle Définir le point de départ ne soit configurée en amont sur le modèle de diagramme pour identifier clairement des points de départ spécifiques.
    • Pour le traçage de type Shortest path (Plus court chemin), des règles Définir le point de début peuvent être configurées dans le modèle de diagramme pour identifier les deux points de départ parmi tous les éléments du réseau de traces actuellement représentés dans le diagramme entre lesquels le chemin le plus court doit être trouvé.

  • Lorsque vous configurez un modèle basé sur une règle Traçage, le traçage est systématiquement réexécuté sur le réseau de distribution ou le réseau de traces à chaque mise à jour du diagramme. Par conséquent, tout diagramme basé sur ce modèle reflète toujours le résultat actuel de la trace réseau lorsqu’il est mis à jour.

  • À compter de Utility Network version 7, vous pouvez configurer les règles de traçage pour réaliser des opérations de traçage en amont et en aval déterminant le flux à l’aide du sens de numérisation des lignes et l’attribut Flow direction plutôt qu’avec la localisation des contrôleurs de sous-réseau.

  • À compter de Utility Network version 7 et Trace Network version 4, vous pouvez également configurer des règles de traçage en utilisant les configurations de tracé nommées.

Paramètres

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

Réseau de distribution ou de traces contenant le modèle de diagramme à modifier.

Utility Network; Trace Network
Modèle de diagramme en entrée

Nom du modèle de diagramme à modifier.

String
Activé

Précise si la règle est active lors de la génération et de la mise à jour des diagrammes selon le modèle spécifique.

  • Activé : la règle ajoutée devient active pendant la génération et la mise à jour de n’importe quel diagramme selon le modèle en entrée. Il s’agit de l’option par défaut.
  • Désactivé : la règle ajoutée n’est pas active pendant la génération ou la mise à jour de n’importe quel diagramme selon le modèle en entrée.

Boolean
Type de traçage

Indique le type de traçage à exécuter pour générer le contenu du diagramme.

  • ConnectéUn traçage connecté est exécuté à partir des éléments du réseau de distribution ou de traces qui sont actuellement représentés dans le diagramme lorsque la règle commence et s’étend le long des éléments connectés. Il s’agit de l’option par défaut.
  • Sous-réseauUn traçage de sous-réseau est exécuté à partir des éléments de réseau de distribution actuellement représentés dans le diagramme lorsque la règle débute et s’étend vers l’extérieur le long des éléments connectés pour trouver les sources ou les cuvettes à partir desquelles elle s’étend vers l’extérieur le long du sous-réseau associé.
  • En amontUn traçage en amont est exécuté à partir des éléments du réseau de distribution ou de traces qui sont actuellement représentés dans le diagramme lorsque la règle commence à découvrir des éléments en amont.
  • En avalUn traçage en aval est exécuté à partir des éléments du réseau de distribution ou de traces qui sont actuellement représentés dans le diagramme lorsque la règle commence à découvrir des éléments en aval.
  • Plus court cheminUn traçage du chemin le plus court est exécuté à partir des entités de réseau du réseau de distribution ou de traces qui sont actuellement spécifiées comme points de départ dans le diagramme lorsque la règle commence à découvrir les entités le long du chemin le plus court entre ces points de départ. Le coût du parcours du chemin est déterminé en fonction de l’attribut de réseau défini pour la valeur du paramètre Nom d’attribut de réseau du chemin le plus court/path_network_weight_name, quelle que soit la direction du flux.
String
Réseau de domaine
(Facultatif)

Nom des classes de réseau sur lesquelles le traçage sera exécuté pour un réseau de distribution. Ce paramètre est obligatoire lors de l’exécution de traçages de type sous-réseau, en amont et en aval.

String
Niveau
(Facultatif)

Nom du tier au niveau duquel le traçage démarrera pour un réseau de distribution. Ce paramètre est facultatif lors de l’exécution de traçages de type connecté. En revanche, il est requis lors de l’exécution de traçages de type sous-réseau, en amont et en aval.

String
Niveau cible
(Facultatif)

Nom du tier cible vers lequel le tier en entrée circulera pour un réseau de distribution. Si ce paramètre est manquant pour les traçages en amont ou en aval, ils s’arrêteront lorsqu’ils atteignent la limite du sous-réseau de départ. Ce paramètre peut être utilisé pour permettre à ces traçages de poursuivre en haut ou en bas de la hiérarchie.

String
Inclure les structures
(Facultatif)

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

  • Activé : les objets et les entités de structure sont inclus dans les résultats de traçage.
  • Désactivé : 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.

Boolean
Inclure les entités d’interruptions
(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. Ce paramètre ne s’applique pas aux entités de dispositif avec des bornes.

  • Coché - Les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la recherche de parcours. Il s’agit de l’option par défaut.
  • Non coché - Les entités d’interruption de capacité à être traversé ne sont pas incluses dans les résultats de la recherche de parcours.

Boolean
Interruptions conditionnelles
(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 (Nom) : filtrez selon une catégorie de réseau ou un attribut de réseau défini dans le système.
  • Operator (Opérateur) : choisissez un des opérateurs.
  • Type (Type) : choisissez une valeur spécifique ou un attribut de réseau à partir de la valeur spécifiée dans le paramètre Name (Nom).
  • Value (Valeur) : 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.
  • Combine using (Utilisation combinée) : définissez cette valeur si vous voulez ajouter plusieurs attributs. Vous pouvez les combiner avec une condition And (Et) ou Or (Ou).

Les options de valeurs Operator (Opérateur) des interruptions conditionnelles sont les suivantes :

  • Est égal à : l’attribut est égal à la valeur.
  • Est différent de : l’attribut est différent de la valeur.
  • Est supérieur à : l’attribut est supérieur à la valeur.
  • Est supérieur ou égal à : l’attribut est supérieur ou égal à la valeur.
  • Est inférieur à : l’attribut est inférieur à la valeur.
  • Est inférieur ou égal à : l’attribut est inférieur ou égal à la valeur.
  • Includes the values (Inclut les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • Does not include the values (N’inclut pas les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • Includes any (Inclut tout) : opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • Does not include any (N’inclut aucune valeur) : opération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

Les options de la valeur Type d'interruptions conditionnelles sont les suivantes :

  • Valeur spécifique : filtrez en fonction d’une valeur spécifique.
  • Attribut de réseau : filtrez en fonction d’un attribut de réseau.

Value Table
Interruptions de fonctions
(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 (Fonction) : choisissez une des fonctions de calcul.
  • Attribute (Attribut) : filtrez selon un attribut de réseau défini dans le système.
  • Operator (Opérateur) : choisissez un des opérateurs.
  • Value (Valeur) : valeur spécifique du type d’attribut en entrée qui, en cas d’identification, entraînera l’arrêt.
  • Use Local Values (Utiliser les valeurs locales) : calculez les valeurs dans chaque sens, et non une valeur globale générale. Par exemple, une interruption de fonction qui calcule la somme de Shape length où le traçage s’arrête si la valeur est supérieure ou égale à 4. Dans le cas des valeurs globales, si vous avez traversé deux tronçons ayant une valeur égale à 2, vous avez déjà atteint une somme Shape length de 4 ; par conséquent, le traçage prend fin. Lorsque des valeurs locales sont utilisées, celles-ci changent le long de chaque chemin et le traçage se poursuit.
    • Coché - Les valeurs locales sont utilisées.
    • Décoché - Les valeurs globales sont utilisées. Il s’agit de l’option par défaut.

Les options de la valeur Function (Fonction) de l’interruption de fonction sont les suivantes :

  • Minimum : minimum des valeurs en entrée.
  • Maximum : maximum des valeurs en entrée.
  • Add (Somme) : somme des valeurs en entrée.
  • Average : la moyenne des valeurs en entrée.
  • Count : le nombre d'entités.
  • Substract : la différence entre les valeurs en entrée.

    Les contrôleurs de sous-réseau et les types de traçage 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 options de la valeur Operator (Opérateur) de l’interruption de fonction sont les suivantes :

  • Est égal à : l’attribut est égal à la valeur.
  • Est différent de : l’attribut est différent de la valeur.
  • Est supérieur à : l’attribut est supérieur à la valeur.
  • Est supérieur ou égal à : l’attribut est supérieur ou égal à la valeur.
  • Est inférieur à : l’attribut est inférieur à la valeur.
  • Est inférieur ou égal à : l’attribut est inférieur ou égal à la valeur.
  • Includes the values (Inclut les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • Does not include the values (N’inclut pas les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • Includes any (Inclut tout) : opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • Does not include any (N’inclut aucune valeur) : opération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

Value Table
Appliquer la traversabilité à
(Facultatif)

Spécifie le type de traversabilité qui sera appliqué. La portée de traversabilité détermine si la traversabilité est appliquée aux jonctions, aux tronçons, ou aux deux. Si, par exemple, une interruption conditionnelle est définie pour arrêter le parcours 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 parcours ne s’interrompt pas même s’il détecte un dispositif 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 edges (Jonctions et tronçons) - La capacité à être traversé s’applique aux jonctions et aux tronçons.
  • Junctions only (Jonctions uniquement) - La capacité à être traversé s’applique uniquement aux jonctions.
  • Edges only (Tronçons uniquement) - La capacité à être traversé s’applique uniquement aux tronçons.

  • Jonctions et tronçonsLa capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • Jonctions uniquementLa capacité à être traversé s’applique uniquement aux jonctions.
  • Tronçons uniquementLa capacité à être traversé s’applique uniquement aux tronçons.
String
Filtrer par interruptions
(Facultatif)

Spécifie si le traçage s’interrompt pour une catégorie spécifique ou un attribut de réseau. Par exemple, arrêtez une recherche de parcours au niveau des entités qui ont un attribut de statut de cycle de vie égal à une valeur certaine. Ce paramètre est utilisé pour définir une entité de terminaison selon une valeur d’un attribut de réseau défini dans le système. Si plusieurs attributs sont utilisés, vous pouvez utiliser le paramètre Combine using (Utilisation combinée) pour définir une condition Et ou une condition Ou.

Les composants du Filtre d'interruption sont les suivants :

  • Nom : filtrez par catégorie ou par un attribut de réseau défini dans le système.
  • Operator (Opérateur) : Choisissez à partir de plusieurs opérateurs.
  • Type (Type) : Choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le paramètre Name (Nom).
  • Value (Valeur)—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.
  • Combiner avec : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez combiner ces attributs à l’aide d’une condition Et ou Ou.

Les options de la valeur Operator (Opérateur) des Filtres d'interruption sont les suivantes :

  • Est égal à : l’attribut est égal à la valeur.
  • Est différent de : l’attribut est différent de la valeur.
  • Est supérieur à : l’attribut est supérieur à la valeur.
  • Est supérieur ou égal à : l’attribut est supérieur ou égal à la valeur.
  • Est inférieur à : l’attribut est inférieur à la valeur.
  • Est inférieur ou égal à : l’attribut est inférieur ou égal à la valeur.
  • Includes the values (Inclut les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • Does not include the values (N’inclut pas les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • Includes any (Inclut tout) : opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • Does not include any (N’inclut aucune valeur) : opération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

Les options de la valeur Type des Filtres d'interruption sont les suivantes :

  • Valeur spécifique : filtrez en fonction d’une valeur spécifique.
  • Attribut de réseau : filtrez en fonction d’un attribut de réseau.

Value Table
Filtrer par fonctions d’interruption
(Facultatif)

Filtre les résultats du traçage pour une catégorie spécifique.

Les composants du Filtre par fonctions d'interruption sont les suivants :

  • Fonction : choisissez un nombre de différents fonction de calcul.
  • Attribute (Attribut) : filtrez par un attribut de réseau défini dans le système.
  • Operator (Opérateur) : Choisissez à partir de plusieurs opérateurs.
  • Value (Valeur)—Fournit une valeur spécifique du type d'attribut en entrée qui, si découverte, entraîne l'arrêt.
  • Use Local Values (Utiliser les valeurs locales) : calcule les valeurs dans chaque direction par opposition à une valeur globale. Considérons, par exemple, une interruption de fonction qui calcule la somme de Shape length à laquelle le traçage s’interrompt 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 aurez atteint une somme de longueur de forme égale à 4, de sorte que la recherche de parcours s’arrête. Si les valeurs locales sont utilisées, les valeurs locales le long de chaque chemin changent, ou la trace continue.
    • Coché - Les valeurs locales sont utilisées.
    • Décoché - Les valeurs globales sont utilisées. Il s’agit de l’option par défaut.

Les options de la valeur Function (Fonction) du filtre des interruptions de fonction sont les suivantes :

  • Minimum : le minimum des valeurs en entrée sera utilisé.
  • Maximum : le maximum des valeurs en entrée sera utilisé.
  • Somme : la somme des valeurs sera utilisée.
  • Moyenne : la moyenne des valeurs en entrée sera utilisée.
  • Nombre : le nombre d'entités sera utilisé.
  • Soustraction : la différence entre les valeurs sera utilisée. Les contrôleurs de sous-réseau et les types de trace de boucle ne permettent pas d'utiliser la fonction de soustraction.

Par exemple, il y a une entité de points de début avec une valeur de 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction Minimum, le résultat est de 20. Le résultat est de 30 pour Maximum, de 50 pour Add (Ajouter), de 25 pour Average (Moyenne), de 2 pour Count (Nombre) et de -10 pour Substract (Soustraire).

Les options de la valeur Operator (Opérateur) du filtre des interruptions de fonction sont les suivantes :

  • Est égal à : l’attribut est égal à la valeur.
  • Est différent de : l’attribut est différent de la valeur.
  • Est supérieur à : l’attribut est supérieur à la valeur.
  • Est supérieur ou égal à : l’attribut est supérieur ou égal à la valeur.
  • Est inférieur à : l’attribut est inférieur à la valeur.
  • Est inférieur ou égal à : l’attribut est inférieur ou égal à la valeur.
  • Includes the values (Inclut les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • Does not include the values (N’inclut pas les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • Includes any (Inclut tout) : opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • Does not include any (N’inclut aucune valeur) : opération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

Value Table
Appliquer le filtre à
(Facultatif)

Spécifie si le filtre pour une catégorie spécifique est forcé aux jonctions, aux tronçons ou les deux. Si, par exemple, une interruption de filtre est définie pour arrêter la trace 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, la trace ne s’interrompt pas même si elle détecte un dispositif 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 pas : les jonctions, tronçons, ou les deux à la fois.

  • Both junctions and edges (Jonctions et tronçons) : le filtre s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • Junctions only (Jonctions uniquement) : le filtre s’applique uniquement aux jonctions.
  • Edges only (Tronçons uniquement) : le filtre s’applique uniquement aux tronçons.

  • Jonctions et tronçonsLe filtre s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • Jonctions uniquementLe filtre s’applique uniquement aux jonctions.
  • Tronçons uniquementLe filtre s’applique uniquement aux tronçons.
String
Filtrer en fonction de l’attribut de réseau bitset
(Facultatif)

Nom de l’attribut de réseau à utiliser pour filtrer par bitset. Ce paramètre ne s'applique qu'aux traçages de type en amont, en aval ou boucles. Ce paramètre peut être utilisé pour ajouter une logique spéciale pendant un traçage de telle sorte qu’il reflète davantage les scénarios réels. Par exemple, pour un traçage de boucles, l'attribut de réseau Phases - Courant peut déterminer si la boucle est une véritable boucle électrique (la même phase est énergisée tout autour de la boucle, à savoir, A) et ne renvoie que des boucles électriques réelles pour les résultats du traçage. Exemple d’un traçage en amont : lors du traçage d’un réseau de distribution électrique, précisez un attribut de réseau Phases - Courant, pour que les résultats du traçage n’incluent que les chemins valides spécifiés dans l’attribut de réseau, et pas tous les chemins.

String
Filtrer par proximité
(Facultatif)

Indique si l’algorithme k-nearest neighbors (k voisins les plus proches) est utilisé pour renvoyer plusieurs entités d’un certain type dans une distance donnée. Vous pouvez fournir un nombre et un coût, ainsi qu’un ensemble de catégories, un type de ressource ou ces deux éléments.

  • Coché : l’algorithme k-nearest neighbors (k voisins les plus proches) est utilisé pour renvoyer un certain nombre d’entités comme indiqué dans les paramètres Count (Nombre), Cost Network Attribute (Attribut de réseau de coût), Nearest Categories (Catégories les plus proches) ou Nearest Asset Groups/Types (Groupes/types d’actifs les plus proches).
  • Non cochée : l’algorithme k-nearest neighbors (k voisins les plus proches) n’est pas utilisé pour filtrer les résultats. Il s’agit de l’option par défaut.

Boolean
Total
(Facultatif)

Nombre d’entités à renvoyer lorsque l’option Filter by nearest (Filtrer par proximité) est cochée.

Long
Attribut de réseau de coût
(Facultatif)

Attribut de réseau numérique à utiliser pour calculer la proximité, le coût ou la distance lorsque l’option Filtrer par proximité est cochée (par exemple, Longueur de forme).

String
Catégories les plus proches
(Facultatif)

Catégories à renvoyer lorsque l’option Filtrer par proximité est cochée (par exemple, Protection).

String
Types/Groupes de ressources les plus proches
(Facultatif)

Groupes d’actifs et types d’actifs à renvoyer lorsque l’option Filter by nearest (Filtrer par proximité) est cochée—par exemple, ElectricDistributionDevice/Transformer/Step Down.

String
Propagateurs
(Facultatif)
  • Est égal àL’attribut est égal à la valeur.
  • Est différent deL’attribut est différent de la valeur.
  • Est supérieur àL’attribut est supérieur à la valeur.
  • Est supérieur ou égal àL’attribut est supérieur ou égal à la valeur.
  • Est inférieur àL’attribut est inférieur à la valeur.
  • Est inférieur ou égal àL’attribut est inférieur ou égal à la valeur.
  • Inclut les valeurs (l'opération Et bit à bit est égale à la valeur)Opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l'attribut (Et bit à bit == valeur).
  • N'inclut pas les valeurs (l'opération Et bit à bit n'est pas égale à la valeur)Opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l'attribut (Et bit à bit !== valeur).
  • Inclut tout (l'opération Et bit à bit est égale à Vrai)Opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l'attribut (Et bit à bit == Vrai).
  • N'inclut aucune valeur (l'opération Et bit à bit est égale à Faux)Opération Et bit à bit dans laquelle aucun des bits de la valeur n'est présent dans l'attribut (Et bit à bit == Faux).
Value Table
Description
(Facultatif)

Description de la règle.

String
Allow Indeterminate Flow (Autoriser le flux indéterminé)
(Facultatif)

Indique si les entités du réseau de traces dont le flux est indéterminé ou non initialisé sont tracées. Ce paramètre est respecté uniquement lors de l’exécution du traçage en amont ou en aval sur un réseau de traces.

  • Activé ‎: les entités du réseau de traces dont le traçage présente un sens de flux non initialisé ou indéterminé ne seront pas incluses.
  • Désactivé ‎: les entités du réseau de traces dont le traçage présente un sens de flux non initialisé ou indéterminé ne seront pas incluses. Il s’agit de l’option par défaut.

Boolean
Path Direction (Direction du chemin)
(Facultatif)

Indique la direction du chemin pour un réseau de traçages. Le coût du parcours du chemin est déterminé en fonction de la valeur du paramètre Shortest Path Network Attribut Name (Nom de l’attribut de réseau du chemin le plus court). Ce paramètre est respecté uniquement lors de l’exécution d’une trace de type Shortest path (Chemin le plus court).

  • NO_DIRECTIONLe chemin reliera les deux points de départ, quel que soit le sens de flux. Il s’agit de l’option par défaut.
  • PATH_UPSTREAMLa direction du chemin sera en aval entre les deux points de départ.
  • PATH_DOWNSTREAMLa direction du chemin sera en amont entre les deux points de départ.
String
Nom d’attribut de réseau du chemin le plus court
(Facultatif)

Attribut de réseau qui sera utilisé pour calculer le chemin d’un réseau de distribution ou réseau de traçage. Lors de l’exécution d’un type de traçage du chemin le plus court, ce chemin est calculé à l’aide d’un attribut de réseau numérique comme la longueur de forme. Les chemins basés sur le coût et la distance peuvent être atteints. Ce paramètre est requis lors de l’exécution d’un traçage de chemin de type Court.

String
Utiliser une configuration de trace
(Facultatif)

Indique si une configuration de tracé nommée existante est utilisée pour définir les propriétés du traçage. Ce paramètre est seulement disponible et actif pour Utility Network version 7 et ultérieure.

  • Activé : une configuration de trace nommée existante est utilisée pour définir les propriétés de la trace.
  • Désactivé : aucune configuration de trace nommée existante n’est utilisée pour définir les propriétés de la trace. Il s’agit de l’option par défaut.

Boolean
Nom de la configuration de trace
(Facultatif)

Nom de la configuration de trace nommée existante qui est utilisée pour définir les propriétés de la trace. Ce paramètre n’est actif que si l’option Utiliser la configuration de tracé est sélectionnée.

String
Utiliser le sens de numérisation
(Facultatif)

Indique si les opérations de traçage en amont et attribut déterminent le flux à l’aide du sens de numérisation de la ligne et l’attribut Flow direction. Ce paramètre est seulement disponible et actif pour Utility Network version 7 et ultérieure lorsque le paramètre Type de traçage est défini sur l’option En amont ou En aval.

  • Activé : les opérations de traçage déterminent la direction de flux à l’aide du sens de numérisation de la ligne et l’attribut de direction de flux. Lorsque cette option est activée, les paramètres Réseau de domaine, Niveau et Niveau cible sont masqués et ignorés.
  • Désactivé : les opérations de traçage déterminent la direction de flux en se basant sur l’emplacement des contrôleurs de sous-réseaux. Il s’agit de l’option par défaut.

Remarque :

Ce paramètre requiert ArcGIS Enterprise 11.3 ou version ultérieure si vous utilisez une géodatabase d’entreprise.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Réseau en sortie

Le réseau technique ou réseau de traces mis à jour.

Utility Network; Trace Network
Modèle de diagramme en sortie

Nom du modèle de diagramme.

String

arcpy.nd.AddTraceRule(in_utility_network, template_name, is_active, trace_type, {domain_network}, {tier}, {target_tier}, {include_structures}, {include_barriers}, {condition_barriers}, {function_barriers}, {traversability_scope}, {filter_barriers}, {filter_function_barriers}, {filter_scope}, {filter_bitset_network_attribute_name}, {filter_nearest}, {nearest_count}, {nearest_cost_network_attribute}, {nearest_categories}, {nearest_assets}, {propagators}, {description}, {allow_indeterminate_flow}, {path_direction}, {path_network_weight_name}, {use_trace_config}, {trace_config_name}, {use_digitized_direction})
NomExplicationType de données
in_utility_network

Réseau de distribution ou de traces contenant le modèle de diagramme à modifier.

Utility Network; Trace Network
template_name

Nom du modèle de diagramme à modifier.

String
is_active

Précise si la règle est activée lors de la génération et de la mise à jour des diagrammes selon le modèle spécifique.

  • ACTIVELa règle ajoutée est activée pendant la génération et la mise à jour de n’importe quel diagramme selon le modèle en entrée. Il s’agit de l’option par défaut.
  • INACTIVELa règle ajoutée n’est pas activée pendant la génération ou la mise à jour de n’importe quel diagramme selon le modèle en entrée.
Boolean
trace_type

Indique le type de traçage à exécuter pour générer le contenu du diagramme.

  • CONNECTEDUn traçage connecté est exécuté à partir des éléments du réseau de distribution ou de traces qui sont actuellement représentés dans le diagramme lorsque la règle commence et s’étend le long des éléments connectés. Il s’agit de l’option par défaut.
  • SUBNETWORKUn traçage de sous-réseau est exécuté à partir des éléments de réseau de distribution actuellement représentés dans le diagramme lorsque la règle débute et s’étend vers l’extérieur le long des éléments connectés pour trouver les sources ou les cuvettes à partir desquelles elle s’étend vers l’extérieur le long du sous-réseau associé.
  • UPSTREAMUn traçage en amont est exécuté à partir des éléments du réseau de distribution ou de traces qui sont actuellement représentés dans le diagramme lorsque la règle commence à découvrir des éléments en amont.
  • DOWNSTREAMUn traçage en aval est exécuté à partir des éléments du réseau de distribution ou de traces qui sont actuellement représentés dans le diagramme lorsque la règle commence à découvrir des éléments en aval.
  • SHORTEST_PATHUn traçage du chemin le plus court est exécuté à partir des entités de réseau du réseau de distribution ou de traces qui sont actuellement spécifiées comme points de départ dans le diagramme lorsque la règle commence à découvrir les entités le long du chemin le plus court entre ces points de départ. Le coût du parcours du chemin est déterminé en fonction de l’attribut de réseau défini pour la valeur du paramètre Nom d’attribut de réseau du chemin le plus court/path_network_weight_name, quelle que soit la direction du flux.
String
domain_network
(Facultatif)

Nom des classes de réseau sur lesquelles le traçage sera exécuté pour un réseau de distribution. Ce paramètre est obligatoire lors de l’exécution de traçages de type sous-réseau, en amont et en aval.

String
tier
(Facultatif)

Nom du tier au niveau duquel le traçage démarrera pour un réseau de distribution. Ce paramètre est facultatif lors de l’exécution de traçages de type connecté. En revanche, il est requis lors de l’exécution de traçages de type sous-réseau, en amont et en aval.

String
target_tier
(Facultatif)

Nom du tier cible vers lequel le tier en entrée circulera pour un réseau de distribution. Si ce paramètre est manquant pour les traçages en amont ou en aval, ils s’arrêteront lorsqu’ils atteignent la limite du sous-réseau de départ. Ce paramètre peut être utilisé pour permettre à ces traçages de poursuivre en haut ou en bas de la hiérarchie.

String
include_structures
(Facultatif)

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

  • INCLUDE_STRUCTURESLes objets et les entités de structure sont inclus dans les résultats de traçage.
  • EXCLUDE_STRUCTURESLes 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.
Boolean
include_barriers
(Facultatif)

Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la trace. Les interruptions de traversabilité sont facultatives même si elles ont été prédéfinies dans la définition de sous-réseau. Ce paramètre ne s’applique pas aux entités de dispositif avec des bornes.

  • INCLUDE_BARRIERSLes entités d’interruption de capacité à être traversé sont incluses dans les résultats de traçage. Il s’agit de l’option par défaut.
  • EXCLUDE_BARRIERSLes entités d’interruption de capacité à être traversé ne sont pas incluses dans les résultats de traçage.
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 de l'interruption conditionnelle sont les suivants :

  • Name : filtrez par n’importe quel attribut de réseau défini dans le système.
  • 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 : 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.
  • Combine Using : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez combiner ces attributs à l’aide d’une condition Et ou Ou.

Les options des valeurs operator d’interruptions conditionnelles 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 dans laquelle 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 dans laquelle tous les bits de la valeur ne sont pas présents dans l'attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle 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 dans laquelle 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 options des valeurs Combine Using d'interruptions conditionnelles sont les suivantes :

  • ANDCombinez les interruptions conditionnelles.
  • ORUtilisez ce paramètre si l’une des interruptions conditionnelles est satisfaite.
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 de l'interruption fonctionnelle sont les suivants :

  • Function : effectuez votre sélection parmi plusieurs fonctions de calcul différentes.
  • Attribute : filtrez par n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez un nombre de différents opérateurs.
  • Value : fournit une valeur spécifique du type d’attribut en entrée qui, si découverte, entraîne l’arrêt.
  • Use Local Values : calcule les valeurs dans chaque direction, par opposition à une valeur globale générale. Considérons, par exemple, une interruption de fonction qui calcule la somme de Shape length à laquelle le traçage s’interrompt 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 aurez atteint une somme de longueur de forme égale à 4, de sorte que la recherche de parcours s’arrête. Si les valeurs locales sont utilisées, les valeurs locales le long de chaque chemin changent, et la trace continue.

Les valeurs des options Function d'interruptions de fonctions sont les suivantes :

  • AVERAGELa moyenne des valeurs en entrée sera utilisée.
  • COUNTLe nombre d’entités sera utilisé.
  • MAXLe maximum des valeurs en entrée sera utilisé.
  • MINLe minimum des valeurs en entrée sera utilisé.
  • ADDLa somme des valeurs sera utilisée.
  • SUBTRACTLa différence entre les valeurs sera utilisée. Les contrôleurs de sous-réseau et les types de trace de boucle ne permettent pas d'utiliser 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 dans laquelle 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 dans laquelle tous les bits de la valeur ne sont pas présents dans l'attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle 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 dans laquelle 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 d’interruption de fonctions de Use Local Values sont les suivantes :

  • TRUELes valeurs locales sont utilisées.
  • FALSELes valeurs globales sont utilisées. Il s’agit de l’option par défaut.
Value Table
traversability_scope
(Facultatif)

Le type de traversabilité qui sera appliqué. La portée de la capacité à être traversé détermine si la capacité à être traversé est appliquée aux jonctions, tronçons, ou aux deux. Imaginons une interruption conditionnelle définie pour mettre fin au traçage du parcours si État du périphérique est réglé sur Ouvert avec la portée de traversabilité réglée sur les tronçons uniquement. Si le traçage détecte un dispositif ouvert, il ne s’interrompt pas, car É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 pas : les jonctions, tronçons, ou les deux à la fois.

  • 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
filter_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Facultatif)

Spécifie si un traçage s’interrompt pour une catégorie spécifique ou un attribut de réseau. Par exemple, arrêtez une recherche de parcours au niveau des entités qui ont un attribut de statut de cycle de vie égal à une valeur certaine. Ce paramètre est utilisé pour définir une entité de terminaison selon une valeur d’un attribut de réseau défini dans le système. Si vous utilisez plusieurs attributs, vous pouvez utiliser l’option Combine Using pour définir une condition Et ou Ou.

Les composants du Filtre d'interruption sont les suivants :

  • Name : filtrez par catégorie ou par attribut de réseau défini dans le système.
  • 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 : 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 combiner ces attributs à l’aide d’une condition Et ou Ou.

Les options des valeurs Operator des filtres par interruptions 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 dans laquelle 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 dans laquelle tous les bits de la valeur ne sont pas présents dans l'attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle 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 dans laquelle 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 des filtres par interruptions sont les suivantes :

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

Les options des valeurs Combine Using des filtres par interruptions sont les suivantes :

  • ANDCombinez les interruptions conditionnelles.
  • ORUtilisez ce paramètre si l’une des interruptions conditionnelles est satisfaite.
Value Table
filter_function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(Facultatif)

Filtre les résultats du traçage pour une catégorie spécifique.

Les composants du Filtre par fonctions d'interruption sont les suivants :

  • Function : effectuez votre sélection parmi plusieurs fonctions de calcul différentes.
  • Attribute : filtrez par n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez un nombre de différents opérateurs.
  • Value : fournit une valeur spécifique du type d’attribut en entrée qui, si découverte, entraîne l’arrêt.
  • Use Local Values : calcule les valeurs dans chaque direction, par opposition à une valeur globale générale. Considérons, par exemple, une interruption de fonction qui calcule la somme de Shape length à laquelle le traçage s’interrompt 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 aurez atteint une somme de longueur de forme égale à 4, de sorte que la recherche de parcours s’arrête. Si les valeurs locales sont utilisées, les valeurs locales le long de chaque chemin changent, ou la trace continue.

Les options de la valeur Function du filtre des interruptions de fonction sont les suivantes :

  • AVERAGELa moyenne des valeurs en entrée sera utilisée.
  • COUNTLe nombre d’entités sera utilisé.
  • MAXLe maximum des valeurs en entrée sera utilisé.
  • MINLe minimum des valeurs en entrée sera utilisé.
  • ADDLa somme des valeurs sera utilisée.
  • SUBTRACTLa différence entre les valeurs sera utilisée. Les contrôleurs de sous-réseau et les types de trace de boucle ne permettent pas d'utiliser la fonction de soustraction.

Les options de la valeur Operator du filtre des interruptions de fonction 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 dans laquelle 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 dans laquelle tous les bits de la valeur ne sont pas présents dans l'attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle 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 dans laquelle 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 d’interruption de fonctions de Use Local Values sont les suivantes :

  • TRUELes valeurs locales sont utilisées.
  • FALSELes valeurs globales sont utilisées. Il s’agit de l’option par défaut.
Value Table
filter_scope
(Facultatif)

Spécifie si le filtre pour une catégorie spécifique est forcé aux jonctions, aux tronçons ou les deux. Si, par exemple, une interruption de filtre est définie pour arrêter la trace 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, la trace ne s’interrompt pas même si elle détecte un dispositif 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 pas : les jonctions, tronçons, ou les deux à la fois.

  • BOTH_JUNCTIONS_AND_EDGESLe filtre s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • JUNCTIONS_ONLYLe filtre s’applique uniquement aux jonctions.
  • EDGES_ONLYLe filtre s’applique uniquement aux tronçons.
String
filter_bitset_network_attribute_name
(Facultatif)

Nom de l’attribut de réseau à utiliser pour filtrer par bitset. Ce paramètre ne s'applique qu'aux traçages de type en amont, en aval ou boucles. Ce paramètre peut être utilisé pour ajouter une logique spéciale pendant un traçage de telle sorte qu’il reflète davantage les scénarios réels. Par exemple, pour un traçage de boucles, l'attribut de réseau Phases - Courant peut déterminer si la boucle est une véritable boucle électrique (la même phase est énergisée tout autour de la boucle, à savoir, A) et ne renvoie que des boucles électriques réelles pour les résultats du traçage. Exemple d’un traçage en amont : lors du traçage d’un réseau de distribution électrique, précisez un attribut de réseau Phases - Courant, pour que les résultats du traçage n’incluent que les chemins valides spécifiés dans l’attribut de réseau, et pas tous les chemins.

String
filter_nearest
(Facultatif)

Indique si l’algorithme k-nearest neighbors (k voisins les plus proches) est utilisé pour renvoyer plusieurs entités d’un certain type dans une distance donnée. Vous pouvez fournir un nombre et un coût, ainsi qu’un ensemble de catégories, un type de ressource ou ces deux éléments.

  • FILTER_BY_NEARESTL’algorithme k voisins les plus proches est utilisé pour renvoyer un certain nombre d’entités comme spécifié dans les paramètres nearest_count, nearest_cost_network_attribute, nearest_categories ou nearest_assets.
  • DO_NOT_FILTERL’algorithme k-nearest neighbors (k voisins les plus proches) n’est pas utilisé pour filtrer les résultats. Il s’agit de l’option par défaut.
Boolean
nearest_count
(Facultatif)

Nombre d’entités à renvoyer lorsque filter_nearest est défini sur FILTER_BY_NEAREST.

Long
nearest_cost_network_attribute
(Facultatif)

Attribut de réseau numérique à utiliser pour calculer la proximité, le coût ou la distance lorsque filter_nearest est défini sur FILTER_BY_NEAREST (par exemple, Longueur de forme).

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

Catégories à renvoyer lorsque filter_nearest est défini sur FILTER_BY_NEAREST (par exemple, Protection).

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

Groupes d’actifs et types d’actifs à renvoyer lorsque filter_nearest est défini sur FILTER_BY_NEAREST (par exemple, ElectricDistributionDevice/Transformer/Step Down).

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 : procédez à un filtrage en fonction d’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 l’une des fonctions de calcul.
  • Operator : choisissez l’un des opérateurs.
  • Value : indiquez la valeur spécifique pour le type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.

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

  • PROPAGATED_BITWISE_ANDLa comparaison des valeurs se fera entre une entité et la suivante.
  • PROPAGATED_MINLa valeur minimale sera propagée.
  • PROPAGATED_MAXLa valeur maximale sera propagée.

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 dans laquelle 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 dans laquelle tous les bits de la valeur ne sont pas présents dans l'attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle 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 dans laquelle 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
description
(Facultatif)

Description de la règle.

String
allow_indeterminate_flow
(Facultatif)

Indique si les entités du réseau de traçage dont le flux est indéterminé ou non initialisé sont tracées. Ce paramètre est respecté uniquement lors de l’exécution de traçages de type en amont ou en aval.

  • TRACE_INDETERMINATE_FLOWLes entités du réseau de traçages dont le traçage présente un sens de flux non initialisé ou indéterminé seront incluses.
  • IGNORE_INDETERMINATE_FLOWLes entités du réseau de traçages dont le traçage présente un sens de flux non initialisé ou indéterminé ne seront pas incluses. Il s’agit de l’option par défaut.
Boolean
path_direction
(Facultatif)

Indique la direction du chemin pour un réseau de traçages. Le coût du parcours du chemin est déterminé en fonction de la valeur du paramètre path_network_weight_name. Ce paramètre est respecté uniquement lors de l’exécution d’un traçage de type SHORTEST_PATH.

  • NO_DIRECTIONLe chemin reliera les deux points de départ, quel que soit le sens de flux. Il s’agit de l’option par défaut.
  • PATH_UPSTREAMLa direction du chemin sera en aval entre les deux points de départ.
  • PATH_DOWNSTREAMLa direction du chemin sera en amont entre les deux points de départ.
String
path_network_weight_name
(Facultatif)

Attribut de réseau qui sera utilisé pour calculer le chemin d’un réseau de distribution ou réseau de traçage. Lors de l’exécution d’un type de traçage du chemin le plus court, ce chemin est calculé à l’aide d’un attribut de réseau numérique comme la longueur de forme. Les chemins basés sur le coût et la distance peuvent être atteints. Ce paramètre est requis lors de l’exécution d’un traçage de chemin de type Court.

String
use_trace_config
(Facultatif)

Indique si une configuration de tracé nommée existante est utilisée pour définir les propriétés du traçage. Ce paramètre est seulement activé pour Utility Network version 7 et ultérieure.

  • USE_TRACE_CONFIGURATIONUne configuration de trace nommée existante est utilisée pour définir les propriétés de la trace.
  • DO_NOT_USE_TRACE_CONFIGURATIONAucune configuration de trace nommée existante n’est utilisée pour définir les propriétés de la trace. Il s’agit de l’option par défaut.
Boolean
trace_config_name
(Facultatif)

Nom de la configuration de trace nommée existante qui est utilisée pour définir les propriétés de la trace. Ce paramètre n’est activé que si le paramètre use_trace_config est défini sur USE_TRACE_CONFIGURATION.

String
use_digitized_direction
(Facultatif)

Indique si les opérations de traçage en amont et attribut déterminent le flux à l’aide du sens de numérisation de la ligne et l’attribut Flow direction. Ce paramètre est seulement disponible et actif pour Utility Network version 7 et ultérieure lorsque le paramètre trace_type est défini sur l’option UPSTREAM ou DOWNSTREAM.

  • USE_DIGITIZED_DIRECTIONLes opérations de traçage déterminent la direction de flux à l’aide du sens de numérisation de la ligne et l’attribut de direction de flux. Grâce à cette option, les paramètres domain_network, tier et target_tier sont ignorés.
  • IGNORE_DIGITIZED_DIRECTIONLes opérations de traçage déterminent la direction de flux en se basant sur l’emplacement des contrôleurs de sous-réseaux. Il s’agit de l’option par défaut.
Remarque :
Ce paramètre requiert ArcGIS Enterprise 11.3 ou version ultérieure si vous utilisez une géodatabase d’entreprise.
Boolean

Sortie obtenue

NomExplicationType de données
out_utility_network

Le réseau technique ou réseau de traces mis à jour.

Utility Network; Trace Network
out_template_name

Nom du modèle de diagramme.

String

Exemple de code

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

Ajoutez une règle de traçage au modèle MyTemplate1 existant dans un réseau donné pour générer les diagrammes depuis le traçage sur les sous-réseaux au sein du niveau Moyenne tension du domaine ElectricDistribution.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"

arcpy.nd.AddTraceRule(input_Network, input_DiagramTemplate, "ACTIVE", 
                      "SUBNETWORK", "ElectricDistribution", "Medium Voltage", 
                      "Low Voltage Mesh")

Environnements

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

Informations de licence

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

Rubriques connexes