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 (Structured Query Language), 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 Écrire une requête dans le générateur de requêtes ou 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 est utilisée pour la valeur du paramètre Entités en entrée et qu’une expression est saisie, 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 sélectionné est écrit dans la classe d’entités en 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 à la place.

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 à créer. Si aucune expression n’est utilisée, elle 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 à créer. Si aucune expression n’est utilisée, elle contient toutes les entités en entrée.	Feature Class
where_clause (Facultatif)	Expression SQL permettant de 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