Ajouter la configuration de trace (Réseau de traces)

Synthèse

Crée une configuration de trace nommée dans le réseau de traces.

Les configurations de traces nommées permettent de configurer et de stocker les propriétés de traces complexes à des fins de réutilisation et de partage. Les configurations de traces stockées dans un réseau de traces peuvent être chargées et exécutées à partir de l’outil Trace ou partagées au moyen d’un service de carte consommé par une carte Web ou une application de terrain.

En savoir plus sur l’ajout d’une configuration de trace

Utilisation

  • Le réseau de traces en entrée doit correspondre à la version 2 ou une version ultérieure.

  • Si une géodatabase d’entreprise est utilisée, le réseau de traces en entrée doit provenir d’un service de réseau de traces.

  • Le compte connecté au portail est défini comme créateur de la configuration de trace nommée.

    • L’authentification du système d’exploitation permet d’enregistrer le créateur d’une configuration de tracé lors de l’utilisation d’un déploiement mono-utilisateur du réseau de traces.

Paramètres

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

Réseau de traces qui contient la nouvelle configuration de trace nommée.

Trace Network; Trace Network Layer
Nom de la configuration de trace

Nom de la configuration de trace nommée.

String
Type de traçage

Spécifie le type de trace à configurer.

  • 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 utilise le sens de circulation.
  • 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 utilise le sens de circulation.
  • 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
Description
(Facultatif)

Description de la configuration de trace nommée.

String
Balises
(Facultatif)

Ensemble de balises utilisées pour identifier la configuration de trace nommée. Les balises peuvent être utilisées pour les recherches et l’indexation.

String
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 non initialisé ou indéterminé sont tracées.
  • Désactivé : les entités dont le sens de flux est non initialisé ou indéterminé 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 composant 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.
  • EffectifNombre 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 àL’attribut est inférieur ou égal à la valeur.
Value Table
Appliquer la traversabilité à
(Facultatif)

Spécifie si la traversabilité est appliquée à des jonctions, des tronçons ou les 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. En d’autres termes, ce paramètre indique à la trace d’ignorer ou non les jonctions, les tronçons, ou d’inclure à la fois les jonctions et les 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 de calcul appliquée 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, une entité de point de départ a 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.
  • EffectifNombre 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.
  • Est inférieur ou égal àL’attribut est inférieur ou égal à la valeur.
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 Dérivation, toute entité tracée à laquelle l’attribut 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.
  • Est inférieur ou égal àL’attribut est inférieur ou égal à la valeur.
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.
String

Sortie obtenue

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

Réseau de traces actualisé.

Trace Network

arcpy.tn.AddTraceConfiguration(in_trace_network, trace_config_name, trace_type, {description}, {tags}, {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})
NomExplicationType de données
in_trace_network

Réseau de traces qui contient la nouvelle configuration de trace nommée.

Trace Network; Trace Network Layer
trace_config_name

Nom de la configuration de trace nommée.

String
trace_type

Spécifie le type de trace à configurer.

  • 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 utilise le sens de circulation.
  • 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 utilise le sens de circulation.
  • 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
description
(Facultatif)

Description de la configuration de trace nommée.

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

Ensemble de balises utilisées pour identifier la configuration de trace nommée. Les balises peuvent être utilisées pour les recherches et l’indexation.

String
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 non initialisé ou indéterminé sont tracées.
  • IGNORE_INDETERMINATE_FLOWLes entités dont le sens de flux est non initialisé ou indéterminé 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 d’opérateurs différents.
  • 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.
  • ADDLa somme des valeurs.
  • SUBTRACTLa différence entre 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_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 :

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

Spécifie si la traversabilité est appliquée à des jonctions, des tronçons ou les 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. En d’autres termes, ce paramètre indique à la trace d’ignorer ou non les jonctions, les tronçons, ou d’inclure à la fois les jonctions et les 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 de calcul appliquée 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, une entité de point de départ a une valeur de 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction MIN, le résultat est 20, avec MAX, 30, avec ADD, 50, avec AVERAGE, 25, avec COUNT, 2 et avec SUBTRACT, -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_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à 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 Dérivation, toute entité tracée à laquelle l’attribut 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_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à 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.
String

Sortie obtenue

NomExplicationType de données
updated_trace_network

Réseau de traces actualisé.

Trace Network

Exemple de code

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

Cet exemple de script ajoute une configuration de trace nommée Upstream_HUC12 à un réseau de traces nommé HydroNetwork.

import arcpy
arcpy.AddTraceConfiguration_un(
        r"HydroNetwork", "Upstream_HUC12", "UPSTREAM", 
        "Upstream trace for HUC12_allow indeterminate", "HUC12;Upstream", 
        "NO_DIRECTION", '', "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", 
        "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", "TRACE_INDETERMINATE_FLOW", 
        None, None, "BOTH_JUNCTIONS_AND_EDGES", None, None, None)

Environnements

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

Informations de licence

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

Rubriques connexes