Traçage (Utility Network)

Synthèse

Renvoie les entités de réseau d’un réseau de distribution selon la connectivité ou la capacité à être traversé depuis les points de départ spécifiés.

Les fonctionnalités de traçage du réseau de distribution vous permettent d’analyser les chemins dans un réseau. La traversabilité se réfère aux chemins établis par les entités connectées ou associées qui répondent également aux exigences de configuration.

Par défaut, les résultats du traçage sont renvoyés en tant que sélection et incluent l’intégralité de l’entité linéaire. Pour renvoyer des résultats d’entités partiels qui respectent les localisations de traçage placées sur un tronçon, comme des points de départ et des interruptions, définissez le paramètre Result Types (Types de résultats) sur Aggregate Geometry (Agréger la géométrie). Les localisations de traçage placées à mi-portée sur un objet tronçon permettent de renvoyer des géométries partielles lorsque les objets tronçon constituent le contenu d’une entité linéaire ; pour cela, utilisez le paramètre Synthesize Geometries (Synthétiser les géométries).

Avec l’option Aggregated Geometry (Géométrie agrégée), les points de départ placés sur un tronçon renvoient l’élément de tronçon de la jonction précédente avec une extrémité ou une connectivité à mi-portée. Lorsqu’une interruption est placée sur un tronçon avec le paramètre Include Barrier Features (Inclure les entités d’interruption) activé, le traçage s’arrête à la jonction suivante rencontrée avec une connectivité à mi-portée ou la ligne se termine. Si le paramètre Include Barrier Features (Inclure les entités d’interruption) est désactivé, le traçage s’arrête à la jonction précédente rencontrée avec une connectivité à mi-portée ou la ligne précédente se termine.

Vous pouvez alors propager l’ensemble de sélection ou la classe d’entités en sortie obtenus par le traçage à une autre carte ou à une vue de diagramme du réseau, ou l’utiliser comme entrée pour un autre outil ou un autre traçage.

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

Utilisation

  • La topologie du réseau doit être activée. Étant donné que l’outil Traçage repose sur la topologie du réseau, il est possible que les résultats d’un traçage manquent de précision si des zones à valider sont tracées. La topologie du réseau pour la zone à tracer doit être validée pour refléter les modifications ou les mises à jour les plus récentes apportées au réseau.

  • Si une géodatabase d’entreprise est utilisée, le réseau technique en entrée doit correspondre à un service du réseau technique.

  • Lorsqu’un traçage basé sur un sous-réseau est exécuté dans un réseau de domaine traditionnel à l’aide de l’outil Traçage via Python, la configuration du traçage de sous-réseau pour le niveau en entrée n’est pas appliquée automatiquement et doit être spécifiée manuellement.

  • Lorsque vous utilisez des attributs de réseau affectés à un champ de date pour les filtres d’interruption, les filtres par fonctions d’interruption, les fonctions et les conditions de sortie, la valeur de date doit avoir le format yyyy-mm-dd hh:mm:ss (par exemple, 2020-10-12 18:45:31).

Paramètres

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

Réseau technique pour lequel le traçage sera effectué. Lorsque vous utilisez une géodatabase d’entreprise, le réseau technique doit provenir d’un service d’entités ; les réseaux techniques issus d’une connexion à une base de données ne sont pas pris en charge.

Utility Network; Utility Network Layer
Type de traçage

Spécifie le type de traçage à utiliser.

  • ConnectéUn traçage connecté qui commence à un ou plusieurs points de départ et s’étend le long des entités connectées est utilisé. Il s’agit de l’option par défaut.
  • Sous-réseauUn tracé de sous-réseau qui commence à un ou plusieurs points de départ et s’étend pour englober le sous-réseau est utilisé. Cette option est prise en charge pour les réseaux de domaine traditionnels uniquement.
  • Contrôleurs de sous-réseauxUn tracé des contrôleurs de sous-réseaux qui localise les sources et les cuvettes des contrôleurs de sous-réseaux associés à un sous-réseau est utilisé. Cette option est prise en charge pour les réseaux de domaine traditionnels uniquement.
  • En amontUn traçage en amont qui découvre les entités en amont d’une localisation dans le réseau est utilisé. Cette option est prise en charge pour les réseaux de domaine traditionnels uniquement, sauf si le paramètre Use Digitized Direction (Utiliser le sens de numérisation) est activé.
  • En avalUn traçage en aval qui découvre les entités en aval d’une localisation dans le réseau est utilisé. Cette option est prise en charge pour les réseaux de domaine traditionnels uniquement, sauf si le paramètre Use Digitized Direction (Utiliser le sens de numérisation) est activé.
  • BouclesUn traçage des boucles qui s’étend vers l’extérieur à partir du point de départ en fonction de la connectivité est utilisé. Les boucles sont des zones du réseau où la direction du flux est ambiguë.
  • Plus court cheminUn traçage du chemin le plus court qui identifie le chemin le plus court entre deux points de départ est utilisé.
  • IsolementUn traçage d’isolement identifiant les entités qui isolent une surface d’un réseau est utilisé. Cette option est prise en charge pour les réseaux de domaine traditionnels uniquement.
String
Points de début
(Facultatif)

Couche d’entités créée dans l’onglet Start (Départ) de la fenêtre Trace (Traçage), ou table ou classe d’entités contenant un ou plusieurs enregistrements qui représentent les points de départ du traçage. Cette table ou classe d’entités doit inclure le champ FEATUREGLOBALID pour stocker les informations relatives à l’entité de réseau associée. La classe d’entités UN_Temp_Starting_Points située dans la géodatabase par défaut du projet est utilisée par défaut.

Feature Layer; Table View
Interruptions
(Facultatif)

Couche d’entités créée dans l’onglet Barriers (Interruptions) de la fenêtre Trace (Traçage), ou table ou classe d’entités contenant un ou plusieurs enregistrements représentant les interruptions qui empêchent le traçage d’aller au-delà de ce point. Cette table ou classe d’entités doit inclure le champ FEATUREGLOBALID pour stocker les informations relatives à l’entité de réseau associée. La classe d’entités UN_Temp_Barriers située dans la géodatabase par défaut du projet est utilisée par défaut.

Feature Layer; Table View
Réseau de domaine
(Facultatif)

Le nom du réseau du domaine sur lequel la trace sera exécutée. Ce paramètre est obligatoire lors de l’exécution du sous-réseau, des contrôleurs de sous-réseaux, des types de traçage en amont et en aval.

String
Niveau
(Facultatif)

Nom du niveau d’un réseau de domaine traditionnel auquel débute le tracé. Ce paramètre est obligatoire lors de l’exécution du sous-réseau, des contrôleurs de sous-réseaux, des types de traçage en amont et en aval.

String
Niveau cible
(Facultatif)

Nom du niveau cible d’un réseau de domaine traditionnel vers lequel le niveau en entrée circule dans un tracé directionnel. Si ce paramètre n’est pas spécifié pour les traçages en amont et en aval, ceux-ci s’arrêtent une fois qu’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
Nom de sous-réseau
(Facultatif)

Nom du sous-réseau d’un réseau de domaine traditionnel sur lequel le traçage est exécuté. Ce paramètre peut être utilisé lors de l’exécution d’un type de traçage de sous-réseau. Si le nom d’un sous-réseau est spécifié, le paramètre Starting Points (Points de départ) n’est pas obligatoire. Lorsque la table de sous-réseaux contient au moins 10 000 enregistrements pour un niveau, la liste de sélection du paramètre n’est pas renseignée et un champ vide est proposé pour le nom du sous-réseau.

String
Nom d’attribut de réseau du chemin le plus court
(Facultatif)

Attribut de réseau utilisé pour calculer le chemin le plus court. 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
Inclure les containers
(Facultatif)

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

  • Cochée : les entités de conteneur sont incluses dans les résultats de traçage. Le paramètre Include up to First Spatial Container (Inclure jusqu’au premier conteneur spatial) devient actif.
  • Non cochée : les entités de conteneur ne sont pas incluses dans les résultats de traçage. Il s’agit de l’option par défaut.

Boolean
Include Content (Inclure le contenu)
(Facultatif)

Indique si le contenu des entités de conteneur est inclus dans les résultats de traçage.

  • Cochée : le contenu des entités de conteneur est inclus dans les résultats de traçage.
  • Non cochée : le contenu des entités de conteneur n’est pas inclus dans les résultats de traçage. Il s’agit de l’option par défaut.

Boolean
Inclure les structures
(Facultatif)

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

  • Coché : les objets et les entités de structure sont inclus dans les résultats de la trace.
  • Non coché : les objets et les entités de structure ne sont pas inclus dans les résultats de la trace. Il s’agit de l’option par défaut.

Boolean
Inclure les entités d’interruption
(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
Valider la cohérence
(Facultatif)

Indique si une erreur est renvoyée lorsque des zones à valider figurent dans les entités renvoyées. C’est la seule façon de garantir qu’un traçage passe via des entités avec un statut cohérent dans le réseau. Pour supprimer les zones à valider, validez la topologie de réseau.

  • Activé : le traçage renvoie une erreur si des zones à valider figurent dans les entités renvoyées.
  • Désactivé : le traçage renvoie des résultats, que des zones à valider figurent ou non dans les entités renvoyées. Il s’agit de l’option par défaut.

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 du réseau ou une catégorie de réseau, un opérateur et un type, ainsi qu’une valeur d’attribut. 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 :

  • Nom : filtrez selon un attribut de réseau défini dans le système ou sélectionnez Category pour utiliser une catégorie de réseau.
  • Opérateur : choisissez un des opérateurs.
  • Type : sélectionnez Specific value ou Network attribute comme type de valeur du paramètre Nom qui sert d’interruption. Le paramètre Type doit être défini sur Specific value lorsque le paramètre Nom a pour valeur Category.
  • Valeur : fournit une valeur spécifique de l’attribut ou de la catégorie 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 conditions à ajouter. Vous pouvez les combiner à l’aide d’une condition Et ou 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 ou d’une catégorie de réseau 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 de l'interruption fonctionnelle sont les suivants :

  • Fonction : choisissez une des fonctions de calcul.
  • Attribute (Attribut) : filtrez par un attribut de réseau défini dans le système.
  • Opérateur : choisissez un des 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) : 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. Si les valeurs locales sont utilisées, les valeurs locales le long de chaque chemin changent, et 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) 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 trace de boucle ne permettent pas d'utiliser 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 si la traversabilité (capacité à être traversé) 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.

  • Jonctions et tronçonsLa traversabilité s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • Jonctions uniquementLa traversabilité s’applique uniquement aux jonctions.
  • Tronçons uniquementLa traversabilité s’applique uniquement aux tronçons.
String
Filtrer par interruptions
(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 (Combiner en utilisant) pour définir une condition And (Et) ou une condition Or (Ou).

Les composants du Filtre d'interruption sont les suivants :

  • Name (Nom) : filtrez par catégorie ou en fonction de n’importe quel 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 (Combiner en utilisant) : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez les combiner en utilisant une condition And (Et) ou une condition Or (Ou).

Les options des valeurs Operator (Opérateur) des filtres d’interruptions 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 :

  • Specific value (Valeur spécifique) : filtrez en fonction d’une valeur spécifique.
  • Network Attribute (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 :

  • 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) : calcule les valeurs dans chaque direction par opposition à une valeur globale. Considérons, par exemple, une interruption de fonction qui calcule la somme de longueur de forme à 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 avez déjà atteint une somme de longueur de forme égale à 4 de sorte que le traçage 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. Il s’agit de l’option par défaut.
    • Décoché - Les valeurs globales sont utilisées.

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

  • Minimum : le nombre minimum de valeurs en entrée est identifié.
  • Maximum : le nombre maximum de valeurs en entrée est identifié.
  • Add (Ajouter) : la somme des valeurs est calculée.
  • Average (Moyenne) : la moyenne des valeurs en entrée est calculée.
  • Count (Nombre) : le nombre d’entités est identifié.
  • Substract (Soustraire) : la différence entre les valeurs est calculé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épart dont la valeur est 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction Minimum, le résultat est égal à 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 des valeurs Operator (Opérateur) des filtres par fonctions d’interruption sont les suivantes :

  • Is equal to (Est égal à) : l’attribut est égal à la valeur.
  • Does not equal (Est différent de) : l’attribut est différent de la valeur.
  • Is greater than (Est supérieur à) : l’attribut est supérieur à la valeur.
  • Is greater than or equal to (Est supérieur ou égal à) : l’attribut est supérieur ou égal à la valeur.
  • Is less than (Est inférieur à) : l’attribut est inférieur à la valeur.
  • Is less than or equal to (Est inférieur ou égal à) : l’attribut est inférieur ou égal à la valeur.
  • Includes the values (Inclut les valeurs) : opération AND (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 AND (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 AND (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 AND (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, un filtre d’interruption est défini pour arrêter la trace lorsque le paramètre Device Status (Statut du dispositif) a la valeur Open (Ouvert) et que la portée de la traversabilité est définie sur les tronçons uniquement, la trace ne s’interrompt pas même si elle détecte un dispositif ouvert, car le statut du dispositif 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) : 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 indiquer un nombre et un coût, ainsi qu’un ensemble de catégories, un type de ressource ou ces deux éléments.

  • Cochée : 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
Effectif
(Facultatif)

Nombre d’entités renvoyées lorsque l’option Filter by nearest (Filtrer par proximité) est activé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 Filter by nearest (Filtrer par proximité) est activée (par exemple, Shape length [Longueur de forme]).

String
Catégories les plus proches
(Facultatif)

Catégories à renvoyer lorsque l’option Filter by nearest (Filtrer par proximité) est activée (par exemple, Protective [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
Fonctions
(Facultatif)

Fonction(s) de calcul appliquée(s) aux résultats du traçage.

Les composants des fonction 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.
  • Filter Name (Nom du filtre) : filtrez les résultats de la fonction par nom d’attribut.
  • Filter Operator (Opérateur de filtrage) : choisissez un des opérateurs.
  • Filter Type (Type de filtre) : choisissez un des types de filtre.
  • Filter Value (Valeur de filtrage) : fournissez une valeur spécifique de l’attribut de filtrage en entrée.

Les options de la valeur Fonction sont les suivantes :

  • Average (Moyenne) : la moyenne des valeurs en entrée est calculée.
  • Count (Nombre) : le nombre d’entités est identifié.
  • Maximum : le nombre maximum de valeurs en entrée est identifié.
  • Minimum : le nombre minimum de valeurs en entrée est identifié.
  • Add (Ajouter) : la somme des valeurs en entrée est calculée.
  • Substract (Soustraire) : la différence entre les valeurs en entrée est calculé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épart 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 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 des valeurs Filter Operator (Opérateur de filtrage) des fonctions sont les suivantes :

  • Is equal to (Est égal à) : l’attribut est égal à la valeur.
  • Does not equal (Est différent de) : l’attribut est différent de la valeur.
  • Is greater than (Est supérieur à) : l’attribut est supérieur à la valeur.
  • Is greater than or equal to (Est supérieur ou égal à) : l’attribut est supérieur ou égal à la valeur.
  • Is less than (Est inférieur à) : l’attribut est inférieur à la valeur.
  • Is less than or equal to (Est inférieur ou égal à) : l’attribut est inférieur ou égal à la valeur.
  • Includes the values (Inclut les valeurs) : opération AND (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 AND (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 AND (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 AND (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 valeur de Filter Type (Type de filtrage) des fonctions sont les suivantes :

  • Specific value (Valeur spécifique) : filtrez en fonction d’une valeur spécifique.
  • Network Attribute (Attribut de réseau) : filtrez en fonction d’un attribut de réseau.

  • MoyenneLa moyenne des valeurs en entrée est calculée.
  • EffectifLe nombre d’entités est identifié.
  • MaximumLe nombre maximum de valeurs en entrée est identifié.
  • MinimumLe nombre minimum de valeurs en entrée est identifié.
  • AdditionLa somme des valeurs en entrée est calculée.
  • SoustraireLa différence entre les valeurs en entrée est calculé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.
Value Table
Propagateurs
(Facultatif)

Spécifie les attributs de réseau à propager, ainsi que la manière dont cette propagation doit être effectuée pendant un traçage dans un réseau de domaine traditionnel. 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 des propagateurs sont les suivants :

  • Attribute : filtrez par n’importe quel 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 une cartographie 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 options de valeur Function pour les propagateurs sont les suivantes :

Les options de valeur Operator pour les propagateurs sont les suivantes :

En savoir plus sur les opérateurs bit à bit

  • 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 AND (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 AND (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 AND (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 AND (Et) bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).
Remarque :

Ce paramètre est uniquement disponible pour Python.

Value Table
Types de ressources en sortie
(Facultatif)

Filtre les types de ressources en sortie à inclure dans les résultats (par exemple, retourner uniquement les transformateurs aériens).

String
Conditions de sortie
(Facultatif)

Types des entités qui sont renvoyées en fonction d’un attribut de réseau ou d’une catégorie. Par exemple, une trace configurée pour filtrer toutes les entités sauf les entités Dérivation, toute entité tracée à laquelle la catégorie Dérivation n’est pas attribuée, n’est pas incluse dans les résultats. Toute entité tracée qui n’est pas renvoyée dans l’ensemble de sélections résultant.

Les composants des Conditions de sortie sont les suivants :

  • Name (Nom) : filtrez selon 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 des valeurs Operator (Opérateur) des conditions de sortie sont les suivantes :

  • Is equal to (Est égal à) : l’attribut est égal à la valeur.
  • Does not equal (Est différent de) : l’attribut est différent de la valeur.
  • Is greater than (Est supérieur à) : l’attribut est supérieur à la valeur.
  • Is greater than or equal to (Est supérieur ou égal à) : l’attribut est supérieur ou égal à la valeur.
  • Is less than (Est inférieur à) : l’attribut est inférieur à la valeur.
  • Is less than or equal to (Est inférieur ou égal à) : l’attribut est inférieur ou égal à la valeur.
  • Includes the values (Inclut les valeurs) : opération AND (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 AND (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 AND (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 AND (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 Conditions de sortie sont les suivantes :

  • Specific value (Valeur spécifique) : filtrez en fonction d’une valeur spécifique.
  • Network Attribute (Attribut de réseau) : filtrez en fonction d’un attribut de réseau.

Value Table
Inclure les entités isolées
(Facultatif)

Indique si les entités isolées sont incluses dans les résultats de traçage avec un réseau de domaine traditionnel. Ce paramètre est utilisé uniquement lors de l’exécution d’un traçage d’isolement.

  • Cochée : les entités isolées sont incluses dans les résultats de traçage.
  • Non cochée : les entités isolées ne sont pas incluses dans les résultats de traçage. Il s’agit de l’option par défaut.

Boolean
Ignore Barriers At Starting Points (Ignorer les interruptions aux points de début)
(Facultatif)

Spécifie si les interruptions dynamiques dans la configuration de tracé sont ignorées pour les points de départ. Cela peut être utile lorsque vous effectuez un parcours de dispositifs de protection en amont et que vous utilisez les dispositifs de protection (interruptions) détectés comme points de début pour rechercher les dispositifs de protection en amont suivants.

  • Activé : les interruptions aux points de début sont ignorées dans le traçage.
  • Désactivé : les interruptions aux points de début ne sont pas ignorées dans le traçage. Il s’agit de l’option par défaut.

Boolean
Inclure jusqu’au premier conteneur spatial
(Facultatif)

Indique si les conteneurs retournés se limitent ou non à ceux rencontrés jusqu’au premier conteneur spatial (inclus) pour chaque élément de réseau dans les résultats de traçage. Si aucun conteneur spatial n’est rencontré, mais que des conteneurs non spatiaux sont présents pour un élément de réseau donné, tous les conteneurs non spatiaux sont inclus dans les résultats. Ce paramètre n’est actif que si l’option Include Containers (Inclure les conteneurs) est activée.

  • Activé : seuls les conteneurs rencontrés jusqu’au premier conteneur spatial (inclus) figurent dans les résultats lorsque des associations d’inclusions imbriquées sont rencontrées le long du chemin de traçage. S’il n’existe aucun conteneur spatial, tous les conteneurs non spatiaux sont inclus dans les résultats d’un élément de réseau donné.
  • Non cochée : tous les conteneurs sont retournés dans les résultats. Il s’agit de l’option par défaut.
Boolean
Type de résultat
(Facultatif)

Spécifie le type de résultat renvoyé par le traçage.

  • SélectionLes résultats du traçage sont renvoyés en tant qu’ensemble de sélection des entités de réseau appropriées. Il s’agit de l’option par défaut.
  • Géométrie agrégéeLes résultats du traçage sont agrégés par type de géométrie et stockés dans les classes d’entités multi-parties affichées sur les couches de la carte active.
  • ConnectivitéLes résultats du traçage sont renvoyés sous forme de graphe de connectivité dans un fichier .json en sortie spécifié pour les entités de réseau traversées. Cette option active les paramètres Include geometry (Inclure la géométrie), Include domain descriptions (Inclure des descriptions de domaine) et Output JSON (JSON en sortie).
    Remarque :

    Pour les géodatabases entreprise, cette option nécessite ArcGIS Enterprise 10.9.1 ou version ultérieure.

  • ElémentsLes résultats du traçage sont renvoyés sous forme d’informations basées sur les entités dans un fichier .json en sortie spécifié pour les entités de réseau traversées. Cette option active le paramètre Output JSON (JSON en sortie).
  • EntitésLes résultats du traçage sont renvoyés sous forme d’informations basées sur les entités dans un fichier .json en sortie spécifié pour les entités de réseau traversées. Cette option active les paramètres Include geometry (Inclure la géométrie), Include domain descriptions (Inclure des descriptions de domaine), Result Network Attributes (Attributs de réseau générés), Result Fields (Champs de résultat) et Output JSON (JSON en sortie).
    Remarque :

    Pour les géodatabases entreprise, cette option nécessiteArcGIS Enterprise 11.1 ou version ultérieure.

  • Associations d’inclusion et de dépendanceLes résultats du traçage sont renvoyés sous forme d’informations d’association pour les entités de réseau traversées qui sont associées par des associations d’inclusion et de dépendances structurelles dans un fichier .json en sortie spécifié. Cette option active les paramètres Include domain descriptions (Inclure des descriptions de domaine) et Output JSON (JSON en sortie).
    Remarque :

    Pour les géodatabases entreprise, cette option nécessiteArcGIS Enterprise 11.1 ou version ultérieure.

  • Enregistrements liésLes valeurs des objets associés sont renvoyées pour les entités traversées dans le fichier en sortie spécifié à l’aide du champ et de la classe de relations spécifiés. Cette option active les paramètres Include geometry (Inclure la géométrie), Include domain descriptions (Inclure des descriptions de domaine), Related Record Fields (Champs d’enregistrement associé) et Output JSON (JSON en sortie).
    Remarque :

    Pour les géodatabases d’entreprise, cette option requiert ArcGIS Enterprise 11.5 ou version ultérieure.

String
Type de sélection

Spécifie la manière dont la sélection est appliquée et ce qui se produit si une sélection actuelle existe déjà.

  • Nouvelle sélectionLa sélection obtenue remplace la sélection courante. Il s’agit de l’option par défaut.
  • Ajouter à la sélection actuelleLa sélection obtenue est ajoutée à la sélection courante si celle-ci existe. S’il n’existe aucune sélection, elle est identique à la nouvelle sélection.
  • Supprimer de la sélection actuelleLa sélection obtenue est supprimée de la sélection courante. S’il n’existe aucune sélection, cette option ne produit aucun effet.
  • Sélectionner un sous-ensemble à partir de la sélection actuelleLa sélection obtenue est associée à la sélection courante. Seuls les enregistrements communs aux deux restent sélectionnés.
  • Inverser la sélection actuelleLa sélection obtenue est inversée. Les résultats qui étaient sélectionnés sont supprimés de la sélection actuelle, tandis que les résultats qui ne l’étaient pas sont ajoutés à la sélection actuelle. S’il n’existe aucune sélection, elle est identique à la nouvelle sélection.
String
Effacer tous les résultats de trace précédents
(Facultatif)

Indique si le contenu sera tronqué des classes d’entités choisies ou ajouté à ces dernières pour stocker la géométrie agrégée. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

  • Activé : les classes d’entités qui stockent la géométrie de traçage agrégée sont tronquées. Seule la géométrie en sortie issue de l’opération actuelle de traçage sera écrite. Il s’agit de l’option par défaut.
  • Désactivé : la géométrie en sortie issue de l’opération de traçage actuelle est ajoutée aux classes d’entités qui stockent la géométrie agrégée.
Boolean
Nom de la trace
(Facultatif)

Nom de l’opération de traçage. Cette valeur est stockée dans le champ TRACENAME de la classe d’entités en sortie pour contribuer à l’identification des résultats de traçage. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

String
Points agrégés
(Facultatif)

Classe d’entités multi-points en sortie qui contient la géométrie de résultat agrégée. Par défaut, ce paramètre est renseigné avec une classe d’entités générée par le système intitulée Trace_Results_Aggregated_Points, qui est stockée dans la géodatabase par défaut du projet.

Cette classe d’entités est créée automatiquement si elle n’existe pas. Il est également possible d’utiliser une classe d’entités existante pour stocker la géométrie agrégée. Si une classe d’entités autre que celle par défaut est utilisée, il doit s’agir d’une classe d’entités multi-points contenant un champ de chaîne nommé TRACENAME. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

Feature Class
Lignes agrégées
(Facultatif)

Classe d’entités polylignes en sortie qui contient la géométrie de résultat agrégée. Par défaut, ce paramètre est renseigné avec une classe d’entités générée par le système intitulée Trace_Results_Aggregated_Lines, qui est stockée dans la géodatabase par défaut du projet.

Cette classe d’entités est créée automatiquement si elle n’existe pas. Il est également possible d’utiliser une classe d’entités existante pour stocker la géométrie agrégée. Si une classe d’entités autre que celle par défaut est utilisée, il doit s’agir d’une classe d’entités polylignes contenant un champ de chaîne nommé TRACENAME. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

Feature Class
Polygones agrégés
(Facultatif)

Classe d’entités surfaciques en sortie qui contient la géométrie de résultat agrégée. Par défaut, ce paramètre est renseigné avec une classe d’entités générée par le système nommée Trace_Results_Aggregated_Polygons, qui est stockée dans la géodatabase par défaut du projet.

Cette classe d’entités est créée automatiquement si elle n’existe pas. Il est également possible d’utiliser une classe d’entités existante pour stocker la géométrie agrégée. Si une classe d’entités autre que celle par défaut est utilisée, il doit s’agir d’une classe d’entités surfaciques contenant un champ de chaîne nommé TRACENAME. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

Feature Class
Autoriser la circulation indéterminée
(Facultatif)

Indique si les entités dont le flux est indéterminé sont tracées. Le flux indéterminé désigne les zones d’un sous-réseau où le sens de flux est ambigu ou ne peut pas être déterminé. Ce paramètre s’applique uniquement lors de l’exécution d’un traçage en amont, en aval ou d’isolement.

  • Activé : les entités dont le flux est indéterminé sont tracées. Il s’agit de l’option par défaut.
  • Désactivé : les entités dont le flux est indéterminé interrompent la traversabilité et ne sont pas tracées.

Remarque :

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

Boolean
Validate Locatability (Valider la localisation)
(Facultatif)

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

  • Activé : le traçage renvoie une erreur si des objets jonction ou tronçon non spatiaux sont identifiés sans l’association d’inclusion, de dépendances ou de connectivité nécessaire dans leur hiérarchie d’associations des objets traversés.
  • Désactivé : le traçage ne vérifie pas la présence d’objets non localisables et renvoie des résultats que ces objets soient présents ou non dans la hiérarchie d’associations des objets traversées. Il s’agit de l’option par défaut.

Remarque :

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

Boolean
Use Trace Configuration (Utiliser la configuration du tracé)
(Facultatif)

Indique si une configuration de tracé nommée existante doit être utilisée pour renseigner les paramètres de cet outil.

  • Activé : une configuration de tracé nommée existante est utilisée pour définir les propriétés du traçage. Tous les paramètres, excepté Trace Configuration Name (Nom de la configuration du tracé), Starting Points (Points de départ) et Barriers (Interruptions) sont ignorés.
  • Désactivé : une configuration de tracé nommée existante n’est pas utilisée pour définir les propriétés du traçage. Il s’agit de l’option par défaut.

Remarque :

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

Boolean
Nom de la configuration de tracé
(Facultatif)

Nom de la configuration de tracé nommée existante utilisée pour définir les propriétés du traçage. Ce paramètre n’est actif que si le paramètre Use Trace Configuration (Utiliser une configuration de tracé) est sélectionné.

Remarque :

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

String
JSON en sortie
(Facultatif)

Nom et emplacement du fichier .json qui est généré lors du renvoi des résultats du traçage avec les types de résultats Connectivité, Éléments, Entités, Associations d’inclusion et de dépendance ou Enregistrements liés.

File
Run in asynchronous mode on the server (Exécution en mode asynchrone sur le serveur)
(Facultatif)

Indique si les opérations de traçage sont traitées de manière asynchrone lors de l’utilisation d’un réseau de distribution dans une géodatabase entreprise.

  • Cochée : les opérations de traçage se déroulent de manière asynchrone.
  • Non cochée : les opérations de traçage se déroulent de manière synchrone. Il s’agit de l’option par défaut.

Remarque :

Ce paramètre requiert ArcGIS Enterprise 10.9.1 ou version ultérieure.

Boolean
Inclure la géométrie
(Facultatif)

Indique si la géométrie figure dans les résultats.

  • Activé : la géométrie est incluse dans les résultats.
  • Désactivé : la géométrie n’est pas incluse dans les résultats. Il s’agit de l’option par défaut.

Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.1 ou version ultérieure.

Boolean
Inclure des descriptions de domaine
(Facultatif)

Spécifie si les descriptions de domaine sont incluses dans le fichier .json en sortie pour communiquer la cartographie de domaine des contrôleurs, les éléments d’entités (featureElements), la connectivité et les associations.

  • Activé : les descriptions de domaine sont incluses dans les résultats.
  • Désactivé : les descriptions de domaine ne sont pas incluses dans les résultats. Il s’agit de l’option par défaut.

Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.1 ou version ultérieure.

Boolean
Attributs de réseau générés
(Facultatif)

Attributs de réseau à inclure dans les résultats.

Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.1 ou version ultérieure.

String
Champ de résultats
(Facultatif)

Champs d’une classe d’entités qui seront renvoyés comme résultats. Les valeurs des champs sont renvoyées dans les résultats pour les entités de la trace.

Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.1 ou version ultérieure.

Value Table
Utiliser le sens de numérisation
(Facultatif)

Indique si les opérations de traçage en amont et en aval déterminent le sens de flux d’après le sens de numérisation de la ligne, les ID globaux d’origine et de destination de l’objet tronçon dans l’association, et l’attribut Flow direction. Ce paramètre est disponible et actif uniquement avec les réseaux de distribution en version 7 et ultérieures lorsque le paramètre Trace Type (Type de traçage) a pour valeur Upstream (En amont) ou Downstream (En aval).

  • Activé : les opérations de traçage déterminent la direction de flux d’après le sens de numérisation de la ligne, les ID globaux d’origine et de destination de l’objet tronçon dans l’association et l’attribut de direction de flux. Lorsque ce paramètre est activé, les propagateurs configurés sur un niveau sont ignorés, et les paramètres Domain Network (Réseau de domaine), Tier (Niveau) et Target Tier (Niveau cible) sont masqués et ignorés.
  • Désactivé : les opérations de traçage déterminent la direction de flux selon la localisation des contrôleurs de sous-réseau. Il s’agit de l’option par défaut.

Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.3 ou version ultérieure.

Boolean
Synthétiser les géométries
(Facultatif)

Spécifie si les géométries sont inférées ou créées (synthétisées) pour les associations et les objets tronçon traversés dans le cadre d’une opération de traçage. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

  • Activé : les géométries sont inférées et créées pour les associations et les objets tronçon traversés dans la classe d’entités Trace_Results_Aggregated_Lines en sortie.
  • Désactivé : les géométries ne sont pas synthétisées pour les associations et les objets tronçon traversés. Il s’agit de l’option par défaut.

Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.3 ou version ultérieure.

Boolean
Champs d’enregistrement associé
(Facultatif)

Champs des classes d’objets associées renvoyés comme résultats. Les valeurs des champs sont renvoyées dans les résultats pour les entités traversées.

  • Relationship Class (Classe de relations) : classe de relations associée à une classe d’entités ou d’objets qui participe au réseau de distribution.
  • Field Name (Nom de champ) : nom d’un champ de la classe d’objets associée dont les valeurs sont renvoyées dans les résultats.

Value Table

Sortie obtenue

ÉtiquetteExplicationType de données
Réseau de distribution en sortie

Réseau technique actualisé.

Utility Network

arcpy.un.Trace(in_utility_network, trace_type, {starting_points}, {barriers}, {domain_network}, {tier}, {target_tier}, {subnetwork_name}, {shortest_path_network_attribute_name}, {include_containers}, {include_content}, {include_structures}, {include_barriers}, {validate_consistency}, {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}, {functions}, {propagators}, {output_assettypes}, {output_conditions}, {include_isolated_features}, {ignore_barriers_at_starting_points}, {include_up_to_first_spatial_container}, {result_types}, selection_type, {clear_all_previous_trace_results}, {trace_name}, {aggregated_points}, {aggregated_lines}, {aggregated_polygons}, {allow_indeterminate_flow}, {validate_locatability}, {use_trace_config}, {trace_config_name}, {out_json_file}, {run_async}, {include_geometry}, {include_domain_descriptions}, {result_network_attributes}, {result_fields}, {use_digitized_direction}, {synthesize_geometries}, {related_record_fields})
NomExplicationType de données
in_utility_network

Réseau technique pour lequel le traçage sera effectué. Lorsque vous utilisez une géodatabase d’entreprise, le réseau technique doit provenir d’un service d’entités ; les réseaux techniques issus d’une connexion à une base de données ne sont pas pris en charge.

Utility Network; Utility Network Layer
trace_type

Spécifie le type de traçage à utiliser.

  • CONNECTEDUn traçage connecté qui commence à un ou plusieurs points de départ et s’étend le long des entités connectées est utilisé. Il s’agit de l’option par défaut.
  • SUBNETWORKUn tracé de sous-réseau qui commence à un ou plusieurs points de départ et s’étend pour englober le sous-réseau est utilisé. Cette option est prise en charge pour les réseaux de domaine traditionnels uniquement.
  • SUBNETWORK_CONTROLLERSUn tracé des contrôleurs de sous-réseaux qui localise les sources et les cuvettes des contrôleurs de sous-réseaux associés à un sous-réseau est utilisé. Cette option est prise en charge pour les réseaux de domaine traditionnels uniquement.
  • UPSTREAMUn traçage en amont qui découvre les entités en amont d’une localisation dans le réseau est utilisé. Cette option est prise en charge pour les réseaux de domaine traditionnels uniquement, sauf si le paramètre use_digitized_direction a pour valeur USE_DIGITIZED_DIRECTION.
  • DOWNSTREAMUn traçage en aval qui découvre les entités en aval d’une localisation dans le réseau est utilisé. Cette option est prise en charge pour les réseaux de domaine traditionnels uniquement, sauf si le paramètre use_digitized_direction a pour valeur USE_DIGITIZED_DIRECTION.
  • LOOPSUn traçage des boucles qui s’étend vers l’extérieur à partir du point de départ en fonction de la connectivité est utilisé. Les boucles sont des zones du réseau où la direction du flux est ambiguë.
  • SHORTEST_PATHUn traçage du chemin le plus court qui identifie le chemin le plus court entre deux points de départ est utilisé.
  • ISOLATIONUn traçage d’isolement identifiant les entités qui isolent une surface d’un réseau est utilisé. Cette option est prise en charge pour les réseaux de domaine traditionnels uniquement.
String
starting_points
(Facultatif)

Table ou classe d’entités ponctuelles contenant un ou plusieurs enregistrements qui représentent les points de départ du traçage. Cette table ou classe d’entités doit inclure le champ FEATUREGLOBALID pour stocker les informations relatives à l’entité de réseau associée. Pour afficher le format spécifique, créez les points de début dans l’onglet Start (Début) de la fenêtre Trace (Traçage) et affichez la structure de la classe d’entités UN_Temp_Starting_Points stockée dans la géodatabase par défaut.

Feature Layer; Table View
barriers
(Facultatif)

Table ou classe d’entités contenant une ou plusieurs entités représentant les interruptions qui empêchent le traçage d’aller au-delà de ce point. Cette table ou classe d’entités doit inclure le champ FEATUREGLOBALID pour stocker les informations relatives à l’entité de réseau associée. Pour afficher le format spécifique, créez des interruptions dans l’onglet Barriers (Interruptions) de la fenêtre Trace (Traçage) et affichez la structure de la classe d’entités UN_Temp_Barriers stockée dans la géodatabase par défaut.

Feature Layer; Table View
domain_network
(Facultatif)

Le nom du réseau du domaine sur lequel la trace sera exécutée. Ce paramètre est obligatoire lors de l’exécution du sous-réseau, des contrôleurs de sous-réseaux, des types de traçage en amont et en aval.

String
tier
(Facultatif)

Nom du niveau d’un réseau de domaine traditionnel auquel débute le tracé. Ce paramètre est obligatoire lors de l’exécution du sous-réseau, des contrôleurs de sous-réseaux, des types de traçage en amont et en aval.

String
target_tier
(Facultatif)

Nom du niveau cible d’un réseau de domaine traditionnel vers lequel le niveau en entrée circule dans un tracé directionnel. Si ce paramètre n’est pas spécifié pour les traçages en amont et en aval, ceux-ci s’arrêtent une fois qu’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
subnetwork_name
(Facultatif)

Nom du sous-réseau d’un réseau de domaine traditionnel sur lequel le traçage est exécuté. Ce paramètre peut être utilisé lors de l’exécution d’un type de traçage de sous-réseau. Si le nom d’un sous-réseau est spécifié, le paramètre starting_points n’est pas requis.

String
shortest_path_network_attribute_name
(Facultatif)

Attribut de réseau utilisé pour calculer le chemin le plus court. 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
include_containers
(Facultatif)

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

  • INCLUDE_CONTAINERSLes entités de conteneur sont incluses dans les résultats de traçage.
  • EXCLUDE_CONTAINERSLes entités de conteneur ne sont pas incluses dans les résultats de traçage. Il s’agit de l’option par défaut.
Boolean
include_content
(Facultatif)

Indique si le contenu des entités de conteneur est inclus dans les résultats de traçage.

  • INCLUDE_CONTENTLe contenu des entités de conteneur est inclus dans les résultats de traçage.
  • EXCLUDE_CONTENTLe contenu des entités de conteneur n’est pas inclus dans les résultats de traçage. Il s’agit de l’option par défaut.
Boolean
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 traçage. 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
validate_consistency
(Facultatif)

Indique si une erreur est renvoyée lorsque des zones à valider figurent dans les entités renvoyées. C’est la seule façon de garantir qu’un traçage passe via des entités avec un statut cohérent dans le réseau. Pour supprimer les zones à valider, validez la topologie de réseau.

  • VALIDATE_CONSISTENCYLe traçage renvoie une erreur si des zones à valider figurent dans les entités renvoyées.
  • DO_NOT_VALIDATE_CONSISTENCYLe traçage renvoie des résultats que des zones à valider figurent ou non dans l’une des entités renvoyées. 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 du réseau ou une catégorie de réseau, un opérateur et un type, ainsi qu’une valeur d’attribut. 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 selon n’importe quel attribut de réseau défini dans le système ou spécifiez Catégorie pour utiliser une catégorie de réseau.
  • Operator : choisissez un des opérateurs.
  • Type : spécifiez Specific value ou Network attribute pour le type de valeur du paramètre Name qui sert d’interruption. Le paramètre Type doit avoir pour valeur Specific value lorsque le paramètre Name est défini sur Category.
  • Value : fournit une valeur spécifique de l’attribut ou de la catégorie 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 conditions à ajouter. Vous pouvez les combiner à 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 AND (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 AND (Et) bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit != valeur)
  • INCLUDES_ANYOpération AND (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 AND (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 ou d’une catégorie de réseau 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.

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 l’une des fonctions de calcul.
  • Attribute : procédez à un filtrage en fonction d’un attribut de réseau défini dans le système.
  • Operator : choisissez l’un des opérateurs.
  • Value : indiquez la valeur spécifique du type d’attribut en entrée qui, si elle est trouvée, va entraîner l’arrêt.
  • Use Local Values : calculez les valeurs dans chaque sens et non une valeur globale générale. Par exemple, une interruption de fonction calcule la somme de Shape length où le traçage s’arrête si la valeur est supérieure ou égale à 4. Si vous utilisez la valeur globale, après avoir 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. Si vous utilisez des valeurs locales, lorsque la traversée rencontre une fourche, les valeurs calculées pour chaque chemin le long de la branche sont gérées séparément. Dans ce cas, si le point de départ est placé à la fourche, les valeurs locales le long de chaque chemin sont calculées séparément et le traçage se poursuit jusqu’à ce que la somme de 4 soit atteinte sur chaque chemin.

Les options des valeurs Function de l’interruption de fonction sont les suivantes :

  • AVERAGELa moyenne des valeurs en entrée est calculée.
  • COUNTLe nombre d’entités est identifié.
  • MAXLe nombre maximum de valeurs en entrée est identifié.
  • MINLe nombre minimum de valeurs en entrée est identifié.
  • ADDLa somme des valeurs en entrée est calculée.
  • SUBTRACTLa différence entre les valeurs en entrée est calculé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.

Les options des valeurs Operator de l’interruption de fonction sont les suivantes :

  • IS_EQUAL_TOLe résultat de la fonction est égal à la valeur.
  • DOES_NOT_EQUALLe résultat de la fonction est différent de la valeur.
  • IS_GREATER_THANLe résultat de la fonction est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOLe résultat de la fonction est supérieur ou égal à la valeur.
  • IS_LESS_THANLe résultat de la fonction est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOLe résultat de la fonction est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération AND (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 AND (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 AND (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 AND (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 Use Local Values d’interruption de fonction sont les suivantes :

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

Spécifie si la traversabilité (capacité à être traversé) 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_EDGESLa traversabilité s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • JUNCTIONS_ONLYLa traversabilité s’applique uniquement aux jonctions.
  • EDGES_ONLYLa traversabilité s’applique uniquement aux tronçons.
String
filter_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Facultatif)

Indique à quel moment 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 And (Et) ou une condition Or (Ou).

Les composants du Filtre d'interruption sont les suivants :

  • Name : filtrez par catégorie ou en fonction de n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez l’un des opérateurs.
  • Type : choisissez une valeur spécifique ou un attribut de réseau à partir de 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 voulez ajouter plusieurs attributs. Vous pouvez les combiner avec une condition And (Et) ou une condition Or (Ou).

Les options des valeurs Operator des filtres d’interruption 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 AND (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 AND (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 AND (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 AND (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 d’interruption 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 d’interruption sont les suivantes :

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

En savoir plus sur l'utilisation de plusieurs expressions conditionnelles

Value Table
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 : choisissez l’une des fonctions de calcul.
  • Attribute : procédez à un filtrage en fonction d’un attribut de réseau défini dans le système.
  • Operator : choisissez l’un des opérateurs.
  • Value : indiquez la valeur spécifique du type d’attribut en entrée qui, si elle est trouvée, va entraîner l’arrêt.
  • Use Local Values : calcule les valeurs dans chaque sens, par opposition à une valeur globale générale. Considérons, par exemple, une interruption de fonction qui calcule la somme de longueur de forme à 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 avez déjà atteint une somme de longueur de forme égale à 4 de sorte que le traçage 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 des valeurs Function des filtres par fonctions d’interruption sont les suivantes :

  • AVERAGELa moyenne des valeurs en entrée est calculée.
  • COUNTLe nombre d’entités est identifié.
  • MAXLe nombre maximum de valeurs en entrée est identifié.
  • MINLe nombre minimum de valeurs en entrée est identifié.
  • ADDLa somme des valeurs est calculée.
  • SUBTRACTLa différence entre les valeurs est calculé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.

Les options des valeurs Operator des filtres par fonctions d’interruption 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 AND (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 AND (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 AND (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 AND (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 Use Local Values des filtres par fonctions d’interruption sont les suivantes :

  • TRUELes valeurs locales sont utilisées. Il s’agit de l’option par défaut.
  • FALSELes valeurs globales sont utilisées.
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, un filtre d’interruption est défini pour arrêter la trace lorsque le paramètre Device Status (Statut du dispositif) a la valeur Open (Ouvert) et que la portée de la traversabilité est définie sur les tronçons uniquement, la trace ne s’interrompt pas même si elle détecte un dispositif ouvert, car le statut du dispositif 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_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 indiquer 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-nearest neighbors (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 renvoyées lorsque filter_nearest a la valeur 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 a pour valeur FILTER_BY_NEAREST (par exemple, Shape length [Longueur de forme]).

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

Catégories à renvoyer lorsque filter_nearest a pour valeur FILTER_BY_NEAREST (par exemple, Protective [Protection]).

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

Groupes de ressources et types de ressources à renvoyer lorsque filter_nearest a pour valeur FILTER_BY_NEAREST (par exemple, ElectricDistributionDevice/Transformer/Step Down [Dispositif de distribution électrique/Transformateur/Abaisseurs]).

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

Fonction(s) de calcul appliquée(s) aux résultats du traçage.

Les composants des fonction sont les suivants :

  • Function : choisissez l’une des fonctions de calcul.
  • Attribute : procédez à un filtrage en fonction d’un attribut de réseau défini dans le système.
  • Filter Name : filtrez les résultats de fonction par nom d’attribut.
  • Filter Operator : choisissez l’un des opérateurs.
  • Filter Type : choisissez l’un des types de filtre.
  • Filter Value : indiquez une valeur spécifique pour l’attribut de filtre en entrée.

Les options des valeurs Function des fonctions sont les suivantes :

  • AVERAGELa moyenne des valeurs en entrée est calculée.
  • COUNTLe nombre d’entités est identifié.
  • MAXLe nombre maximum de valeurs en entrée est identifié.
  • MINLe nombre minimum de valeurs en entrée est identifié.
  • ADDLa somme des valeurs en entrée est calculée.
  • SUBTRACTLa différence entre les valeurs en entrée est calculé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épart 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 ADDest de 50, la AVERAGE est de 25, le COUNT est de 2, et la SUBTRACT est de -10.

Les options des valeurs Filter 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 AND (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 AND (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 AND (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 AND (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 Filter Type des fonctions sont les suivantes :

  • SPECIFIC_VALUEFiltrez en fonction d’une valeur spécifique.
  • NETWORK_ATTRIBUTEFiltrez en fonction d’un attribut de réseau.
Value Table
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value],...]
(Facultatif)

Spécifie les attributs de réseau à propager, ainsi que la manière dont cette propagation doit être effectuée pendant un traçage dans un réseau de domaine traditionnel. 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 des propagateurs sont les suivants :

  • Attribute : filtrez par n’importe quel 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 une cartographie 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 options de valeur Function pour les propagateurs sont les suivantes :

  • PROPAGATED_BITWISE_ANDLes valeurs d’une entité à la suivante sont comparées.
  • PROPAGATED_MINLa valeur minimale est identifiée.
  • PROPAGATED_MAXLa valeur maximale est identifiée.

Les options de valeur Operator pour les 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 AND (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 AND (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 AND (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 AND (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 pour Python.

Value Table
output_assettypes
[output_assettypes,...]
(Facultatif)

Filtre les types de ressources en sortie à inclure dans les résultats (par exemple, retourner uniquement les transformateurs aériens).

String
output_conditions
[[Name, Operator, Type, Value, Combine Using],...]
(Facultatif)

Types des entités qui sont renvoyées en fonction d’un attribut de réseau ou d’une catégorie. Par exemple, une trace configurée pour filtrer toutes les entités sauf les entités Tap (Dérivation), toute entité tracée à laquelle la catégorie Tap (Dérivation) n’est pas attribuée, n’est pas incluse dans les résultats. Toute entité tracée qui n’est pas renvoyée dans l’ensemble de sélection des résultats. Si vous utilisez plusieurs attributs, vous pouvez utiliser l’option Combine Using pour définir une condition And (Et) ou une condition Or (Ou).

Les composants des Conditions de sortie sont les suivants :

  • Name : filtrez en fonction de n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez l’un des opérateurs.
  • Type : choisissez une valeur spécifique ou un attribut de réseau à partir de 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 voulez ajouter plusieurs attributs. Vous pouvez les combiner avec une condition And (Et) ou une condition Or (Ou).

Les options des valeurs Operator des conditions de sortie 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 AND (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 AND (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 AND (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 AND (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 conditions de sortie 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 conditions de sortie sont les suivantes :

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

En savoir plus sur l'utilisation de plusieurs expressions conditionnelles

Value Table
include_isolated_features
(Facultatif)

Indique si les entités isolées sont incluses dans les résultats de traçage avec un réseau de domaine traditionnel. Ce paramètre est utilisé uniquement lors de l’exécution d’un traçage d’isolement.

  • INCLUDE_ISOLATED_FEATURESLes entités isolées sont incluses dans les résultats de traçage.
  • EXCLUDE_ISOLATED_FEATURESLes entités isolées ne sont pas incluses dans les résultats de traçage. Il s’agit de l’option par défaut.
Boolean
ignore_barriers_at_starting_points
(Facultatif)

Spécifie si les interruptions dynamiques dans la configuration de tracé sont ignorées pour les points de départ. Cela peut être utile lorsque vous effectuez un parcours de dispositifs de protection en amont et que vous utilisez les dispositifs de protection (interruptions) détectés comme points de début pour rechercher les dispositifs de protection en amont suivants.

  • IGNORE_BARRIERS_AT_STARTING_POINTSLes interruptions au points de départ sont ignorées dans le traçage.
  • DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTSLes interruptions au points de départ ne sont pas ignorées dans le traçage. Il s’agit de l’option par défaut.
Boolean
include_up_to_first_spatial_container
(Facultatif)

Indique si les conteneurs retournés se limitent ou non à ceux rencontrés jusqu’au premier conteneur spatial (inclus) pour chaque élément de réseau dans les résultats de traçage. Si aucun conteneur spatial n’est rencontré, mais que des conteneurs non spatiaux sont présents pour un élément de réseau donné, tous les conteneurs non spatiaux sont inclus dans les résultats. Ce paramètre n’est actif que si include_containers a pour valeur INCLUDE_CONTAINERS.

  • INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINERSeuls les conteneurs rencontrés jusqu’au premier conteneur spatial (inclus) figurent dans les résultats lorsque des associations d’inclusions imbriquées sont rencontrées le long du chemin de traçage. S’il n’existe aucun conteneur spatial, tous les conteneurs non spatiaux sont inclus dans les résultats d’un élément de réseau donné.
  • DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINERTous les conteneurs sont retournés dans les résultats. Il s’agit de l’option par défaut.
Boolean
result_types
[result_types,...]
(Facultatif)

Spécifie le type de résultat renvoyé par le traçage.

  • SELECTIONLes résultats du traçage sont renvoyés en tant qu’ensemble de sélection des entités de réseau appropriées. Il s’agit de l’option par défaut.
  • AGGREGATED_GEOMETRYLes résultats du traçage sont agrégés par type de géométrie et stockés dans les classes d’entités multi-parties affichées sur les couches de la carte active.
  • CONNECTIVITYLes résultats du traçage sont renvoyés sous forme de graphe de connectivité dans un fichier .json en sortie spécifié pour les entités de réseau traversées. Cette option active les paramètres include_geometry, include_domain_description et out_json_file.
    Remarque :

    Pour les géodatabases entreprise, cette option nécessite ArcGIS Enterprise 10.9.1 ou version ultérieure.

  • ELEMENTSLes résultats du traçage sont renvoyés sous forme d’informations basées sur les entités dans un fichier .json en sortie spécifié pour les entités de réseau traversées. Cette option active le paramètre out_json_file.
  • FEATURESLes résultats du traçage sont renvoyés sous forme d’informations basées sur les entités dans un fichier .json en sortie spécifié pour les entités de réseau traversées. Cette option active les paramètres include_geometry, include_domain_description, result_network_attributes, result_fields et out_json_file.
    Remarque :

    Pour les géodatabases entreprise, cette option nécessiteArcGIS Enterprise 11.1 ou version ultérieure.

  • CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONSLes résultats du traçage sont renvoyés sous forme d’informations d’association pour les entités de réseau traversées qui sont associées par des associations d’inclusion et de dépendances structurelles dans un fichier .json en sortie spécifié. Cette option active les paramètres include_domain_description et out_json_file.
    Remarque :

    Pour les géodatabases entreprise, cette option nécessiteArcGIS Enterprise 11.1 ou version ultérieure.

  • RELATED_RECORDSLes valeurs des objets associés sont renvoyées pour les entités traversées dans le fichier en sortie spécifié à l’aide du champ et de la classe de relations spécifiés. Cette option active les paramètres include_geometry, include_domain_description, related_record_fields et out_json_file.
    Remarque :

    Pour les géodatabases d’entreprise, cette option requiert ArcGIS Enterprise 11.5 ou version ultérieure.

String
selection_type

Spécifie la manière dont la sélection est appliquée et ce qui se produit si une sélection actuelle existe déjà.

  • NEW_SELECTIONLa sélection obtenue remplace la sélection courante. Il s’agit de l’option par défaut.
  • ADD_TO_SELECTIONLa sélection obtenue est ajoutée à la sélection courante si celle-ci existe. S’il n’existe aucune sélection, elle est identique à la nouvelle sélection.
  • REMOVE_FROM_SELECTIONLa sélection obtenue est supprimée de la sélection courante. S’il n’existe aucune sélection, cette option ne produit aucun effet.
  • SUBSET_SELECTIONLa sélection obtenue est associée à la sélection courante. Seuls les enregistrements communs aux deux restent sélectionnés.
  • SWITCH_SELECTIONLa sélection obtenue est inversée. Les résultats qui étaient sélectionnés sont supprimés de la sélection actuelle, tandis que les résultats qui ne l’étaient pas sont ajoutés à la sélection actuelle. S’il n’existe aucune sélection, elle est identique à la nouvelle sélection.
String
clear_all_previous_trace_results
(Facultatif)

Indique si le contenu sera tronqué des classes d’entités choisies ou ajouté à ces dernières pour stocker la géométrie agrégée. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

  • CLEAR_ALL_PREVIOUS_TRACE_RESULTSLes classes d’entités qui stockent la géométrie de traçage agrégée sont tronquées. Seule la géométrie en sortie issue de l’opération actuelle de traçage sera écrite. Il s’agit de l’option par défaut.
  • DO_NOT_CLEAR_ALL_PREVIOUS_TRACE_RESULTSLa géométrie en sortie issue de l’opération de traçage actuelle sera ajoutée aux classes d’entités qui stockent la géométrie agrégée.
Boolean
trace_name
(Facultatif)

Nom de l’opération de traçage. Cette valeur est stockée dans le champ TRACENAME de la classe d’entités en sortie pour contribuer à l’identification des résultats de traçage. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

String
aggregated_points
(Facultatif)

Classe d’entités multi-points en sortie qui contient la géométrie de résultat agrégée. Par défaut, ce paramètre est renseigné avec une classe d’entités générée par le système intitulée Trace_Results_Aggregated_Points, qui est stockée dans la géodatabase par défaut du projet.

Cette classe d’entités est créée automatiquement si elle n’existe pas. Il est également possible d’utiliser une classe d’entités existante pour stocker la géométrie agrégée. Si une classe d’entités autre que celle par défaut est utilisée, il doit s’agir d’une classe d’entités multi-points contenant un champ de chaîne nommé TRACENAME. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

Feature Class
aggregated_lines
(Facultatif)

Classe d’entités polylignes en sortie qui contient la géométrie de résultat agrégée. Par défaut, ce paramètre est renseigné avec une classe d’entités générée par le système intitulée Trace_Results_Aggregated_Lines, qui est stockée dans la géodatabase par défaut du projet.

Cette classe d’entités est créée automatiquement si elle n’existe pas. Il est également possible d’utiliser une classe d’entités existante pour stocker la géométrie agrégée. Si une classe d’entités autre que celle par défaut est utilisée, il doit s’agir d’une classe d’entités polylignes contenant un champ de chaîne nommé TRACENAME. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

Feature Class
aggregated_polygons
(Facultatif)

Classe d’entités surfaciques en sortie qui contient la géométrie de résultat agrégée. Par défaut, ce paramètre est renseigné avec une classe d’entités générée par le système nommée Trace_Results_Aggregated_Polygons, qui est stockée dans la géodatabase par défaut du projet.

Cette classe d’entités est créée automatiquement si elle n’existe pas. Il est également possible d’utiliser une classe d’entités existante pour stocker la géométrie agrégée. Si une classe d’entités autre que celle par défaut est utilisée, il doit s’agir d’une classe d’entités surfaciques contenant un champ de chaîne nommé TRACENAME. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

Feature Class
allow_indeterminate_flow
(Facultatif)

Indique si les entités dont le flux est indéterminé sont tracées. Le flux indéterminé désigne les zones d’un sous-réseau où le sens de flux est ambigu ou ne peut pas être déterminé. Ce paramètre s’applique uniquement lors de l’exécution d’un traçage en amont, en aval ou d’isolement.

  • TRACE_INDETERMINATE_FLOWLes entités dont le flux est indéterminé sont tracées. Il s’agit de l’option par défaut.
  • IGNORE_INDETERMINATE_FLOWLes entités dont le flux est indéterminé interrompent la traversabilité et ne sont pas tracées.
Remarque :

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

Boolean
validate_locatability
(Facultatif)

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

  • VALIDATE_LOCATABILITYLe traçage renvoie une erreur si des objets jonction ou tronçon non spatiaux sont identifiés sans l’association d’inclusion, de dépendances ou de connectivité nécessaire dans leur hiérarchie d’associations des objets traversés.
  • DO_NOT_VALIDATE_LOCATABILITYLe traçage ne vérifie pas la présence d’objets non localisables et renvoie des résultats que ces objets soient présents ou non dans la hiérarchie d’associations des objets traversés. Il s’agit de l’option par défaut.
Remarque :

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

Boolean
use_trace_config
(Facultatif)

Indique si une configuration de tracé nommée existante doit être utilisée pour renseigner les paramètres de cet outil.

  • USE_TRACE_CONFIGURATIONUne configuration de tracé nommée existante est utilisée pour définir les propriétés du traçage. Tous les paramètres, excepté trace_config_name, starting_points et barriers sont ignorés.
  • DO_NOT_USE_TRACE_CONFIGURATIONAucune configuration de tracé nommée existante n’est utilisée pour définir les propriétés du traçage. Il s’agit de l’option par défaut.
Remarque :

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

Boolean
trace_config_name
(Facultatif)

Nom de la configuration de tracé nommée existante utilisée pour définir les propriétés du traçage. Ce paramètre n’est activé que lorsque le paramètre use_trace_config a pour valeur USE_TRACE_CONFIGURATION.

String
out_json_file
(Facultatif)

Nom et emplacement du fichier .json qui est généré lors du renvoi des résultats du traçage avec les types de résultats Connectivité, Éléments, Entités, Associations d’inclusion et de dépendance ou Enregistrements liés.

File
run_async
(Facultatif)

Indique si les opérations de traçage sont traitées de manière asynchrone lors de l’utilisation d’un réseau de distribution dans une géodatabase entreprise.

  • RUN_ASYNCHRONOUSLYLes opérations de traçage sont traitées de manière asynchrone.
  • RUN_SYNCHRONOUSLYLes opérations de traçage sont traitées de manière synchrone. Il s’agit de l’option par défaut.
Remarque :
Ce paramètre requiert ArcGIS Enterprise 10.9.1 ou version ultérieure.
Boolean
include_geometry
(Facultatif)

Indique si la géométrie figure dans les résultats.

  • INCLUDE_GEOMETRYLa géométrie est incluse dans les résultats.
  • EXCLUDE_GEOMETRYLa géométrie n’est pas incluse dans les résultats. Il s’agit de l’option par défaut.
Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.1 ou version ultérieure.

Boolean
include_domain_descriptions
(Facultatif)

Spécifie si les descriptions de domaine sont incluses dans le fichier .json en sortie pour communiquer la cartographie de domaine des contrôleurs, les éléments d’entités (featureElements), la connectivité et les associations.

  • INCLUDE_DOMAIN_DESCRIPTIONSLes descriptions de domaine sont incluses dans les résultats.
  • EXCLUDE_DOMAIN_DESCRIPTIONSLes descriptions de domaine ne sont pas incluses dans les résultats. Il s’agit de l’option par défaut.
Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.1 ou version ultérieure.

Boolean
result_network_attributes
[result_network_attributes,...]
(Facultatif)

Attributs de réseau à inclure dans les résultats.

Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.1 ou version ultérieure.

String
result_fields
[[Feature Class, Field Name],...]
(Facultatif)

Champs d’une classe d’entités qui seront renvoyés comme résultats. Les valeurs des champs sont renvoyées dans les résultats pour les entités de la trace.

Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.1 ou version ultérieure.

Value Table
use_digitized_direction
(Facultatif)

Indique si les opérations de traçage en amont et en aval déterminent le sens de flux d’après le sens de numérisation de la ligne, les ID globaux d’origine et de destination de l’objet tronçon dans l’association, et l’attribut Flow direction. Ce paramètre est disponible et actif uniquement avec les réseaux de distribution en version 7 et ultérieures lorsque le paramètre trace_type a pour valeur UPSTREAM ou DOWNSTREAM.

  • USE_DIGITIZED_DIRECTIONLes opérations de traçage déterminent le sens de flux d’après le sens de numérisation de la ligne, les ID globaux d’origine et de destination de l’objet tronçon dans l’association et l’attribut de sens de flux. Avec cette option, les propagateurs configurés sur un niveau sont ignorés et les paramètres domain_network, tier et target_tier le sont également.
  • IGNORE_DIGITIZED_DIRECTIONLes opérations de traçage déterminent le sens de flux en fonction de la localisation des contrôleurs de sous-réseaux. Il s’agit de l’option par défaut.
Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.3 ou version ultérieure.

Boolean
synthesize_geometries
(Facultatif)

Spécifie si les géométries sont inférées ou créées (synthétisées) pour les associations et les objets tronçon traversés dans le cadre d’une opération de traçage. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.

  • DO_NOT_SYNTHESIZE_GEOMETRIESLes géométries ne sont pas synthétisées pour les associations et les objets tronçon traversés. Il s’agit de l’option par défaut.
  • SYNTHESIZE_GEOMETRIESLes géométries sont inférées et créées pour les associations et les objets tronçon traversés dans la classe d’entités Trace_Results_Aggregated_Lines en sortie.

Remarque :

Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.3 ou version ultérieure.

Boolean
related_record_fields
[[Feature Class, Field Name],...]
(Facultatif)

Champs des classes d’objets associées renvoyés comme résultats. Les valeurs des champs sont renvoyées dans les résultats pour les entités traversées.

  • Relationship Class : classe de relations associée à une classe d’entités ou d’objets qui participe au réseau de distribution.
  • Field Name : nom d’un champ de la classe d’objets associée dont les valeurs sont renvoyées dans les résultats.

Value Table

Sortie obtenue

NomExplicationType de données
out_utility_network

Réseau technique actualisé.

Utility Network

Exemple de code

Exemple d’utilisation de l’outil de recherche de parcours (script autonome)

Exécutez un traçage en aval sur un réseau de distribution électrique sur le niveau de tension moyenne qui ajoute le chargement du transformateur sur les phases A, B et C.

'''****************************************************************************
Name:        DownstreamTrace.py
Description: This script executes a downstream trace on the Medium Voltage tier 
             that adds up the transformer load on phases A, B, and C.
Created by:  Esri
****************************************************************************'''

# Import required modules        
import arcpy

# Set local variables
in_utility_network = "NapervilleElectric Utility Network"
trace_type = "DOWNSTREAM"
starting_points = "C:\\MyProject\\Bissell.gdb\UN_Temp_Starting_Points"
barriers = "C:\\MyProject\\Bissell.gdb\UN_Temp_Barriers"
domain_network = "ElectricDistribution"
tier = "Medium Voltage Radial"
include_containers = "INCLUDE_CONTAINERS"
include_content ="INCLUDE_CONTENT"
include_structures = "INCLUDE_STRUCTURES"
include_barriers ="INCLUDE_BARRIERS"
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 1 #"
propagators = "'Phases Current' phasessub PROPAGATED_BITWISE_AND INCLUDES_ANY 15"
functions = "ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 4;ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 2;ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 1"
use_digitized_direction = "IGNORE_DIGITIZED_DIRECTION"
synthesize_geometries = "DO_NOT_SYNTHESIZE_GEOMETRIES"




# Run Trace with specified parameters and leave the rest default
arcpy.un.Trace(in_utility_network, 
               trace_type, 
               starting_points, 
               barriers, 
               domain_network, 
               tier,
               include_containers=include_containers,
               include_content=include_content,
               include_structures=include_structures,
               condition_barriers=condition_barriers,
               propagators=propagators,
               functions=functions,
               use_digitized_direction = use_digitized_direction,
               synthesize_geometries=synthesize_geometries)

Environnements

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

Informations de licence

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

Rubriques connexes