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

サマリー

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

使用法

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

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

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

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

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

  • このツールは、異なるスキーマを含むアノテーション フィーチャクラスを処理します。 アノテーション フィーチャクラスのスキーマが同じ場合は、[アペンド (Append)] ツールを使用してください。

パラメーター

ラベル説明データ タイプ
入力フィーチャ

出力フィーチャクラスにアノテーション クラスを形成する入力アノテーション フィーチャです。

Feature Layer
出力フィーチャクラス

各入力アノテーション フィーチャクラスのアノテーション クラスを含む新規または既存のアノテーション フィーチャクラス。

Feature Class
基準縮尺

出力フィーチャクラスに設定されている基準縮尺。 異なる基準縮尺で作成された入力フィーチャは、この出力基準縮尺に合わせて変換されます。

Double
シングル アノテーションクラスの作成
(オプション)

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

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

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

  • オン - アノテーション フィーチャを作成する際、出力フィーチャクラスのシンボル コレクションに含まれているシンボルのリストのみを使用できます。
  • オフ - アノテーション フィーチャを作成する際に、任意のシンボルを使用できます。 これがデフォルトです。
Boolean
新しいフィーチャの追加時にアノテーションを作成 (フィーチャリンク アノテーションのみ有効)
(オプション)

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

  • オン - リンクされたフィーチャが追加されるときに、ラベル エンジンを使用してフィーチャリンク アノテーションを作成します。 これがデフォルトです。
  • オフ - フィーチャが追加されるときにフィーチャリンク アノテーションを作成しません。
Boolean
アノテーションとリンクするシェープが修正されたときにアノテーションも更新 (フィーチャリンク アノテーションのみ有効)
(オプション)

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

  • オン - リンクされたフィーチャが変更されるときに、ラベル エンジンを使用してフィーチャリンク アノテーションが更新されます。 これがデフォルトです。
  • オフ - リンクされたフィーチャが変更されるときに、フィーチャリンク アノテーションが更新されません。
Boolean

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
(オプション)

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

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

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

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

コードのサンプル

AppendAnnotation の例 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで AppendAnnotation 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/data/Cobourg.gdb"
arcpy.management.AppendAnnotation(["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.management.AppendAnnotation(fcList, outFeatureClass, refScale, 
                                  createClasses, symbolReq, autoCreate, 
                                  autoUpdate)

print("Annotation feature classes in {} have been appended into {}".format(
    arcpy.env.workspace, outFeatureClass))

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック