Выборка

Краткая информация

Извлекает пространственные объекты из входного класса пространственных объектов или входного слоя пространственных объектов, как правило, с помощью выражения 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 Desktop Basic: Да
• ArcGIS Desktop Standard: Да
• ArcGIS Desktop Advanced: Да