Sélectionner (Analyse)

Résumé

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 de Query Builder (Générateur de requêtes) ou 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.

Syntaxe

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

Paramètre	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)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction Select en mode immédiat.

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

Exemple 2 d’utilisation de l’outil Sélection (script autonome)

Le script Python ci-dessous illustre l'utilisation de l'outil 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.Select_analysis(in_features, out_feature_class, where_clause)

Environnements

Valeur Z en sortie par défaut, Résolution M, Tolérance M, Mot-clé de configuration en sortie, Domaine M en sortie, Domaine XY en sortie, Système de coordonnées en sortie, Etendue, Valeurs M en sortie, Résolution XY, Tolérance XY

Informations de licence

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