Sélectionner (Analyse)
Récapitulatif
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 simplement saisie. Pour plus d'informations sur la syntaxe des expressions, reportez-vous à la rubrique Construction d'une expression SQL ou à la Référence SQL.
-
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 les entités en entrée et qu'une expression est entré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 sélectionné est enregistré dans la classe d'entités en sortie.
-
Pour créer une classe d'entités à partir de l'ensemble d'entités sélectionné dans une couche, utilisez l'outil Copier des entités.
Syntaxe
| 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. La syntaxe de l'expression diffère légèrement en fonction de la source des données. Par exemple, lorsque vous interrogez des géodatabases fichier ou ArcSDE, des fichiers de formes ou des couvertures, placez le nom des champs entre guillemets doubles : "MY_FIELD" Si vous interrogez des géodatabases personnelles, placez les champs entre crochets : [MON_CHAMP] Dans la fenêtre Python, mettez {clause_where} entre parenthèses pour garantir que les espaces (lesquels sont des délimiteurs entre des paramètres) sont interprétés correctement. Pour plus d'informations sur la syntaxe SQL et la façon dont elle diffère selon la source de données, reportez-vous à la rubrique d’aide Référence SQL pour les expressions de requête utilisées dans ArcGIS. | SQL Expression |
Exemple de code
import arcpy
from arcpy import env
env.workspace = "c:/basedata/roads.gdb"
arcpy.Select_analysis("nfroads", "paved", '[ROAD_CLASS] = "PAVED"')
Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction Sélectionner en mode immédiat.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Select_analysis("majorrds.shp", "C:/output/majorrdsClass4.shp", '"CLASS" = \'4\'')
Le script Python ci-dessous illustre l'utilisation de la fonction Sélectionner dans un script autonome.
# Name: Select_Example2.py # Description: Select roads of Class 4 from major roads tin the gnatcatcher habitat study area # Author: ESRI # Import system modules import arcpy from arcpy import env # Set workspace 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)