概要
複数の入力ジオデータベース アノテーション フィーチャクラスのアノテーションを、複数のアノテーション クラスを使用して 1 つのフィーチャクラスに結合することにより、ジオデータベース アノテーション フィーチャクラスを作成するか、既存のアノテーション フィーチャクラスに追加 (アペンド) します。
使用法
複数のアノテーション フィーチャクラスを 1 つの新しいアノテーション フィーチャクラスに追加するには、入力アノテーション フィーチャクラスが同じデータベース内に存在する必要があります。
ArcMap でジオデータベース アノテーション フィーチャを選択するか、フィルター設定を作成すると、選択されたフィーチャだけが出力フィーチャクラスに追加されます。
フィーチャリンク アノテーション フィーチャクラスを追加するには、すべての入力アノテーション フィーチャクラスが同じフィーチャクラスにリンクされている必要があります。
すでに存在する出力アノテーション フィーチャクラスを選択した場合、フィーチャはこのフィーチャクラスに追加され、アノテーション フィーチャは出力先の空間参照に投影されます。
複数のアノテーション サブクラスを持つアノテーション フィーチャクラスを追加すると、サブクラスが追加され、1 つのクラスにマージはされません。
出力フィーチャリンク アノテーション フィーチャクラスを作成するには、ArcGIS Desktop Standard または ArcGIS Desktop Advanced ライセンスが必要です。
構文
arcpy.management.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 (オプション) | フィーチャが追加されるときに、フィーチャリンク アノテーションを作成するかどうかを指定します。
| Boolean |
update_annotation_when_feature_modified (オプション) | リンクされたフィーチャが変更されるときに、フィーチャリンク アノテーションを更新するかどうかを指定します。
| Boolean |
コードのサンプル
AppendAnnotation (アノテーションのアペンド) の例 (Python ウィンドウ)
次の 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 (アノテーションのアペンド) の例 (スタンドアロン スクリプト)
次のスタンドアロン スクリプトで、この 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: はい