Ajouter une règle de requête spatiale (Diagramme de réseau)

Synthèse

Ajoute une règle de diagramme en vue d’ajouter automatiquement de nouvelles entités de réseau aux diagrammes en fonction de leur position par rapport aux entités de réseau actuellement représentées dans le diagramme.

Pour en savoir plus sur l’utilisation des règles de requête spatiale en vue de construire des diagrammes de réseau

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 Diagramme à mettre à jour jusqu’à leur mise à jour.

Utilisation

  • Cet outil n’est pas pris en charge en cas d’utilisation d’un service de réseau de distribution ou de traces. Vous devez utiliser un réseau de distribution ou un réseau de traces dans une géodatabase fichier ou mobile, ou une connexion de base de données à un réseau de distribution ou de traces dans une géodatabase d’entreprise. Lorsque vous utilisez une géodatabase d’entreprise, tenez compte des exigences suivantes :

  • La règle Spatial Query (Requête spatiale) permet de détecter les nouvelles entités de réseau en fonction de leur localisation par rapport aux entités de réseau qui existent actuellement dans le diagramme et elle ajoute les entités récemment détectées au diagramme de réseau.

  • Les entités de réseau avec lesquelles la règle fonctionne reposent sur la même classe d’entités et ces entités peuvent être filtrées à l’aide d’une expression de requête SQL.

  • Les entités de réseau ajoutées reposent sur la même classe d’entités et ces entités peuvent être filtrées à l’aide d’une expression de requête SQL.

Paramètres

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

Réseau de distribution ou de traces contenant le modèle de diagramme à modifier.

Utility Network; Trace Network
Modèle de diagramme en entrée

Nom du modèle de diagramme à modifier.

String
Activé

Précise si la règle est active lors de la génération et de la mise à jour des diagrammes selon le modèle spécifique.

  • Activé : la règle ajoutée devient active pendant la génération et la mise à jour de n’importe quel diagramme selon le modèle en entrée. Il s’agit de l’option par défaut.
  • Désactivé : la règle ajoutée n’est pas active pendant la génération ou la mise à jour de n’importe quel diagramme selon le modèle en entrée.

Boolean
Ajouter des entités

La classe d’entités source à laquelle les entités sont ajoutées.

Feature Class
Relation
(Facultatif)

Spécifie la relation spatiale entre les entités.

  • IntersecterLes entités de la classe d’entités source Add Features (Ajouter des entités) seront ajoutées au diagramme si elles intersectent une des entités existantes. Il s’agit de l’option par défaut.
  • Dans une distanceLes entités de la classe d’entités source Add Features (Ajouter des entités) seront ajoutées au diagramme si elles se trouvent à la distance spécifiée (distance euclidienne) d’une des entités existantes. Utilisez le paramètre Distance de recherche pour spécifier la distance.
  • Contient | Est contenu dansLes entités de la classe d’entités source Add Features (Ajouter des entités) seront ajoutées au diagramme si elles contiennent des entités appartenant aux Existing Features (Entités existantes) ou si elles sont contenues dans ces dernières.
  • DansLes entités de la classe d’entités source Ajouter des entités seront ajoutées au diagramme si elles se trouvent dans les entités existantes.
  • La limite toucheLes entités de la classe d’entités source Add Features (Ajouter des entités) seront ajoutées au diagramme si elles comportent une limite qui touche une des entités existantes. Lorsque les entités existantes sont des lignes ou des polygones, la limite de l’entité en entrée Add Features (Ajouter des entités) peut uniquement toucher la limite des entités existantes, et aucune partie de l’entité en entrée ne peut traverser la limite des entités existantes.
  • Partagent un segment de ligne avecLes entités de la classe d’entités source Add Features (Ajouter des entités) seront ajoutées au diagramme si elles partagent un segment de ligne avec une des entités existantes. Les entités ajoutées et existantes doivent être des lignes ou des polygones.
  • Traversé par le contour deLes entités de la classe d’entités source Add Features (Ajouter des entités) seront ajoutées au diagramme si elles sont traversées par le contour d’une des entités existantes. Les entités ajoutées et existantes doivent être des lignes ou des polygones. Si des polygones sont utilisés pour les entités existantes, la limite (ligne) du polygone est utilisée. Les lignes qui se croisent au niveau d’un point sont ajoutées, contrairement à celles qui partagent un segment de ligne.
String
Entités existantes

Classe d’entités source sur laquelle la requête spatiale sera exécutée.

Feature Class
Distance de recherche
(Facultatif)

La distance entre les entités du paramètre Existing Features (Entités existantes) et les entités du paramètre Add Features (Ajouter des entités). Ce paramètre est valide uniquement si le paramètre Relation est défini sur Intersection, Dans une distance, Contient ou Dans.

Linear Unit
Ensemble de définition des entités ajoutées
(Facultatif)

Requête SQL à utiliser pour filtrer les entités à ajouter au diagramme. Sans requête SQL, les entités reposant sur la classe source spécifiée qui sont spatialement liées aux entités existantes spécifiées seront ajoutées au diagramme.

SQL Expression
Ensemble de définition des entités existantes
(Facultatif)

Requête SQL qui permettra de filtrer les entités existantes dans le diagramme. Sans requête SQL, les entités reposant sur la classe source spécifiée qui existent dans le diagramme seront prises en compte.

SQL Expression
Description
(Facultatif)

Description de la règle.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Réseau en sortie

Le réseau technique ou réseau de traces mis à jour.

Utility Network; Trace Network
Modèle de diagramme en sortie

Nom du modèle de diagramme.

String

arcpy.nd.AddSpatialQueryRule(in_utility_network, template_name, is_active, added_features, {overlap_type}, existing_features, {search_distance}, {added_where_clause}, {existing_where_clause}, {description})
NomExplicationType de données
in_utility_network

Réseau de distribution ou de traces 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.

  • ACTIVELa règle ajoutée est activée pendant la génération et la mise à jour de n’importe quel diagramme selon le modèle en entrée. Il s’agit de l’option par défaut.
  • INACTIVELa règle ajoutée n’est pas activée pendant la génération ou la mise à jour de n’importe quel diagramme selon le modèle en entrée.
Boolean
added_features

La classe d’entités source à laquelle les entités sont ajoutées.

Feature Class
overlap_type
(Facultatif)

Spécifie la relation spatiale à évaluer.

  • INTERSECTLes entités de la classe d’entités source added_features seront ajoutées au diagramme si elles intersectent une des existing_features. Il s’agit de l’option par défaut.
  • WITHIN_A_DISTANCELes entités de la classe d’entités source added_features seront ajoutées au diagramme si elles se trouvent à la distance spécifiée (distance euclidienne) d’une des existing_features. Utilisez le paramètre search_distance pour spécifier la distance.
  • CONTAINSLes entités de la classe d’entités source added_features seront ajoutées au diagramme si elles contiennent des entités appartenant aux existing_features ou sont contenues dans ces dernières.
  • WITHINLes entités de la classe d’entités source added_features seront ajoutées au diagramme si elles se trouvent dans les existing_features.
  • BOUNDARY_TOUCHESLes entités de la classe d’entités source added_features seront ajoutées au diagramme si elles comportent une limite qui touche une des existing_features. Lorsque les existing_features sont des lignes ou des polygones, la limite des added_features peut uniquement toucher la limite d’une des existing_features, et aucune partie de l’entité en entrée ne peut traverser la limite d’une des existing_features.
  • SHARE_A_LINE_SEGMENT_WITHLes entités de la classe d’entités source added_features seront ajoutées au diagramme si elles partagent un segment de ligne avec une des existing_features. Les entités ajoutées et existantes doivent être des lignes ou des polygones.
  • CROSSED_BY_THE_OUTLINE_OFLes entités de la classe d’entités source added_features seront ajoutées au diagramme si elles sont traversées par le contour d’une des existing_features. Les entités ajoutées et existantes doivent être des lignes ou des polygones. Si des polygones sont utilisés pour les existing_features, la limite (ligne) du polygone est utilisée. Les lignes qui se croisent au niveau d’un point sont ajoutées, contrairement à celles qui partagent un segment de ligne.
String
existing_features

Classe d’entités source sur laquelle la requête spatiale sera exécutée.

Feature Class
search_distance
(Facultatif)

Distance entre les entités du paramètre existing_features et les entités du paramètre added_features. Ce paramètre est valide uniquement si le paramètre overlap_type est défini sur INTERSECT, WITHIN_A_DISTANCE, CONTAINS ou WITHIN.

Linear Unit
added_where_clause
(Facultatif)

Requête SQL à utiliser pour filtrer les entités à ajouter au diagramme. Sans requête SQL, les entités reposant sur la classe source spécifiée qui sont spatialement liées aux entités existantes spécifiées seront ajoutées au diagramme.

SQL Expression
existing_where_clause
(Facultatif)

Requête SQL qui permettra de filtrer les entités existantes dans le diagramme. Sans requête SQL, les entités reposant sur la classe source spécifiée qui existent dans le diagramme seront prises en compte.

SQL Expression
description
(Facultatif)

Description de la règle.

String

Sortie obtenue

NomExplicationType de données
out_utility_network

Le réseau technique ou réseau de traces mis à jour.

Utility Network; Trace Network
out_template_name

Nom du modèle de diagramme.

String

Exemple de code

Exemple d’utilisation de l’outil AddSpatialQueryRule (script autonome)

Ajoutez une règle de requête spatiale au modèle MyTemplate1 pour ajouter systématiquement toutes les lignes de sous-transmission qui intersectent les sous-stations dans les diagrammes générés.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DistributionLine = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricDistributionLine"
input_StructureBoundary = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricStructureBoundary"

input_DiagramTemplate = "MyTemplate1"

arcpy.nd.AddSpatialQueryRule(input_Network, input_DiagramTemplate, 
                             'ACTIVE', input_DistributionLine, 'INTERSECT',
                             input_StructureBoundary, None, 'ASSETGROUP=6', 
                             'ASSETGROUP=3')

Environnements

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

Informations de licence

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

Rubriques connexes