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 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
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 en savoir plus sur la syntaxe SQL, 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
Exemple d'utilisation de l'outil Sélectionner (fenêtre Python)
import arcpy
from arcpy import env
env.workspace = "c:/basedata/roads.gdb"
arcpy.Select_analysis("nfroads", "paved", '[ROAD_CLASS] = "PAVED"')
Exemple d'utilisation de l'outil Sélectionner (fenêtre Python)
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\'')
Exemple d'utilisation de l'outil Sélectionner 2 (script Python autonome)
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
# 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)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui