Relation spatiale présente (ModelBuilder)

Résumé

Évalue si les entrées possèdent une relation spatiale spécifiée.

Pour en savoir plus sur le fonctionnement de l’outil Relation spatiale présente dans ModelBuilder

Utilisation

• Cet outil est prévu pour une utilisation dans ModelBuilder, et non dans des scripts Python.

• L’outil possède deux sorties booléennes : True (vrai) et False (faux). Selon la condition en cours de vérification, une des deux sorties booléennes est vraie et l’autre est fausse après l’exécution de l’outil. Ces sorties booléennes doivent être définies comme condition préalable aux outils en aval à exécuter si une des conditions préalables est vraie.

Syntaxe

arcpy.mb.SpatialRelationshipIfThenElse(in_features, {overlap_type}, {select_features}, {search_distance}, {invert_spatial_relationship}, {selection_condition}, {count}, {count_min}, {count_max})

Paramètre	Explication	Type de données
in_features	Entités en entrée à vérifier.	Feature Layer
overlap_type (Facultatif)	Spécifie la relation spatiale à évaluer. INTERSECT —Les entités de la couche en entrée sont sélectionnées si elles intersectent une entité de la couche de sélection. Il s’agit de l’option par défaut. INTERSECT_3D —Les entités dans la couche en entrée sont sélectionnées si elles intersectent une entité de la couche de sélection dans un espace tridimensionnel (x, y et z). INTERSECT_DBMS —Les entités de la couche en entrée sont sélectionnées si elles intersectent une entité de la couche de sélection. Cette option s’applique uniquement aux géodatabases d’entreprise. La sélection sera traitée dans le SGBD de géodatabase d’entreprise et non sur le client lorsque toutes les conditions sont remplies (reportez-vous aux remarques sur l’utilisation de l’outil). Cette option peut offrir de meilleures performances que la sélection sur le client. WITHIN_A_DISTANCE —Les entités de la couche en entrée sont sélectionnées si elles se trouvent à la distance spécifiée (distance euclidienne) d'une entité de la couche de sélection. Utilisez le paramètre search_distance pour spécifier la distance. WITHIN_A_DISTANCE_3D —Les entités de la couche en entrée sont sélectionnées si elles se trouvent à une distance donnée d'une entité de la couche de sélection dans un espace tridimensionnel. Utilisez le paramètre search_distance pour spécifier la distance. WITHIN_A_DISTANCE_GEODESIC —Les entités de la couche en entrée sont sélectionnées si elles se trouvent à une distance donnée d'une entité de la couche de sélection. La distance entre les entités est calculée à l’aide d’une formule géodésique qui tient compte de la courbure de la sphéroïde et gère correctement les données situées près de la ligne de changement de jour et des pôles. Utilisez le paramètre search_distance pour spécifier la distance. CONTAINS —Les entités de la couche en entrée sont sélectionnées si elles contiennent une entité de la couche de sélection. COMPLETELY_CONTAINS —Les entités de la couche en entrée sont sélectionnées si elles contiennent complètement une entité de la couche de sélection. CONTAINS_CLEMENTINI —Cette relation spatiale renvoie les mêmes résultats que COMPLETELY_CONTAINS, mais si la couche de sélection se trouve entièrement à la limite de l’entité en entrée (sans aucune partie véritablement à l’intérieur ou à l’extérieur), l’entité n’est pas sélectionnée. CLEMENTINI définit le polygone de limite comme la ligne qui sépare l'intérieur et l'extérieur ; la limite d'une ligne est définie par ses extrémités et la limite d'un point est toujours vide. WITHIN —Les entités de la couche en entrée sont sélectionnées si elles se trouvent dans une entité de la couche de sélection. COMPLETELY_WITHIN —Les entités de la couche en entrée sont sélectionnées si elles se trouvent complètement dans ou sont contenues par les entités de la couche de sélection. WITHIN_CLEMENTINI —Le résultat est identique à celui obtenu avec WITHIN, mais si la totalité de l'entité dans la couche en entrée est à la limite de l'entité dans la couche de sélection, l'entité n'est pas sélectionnée. CLEMENTINI définit le polygone de limite comme la ligne qui sépare l'intérieur et l'extérieur ; la limite d'une ligne est définie par ses extrémités et la limite d'un point est toujours vide. ARE_IDENTICAL_TO —Les entités de la ou des couches en entrée sont sélectionnées si elles sont identiques (en géométrie) à une entité de la couche de sélection. BOUNDARY_TOUCHES —Les entités de la couche en entrée sont sélectionnées si une de leurs limites touche une entité de la couche de sélection. Lorsque les entités en entrée sont des lignes ou des polygones, la limite de l'entité en entrée peut uniquement toucher la limite de l'entité sélectionnée, et aucune partie de l'entité en entrée ne peut traverser la limite de l'entité sélectionnée. SHARE_A_LINE_SEGMENT_WITH —Les entités de la couche en entrée sont sélectionnées si elles partagent un segment de ligne avec une entité de la couche de sélection. Les entités de la couche en entrée et de la couche de sélection doivent être des lignes ou des polygones. CROSSED_BY_THE_OUTLINE_OF —Les entités de la ou des couches en entrée sont sélectionnées si elles sont croisées par le contour d'une entité de la couche de sélection. Les entrées et les entités de la couche de sélection doivent être des lignes ou des polygones. Si des polygones sont utilisés pour la couche en entrée ou la couche de sélection, la limite (ligne) du polygone sera utilisée. Les lignes qui se croisent au niveau d'un point sont sélectionnées, contrairement à celles qui partagent un segment de ligne. HAVE_THEIR_CENTER_IN —Les entités de la couche en entrée sont sélectionnées si leur centre se trouve dans une entité de la couche de sélection. Le centre de l’entité est calculé comme suit : pour les polygones et multi-points, c’est le centroïde de la géométrie qui est utilisé et pour les lignes en entrée, le centre de la géométrie.	String
select_features (Facultatif)	Les entités du paramètre Input Features (Entités en entrée) sont sélectionnées en fonction de leur relation avec les entités de cette couche ou classe d’entités.	Feature Layer
search_distance (Facultatif)	La distance spécifiée dans laquelle la recherche sera effectuée. Ce paramètre est valide uniquement si le paramètre overlap_type est défini sur l'une des valeurs suivantes : WITHIN_A_DISTANCE, WITHIN_A_DISTANCE_GEODESIC, WITHIN_A_DISTANCE_3D, INTERSECT, INTERSECT_3D, HAVE_THEIR_CENTER_IN ou CONTAINS. Si l’option WITHIN_A_DISTANCE_GEODESIC est sélectionnée, utilisez une unité linéaire, telle que le kilomètre ou le mile.	Linear Unit
invert_spatial_relationship (Facultatif)	Spécifie si le résultat de l’évaluation de la relation spatiale sera utilisé en l’état, ou si le résultat opposé sera utilisé. Par exemple, ce paramètre peut servir à obtenir la liste des entités qui ne s’intersectent pas ou ne se trouvent pas à une certaine distance des entités d’un autre jeu de données. NOT_INVERT —La requête sera utilisée en l’état. Il s’agit de l’option par défaut. INVERT —La requête opposée sera utilisée. Si vous utilisez le paramètre selection_type, l’inversion de la sélection se produit avant qu’elle ne soit associée aux sélections existantes.	Boolean
selection_condition (Facultatif)	Condition de sélection de la relation spatiale entre les entités en entrée et de sélection. EXISTS —Vérifie si la relation spatiale est présente entre des entités dans les entités en entrée et de sélection. Il s’agit de l’option par défaut. NO_SELECTION —Vérifie si la relation spatiale n’est pas présente entre des entités des entités en entrée et de sélection. ALL_SELECTED —Vérifie si la relation spatiale est présente pour toutes les entités dans les entités en entrée et de sélection. IS_EQUAL_TO —Vérifie si le nombre d’entités en entrée avec la relation spatiale est égal à la valeur Count (Total). IS_BETWEEN —Vérifie si le nombre d’entités en entrée avec la relation spatiale est compris entre la valeur Minimum Count (Nombre minimum) et la valeur Maximum Count (Nombre maximum). IS_LESS_THAN —Vérifie si le nombre d’entités en entrée avec la relation spatiale est inférieur à la valeur Count (Total). IS_GREATER_THAN —Vérifie si la valeur de champ des enregistrements correspondant à l’expression SQL est supérieure à la valeur Count (Total). IS_NOT_EQUAL_TO —Vérifie si le nombre d’entités en entrée avec la relation spatiale est différent de la valeur Count (Total).	String
count (Facultatif)	Valeur de nombre entier.	Long
count_min (Facultatif)	Valeur de nombre minimal entier.	Long
count_max (Facultatif)	Valeur de nombre maximal entier.	Long

Sortie dérivée

Nom	Explication	Type de données
true	Si le critère spécifié est rempli, ce paramètre est défini sur True (Vrai).	Booléen
false	Si le critère spécifié n’est pas rempli, ce paramètre est défini sur False (Vrai).	Booléen

Environnements

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

Informations de licence

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