对要素进行编号 (Defense)

摘要

将序号添加到输入要素集的新字段或现有字段中。

使用情况

• 向现有字段添加序列号将覆盖该字段中的值。

• 要编号的输入面参数值区域之外的要素将自动将要编号的字段（现有或新建）参数设置为空。

• 在要编号的字段（现有或新建）参数中指定要编号的新字段时，首字母必须为字母字符，其余字母必须为字母数字或下划线。

• 对点以外的要素进行编号时，将对要编号的输入面参数值包含或与之相交的所有要素进行编号。

参数

对话框

标注	说明	数据类型
输入要素	将对输入要素进行编号。	Feature Set
要编号的字段（现有或新建）	将对输入字段进行编号。 该字段可以是现有的短型、长型或文本字段，也可以是新字段。	Field
要编号的输入面 (可选)	限制要编号的要素的面；将仅对此面内的要素进行编号。	Feature Set
空间排序方法 (可选)	指定如何对要素进行空间排序以进行编号。 不会对表中的要素重新排序。 右上角—要素将从右上角开始排序。 这是默认设置。 左上角—要素将从左上角开始排序。 右下角—要素将从右下角开始排序。 左下角—要素将从左下角开始排序。 皮亚诺曲线—要素将使用空间填充曲线算法（也称为皮亚诺曲线）进行排序。 居中—要素将从中心点开始排序（如果没有提供中心，将使用平均中心）。 顺时针—要素将从中心点开始排序，并按顺时针移动。 逆时针—要素将从中心点开始排序，并按逆时针移动。 无—不会使用空间排序。 将使用与要素类相同的顺序。	String
新字段的字段类型 (可选)	指定将用于新字段的字段类型。 仅当输入表中不存在字段名称时才使用此参数。 短整型—该字段的类型将为短型。 这是默认设置。 长整型—该字段的类型将为长型。 文本—该字段的类型将为文本。	String
开始于 (可选)	将用于开始编号的值。	Long
增量 (可选)	将用作从上一个值增加的值。	Long
中心点 (可选)	将用于排序和编号要素的中心点。	Feature Set
添加到中心的距离和方位角 (可选)	指定是否将距中心点距离和方向角字段添加到输出中。 不添加距离和方位角—不会将距离或方位字段添加到输出中。 这是默认设置。 添加距离和方位角—DIST_TO_CENTER 和 ANGLE_TO_CENTER 字段将被添加到输出中。	Boolean

派生输出

标注	说明	数据类型
输出要素类	已更新的要素类。	Feature Class

Python

arcpy.defense.NumberFeatures(in_features, field_to_number, {in_area}, {spatial_sort_method}, {new_field_type}, {starting_number}, {increment_by}, {center_point}, {add_distance_and_bearing})

名称	说明	数据类型
in_features	将对输入要素进行编号。	Feature Set
field_to_number	将对输入字段进行编号。 该字段可以是现有的短型、长型或文本字段，也可以是新字段。	Field
in_area (可选)	限制要编号的要素的面；将仅对此面内的要素进行编号。	Feature Set
spatial_sort_method (可选)	指定如何对要素进行空间排序以进行编号。 不会对表中的要素重新排序。 UR—要素将从右上角开始排序。 这是默认设置。 UL—要素将从左上角开始排序。 LR—要素将从右下角开始排序。 LL—要素将从左下角开始排序。 PEANO—要素将使用空间填充曲线算法（也称为皮亚诺曲线）进行排序。 CENTER—要素将从中心点开始排序（如果没有提供中心，将使用平均中心）。 CLOCKWISE—要素将从中心点开始排序，并按顺时针移动。 COUNTERCLOCKWISE—要素将从中心点开始排序，并按逆时针移动。 NONE—不会使用空间排序。 将使用与要素类相同的顺序。	String
new_field_type (可选)	指定将用于新字段的字段类型。 仅当输入表中不存在字段名称时才使用此参数。 SHORT—该字段的类型将为短型。 这是默认设置。 LONG—该字段的类型将为长型。 TEXT—该字段的类型将为文本。	String
starting_number (可选)	将用于开始编号的值。	Long
increment_by (可选)	将用作从上一个值增加的值。	Long
center_point (可选)	将用于排序和编号要素的中心点。	Feature Set
add_distance_and_bearing (可选)	指定是否将距中心点距离和方向角字段添加到输出中。 DONT_ADD_DISTANCE—不会将距离或方位字段添加到输出中。 这是默认设置。 ADD_DISTANCE—DIST_TO_CENTER 和 ANGLE_TO_CENTER 字段将被添加到输出中。	Boolean

派生输出

名称	说明	数据类型
out_feature_class	已更新的要素类。	Feature Class

代码示例

NumberFeatures 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何使用 NumberFeatures 函数。

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.defense.NumberFeatures("Structures", "structure_number", None, "LL", 
                             "SHORT")

NumberFeatures 示例 2（独立脚本）

以下示例将在示例工作流脚本中使用 NumberFeatures 函数。

# Convert building footprints to points and number the points.

# Import modules
import arcpy

# Set workspace
arcpy.env.workspace = r"C:/Data.gdb"

# Get building center points
result_points = "Building_Points"
arcpy.management.FeatureToPoint("Buildings_1", result_points)

# Number the points that represent buildings
arcpy.defense.NumberFeatures(result_points,
                             "building_number",
                             None,
                             "CENTER",
                             "TEXT",
                             25,
                             5,
                             "center_bldg",
                             "ADD_DISTANCE")

环境

范围, 当前工作空间, 临时工作空间

许可信息

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