选择 (分析)

摘要

用于从输入要素类或输入要素图层中提取要素（通常使用选择或 SQL 表达式），并将其存储于输出要素类中。

使用情况

• 选择表达式或 SQL 表达式可使用查询构建器构建，也可直接输入。 有关表达式语法的详细信息，请参阅查询表达式简介或者在 ArcGIS 中使用的查询表达式的 SQL 参考。

• 如果针对输入要素参数值使用图层并且未输入任何表达式，则仅将所选要素写入输出要素类。 如果将具有选择的图层用于输入要素参数值，并且指定了表达式参数值，则仅对所选要素运行该表达式，并将所选集合中基于表达式的子集写入输出要素类。 如果所选要素不包含任何与表达式相匹配的要素，则仅将所选集合中的要素写入输出。

• 如果已具有包含一组选定要素的图层，请使用复制要素工具创建要素类。

参数

对话框

标注	说明	数据类型
输入要素	将从中选择要素的输入要素类或图层。	Feature Layer
输出要素类	将创建的输出要素类。 如果未使用任何表达式，则输出将包含所有输入要素。	Feature Class
表达式 (可选)	用于选择要素子集的 SQL 表达式。	SQL Expression

Python

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

名称	说明	数据类型
in_features	将从中选择要素的输入要素类或图层。	Feature Layer
out_feature_class	将创建的输出要素类。 如果未使用任何表达式，则输出将包含所有输入要素。	Feature Class
where_clause (可选)	将用于选择要素子集的 SQL 表达式。 有关 SQL 语法的详细信息，请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考。	SQL Expression

代码示例

Select 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 Select 函数。

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

Select 示例 2（独立脚本）

以下 Python 脚本演示了如何在独立脚本中使用 Select 函数。

# 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\''

# Run Select
arcpy.analysis.Select(in_features, out_feature_class, where_clause)

环境

默认输出 Z 值, M 分辨率, M 容差, 输出配置关键字, 输出 M 值域, 输出 XY 值域, 输出坐标系, 范围, 输出包含 M 值, XY 分辨率, XY 容差, 当前工作空间, 临时工作空间

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是