描述
创建地理数据库注记要素类,或者通过合并多个输入地理数据库要素类中的注记将现有注记要素类追加到一个包含注记类的要素类中。
使用方法
将多个注记要素类追加到新的注记要素类中时,输入注记要素类必须位于同一个数据库中。
如果在 ArcGIS Pro 中选择地理数据库注记要素或者构建定义查询,则只会将这些要素追加到输出要素类中。
追加关联要素的注记要素类时,所有输入注记要素类必须与同一个要素类相关联。
如果选择已存在的输出注记要素类,则会将要素追加到该要素类中,并且此工具会在目标空间参考中对注记要素进行投影。
追加带有多个注记子类的注记要素类时,如果子类的属性匹配,则将合并子类。
要创建输出关联要素的注记要素类,需要 ArcGIS Desktop Standard 或 ArcGIS Desktop Advanced 许可。
语法
AppendAnnotation(input_features, output_featureclass, reference_scale, {create_single_class}, {require_symbol_from_table}, {create_annotation_when_feature_added}, {update_annotation_when_feature_modified})
参数 | 说明 | 数据类型 |
input_features [input_features,...] | 将在输出要素类中形成注记类的输入注记要素。 | Feature Layer |
output_featureclass | 将包含各输入注记要素类的注记类的新注记要素类。 | Feature Class |
reference_scale | 在输出要素类中设置的参考比例。以不同参考比例创建的输入要素将进行变换以与此输出参考比例相匹配。 | Double |
create_single_class (可选) | 指定如何向输出要素类添加注记要素。
| Boolean |
require_symbol_from_table (可选) | 指定如何为新建的注记要素选择符号。
| Boolean |
create_annotation_when_feature_added (可选) | 许可:仅当具有 ArcGIS Desktop Standard 和 ArcGIS Desktop Advanced 级别许可时,此参数才可用。 指定在添加要素时是否创建关联要素的注记。
| Boolean |
update_annotation_when_feature_modified (可选) | 许可:仅当具有 ArcGIS Desktop Standard 和 ArcGIS Desktop Advanced 级别许可时,此参数才可用。 指定在关联要素发生更改时是否更新关联要素的注记。
| Boolean |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 AppendAnnotation 工具。
import arcpy
arcpy.env.workspace = "C:/data/Cobourg.gdb"
arcpy.AppendAnnotation_management("highways;roads", "transport_anno", 1200,
"CREATE_CLASSES", "NO_SYMBOL_REQUIRED",
"AUTO_CREATE", "AUTO_UPDATE")
以下独立脚本演示了如何使用 AppendAnnotation 工具。
# Name: AppendAnnotation_Example.py
# Description: Use AppendAnnotation to append annotation feature classes in a
# geodatabase
# import system modules
import arcpy
import os
# Set environment settings - user specified
# User input geodatabase for annotation location - eg. C:/data/roads.gdb
arcpy.env.workspace = input('Location of geodatabase annotation: ')
# Create list of annotation feature classes within the geodatabase
fcList = arcpy.ListFeatureClasses("", "ANNOTATION")
# Set variables
# User input output feature class name - eg. appendedroadsAnno
outFeatureClass = arcpy.env.workspace + os.sep + \
input('Output annotation feature class name: ')
refScale = 1200
createClasses = "CREATE_CLASSES"
symbolReq = "NO_SYMBOL_REQUIRED"
autoCreate = "AUTO_CREATE"
autoUpdate = "AUTO_UPDATE"
# Process: Append the annotation feature classes
print("Appending annotation feature classes...")
arcpy.AppendAnnotation_management(fcList, outFeatureClass, refScale,
createClasses, symbolReq, autoCreate,
autoUpdate)
print("Annotation feature classes in {} have been appended into {}".format(
arcpy.env.workspace, outFeatureClass))
许可信息
- Basic: 受限
- Standard: 是
- Advanced: 是