Traçage (Outils du réseau de traces)

Résumé

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 Result Types(Types de résultats) sur Aggregate Geometry (Agréger la géométrie). Lorsqu’un point de départ 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 Traçage repose sur la topologie du réseau, la précision des résultats du traçage 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).

Etiqueter	Explication	Type 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é) : un traçage connecté commence à un ou plusieurs points de départ et s’étend le long des entités connectées. Upstream (En amont) : un traçage en amont découvre les entités en amont depuis une localisation figurant dans le réseau. Ce type de trace nécessite que le sens de circulation soit défini. Downstream (En aval) : un traçage en aval découvre les entités en aval depuis une localisation figurant dans le réseau. Ce type de trace nécessite que le sens de circulation soit défini. Shortest path (Chemin le plus court) : un traçage recherche le chemin le plus court entre deux points de départ sur le réseau, quel que soit le sens de flux. Le coût de traversée 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 d’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 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. 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. Plus court chemin—Un traçage recherche le chemin le plus court entre deux points de départ sur le réseau, quel que soit le sens de flux. Le coût de traversée 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 Starting Points (Points de départ) dans la fenêtre Trace Locations (Localisations de traçage), 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 générée dans la géodatabase par défaut du projet lorsque vous créez des points de début à l’aide de l’outil Points de départ dans la fenêtre Trace Locations (Localisations de traçage).	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 le traçage d’aller au-delà de ce point. La classe d’entités TN_Temp_Barriers est utilisée par défaut et 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 Barriers (Interruptions) dans la fenêtre Trace Locations (Localisations de traçage).	Feature Layer; Table View
Path Direction (Direction du chemin) (Facultatif)	Indique la direction du chemin de la trace. Le coût de traversée du chemin est déterminé en fonction de la valeur du paramètre Shortest Path Network Attribut Name (Nom d’attribut de réseau du chemin le plus court). Ce paramètre est respecté uniquement lors de l’exécution d’un traçage 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 recherche de parcours. Activé—Les 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. Décoché—Les entités d’interruption de capacité à être traversé ne sont pas incluses dans les résultats de traçage.	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 traçage renvoie une erreur si une zone à valider figure dans les entités traversées. Il s’agit de l’option par défaut. Décoché—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ébut) (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écoché—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
Autoriser la circulation indéterminée (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écoché—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 Et ou Ou. Colonnes de la table de valeurs : Name—Filter by network attribute name. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Type—Filter by a specific type. Specific value—Filter by a specific value. Network attribute—Filter by a network attribute. Value—Filter by a specific value. Combine Using—Combine multiple condition barriers. And—Combine the condition barriers. Or—Use if either condition barrier is met.	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. Colonnes de la table de valeurs : Function—Filter by a function. Min—The minimum of the input values. Max—The maximum of the input values. Average—The average of the input values. Count—The number of features. Add—Add the values. Subtract—Subtract the values. Attribute—Filter by a network attribute. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Value—Filter by a specific value. Use Local Values—Boolean value to use local variables instead of a global variable.	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çons—La capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut. Jonctions uniquement—La capacité à être traversé s’applique uniquement aux jonctions. Tronçons uniquement—La 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. Colonnes de la table de valeurs : Function—Filter by a function. Min—The minimum of the input values. Max—The maximum of the input values. Average—The average of the input values. Count—The number of features. Add—The sum of the values. Subtract—The difference between the values. Attribute—Filter by a network attribute Filter Name—Filter by attribute name. Filter Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Filter Type—Filter by attribute type. Specific value—Filter by a specific value. Network attribute—Filter by a network attribute. Filter Value—Filter by a specific value. Function Name—The name for the alias to describe the function result.	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. Colonnes de la table de valeurs : Name—Filter by network attribute name. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Type—Filter by a specific type. Specific value—Filter by a specific value. Network attribute—Filter by a network attribute. Value—Filter by a specific value. Combine Using—Combine multiple conditions. And—Combine the conditions. Or—Use if either condition is met.	Value Table
Type de résultat (Facultatif)	Spécifie le type de résultat renvoyé par la trace. Sélection—Les 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ée—Les 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éseau—Les 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 du traçage sont renvoyés sous forme d’un graphe de connectivité dans un fichier `.json` en sortie spécifié. Cette option active le paramètre Output JSON (JSON en sortie). Eléments—Les 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é. Cette option active 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élection—La sélection obtenue remplace la sélection courante. Il s’agit de l’option par défaut. Ajouter à la sélection actuelle—La 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 actuelle—La 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 actuelle—La sélection obtenue est associée à la sélection courante. Seuls les enregistrements communs aux deux restent sélectionnés. Inverser la sélection actuelle—La 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
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 s’applique uniquement au type de résultat 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 sera écrite. Il s’agit de l’option par défaut. Dé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
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 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 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 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 s’applique uniquement au type de résultat 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 renvoyés par le traçage. Cette couche permet d’accéder à la sortie d’un traçage 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 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 l’outil Traçage. Remarque : Ce paramètre nécessite un réseau de traces en version 2 ou version ultérieure. 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 Trace Configuration Name (Nom de la configuration du tracé), Starting Points (Points de départ) et Barriers (Interruptions) sont ignorés. Décoché—Aucune configuration de trace nommée existante n’est utilisée pour définir les propriétés de la trace. Il s’agit de l’option par défaut.	Boolean
Nom de la configuration de trace (Facultatif)	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 Use Trace Configuration (Utiliser une configuration de tracé) est sélectionnée. Remarque : Ce paramètre nécessite un réseau de traces en version 2 ou version ultérieure.	String
JSON en sortie (Facultatif)	Nom et emplacement du fichier `.json` qui sera généré.	File

Sortie dérivée

Etiqueter	Explication	Type 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})

Nom	Explication	Type 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. `CONNECTED`—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. `UPSTREAM`—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`—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`—Un traçage recherche le chemin le plus court entre deux points de départ sur le réseau, quel que soit le sens de flux. Le coût de traversée 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 Starting Points (Points de départ) dans la fenêtre Trace Locations (Localisations de traçage), 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 générée dans la géodatabase par défaut du projet lorsque vous créez des points de début à l’aide de l’outil Points de départ dans la fenêtre Trace Locations (Localisations de traçage).	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. La classe d’entités TN_Temp_Barriers est utilisée par défaut et 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 Barriers (Interruptions) dans la fenêtre Trace Locations (Localisations de traçage).	Feature Layer; Table View
path_direction (Facultatif)	Indique la direction du chemin de la trace. Le coût de traversée 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_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. `PATH_UPSTREAM`—Le chemin en amont entre les deux points de début est utilisé. `PATH_DOWNSTREAM`—Le 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 recherche de parcours. `INCLUDE_BARRIERS`—Les 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_BARRIERS`—Les 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_CONSISTENCY`—Le traçage renvoie 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_CONSISTENCY`—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 (Facultatif)	Spécifie si les interruptions dans la configuration de trace sont ignorées pour les points de début. `IGNORE_BARRIERS_AT_STARTING_POINTS`—Les interruptions au points de départ sont ignorées dans le traçage. `DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS`—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 (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_FLOW`—Les entités dont le sens de flux est indéterminé ou non initialisé sont tracées. `IGNORE_INDETERMINATE_FLOW`—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
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. Colonnes de la table de valeurs : `Name`—Filter by network attribute name. `Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `Type`—Filter by a specific type. `SPECIFIC_VALUE`—Filter by a specific value. `NETWORK_ATTRIBUTE`—Filter by a network attribute. `Value`—Filter by a specific value. `Combine Using`—Combine multiple condition barriers. `AND`—Combine the condition barriers. `OR`—Use if either condition barrier is met.	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. Colonnes de la table de valeurs : `Function`—Filter by a function. `MIN`—The minimum of the input values. `MAX`—The maximum of the input values. `AVERAGE`—The average of the input values. `COUNT`—The number of features. `ADD`—Add the values. `SUBTRACT`—Subtract the values. `Attribute`—Filter by a network attribute. `Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `Value`—Filter by a specific value. `Use Local Values`—Boolean value to use local variables instead of a global variable.	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_EDGES`—La capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut. `JUNCTIONS_ONLY`—La capacité à être traversé s’applique uniquement aux jonctions. `EDGES_ONLY`—La capacité à être traversé s’applique uniquement aux tronçons.	String
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value, Function Name],...] (Facultatif)	Fonction(s) de calcul appliquée(s) aux résultats du traçage. Colonnes de la table de valeurs : `Function`—Filter by a function. `MIN`—The minimum of the input values. `MAX`—The maximum of the input values. `AVERAGE`—The average of the input values. `COUNT`—The number of features. `ADD`—The sum of the values. `SUBTRACT`—The difference between the values. `Attribute`—Filter by a network attribute `Filter Name`—Filter by attribute name. `Filter Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `Filter Type`—Filter by attribute type. `SPECIFIC_VALUE`—Filter by a specific value. `NETWORK_ATTRIBUTE`—Filter by a network attribute. `Filter Value`—Filter by a specific value. `Function Name`—The name for the alias to describe the function result.	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. Colonnes de la table de valeurs : `Name`—Filter by network attribute name. `Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `Type`—Filter by a specific type. `SPECIFIC_VALUE`—Filter by a specific value. `NETWORK_ATTRIBUTE`—Filter by a network attribute. `Value`—Filter by a specific value. `Combine Using`—Combine multiple conditions. `AND`—Combine the conditions. `OR`—Use if either condition is met.	Value Table
result_types [result_types,...] (Facultatif)	Spécifie le type de résultat renvoyé par la trace. `SELECTION`—Les 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_GEOMETRY`—Les 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_LAYERS`—Les 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. `CONNECTIVITY`—Les résultats du traçage sont renvoyés sous forme d’un graphe de connectivité dans un fichier `.json` en sortie spécifié. Cette option permet d’activer le paramètre `out_json_file`. `ELEMENTS`—Les résultats du traçage 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_SELECTION`—La sélection obtenue remplace la sélection courante. Il s’agit de l’option par défaut. `ADD_TO_SELECTION`—La 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_SELECTION`—La 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_SELECTION`—La sélection obtenue est associée à la sélection courante. Seuls les enregistrements communs aux deux restent sélectionnés. `SWITCH_SELECTION`—La 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 s’applique uniquement au type de résultat Géométrie agrégée. `CLEAR_ALL_PREVIOUS_TRACE_RESULTS`—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 sera écrite. Il s’agit de l’option par défaut. `DO_NOT_CLEAR_ALL_PREVIOUS_TRACE_RESULTS`—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 (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 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 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 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 s’applique uniquement au type de résultat 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 renvoyés par le traçage. Cette couche permet d’accéder à la sortie d’un traçage 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 tracé nommée existante doit être utilisée pour renseigner les paramètres de l’outil Traçage. Remarque : Ce paramètre nécessite un réseau de traces en version 2 ou version ultérieure. `USE_TRACE_CONFIGURATION`—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 `trace_config_name`, `starting_points` et `barriers`, sont ignorés. `DO_NOT_USE_TRACE_CONFIGURATION`—Aucune configuration de trace nommée existante n’est utilisée pour définir les propriétés de la trace. Il s’agit de l’option par défaut.	Boolean
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 en version 2 ou version ultérieure.	String
out_json_file (Facultatif)	Nom et emplacement du fichier `.json` qui sera généré.	File

Sortie dérivée

Nom	Explication	Type de données
updated_trace_network	Réseau de traces actualisé.	Any Value

Exemple de code

Exemple d’utilisation de la fonction Trace (fenêtre Python)

Exécutez une trace en aval sur un réseau de traces nommé HydroNetwork pour renvoyer les entités situées à moins de 500 mètres du point de départ. Le résultat sera un groupe de couches avec une sélection à l’aide du type de résultat Couches de réseau.

'''****************************************************************************
Name:        UpstreamTrace.py
Description: This script runs an upstream trace in a trace network from a 
             specified starting point to return the total length of the 
             features using the network layers result type.
Created by:  Esri
****************************************************************************'''

# Import required modules
import arcpy

# Set local variables
in_trace_network = "Hydro Network"
trace_type = "UPSTREAM"
starting_points = "C:\\MyProject\\HydroTN.gdb\\TN_Temp_Starting_Points"
barriers = "C:\\MyProject\\HydroTN.gdb\\TN_Temp_Barriers"
path_direction = "NO_DIRECTION"
include_barriers = "INCLUDE_BARRIERS"
functions = "ADD 'Shape length' # # # # 'Total Length (Meters)'"
result_types = "NETWORK_LAYERS"
out_network_layer = "My_Trace_Result"

# Run Trace with specified parameters and leave the rest default
arcpy.tn.Trace(in_trace_network,
               trace_type,
               starting_points,
               barriers,
               path_direction,
               include_barriers,
               functions,
               result_types,
               out_network_layer)

Environnements

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

Informations de licence

Basic: Limité
Prise en charge dans un déploiement d’entreprise lors de l’utilisation de licences d’utilisateur nommé dans ArcGIS Enterprise.
Standard: Oui
Advanced: Oui

Traçage (Outils du réseau de traces)

Résumé

Utilisation

Paramètres

Remarque :

Remarque :

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes