Résumé
Ajoute une règle de diagramme pour exécuter automatiquement un traçage sur un réseau de distribution ou un réseau de traçage lors de la génération de diagrammes en fonction d’un modèle existant. Les entités de réseau et les objets réseau tracés qui en résultent sont utilisés pour créer le contenu des diagrammes.
Pour en savoir plus sur l’utilisation de la règle de traçage en vue de construire des diagrammes
Attention :
Cet outil est un outil de configuration et d’administration.
Remarque :
Cet outil impacte la cohérence des diagrammes existants basés sur le modèle de diagramme en entrée. Tous les diagrammes existants demeurent incohérents et s’ouvrent avec une icône d’avertissement sur la cohérence jusqu’à leur mise à jour.
Utilisation
Cet outil n’est pas pris en charge en cas d’utilisation d’un service de réseau technique ou de réseau de traces. Vous devez utiliser un réseau technique ou un réseau de traçages dans une géodatabase fichier ou une connexion de base de données à un réseau technique ou à un réseau de traces dans une géodatabase d’entreprise. Lorsque vous utilisez une géodatabase d’entreprise, tenez compte des exigences suivantes :
- La valeur du paramètre Input Network (Réseau en entrée) doit provenir d’une connexion à une base de données établie en tant que propriétaire du réseau technique de la base de données ou propriétaire du réseau de traces de la base de données.
- Le compte connecté au portail ArcGIS Enterprise doit être celui du propriétaire du réseau technique du portail ou du propriétaire du réseau de traces du portail.
- Cet outil doit être connecté à la version par défaut qui doit être publique et non protégée.
Avec la règle Traçage, exécutez un traçage à partir des éléments du réseau de distribution ou du réseau de traçage actuellement représentés dans un diagramme.
Selon le type de traçage indiqué, des points de départ peuvent ou doivent être prédéfinis dans le diagramme pour que la règle de traçage soit exécutée :
- Pour les types de traçage Connected (Connecté), Subnetwork (Sous-réseau), Upstream (En amont), et Downstream (En aval), tous les éléments du réseau de distribution ou du réseau de traçage actuellement représentés dans le diagramme au démarrage de la règle de traçage sont considérés comme les points de départ du traçage, à moins qu’une règle Définir le point de départ ne soit configurée en amont sur le modèle de diagramme pour identifier clairement des points de départ spécifiques.
- Pour le traçage de type Chemin le plus court, les règles Définir le point de départ doivent être configurées sur le modèle de diagramme pour identifier les deux points de départ parmi tous les éléments du réseau de traçage actuellement représentés dans le diagramme entre lesquels le chemin le plus court doit être trouvé.
Lorsque vous configurez un modèle basé sur une règle Traçage, le traçage est systématiquement exécuté sur le réseau de distribution ou le réseau de traçage à chaque mise à jour du diagramme. Par conséquent, tout diagramme basé sur ce modèle reflète toujours le résultat actuel de la trace réseau lorsqu’il est mis à jour.
Syntaxe
arcpy.nd.AddTraceRule(in_utility_network, template_name, is_active, trace_type, {domain_network}, {tier}, {target_tier}, {include_structures}, {include_barriers}, {condition_barriers}, {function_barriers}, {traversability_scope}, {filter_barriers}, {filter_function_barriers}, {filter_scope}, {filter_bitset_network_attribute_name}, {filter_nearest}, {nearest_count}, {nearest_cost_network_attribute}, {nearest_categories}, {nearest_assets}, {propagators}, {description}, {allow_indeterminate_flow}, {path_direction}, {path_network_weight_name})
Paramètre | Explication | Type de données |
in_utility_network | Réseau de distribution ou réseau de traçages contenant le modèle de diagramme à modifier. | Utility Network; Trace Network |
template_name | Nom du modèle de diagramme à modifier. | String |
is_active | Précise si la règle est activée lors de la génération et de la mise à jour des diagrammes selon le modèle spécifique.
| Boolean |
trace_type | Spécifier le type de traçage que la règle exécute pour créer le contenu des diagrammes.
| String |
domain_network (Facultatif) | Nom des classes de réseau sur lesquelles le traçage est exécuté pour un réseau de distribution. Ce paramètre est obligatoire lors de l’exécution de traçages de type sous-réseau, en amont et en aval. | String |
tier (Facultatif) | Nom du tier au niveau duquel le traçage démarre pour un réseau de distribution. Ce paramètre est facultatif lors de l’exécution de traçages de type connecté. En revanche, il est requis lors de l’exécution de traçages de type sous-réseau, en amont et en aval. | String |
target_tier (Facultatif) | Nom du tier cible vers lequel le tier en entrée circule pour un réseau de distribution. Si ce paramètre est manquant pour les traçages en amont ou en aval, ils s’arrêteront lorsqu’ils atteignent la limite du sous-réseau de départ. Ce paramètre peut être utilisé pour permettre à ces traçages de poursuivre en haut ou en bas de la hiérarchie. | String |
include_structures (Facultatif) | Indique si les objets et les entités de structure sont inclus dans les résultats de traçage.
| Boolean |
include_barriers (Facultatif) | Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de traçage. Les interruptions de traversabilité sont facultatives même si elles ont été prédéfinies dans la définition de sous-réseau. Ce paramètre ne s’applique pas aux entités de dispositif avec des bornes.
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (Facultatif) | Définit une interruption conditionnelle de traversabilité sur les entités en fonction d’une comparaison avec un attribut de réseau ou vérifie une chaîne de catégorie. Une interruption conditionnelle utilise un attribut de réseau, un opérateur et un type, ainsi qu’une valeur attributaire. Par exemple, arrêtez un traçage lorsque l’attribut Device Status d’une entité est égal à la valeur spécifique de Open. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. En cas d’utilisation de plusieurs attributs, vous pouvez définir une condition Et ou une condition Ou à l’aide du paramètre Combine using (Combiner en utilisant). Les composants d’interruptions conditionnelles sont les suivants :
Les options des valeurs operator d’interruptions conditionnelles sont les suivantes :
En savoir plus sur les opérateurs bit à bit Les options des valeurs Type d’interruptions conditionnelles sont les suivantes :
Les options des valeurs Combine Using d’interruptions conditionnelles sont les suivantes :
| Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Facultatif) | Définit l’interruption de traversabilité sur les entités en fonction d’une fonction. Les interruptions fonctionnelles peuvent être utilisées pour effectuer des actions comme limiter la distance que le traçage peut parcourir depuis le point de départ, ou définir une valeur maximale à laquelle arrêter un traçage. Par exemple, la longueur de chaque ligne parcourue est ajoutée à la distance totale parcourue jusqu’ici. Lorsque la distance totale parcourue atteint la valeur spécifiée, le traçage s’arrête. Les composants d’interruptions de fonctions sont les suivants :
Les valeurs des options function d’interruptions de fonctions sont les suivantes :
Les valeurs des options operator d’interruptions de fonctions sont les suivantes :
En savoir plus sur les opérateurs bit à bit Les options d’interruption de fonctions de Use Local Values sont les suivantes :
| Value Table |
traversability_scope (Facultatif) | Le type de traversabilité à appliquer. La portée de traversabilité détermine si la traversabilité est appliquée aux jonctions, tronçons, ou aux deux. Imaginons une interruption conditionnelle définie pour arrêter le traçage si Device Status (État du périphérique) est réglé sur Open (Ouvert) avec la portée de traversabilité réglée sur les tronçons uniquement. Si le traçage détecte un dispositif ouvert, il ne s’interrompt pas, car Device Status (État du périphérique) ne s’applique qu’aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou non les jonctions, les tronçons, voire les deux.
| String |
filter_barriers [[Name, Operator, Type, Value, Combine Using],...] (Facultatif) | Spécifie si un traçage s’interrompt pour une catégorie spécifique ou un attribut de réseau. Par exemple, arrêtez une recherche de parcours au niveau des entités qui ont un attribut de statut de cycle de vie égal à une valeur certaine. Ce paramètre est utilisé pour définir une entité de terminaison selon une valeur d’un attribut de réseau défini dans le système. Si vous utilisez plusieurs attributs, vous pouvez utiliser l’option Combine Using pour définir une condition Et ou Ou. Les composants du Filtre d'interruption sont les suivants :
Les options des valeurs operator des filtres par interruptions sont les suivantes :
En savoir plus sur les opérateurs bit à bit Les options des valeurs Type des filtres par interruptions sont les suivantes :
Les options des valeurs Combine Using des filtres par interruptions sont les suivantes :
| Value Table |
filter_function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Facultatif) | Filtre les résultats du traçage pour une catégorie spécifique. Les composants du Filtre par fonctions d'interruption sont les suivants :
Les options de la valeur function du filtre des interruptions de fonction sont les suivantes :
Les options de la valeur operator du filtre des interruptions de fonction sont les suivantes :
En savoir plus sur les opérateurs bit à bit Les options d’interruption de fonctions de Use Local Values sont les suivantes :
| Value Table |
filter_scope (Facultatif) | Spécifie si le filtre pour une catégorie spécifique est forcé aux jonctions, aux tronçons ou les deux. Si, par exemple, une interruption de filtre est définie pour arrêter la trace lorsque le paramètre Device Status (État du périphérique) est réglé sur Open (Ouvert), avec la portée de capacité à être traversé réglée sur les tronçons uniquement, la trace ne s’interrompt pas même si elle détecte un dispositif ouvert. En effet, l’état du périphérique ne s’applique qu’aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou non les jonctions, les tronçons, voire les deux.
| String |
filter_bitset_network_attribute_name (Facultatif) | Nom de l’attribut de réseau à utiliser pour filtrer par bitset. Ce paramètre ne s'applique qu'aux traçages de type en amont, en aval ou boucles. Ce paramètre peut être utilisé pour ajouter une logique spéciale pendant un traçage de telle sorte qu’il reflète davantage les scénarios réels. Par exemple, pour un traçage de boucles, l'attribut de réseau Phases - Courant peut déterminer si la boucle est une véritable boucle électrique (la même phase est énergisée tout autour de la boucle, à savoir, A) et ne renvoie que des boucles électriques réelles pour les résultats du traçage. Exemple d’un traçage en amont : lors du traçage d’un réseau de distribution électrique, précisez un attribut de réseau Phases - Courant, pour que les résultats du traçage n’incluent que les chemins valides spécifiés dans l’attribut de réseau, et pas tous les chemins. | String |
filter_nearest (Facultatif) | Indique si l’algorithme k-nearest neighbors (k voisins les plus proches) est utilisé pour renvoyer plusieurs entités d’un certain type dans une distance donnée. Lorsque ce paramètre est utilisé, vous pouvez préciser un nombre et un coût, ainsi qu’un ensemble de catégories, un type de ressource ou ces deux éléments.
| Boolean |
nearest_count (Facultatif) | Nombre d’entités à renvoyer lorsque filter_nearest a pour valeur FILTER_BY_NEAREST. | Long |
nearest_cost_network_attribute (Facultatif) | Attribut de réseau numérique à utiliser pour calculer la proximité, le coût ou la distance lorsque filter_nearest est FILTER_BY_NEAREST—par exemple, Shape length (Longueur de forme). | String |
nearest_categories [nearest_categories,...] (Facultatif) | Catégories à renvoyer lorsque filter_nearest est FILTER_BY_NEAREST—par exemple, Protective (Protection). | String |
nearest_assets [nearest_assets,...] (Facultatif) | Groupes d’actifs et types d’actifs à renvoyer lorsque filter_nearest est FILTER_BY_NEAREST—par exemple, ElectricDistributionDevice/Transformer/Step Down. | String |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (Facultatif) | Spécifie les attributs de réseau à propager ainsi que la façon dont cette propagation devra être effectuée pendant un traçage. Les attributs de classe propagés désignent les valeurs clés sur les contrôleurs de sous-réseau qui sont distribuées au reste des entités dans le sous-réseau. Par exemple, dans un modèle de distribution électrique, vous pouvez propager la valeur de phase. Les composants de propagateurs sont les suivants :
Les options de la valeur function des propagateurs sont les suivantes :
Les options de la valeur operator des propagateurs sont les suivantes :
En savoir plus sur les opérateurs bit à bit Remarque :Ce paramètre est uniquement disponible via Python. | Value Table |
description (Facultatif) | Description de la règle. | String |
allow_indeterminate_flow (Facultatif) | Indique si les entités du réseau de traçage dont le flux est indéterminé ou non initialisé sont tracées. Ce paramètre est respecté uniquement lors de l’exécution de traçages de type en amont ou en aval.
| Boolean |
path_direction (Facultatif) | Indique la direction du chemin pour un réseau de traçages. Le coût du parcours du chemin est déterminé en fonction de la valeur définie pour path_network_attribute_name. Ce paramètre est respecté uniquement lors de l’exécution d’un traçage de type PATH.
| String |
path_network_weight_name (Facultatif) | Attribut de réseau permettant de calculer le chemin d’un réseau de traçages. 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 |
Sortie dérivée
Nom | Explication | Type de données |
out_utility_network | Le réseau technique ou réseau de traces mis à jour. | Réseau technique ; réseau de parcours |
out_template_name | Nom du modèle de diagramme. | Chaîne |
Exemple de code
Ajoutez une règle de traçage au modèle MyTemplate1 existant dans un réseau donné pour générer les diagrammes depuis le traçage sur les sous-réseaux au sein du niveau Moyenne tension du domaine ElectricDistribution.
import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddTraceRule_nd(input_Network, input_DiagramTemplate, "ACTIVE",
"SUBNETWORK", "ElectricDistribution", "Medium Voltage",
"Low Voltage Mesh")
Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?