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

Résumé

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

Les configurations de traces 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 être de version 2 ou 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 indiqué comme créateur de la configuration de trace.

  • L’authentification du système d’exploitation permet d’enregistrer le créateur d’une configuration de tracé en cas d’utilisation d’un réseau de traces dans une géodatabase fichier.

Syntaxe

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})

Paramètre	Explication	Type de données
in_trace_network	Réseau de traces qui contient la nouvelle configuration de trace.	Trace Network; Trace Network Layer
trace_config_name	Nom de la configuration de trace.	String
trace_type	Spécifie le type de trace à configurer. CONNECTED —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 —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 utilise le sens de circulation. 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 utilise le sens de circulation. SHORTEST_PATH —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_attribute_name.	String
description (Facultatif)	Description de la configuration de trace.	String
tags [tags,...] (Facultatif)	Ensemble de balises utilisées pour identifier la configuration de trace. 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_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’une trace de type Chemin le plus 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_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 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_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 non initialisé ou indéterminé sont tracées. IGNORE_INDETERMINATE_FLOW —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
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 une trace 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 And (Et) ou Or (Ou). Les composants d’interruptions conditionnelles 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 les combiner à l’aide d’une condition Et ou d’une condition Ou. Les composants du type Operator sont les suivants : IS_EQUAL_TO —L’attribut est égal à la valeur. DOES_NOT_EQUAL —L’attribut est différent de la valeur. IS_GREATER_THAN —L’attribut est supérieur à la valeur. IS_GREATER_THAN_OR_EQUAL_TO —L’attribut est supérieur ou égal à la valeur. IS_LESS_THAN —L’attribut est inférieur à la valeur. IS_LESS_THAN_OR_EQUAL_TO —L’attribut est inférieur ou égal à la valeur. Les composants du type Type sont les suivants : SPECIFIC_VALUE —Filtrez en fonction d’une valeur spécifique. NETWORK_ATTRIBUTE —Filtrez en fonction d’un attribut de réseau. Les composants du type Combine Using sont les suivants : AND —Combinez les interruptions conditionnelles. OR —Utilisez le paramètre Or (Ou) 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 d’interruptions de fonctions sont les suivants : Function : choisissez une des fonctions de calcul. Attribute : filtrez par un 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. Lorsque des valeurs locales sont utilisées, celles-ci changent le long de chaque chemin et le traçage se poursuit. Les composants du type Function sont les suivants : AVERAGE —Moyenne des valeurs en entrée. COUNT —Nombre d’entités. MAX —Maximum des valeurs en entrée. MIN —Minimum des valeurs en entrée. ADD —Ajoutez les valeurs. SUBTRACT —Soustrayez les valeurs. Les composants du type Operator sont les suivants : IS_EQUAL_TO —L’attribut est égal à la valeur. DOES_NOT_EQUAL —L’attribut est différent de la valeur. IS_GREATER_THAN —L’attribut est supérieur à la valeur. IS_GREATER_THAN_OR_EQUAL_TO —L’attribut est supérieur ou égal à la valeur. IS_LESS_THAN —L’attribut est inférieur à la valeur. IS_LESS_THAN —L’attribut est inférieur à la valeur. Les composants du type Use Local Values sont les suivants : TRUE —Utilisez les valeurs locales. FALSE —Utilisez les valeurs globales. 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_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],...] (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 un attribut de réseau défini dans le système. Filter Name : filtrez les résultats de fonction par nom d’attribut. Filter Operator : choisissez 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 : AVERAGE —Moyenne des valeurs en entrée. COUNT —Nombre d’entités. MAX —Maximum des valeurs en entrée. MIN —Minimum des valeurs en entrée. ADD —La somme des valeurs. SUBTRACT —La 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. MAX est égal à 30, ADD est 50, AVERAGE est égal à 25, COUNT est 2, et SUBTRACT est -10. Les options du composant Filter Operator sont les suivantes : IS_EQUAL_TO —L’attribut est égal à la valeur. DOES_NOT_EQUAL —L’attribut est différent de la valeur. IS_GREATER_THAN —L’attribut est supérieur à la valeur. IS_GREATER_THAN_OR_EQUAL_TO —L’attribut est supérieur ou égal à la valeur. IS_LESS_THAN —L’attribut est inférieur à la valeur. IS_LESS_THAN —L’attribut est inférieur à la valeur. Les options du composant Filter Type sont les suivantes : SPECIFIC_VALUE —Filtrez en fonction d’une valeur spécifique. NETWORK_ATTRIBUTE —Filtrez 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 les combiner à l’aide d’une condition Et ou d’une condition Ou. Les options du composant Operator sont les suivantes : IS_EQUAL_TO —L’attribut est égal à la valeur. DOES_NOT_EQUAL —L’attribut est différent de la valeur. IS_GREATER_THAN —L’attribut est supérieur à la valeur. IS_GREATER_THAN_OR_EQUAL_TO —L’attribut est supérieur ou égal à la valeur. IS_LESS_THAN —L’attribut est inférieur à la valeur. IS_LESS_THAN —L’attribut est inférieur à la valeur. Les options du composant Type sont les suivantes : SPECIFIC_VALUE —Filtrez en fonction d’une valeur spécifique. NETWORK_ATTRIBUTE —Filtrez en fonction d’un attribut de réseau. Les options du composant Combine Using sont les suivantes : AND —Combinez les conditions. OR —Utilisez le paramètre Or (Ou) 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. 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.	String

Sortie dérivée

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

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 au réseau de traces 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