アノテーション フィーチャクラスのアペンド (Append Annotation Feature Classes) (データ管理)

概要

複数の入力ジオデータベース アノテーション フィーチャクラスのアノテーションを、複数のアノテーション クラスを使用して 1 つのフィーチャクラスに結合することにより、ジオデータベース アノテーション フィーチャクラスを作成するか、既存のアノテーション フィーチャクラスに追加 (アペンド) します。

使用法

  • 複数のアノテーション フィーチャクラスを 1 つの新しいアノテーション フィーチャクラスに追加するには、入力アノテーション フィーチャクラスが同じデータベース内に存在する必要があります。

  • ArcGIS Pro でジオデータベース アノテーション フィーチャを選択するか、フィルター設定を作成すると、選択されたフィーチャだけが出力フィーチャクラスに追加されます。

  • フィーチャリンク アノテーション フィーチャクラスを追加するには、すべての入力アノテーション フィーチャクラスが同じフィーチャクラスにリンクされている必要があります。

  • すでに存在する出力アノテーション フィーチャクラスを選択した場合、フィーチャはこのフィーチャクラスに追加され、アノテーション フィーチャは出力先の空間参照に投影されます。

  • 複数のアノテーション サブクラスを持つアノテーション フィーチャクラスを追加すると、サブクラスのプロパティが一致した場合、サブクラスはマージされます。

  • 出力フィーチャリンク アノテーション フィーチャクラスを作成するには、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
(オプション)

出力フィーチャクラスにアノテーション フィーチャを追加する方法を指定します。

  • ONE_CLASS_ONLY出力フィーチャクラス内の 1 つのアノテーション クラスにすべてのアノテーション フィーチャを集約します。
  • CREATE_CLASSESクラスが同じ名前を付けられ、同じプロパティを持たない限り、出力フィーチャクラス内の入力アノテーション クラスごとに別個のアノテーション クラスを作成します。この場合、クラスはマージされます。これがデフォルトです。
Boolean
require_symbol_from_table
(オプション)

新しく作成したアノテーション フィーチャに対してシンボルを選択する方法を指定します。

  • REQUIRE_SYMBOLアノテーション フィーチャの作成を、出力フィーチャクラスのシンボル コレクションに含まれているシンボルのリストに制限します。
  • NO_SYMBOL_REQUIREDアノテーション フィーチャを任意のシンボル情報で作成できます。これがデフォルトです。
Boolean
create_annotation_when_feature_added
(オプション)
ライセンス:

このパラメーターは ArcGIS Desktop Standard および ArcGIS Desktop Advanced ライセンスでのみ利用可能です。

フィーチャが追加されるときに、フィーチャリンク アノテーションを作成するかどうかを指定します。

  • AUTO_CREATEリンクされたフィーチャが作成されるときに、ラベル エンジンを使用してフィーチャリンク アノテーションが作成されます。これがデフォルトです。
  • NO_AUTO_CREATEフィーチャが作成されるときに、フィーチャリンク アノテーションが作成されません。
Boolean
update_annotation_when_feature_modified
(オプション)
ライセンス:

このパラメーターは ArcGIS Desktop Standard および ArcGIS Desktop Advanced ライセンスでのみ利用可能です。

リンクされたフィーチャが変更されるときに、フィーチャリンク アノテーションを更新するかどうかを指定します。

  • AUTO_UPDATEリンクされたフィーチャが変更されるとき、ラベル エンジンを使用してフィーチャリンク アノテーションが更新されます。これがデフォルトです。
  • NO_AUTO_UPDATEリンクされたフィーチャが変更されるときに、フィーチャリンク アノテーションは更新されません。
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: はい

関連トピック