Traçage (Réseau de traces)

Synthèse

Renvoie les entités sélectionnées d’un réseau de traces selon la connectivité ou la capacité à être traversé à partir des points de départ spécifiés.

Les fonctions de traçage du réseau de traces vous permettent d’analyser les chemins sur votre réseau. La capacité à être traversé se réfère aux chemins établis par les entités connecté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, définissez le paramètre Types de résultats sur Agréger la géométrie. Lorsqu’un point de début ou une interruption est placé sur une jonction avec une connectivité à mi-portée, les résultats du traçage renverront des éléments partiels de l’entité tronçon. Lorsqu’une interruption est placée le long d’un segment, les résultats du traçage peuvent être arrêtés à la jonction la plus proche avec la connectivité à mi-portée. Le jeu sélectionné ou la classe d’entités en sortie obtenu par traçage peut ensuite se propager vers une autre carte, une fenêtre de diagramme du réseau ou servir d’entrée pour un autre outil ou une autre trace.

En savoir plus sur le traçage d’un réseau de traces

Utilisation

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

  • Lorsque vous utilisez une géodatabase d’entreprise, le réseau de traces en entrée doit provenir d’un service d’entités ; les réseaux de traces issus d’une connexion à une base de données ne sont pas pris en charge.

  • Puisque l’outil Trace (Traçage) repose sur la topologie du réseau, la précision des résultats de la trace n’est pas garantie si des zones à valider se trouvent dans l’étendue de la trace. 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.

  • Lors de l’utilisation d’attributs de réseau affectés à un champ de date pour les interruptions conditionnelles, les interruptions de fonctions, 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 traces en entrée

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

Trace Network; Trace Network Layer
Type de traçage

Spécifie le type de traçage à exécuter.

  • Connected (Connecté) : une trace connectée qui commence à un ou plusieurs points de début et s’étend le long des entités connectées est utilisé.
  • Upstream (En amont) : une trace en amont qui découvre les entités en amont depuis un emplacement dans le réseau est utilisé. Ce type de trace nécessite que le sens de circulation soit défini.
  • Downstream (En aval) : une trace en aval qui découvre les entités en aval depuis un emplacement dans le réseau est utilisé. Ce type de trace nécessite que le sens de circulation soit défini.
  • Shortest path (Chemin le plus court) : une trace qui recherche le chemin le plus court entre deux points de début sur le réseau, quel que soit le sens de circulation, est utilisé. Le coût du parcours du chemin est déterminé en fonction de l’attribut de réseau défini pour le paramètre Shortest Path Network Attribut Name (Nom de l’attribut de réseau du chemin le plus court).

  • ConnectéUne trace connectée qui commence à un ou plusieurs points de départ et s’étend le long des entités connectées est utilisée.
  • En amontUne trace en amont qui découvre les entités en amont depuis un emplacement dans le réseau est utilisé. Ce type de trace nécessite que le sens de circulation soit défini.
  • En avalUne trace en aval qui découvre les entités en aval depuis un emplacement dans le réseau est utilisé. Ce type de trace nécessite que le sens de circulation soit défini.
  • Plus court cheminUne trace qui recherche le chemin le plus court entre deux points de début sur le réseau, quel que soit le sens de circulation, est utilisé. Le coût du parcours du chemin est déterminé en fonction de l’attribut de réseau défini pour le paramètre shortest_path_network_attribute_name.
String
Points de début

Couche d’entités créée à l’aide de l’onglet Points de départ dans la fenêtre Emplacements de trace, ou classe d’entités ponctuelles contenant une ou plusieurs entités qui représentent les points de départ du traçage. La classe d’entités TN_Temp_Starting_Points est utilisée par défaut et est générée dans la géodatabase par défaut du projet lors de la création des points de début à l’aide de l’outil Starting Points (Points de début) dans la fenêtre Trace Locations (Emplacement des traces).

Feature Layer; Table View
Interruptions
(Facultatif)

Table ou classe d’entités contenant une ou plusieurs entités représentant les interruptions qui empêchent la trace d’aller au-delà de ce point. La classe d’entités TN_Temp_Barriers est utilisée par défaut et est générée dans la géodatabase par défaut du projet lors de la création des interruptions à l’aide de l’onglet Interruptions dans la fenêtre Emplacement des traces.

Feature Layer; Table View
Path Direction (Direction du chemin)
(Facultatif)

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

  • No direction (Pas de direction)Le chemin entre les deux points de début, quel que soit le sens de circulation, est utilisé. Il s’agit de l’option par défaut.
  • Upstream path (Chemin en amont)Le chemin en amont entre les deux points de début est utilisé.
  • Downstream path (Chemin en aval)Le chemin en aval entre les deux points de début est utilisé.
String
Nom d’attribut de réseau du chemin le plus court
(Facultatif)

Nom de l’attribut de réseau utilisé pour calculer le chemin. 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 entités d’interruption
(Facultatif)

Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la trace.

  • 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 retournée lorsqu’une zone à valider figure dans les entités traversé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 parcours retourne une erreur si une zone à valider figure dans les entités traversées. Il s’agit de l’option par défaut.
  • Désactivé : le parcours retourne des résultats, qu’une zone à valider figure ou non dans les entités traversées.

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

Spécifie si les interruptions dans la configuration de trace sont ignorées pour les points de début.

  • Activé : les interruptions au points de départ sont ignorées dans le traçage.
  • Désactivé : les 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
Allow Indeterminate Flow (Autoriser le flux indéterminé)
(Facultatif)

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

  • Activé : les entités dont le sens de flux est indéterminé ou non initialisé sont tracées.
  • Désactivé : les entités dont le sens de flux est indéterminé ou non initialisé ne sont pas tracées. Il s’agit de l’option par défaut.

Boolean
Interruptions conditionnelles
(Facultatif)

Définit une interruption conditionnelle de capacité à être traversé sur les entités en fonction d’une comparaison avec un attribut de réseau. Une interruption conditionnelle utilise un attribut de réseau, un opérateur et un type, ainsi qu’une valeur attributaire. Par exemple, arrêtez un traçage lorsque l’attribut Code d’une entité est égal à la valeur spécifique de ArtificialPath. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. Lorsque plusieurs attributs sont utilisés, vous pouvez utiliser le paramètre Combine Using (Combiner en utilisant) pour définir une condition And (Et) ou une condition Or (Ou).

Les composants de l'interruption conditionnelle 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 : choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le composant Name (Nom).
  • Value (Valeur)—Fournit une valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Combiner avec : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez combiner ces attributs à l’aide d’une condition Et ou Ou.

Les composants du type Operator (Opérateur) sont les suivants :

  • 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.

Les composants du type Type sont les suivants :

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

Les composants du type Combine using (Combiner en utilisant) sont les suivants :

  • And (Et) : combinez les interruptions conditionnelles.
  • Ou : utilisez ce paramètre si l’une des interruptions conditionnelles est satisfaite.

  • 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.
  • Valeur spécifiqueFiltrez en fonction d’une valeur spécifique.
  • Attribut de réseauFiltrez en fonction d’un attribut de réseau.
  • EtCombinez les interruptions conditionnelles.
  • OuUtilisez ce paramètre si l’une des interruptions conditionnelles est satisfaite.
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, par exemple, pour limiter la distance que la trace peut parcourir depuis le point de début, ou définir une valeur maximale à laquelle arrêter une trace. Par exemple, la longueur de chaque ligne parcourue est ajoutée à la distance totale parcourue jusqu’ici. Lorsque la distance totale parcourue atteint la valeur spécifiée, le traçage s’arrête.

Les composants de l'interruption fonctionnelle sont les suivants :

  • Function (Fonction) : choisissez une des fonctions de calcul.
  • Attribute (Attribut) : filtrez par un attribut de réseau défini dans le système.
  • Operator (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) : calcule les valeurs dans chaque direction par opposition à une valeur globale. Considérons, par exemple, une interruption de fonction qui calcule la somme de Shape length (Longueur de forme) à laquelle la trace 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 la recherche de parcours s’arrête. Si les valeurs locales sont utilisées, les valeurs locales le long de chaque chemin changent, et la trace continue.

Les composants du type Function (Fonction) sont les suivants :

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

Par exemple, vous avez une entité de points de début avec une valeur de 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction Minimum, le résultat est de 20, le 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 composants du type Operator (Opérateur) sont les suivants :

  • 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.

Les composants du type Use Local Values (Utiliser les valeurs locales) sont les suivants :

  • Coché - Les valeurs locales sont utilisées.
  • Décoché - Les valeurs globales sont utilisées. Il s’agit de l’option par défaut.

  • MoyenneMoyenne des valeurs en entrée.
  • TotalNombre d’entités.
  • Max.Maximum des valeurs en entrée.
  • MinMinimum des valeurs en entrée.
  • AjouterAjoutez les valeurs.
  • SoustraireSoustrayez les valeurs.
  • 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.
Value Table
Appliquer la traversabilité à
(Facultatif)

Spécifie le type de traversabilité qui sera appliqué. La portée de la capacité à être traversé détermine si la capacité à être traversé est appliquée aux jonctions, tronçons, ou aux deux. Par exemple, dans un réseau de pistes de loisirs, si une interruption conditionnelle est définie pour arrêter une trace lorsqu’un attribut surfacetype est défini comme étant du gravier et que la portée de la capacité à être traversé est définie sur les jonctions uniquement, la trace ne s’arrêtera pas, même si elle rencontre une entité tronçon avec cette valeur dans le champ surfacetype, car l’attribut surfacetype s’applique uniquement aux tronçons.

  • Jonctions et tronçonsLa capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • Jonctions uniquementLa capacité à être traversé s’applique uniquement aux jonctions.
  • Tronçons uniquementLa capacité à être traversé s’applique uniquement aux tronçons.
String
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 par un attribut de réseau défini dans le système.
  • Filter Name (Nom du filtre) : filtrez les résultats de 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)—Fournit une valeur spécifique de l’attribut de filtrage en entrée.

Les options du composant Function (Fonction) sont les suivantes :

  • Min : minimum des valeurs en entrée.
  • Max : maximum des valeurs en entrée.
  • Add (Somme) : somme des valeurs en entrée.
  • Average (Moyenne) : moyenne des valeurs en entrée.
  • Count (Nombre) : nombre d’entités.
  • Substract (Différence) : différence entre les valeurs en entrée.

Par exemple, vous avez une entité de points de début avec une valeur de 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction Min, le résultat est 20. Max est 30, Add (Somme) est 50, Average (Moyenne) est 25, Count (Nombre) est 2 et Subtract (Différence) est -10.

Les options du composant Filter Operator (Opérateur de filtrage) 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.

Les options du composant Filter Type (Type de filtre) sont les suivantes :

  • 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.

  • MoyenneMoyenne des valeurs en entrée.
  • TotalNombre d’entités.
  • Max.Maximum des valeurs en entrée.
  • MinMinimum des valeurs en entrée.
  • AjouterLa somme des valeurs.
  • SoustraireLa différence entre les valeurs.
  • 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.L’attribut est inférieur à la valeur.
  • Est inférieur ou égal à
Value Table
Conditions de sortie
(Facultatif)

Types des entités renvoyées selon un attribut de réseau. Par exemple, sur une trace configurée pour filtrer toutes les entités sauf les entités Tap (Dérivation), toute entité tracée à laquelle l’attribut Tap (Dérivation) n’est pas attribué 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 par un attribut de réseau défini dans le système.
  • Operator (Opérateur) : choisissez un des opérateurs.
  • Type : choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le composant Name (Nom).
  • Value (Valeur)—Fournit une valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Combiner avec : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez combiner ces attributs à l’aide d’une condition Et ou Ou.

Les options du composant Operator (Opérateur) 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.

Les options du composant Type sont les suivantes :

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

  • 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.L’attribut est inférieur à la valeur.
  • Est inférieur ou égal à
Value Table
Type de résultat
(Facultatif)

Spécifie le type de résultat renvoyé par la trace.

  • SélectionLes résultats de la trace sont renvoyés comme un ensemble de sélections 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 de la trace sont agrégés par type de géométrie et stockés dans les classes d’entités affichées sur les couches de la carte active.
  • Couches réseauLes résultats de la trace sont ajoutés aux couches d’entités en tant que jeu de sélection au sein d’une couche de groupe.
  • ConnectivitéLes résultats de la trace sont renvoyés sous forme de graphe de connectivité dans un fichier .json en sortie spécifié. Cette option permet d’activer le paramètre Output JSON (JSON en sortie).
  • ElémentsLes résultats de la trace sont renvoyés sous forme d'informations basées sur les entités dans un fichier .json en sortie spécifié. Cette option permet d’activer le paramètre Output JSON (JSON en sortie).
String
Type de sélection

Spécifie la manière dont la sélection est appliquée et la marche à suivre si une sélection 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 finale 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 (Effacer tous les résultats de trace précédents)
(Facultatif)

Indique si le contenu sera tronqué des classes d’entités choisies pour stocker la géométrie agrégée ou ajouté à celles-ci. Ce paramètre ne s’applique qu’au type de résultat de la géométrie agrégée.

  • Activé : les classes d’entités dans lesquelles est stockée la géométrie agrégée de la trace seront tronquées. Seule la géométrie en sortie issue de l’opération actuelle de traçage est écrite. Il s’agit de l’option par défaut.
  • Non coché : la 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 (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 ne s’applique qu’au type de résultat de la géométrie agrégée.

String
Aggregated Points (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 complété avec une classe d’entités généré 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 automatiquement créée 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 vous utilisez une classe d’entités autre que la classe d’entités par défaut, il doit s’agir d’une classe d’entités multi-points qui contient un champ de chaîne nommé TRACENAME. Ce paramètre ne s’applique qu’au type de résultat de la géométrie agrégée.

Feature Class
Aggregated Lines (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 complété avec une classe d’entités généré 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 automatiquement créée 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 vous utilisez une classe d’entités autre que la classe d’entités par défaut, il doit s’agir d’une classe d’entités polylignes qui contient un champ de chaîne nommé TRACENAME. Ce paramètre ne s’applique qu’au type de résultat de la géométrie agrégée.

Feature Class
Nom de la couche de groupe en sortie
(Facultatif)

Nom de la couche de groupe en sortie qui contient les couches d’entités avec les jeux de sélection retournés par la trace. Cette couche permet d’accéder à la sortie d’une trace dans ModelBuilder et Python.

Ce paramètre ne s’applique qu’au type de résultat des couches de réseau.

Group Layer
Utiliser une configuration de trace
(Facultatif)

Indique si une configuration de trace nommée existante doit être utilisée pour renseigner les paramètres de l’outil Trace.

  • Activé : une configuration de trace nommée existante est utilisée pour définir les propriétés de la trace. Tous les paramètres, sauf Nom de la configuration de trace, Points de départ et Interruptions sont ignorés.
  • Désactivé : aucune configuration de trace nommée existante n’est utilisée pour définir les propriétés de la trace. Il s’agit de l’option par défaut.

Remarque :

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

Boolean
Nom de la configuration de trace
(Facultatif)

Le nom de la configuration de trace à utiliser pour définir les propriétés de la trace. Ce paramètre n’est actif que si l’option Utiliser une configuration de trace est sélectionnée.

Remarque :

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

String
JSON en sortie
(Facultatif)

Nom et emplacement du fichier .json qui sera généré.

File

Sortie obtenue

ÉtiquetteExplicationType de données
Réseau de traces mis à jour

Réseau de traces actualisé.

Any Value

arcpy.tn.Trace(in_trace_network, trace_type, starting_points, {barriers}, {path_direction}, {shortest_path_network_attribute_name}, {include_barriers}, {validate_consistency}, {ignore_barriers_at_starting_points}, {allow_indeterminate_flow}, {condition_barriers}, {function_barriers}, {traversability_scope}, {functions}, {output_conditions}, {result_types}, selection_type, {clear_all_previous_trace_results}, {trace_name}, {aggregated_points}, {aggregated_lines}, {out_network_layer}, {use_trace_config}, {trace_config_name}, {out_json_file})
NomExplicationType de données
in_trace_network

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

Trace Network; Trace Network Layer
trace_type

Spécifie le type de trace à exécuter.

  • CONNECTEDUne trace connectée qui commence à un ou plusieurs points de départ et s’étend le long des entités connectées est utilisée.
  • UPSTREAMUne trace en amont qui découvre les entités en amont depuis un emplacement dans le réseau est utilisé. Ce type de trace nécessite que le sens de circulation soit défini.
  • DOWNSTREAMUne trace en aval qui découvre les entités en aval depuis un emplacement dans le réseau est utilisé. Ce type de trace nécessite que le sens de circulation soit défini.
  • SHORTEST_PATHUne trace qui recherche le chemin le plus court entre deux points de début sur le réseau, quel que soit le sens de circulation, est utilisé. Le coût du parcours du chemin est déterminé en fonction de l’attribut de réseau défini pour le paramètre shortest_path_network_attribute_name.
String
starting_points

Couche d’entités créée à l’aide de l’onglet Points de départ dans la fenêtre Emplacements de trace, ou classe d’entités ponctuelles contenant une ou plusieurs entités qui représentent les points de départ du traçage. La classe d’entités TN_Temp_Starting_Points est utilisée par défaut et est générée dans la géodatabase par défaut du projet lors de la création des points de début à l’aide de l’outil Starting Points (Points de début) dans la fenêtre Trace Locations (Emplacement des traces).

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 la trace d’aller au-delà de ce point. La classe d’entités TN_Temp_Barriers est utilisée par défaut et est générée dans la géodatabase par défaut du projet lors de la création des interruptions à l’aide de l’onglet Interruptions dans la fenêtre Emplacement des traces.

Feature Layer; Table View
path_direction
(Facultatif)

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

  • NO_DIRECTIONLe chemin entre les deux points de début, quel que soit le sens de circulation, est utilisé. Il s’agit de l’option par défaut.
  • PATH_UPSTREAMLe chemin en amont entre les deux points de début est utilisé.
  • PATH_DOWNSTREAMLe chemin en aval entre les deux points de début est utilisé.
String
shortest_path_network_attribute_name
(Facultatif)

Nom de l’attribut de réseau utilisé pour calculer le chemin. 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_barriers
(Facultatif)

Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la trace.

  • 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 retournée lorsqu’une zone à valider figure dans les entités traversé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 parcours retourne une erreur si une zone à valider figure dans les entités traversées. Il s’agit de l’option par défaut.
  • DO_NOT_VALIDATE_CONSISTENCYLe parcours retourne des résultats qu’une zone à valider figure ou non dans les entités traversées.
Boolean
ignore_barriers_at_starting_points
(Facultatif)

Spécifie si les interruptions dans la configuration de trace sont ignorées pour les points de début.

  • 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
allow_indeterminate_flow
(Facultatif)

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

  • TRACE_INDETERMINATE_FLOWLes entités dont le sens de flux est indéterminé ou non initialisé sont tracées.
  • IGNORE_INDETERMINATE_FLOWLes entités dont le sens de flux est indéterminé ou non initialisé ne sont pas tracé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 capacité à être traversé sur les entités en fonction d’une comparaison avec un attribut de réseau. Une interruption conditionnelle utilise un attribut de réseau, un opérateur et un type, ainsi qu’une valeur attributaire. Par exemple, arrêtez un traçage lorsque l’attribut Code d’une entité est égal à la valeur spécifique de ArtificialPath. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. Si vous utilisez plusieurs attributs, vous pouvez utiliser le composant Combine Using pour définir une condition Et ou Ou.

Les composants de l'interruption conditionnelle sont les suivants :

  • Name : filtrez par n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez un nombre de différents opérateurs.
  • Type : choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le composant Name.
  • Value : indiquez la valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Combine Using : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez combiner ces attributs à l’aide d’une condition Et ou Ou.

Les composants du type Operator sont les suivants :

  • 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.

Les composants du type Type sont les suivants :

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

Les composants du type Combine Using sont les suivants :

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

Définit l’interruption de traversabilité sur les entités en fonction d’une fonction. Les interruptions fonctionnelles peuvent être utilisées, par exemple, pour limiter la distance que la trace peut parcourir depuis le point de début, ou définir une valeur maximale à laquelle arrêter une trace. Par exemple, la longueur de chaque ligne parcourue est ajoutée à la distance totale parcourue jusqu’ici. Lorsque la distance totale parcourue atteint la valeur spécifiée, le traçage s’arrête.

Les composants de l'interruption fonctionnelle sont les suivants :

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

Les composants du type Function sont les suivants :

  • AVERAGEMoyenne des valeurs en entrée.
  • COUNTNombre d’entités.
  • MAXMaximum des valeurs en entrée.
  • MINMinimum des valeurs en entrée.
  • ADDAjoutez les valeurs.
  • SUBTRACTSoustrayez les valeurs.

Les composants du type Operator sont les suivants :

  • 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.

Les composants du type Use Local Values sont les suivants :

  • TRUEUtilisez les valeurs locales.
  • FALSEUtilisez les valeurs globales. Il s’agit de l’option par défaut.
Value Table
traversability_scope
(Facultatif)

Spécifie le type de traversabilité qui sera appliqué. La portée de la capacité à être traversé détermine si la capacité à être traversé est appliquée aux jonctions, tronçons, ou aux deux. Par exemple, dans un réseau de pistes de loisirs, si une interruption conditionnelle est définie pour arrêter la trace lorsque le type de piste est défini comme étant du gravier et que la portée de la capacité à être traversé est définie sur les jonctions uniquement, la trace ne s’arrêtera pas, même si elle rencontre un chemin en gravier, car le type de chemin s’applique uniquement aux tronçons.

  • BOTH_JUNCTIONS_AND_EDGESLa capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • JUNCTIONS_ONLYLa capacité à être traversé s’applique uniquement aux jonctions.
  • EDGES_ONLYLa capacité à être traversé s’applique uniquement aux tronçons.
String
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 une des fonctions de calcul.
  • Attribute : filtrez par n’importe quel 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 un des opérateurs.
  • Filter Type : choisissez un nombre de types de filtre.
  • Filter Value : fournit une valeur spécifique de l’attribut de filtrage en entrée.

Les options du composant Function sont les suivantes :

  • AVERAGEMoyenne des valeurs en entrée.
  • COUNTNombre d’entités.
  • MAXMaximum des valeurs en entrée.
  • MINMinimum des valeurs en entrée.
  • ADDLa somme des valeurs.
  • SUBTRACTLa différence entre les valeurs.

Par exemple, vous avez une entité de points de début avec une valeur de 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction MIN, le résultat est de 20. Avec MAX il est de 30, avec ADD, de 50, avec AVERAGE, de 25, avec COUNT, de 2, et avec SUBTRACT, de -10.

Les options du composant 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_THANL’attribut est inférieur à la valeur.

Les options du composant Filter Type sont les suivantes :

  • SPECIFIC_VALUEFiltrez en fonction d’une valeur spécifique.
  • NETWORK_ATTRIBUTEFiltrez en fonction d’un attribut de réseau.
Value Table
output_conditions
[[Name, Operator, Type, Value, Combine Using],...]
(Facultatif)

Types des entités renvoyées selon un attribut de réseau. Par exemple, sur une trace configurée pour filtrer toutes les entités sauf les entités Tap (Dérivation), toute entité tracée à laquelle l’attribut Tap (Dérivation) n’est pas attribué 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. Si vous utilisez plusieurs attributs, vous pouvez utiliser l’option Combine Using pour définir une condition Et ou Ou.

Les composants des Conditions de sortie sont les suivants :

  • Name : filtrez par n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez un des opérateurs.
  • Type : choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le composant Name.
  • Value : fournit une valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Combine Using : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez combiner ces attributs à l’aide d’une condition Et ou Ou.

Les options du composant 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_THANL’attribut est inférieur à la valeur.

Les options du composant Type sont les suivantes :

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

Les options du composant Combine Using sont les suivantes :

  • ANDCombinez les conditions.
  • ORUtilisez ce paramètre si l’une des conditions est satisfaite.
Value Table
result_types
[result_types,...]
(Facultatif)

Spécifie le type de résultat renvoyé par la trace.

  • SELECTIONLes résultats de la trace sont renvoyés comme un ensemble de sélections des entités de réseau appropriées. Il s’agit de l’option par défaut.
  • AGGREGATED_GEOMETRYLes résultats de la trace sont agrégés par type de géométrie et stockés dans les classes d’entités affichées sur les couches de la carte active.
  • NETWORK_LAYERSLes résultats de la trace sont ajoutés aux couches d’entités en tant que jeu de sélection au sein d’une couche de groupe.
  • CONNECTIVITYLes résultats de la trace sont renvoyés sous forme de graphe de connectivité dans un fichier .json en sortie spécifié. Cette option permet d’activer le paramètre out_json_file.
  • ELEMENTSLes résultats de la trace sont renvoyés sous forme d'éléments d'entité dans un fichier .json en sortie spécifié. Cette option permet d’activer le paramètre out_json_file.
String
selection_type

Spécifie la manière dont la sélection est appliquée et la marche à suivre si une sélection 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 finale 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 pour stocker la géométrie agrégée ou ajouté à celles-ci. Ce paramètre ne s’applique qu’au type de résultat de la géométrie agrégée.

  • CLEAR_ALL_PREVIOUS_TRACE_RESULTSLes classes d’entités dans lesquelles est stockée la géométrie agrégée de la trace seront tronquées. Seule la géométrie en sortie issue de l’opération actuelle de traçage est é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 ne s’applique qu’au type de résultat de la 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 complété avec une classe d’entités généré 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 automatiquement créée 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 vous utilisez une classe d’entités autre que la classe d’entités par défaut, il doit s’agir d’une classe d’entités multi-points qui contient un champ de chaîne nommé TRACENAME. Ce paramètre ne s’applique qu’au type de résultat de la 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 complété avec une classe d’entités généré 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 automatiquement créée 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 vous utilisez une classe d’entités autre que la classe d’entités par défaut, il doit s’agir d’une classe d’entités polylignes qui contient un champ de chaîne nommé TRACENAME. Ce paramètre ne s’applique qu’au type de résultat de la géométrie agrégée.

Feature Class
out_network_layer
(Facultatif)

Nom de la couche de groupe en sortie qui contient les couches d’entités avec les jeux de sélection retournés par la trace. Cette couche permet d’accéder à la sortie d’une trace dans ModelBuilder et Python.

Ce paramètre ne s’applique qu’au type de résultat des couches de réseau.

Group Layer
use_trace_config
(Facultatif)

Indique si une configuration de trace nommée existante doit être utilisée pour renseigner les paramètres de l’outil Trace.

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

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

Boolean
trace_config_name
(Facultatif)

Le nom de la configuration de trace à utiliser pour définir les propriétés de la trace. Ce paramètre n’est activé que lorsque le paramètre use_trace_config est défini sur USE_TRACE_CONFIGURATION.

Remarque :

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

String
out_json_file
(Facultatif)

Nom et emplacement du fichier .json qui sera généré.

File

Sortie obtenue

NomExplicationType de données
updated_trace_network

Réseau de traces actualisé.

Any Value

Exemple de code

Exemple d’utilisation de l’outil Trace (fenêtre Python)

Exécutez une trace en aval sur un réseau de traces nommé HydroNetwork à l’aide de la fonction Trace.

import arcpy
arcpy.Trace_tn(r"C:\MyProject\NHD.gdb\Hydro\HydroNetwork", 
               "DOWNSTREAM", r"C:\MyProject\NHD.gdb\TN_Temp_Starting_Points")

Environnements

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

Informations de licence

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

Rubriques connexes