按扇区对要素进行编号 (Defense)

摘要

根据要素所属的地理分组将序列号添加到一组输入要素的新字段或现有字段中。

使用情况

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

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

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

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

• 每个扇区根据增量值开始一个新的编号序列。

• 如果扇形面参数值中存在字段 SortMethod，则空间排序方法参数将处于非活动状态。 SortMethod 字段中的有效值包括 SortMethod 字段中的有效值包括：

  • UR - 要素将从右上角开始排序。
  • UL - 要素将从左上角开始排序。
  • LR - 要素将从右上角开始排序。
  • LL - 要素将从左下角开始排序。
  • PEANO - 要素将使用空间填充曲线算法（也称为皮亚诺曲线）进行排序。
  • CENTER - 要素将从中心点开始排序（如果没有提供中心，将使用平均中心）。
  • CLOCKWISE - 要素将从中心点开始排序，并按顺时针移动。
  • COUNTERCLOCKWISE - 要素将从中心点开始排序，并按逆时针移动。
  • NONE - 不会使用空间排序。 将使用与要素类相同的顺序。

• 如果扇面参数值中存在 StartNumber 字段，则增量扇面依据参数值参数将处于非活动状态。 StartNumber 字段中值的有效包括 StartNumber 字段类型必须为 Long。

• 以下排序方法不使用中心点，而是按扇区应用。

  • 右上角
  • 左上角
  • 右下角
  • 左下角
  • 皮亚诺曲线

• 当未指定中心点参数值时，以下排序方法按扇区应用。

  • 居中
  • 顺时针
  • 逆时针

参数

对话框

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

派生输出

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

Python

arcpy.defense.NumberFeaturesBySector(in_features, sector_polygons, field_to_number, {new_field_type}, {spatial_sort_method}, {increment_by}, {center_point}, {add_distance_and_bearing})

名称	说明	数据类型
in_features	将对输入要素进行编号。	Feature Set
sector_polygons	表示用于编号的扇区的输入多边形。	Feature Set
field_to_number	将对输入字段进行编号。 该字段可以是现有的短型、长型或文本字段，也可以是新字段。	Field
new_field_type (可选)	指定将用于新字段的字段类型。 仅当输入表中不存在字段名称时才使用此参数。 SHORT—该字段的类型将为短型。 这是默认设置。 LONG—该字段的类型将为长型。 TEXT—该字段的类型将为文本。	String
spatial_sort_method (可选)	指定如何对要素进行空间排序以进行编号。 不会对表中的要素重新排序。 如果 sector_polygons 输入中存在字段 SortMethod，则将使用该值。 UR—要素将从右上角开始排序。 这是默认设置。 UL—要素将从左上角开始排序。 LR—要素将从右下角开始排序。 LL—要素将从左下角开始排序。 PEANO—要素将使用空间填充曲线算法（也称为皮亚诺曲线）进行排序。 CENTER—要素将从中心点开始排序（如果没有提供中心，将使用平均中心）。 CLOCKWISE—要素将从中心点开始排序，并按顺时针移动。 COUNTERCLOCKWISE—要素将从中心点开始排序，并按逆时针移动。 NONE—不会使用空间排序。 将使用与要素类相同的顺序。	String
increment_by (可选)	将用作从上一个扇面增加的值。 如果 sector_polygons 输入中存在字段 StartNumber，则将使用该值。	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

代码示例

NumberFeaturesBySector 示例 1（Python 窗口）

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

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.NumberFeaturesBySector_defense("bldg_footprints", "sectors", "bldg_number")

NumberFeaturesBySector 示例 2（独立脚本）

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

# Assign buildings a number based on their sector and export the first building in sector 700

# Import modules
import arcpy

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

# Number the buildings by sector
arcpy.NumberFeaturesBySector_defense("bldg_footprints",
                                     "sectors",
                                     "bldg_number",
                                     "LONG",
                                     "CENTER",
                                     100,
                                     "neighborhood_center",
                                     "DONT_ADD_DISTANCE")

# Select the first building in sector 700
select_from = "bldg_footprints"
expression = "bldg_number = 700"
arcpy.SelectLayerByAttribute_management(select_from,
                                        "NEW_SELECTION",
                                        expression)

# Export to new feature class
arcpy.FeatureClassToFeatureClass_conversion(select_from,
                                            arcpy.env.workspace,
                                            "bldg700")

环境

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

特殊情况

许可信息

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