使用字母标注要素 (Defense)

摘要

将字母添加到要素集的新字段或现有字段中。

使用情况

• 向现有字段添加顺序字母方案将覆盖该字段中的值。

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

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

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

参数

对话框

标注	说明	数据类型
输入要素	将使用字母标注输入要素。	Feature Set
要字母标注的字段（现有或新建）	将使用字母标注输入字段。 该字段必须为新建或现有文本字段。	Field
要字母标注的输入面 (可选)	限制要字母标注的要素的面；将仅对此面内的要素进行字母标注。	Feature Set
空间排序方法 (可选)	指定如何对要素进行空间排序以进行字母标注。 不会对表中的要素重新排序。 右上角—要素将从右上角开始排序。 这是默认设置。 左上角—要素将从左上角开始排序。 右下角—要素将从右下角开始排序。 左下角—要素将从左下角开始排序。 皮亚诺曲线—要素将使用空间填充曲线算法（也称为皮亚诺曲线）进行排序。 居中—要素将从中心点开始排序（如果没有提供中心，将使用平均中心）。 顺时针—要素将从中心点开始排序，并按顺时针移动。 逆时针—要素将从中心点开始排序，并按逆时针移动。 无—不会使用空间排序。 将使用与要素类相同的顺序。	String
字母标注格式 (可选)	指定将用于每个要素的标注格式。 Excel（A、B、C...）—将字母字符（例如，A、B、C）用作标注。 这是默认设置。 Grid（AA、AB、AC...）—将使用具有递增的第二个字母字符格网的常量字母字符（例如，AA、AB、AC）。 交替 Grid（AA、BB、CC...）—将使用为每个要素递增的双字母字符（例如，AA、BB、CC）。	String
开头字母 (可选)	将用于开始字母标注的值。	String
忽略字母 (可选)	将从字母序列中省略的值。	String
中心点 (可选)	将用于排序和字母标注要素的中心点。	Feature Set
添加到中心的距离和方位角 (可选)	指定是否将距中心点距离和方向角字段添加到输出中。 不添加距离和方位角—不会将距离或方位字段添加到输出中。 这是默认设置。 添加距离和方位角—DIST_TO_CENTER 和 ANGLE_TO_CENTER 字段将被添加到输出中。	Boolean

派生输出

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

Python

arcpy.defense.LetterFeatures(in_features, field_to_letter, {in_area}, {spatial_sort_method}, {lettering_format}, {starting_letter}, {omit_letters}, {center_point}, {add_distance_and_bearing})

名称	说明	数据类型
in_features	将使用字母标注输入要素。	Feature Set
field_to_letter	将使用字母标注输入字段。 该字段必须为新建或现有文本字段。	Field
in_area (可选)	限制要字母标注的要素的面；将仅对此面内的要素进行字母标注。	Feature Set
spatial_sort_method (可选)	指定如何对要素进行空间排序以进行字母标注。 不会对表中的要素重新排序。 UR—要素将从右上角开始排序。 这是默认设置。 UL—要素将从左上角开始排序。 LR—要素将从右下角开始排序。 LL—要素将从左下角开始排序。 PEANO—要素将使用空间填充曲线算法（也称为皮亚诺曲线）进行排序。 CENTER—要素将从中心点开始排序（如果没有提供中心，将使用平均中心）。 CLOCKWISE—要素将从中心点开始排序，并按顺时针移动。 COUNTERCLOCKWISE—要素将从中心点开始排序，并按逆时针移动。 NONE—不会使用空间排序。 将使用与要素类相同的顺序。	String
lettering_format (可选)	指定将用于每个要素的标注格式。 A_B_C—将字母字符（例如，A、B、C）用作标注。 这是默认设置。 AA_AB_AC—将使用具有递增的第二个字母字符格网的常量字母字符（例如，AA、AB、AC）。 AA_BB_CC—将使用为每个要素递增的双字母字符（例如，AA、BB、CC）。	String
starting_letter (可选)	将用于开始字母标注的值。	String
omit_letters [omit_letters,...] (可选)	将从字母序列中省略的值。	String
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

代码示例

LetterFeatures 示例 1（Python 窗口）

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

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.defense.LetterFeatures("bldg_footprints", "bldg_letter")

LetterFeatures 示例 2（独立脚本）

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

# Select buildings with a footprint over 5000 square feet and assign a letter

# Import system modules
import arcpy

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

# Project data
out_coordinate_system = arcpy.SpatialReference(3395)
proj_bldg = "bldg_footprint_proj"
arcpy.management.Project("Buildings",
                         proj_bldg,
                         out_coordinate_system)

# Calculate area
arcpy.management.CalculateGeometryAttributes(proj_bldg,
                                             "area AREA",
                                             '',
                                             "SQUARE_FEET_US")

# Export to a new feature class
expression = "area >= 5000"
arcpy.conversion.FeatureClassToFeatureClass(proj_bldg,
                                            arcpy.env.workspace,
                                            "bldg_over_5000",
                                            expression)

# Letter the buildings
arcpy.defense.LetterFeatures("bldg_over_5000",
                             "bldg_letter",
                              None,
                              "CENTER",
                              "A_B_C",
                              "A",
                              "D",
                              "neighborhood_center",
                              "ADD_DISTANCE")

环境

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

许可信息

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