Sélectionner (Analyse)

Synthèse

Extrait des entités d’une classe d’entités ou d’une couche d’entités en entrée, généralement à l’aide d’une expression de sélection ou SQL, et les stocke dans une classe d’entités en sortie.

Utilisation

• L’expression de sélection ou SQL est créée à l’aide du générateur de requêtes ou est saisie. Pour plus d’informations sur la syntaxe de l’expression, reportez-vous à la rubrique Introduction aux expressions de requête ou à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.

• Si une couche est utilisée pour la valeur du paramètre Entités en entrée et qu’aucune expression n’est saisie, seules les entités sélectionnées sont écrites dans la classe d’entités en sortie. Si une couche avec une sélection est utilisée pour la valeur du paramètre Input Features (Entités en entrée) et qu’une valeur de paramètre Expression est spécifiée, l’expression est exécutée uniquement sur les entités sélectionnées et le sous-ensemble (basé sur l’expression) de l’ensemble de sélection est écrit dans la classe d’entités en sortie. Si les entités sélectionnées ne contiennent aucune entité correspondant à l’expression, seules les entités de l’ensemble de sélection sont écrites dans la sortie.

• Si vous disposez déjà d’une couche avec un ensemble d’entités sélectionné, utilisez l’outil Copier des entités pour créer une classe d’entités.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Couche ou classe d’entités en entrée dans laquelle les entités sont sélectionnées.	Feature Layer
Classe d’entités en sortie	Classe d’entités en sortie qui sera créée. Si aucune expression n’est utilisée, la sortie contient toutes les entités en entrée.	Feature Class
Expression (Facultatif)	Expression SQL permettant de sélectionner un sous-ensemble d’entités.	SQL Expression

Python

arcpy.analysis.Select(in_features, out_feature_class, {where_clause})

Nom	Explication	Type de données
in_features	Couche ou classe d’entités en entrée dans laquelle les entités sont sélectionnées.	Feature Layer
out_feature_class	Classe d’entités en sortie qui sera créée. Si aucune expression n’est utilisée, la sortie contient toutes les entités en entrée.	Feature Class
where_clause (Facultatif)	Expression SQL utilisée pour sélectionner un sous-ensemble d’entités. Pour plus d’informations sur la syntaxe SQL, reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.	SQL Expression

Exemple de code

Exemple 1 d’utilisation de la fonction Select (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction Select en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.Select("majorrds.shp", "C:/output/majorrdsClass4.shp", '"CLASS" = \'4\'')

Exemple 2 d’utilisation de la fonction Select (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction Select dans un script autonome.

# Name: Select_Example2.py
# Description: Select roads of Class 4 from major roads in the gnatcatcher habitat study area

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/data"

# Set local variables
in_features = "majorrds.shp"
out_feature_class = "C:/output/majorrdsClass4.shp"
where_clause = '"CLASS" = \'4\''

# Run Select
arcpy.analysis.Select(in_features, out_feature_class, where_clause)

Environnements

Valeur Z en sortie par défaut, Résolution M, Tolérance M, Mot-clé CONFIG en sortie, Domaine M en sortie, Domaine XY en sortie, Système de coordonnées en sortie, Étendue, Valeurs M en sortie, Résolution XY, Tolérance XY, Espace de travail courant, Espace de travail temporaire

Informations de licence

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