Краткая информация
Извлекает пространственные объекты из входного класса пространственных объектов или входного слоя пространственных объектов, как правило, с помощью выражения SQL (Structured Query Language), и сохраняет их в выходном классе объектов.
Использование
Выражение выборки или SQL-запрос строится с помощью Конструктора запросов или путем ввода. Для получения более подробной информации о синтаксисе выражений см. Построение выражения SQL или Основы SQL.
Если для входных объектов используется слой и не вводится выражение, в выходной класс объектов записываются только выбранные пространственные объекты. Если для Входных объектов используется слой и вводится выражение, то данное выражение выполняется только в отношении выбранных пространственных объектов, и основанный на выражении поднабор выбранного набора записывается в выходной класс объектов.
Если вы хотите создать класс пространственных объектов из выбранного набора пространственных объектов в слое, используйте инструмент Копировать объекты (Copy Features).
Синтаксис
Select_analysis (in_features, out_feature_class, {where_clause})| Параметр | Объяснение | Тип данных |
in_features | Входной класс пространственных объектов или слой, из которого выбираются объекты. | Feature Layer |
out_feature_class | Создаваемый выходной класс пространственных объектов. Если выражение не используется, он содержит все входные объекты. | Feature Class |
where_clause (дополнительно) | SQL-выражение, использованное для выбора поднабора пространственных объектов. Подробнее о синтаксисе SQL см. в разделе Справка SQL по выражениям запросов, используемым в ArcGIS. | SQL Expression |
Пример кода
Пример выборки (Окно Python)
import arcpy
from arcpy import env
env.workspace = "c:/basedata/roads.gdb"
arcpy.Select_analysis("nfroads", "paved", '[ROAD_CLASS] = "PAVED"')
Пример выборки (Окно Python)
В следующем скрипте окна Python показано, как использовать функцию Выборка в окне Python в ArcGIS.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Select_analysis("majorrds.shp", "C:/output/majorrdsClass4.shp", '"CLASS" = \'4\'')
Пример выборки 2 (автономный скрипт Python)
В следующем скрипте Python показано, как использовать функцию выборки в автономном скрипте.
# 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)
Параметры среды
- Выходное значение Z по умолчанию (Default Output Z Value)
- Разрешение M (M Resolution)
- Допуск M (M Tolerance)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходной домен M (Output M Domain)
- Выходной XY домен (Output XY Domain)
- Выходная система координат (Output Coordinate System)
- Экстент (Extent)
- Выходные данные содержат значения M (Output has M values)
- Выходная пространственная сетка 1
- Выходная пространственная сетка 2
- Выходная пространственная сетка 3
- Разрешение XY (XY Resolution)
- Допуск XY (XY Tolerance)
Информация о лицензировании
- ArcGIS for Desktop Basic: Да
- ArcGIS for Desktop Standard: Да
- ArcGIS for Desktop Advanced: Да