对要素进行编号 (Defense)

摘要

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

使用情况

  • 使用现有字段进行编号时,将覆盖该字段中的值。

  • 要编号的输入面之外的要素的将要编号的字段(现有或新建)将设置为 Null。

  • 要编号的字段(现有或新建)参数中指定要编号的新字段名称时,首字母必须为字母,其余字母必须为字母数字或下划线。

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

参数

标注说明数据类型
输入要素

要编号的输入要素。

Feature Set
要编号的字段(现有或新建)

要编号的输入字段。 该字段可以是现有的短型、长型或文本字段,也可以是新字段。

Field
要编号的输入面
(可选)

限制要编号的要素的面;将仅对此面内的要素进行编号。

Feature Set
空间排序方法
(可选)

指定如何对要素进行空间排序以进行编号。 不会对表中的要素重新排序。

  • 右上角要素将从右上角开始排序。 这是默认设置。
  • 左上角要素将从左上角开始排序。
  • 右下角要素将从右下角开始排序。
  • 左下角要素将从左下角开始排序。
  • 皮亚诺曲线要素将使用空间填充曲线算法(也称为皮亚诺曲线)进行排序。
  • 居中要素将从中心点开始排序(如果没有提供中心,将使用平均中心)。
  • 顺时针要素将从中心点开始排序,并按顺时针移动。
  • 逆时针要素将从中心点开始排序,并按逆时针移动。
  • 不会使用空间排序。 将使用与要素类相同的顺序。
String
新字段的字段类型
(可选)

指定新字段的字段类型。 仅当输入表中不存在字段名称时才使用此参数。

  • 短整型该字段的类型将为短型。 这是默认设置。
  • 长整型该字段的类型将为长型。
  • 文本该字段的类型将为文本。
String
开始于
(可选)

要开始编号的值。

Long
增量
(可选)

要从上一个值增加的值。

Long
中心点
(可选)

用于对要素进行排序和编号的中心点。

Feature Set
添加到中心的距离和方位角
(可选)

指定是否将距中心点距离和方向角字段添加到输出中。

  • 不添加距离和方位角不会将距离或方位字段添加到输出中。 这是默认设置。
  • 添加距离和方位角DIST_TO_CENTERANGLE_TO_CENTER 字段将被添加到输出中。
Boolean

派生输出

标注说明数据类型
输出要素类

已更新的要素类。

Feature Class

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_DISTANCEDIST_TO_CENTERANGLE_TO_CENTER 字段将被添加到输出中。
Boolean

派生输出

名称说明数据类型
out_feature_class

已更新的要素类。

Feature Class

代码示例

NumberFeatures 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.NumberFeatures_defense("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.FeatureToPoint_management("Buildings_1", result_points)

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

许可信息

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

相关主题