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 (Query Builder) ou par saisie. Pour en savoir plus 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 les Entités en entrée et qu'aucune expression n'est entrée, seules les entités sélectionnées sont enregistrées dans la classe d'entités en sortie. Si une couche est utilisée pour Input Features (Entité 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) du jeu sélectionné est écrit dans la classe d’entités en sortie.

• Si vous disposez déjà d’une couche avec un jeu 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 l’outil Sélection (fenêtre Python)

La fenêtre de script Python suivante illustre l’utilisation de 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 l’outil Sélection (script autonome)

Le script Python suivant 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\''

# Execute 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

Informations de licence

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