コンターアノテーション (カートグラフィツール)

サマリー

コンターフィーチャ用のアノテーションを作成します。

このツールは入力コンターフィーチャに基づいて、対応するマスクポリゴンを使用してアノテーションフィーチャクラスを作成します。

使用法

コンターは、Maplex Label Engine の 等高線配置 スタイルおよび 中央に直線 配置位置を使用してラベル付けされます。

コンターのラベル付けの詳細
このツールの出力はグループレイヤーです。グループレイヤーには入力コンターフィーチャ、アノテーションレイヤー、またマスクポリゴンが格納されます。
同じレイヤー名が指定されるか、出力の上書きが明示的に許可された場合は、既存のグループレイヤーが上書きされます。
カタログ ウィンドウまたは ModelBuilder での作業中は、レイヤーファイルの保存 ツールを使用して出力グループレイヤーをレイヤーファイルに書き込むことができます。
このツールを単一コンターフィーチャクラスに対して複数回にわたって実行しても、アノテーションフィーチャクラスは上書きされません。この例では、アノテーションフィーチャクラス名の末尾に番号が付加されます (例: ContourAnno、ContourAnno_1 など)。
アノテーションフィーチャの周囲に 2 ポイントマージンで各マスクが作成されます。マスクタイプは完全に簡略化です。つまり、マスクはジェネラライズされたポリゴンであり、アノテーションの正確な形状を表します。
コンターレイヤーおよび出力アノテーションの色は、黒、茶および青の 3 色からいずれかを選択します。
入力バリア設定を含むコンター ツールを使用して作成されたコンターには、Type フィールドが含まれます。 Type フィールドには、次の値の 1 つまたは複数が含まれています。
- 1—コンター
- 2—インデックスコンター
- 3—明示的なコンター
この Type フィールドは、コンタータイプフィールド パラメーターの入力として使用できます。各タイプのアノテーション用に別個のアノテーションクラスが作成されます。
このツールはアノテーションテキスト文字列フィールド長環境に従います。設定すると、データベースで作成されたすべてのアノテーションフィーチャクラスの TextString フィールドでデフォルトのフィールド長をオーバーライドします。

ラベル	説明	データタイプ
入力フィーチャ	アノテーションが作成される対象のコンターラインフィーチャクラス。	Feature Layer
出力ジオデータベース	出力フィーチャクラスが保存されるワークスペース。ワークスペースには、既存のジオデータベースまたは既存のフィーチャデータセットを指定できます。	Workspace; Feature Dataset
コンターラベルフィールド	アノテーションテキストのベースになる、入力レイヤー属性テーブル内のフィールド。	Field
基準縮尺	アノテーションの参照として使用される縮尺です。これにより、アノテーション内のすべてのシンボルサイズとテキストサイズの基準になる縮尺が設定されます。	Double
出力レイヤー名	コンターレイヤー、アノテーションレイヤー、またはマスクレイヤーを格納するグループレイヤー。カタログウィンドウで作業しているときに、レイヤーファイルの保存ツールを使用して出力グループレイヤーをレイヤーファイルに書き込むことができます。 ArcGIS Pro を使用している場合は、オプションダイアログボックスのジオプロセシングタブで開いているマップに出力データセットを追加オプションをオンにしておくと、このツールによってグループレイヤーが表示に追加されます。作成されるグループレイヤーは一時的なもので、ドキュメントを保存しない限り、セッションの終了後は維持されません。	Group Layer
コンターとラベルの色	出力コンターレイヤーおよびアノテーションフィーチャの色を指定します。黒—出力コンターレイヤーおよびアノテーションフィーチャは、黒で描画されます。これがデフォルトです。茶—出力コンターレイヤーおよびアノテーションフィーチャは、茶色で描画されます。青—出力コンターレイヤーおよびアノテーションフィーチャは、青色で描画されます。	String
コンタータイプフィールド (オプション)	コンターフィーチャのタイプに応じた値を格納する、入力レイヤー属性テーブル内のフィールド。タイプ値ごとにアノテーションクラスが作成されます。	Field
コンターの配置 (オプション)	コンター標高に沿ってアノテーションを配置する方法を指定します。アノテーションは、テキストの上部が必ず斜面の上側または下側になるように、標高の上昇に合わせて配置することができます。これらのオプションを選択すると、アノテーションが上下逆に表示されることがあります。また、テキストの向きが上下逆にならないように、コンターアノテーションをページの向きに合わせて配置することもできます。ページの上部に合わせてテキストの上部を配置—また、テキストの向きが上下逆にならないように、アノテーションをページの向きに合わせて配置することもできます。これがデフォルトです。斜面の上側になるようにテキストの上部を配置—アノテーションは、テキストの上部が必ず斜面の上側になるように、標高の上昇に合わせて配置されます。このオプションを選択すると、アノテーションが上下逆に表示されることがあります。斜面の下側になるようにテキストの上部を配置—アノテーションは、テキストの上部が必ず斜面の下側になるように、標高の上昇に合わせて配置することができます。このオプションを選択すると、アノテーションが上下逆に表示されることがあります。	String
ラベルの整列を有効化 (オプション)	アノテーションを整列させるかどうかを指定します。ラベルを整列させると、テキストが標高の高低に合わせて直線に沿って表示されるようになります。整列されたラベルは、標高の高い方から低い方に向かって並べられ、相互に交わることはなく、1 つの斜面のみに属し、他の斜面と交差しません。オン—アノテーションを標高の高低に合わせて直線に沿って表示します。オフ—アノテーションを標高の高低に合わせて直線に沿って表示しません。これがデフォルトです。	Boolean

派生した出力

ラベル	説明	データタイプ
Output Workspace (出力ワークスペース)	出力フィーチャクラスが保存されるワークスペース。	Workspace; Feature Dataset

arcpy.cartography.ContourAnnotation(in_features, out_geodatabase, contour_label_field, reference_scale_value, out_layer, contour_color, {contour_type_field}, {contour_alignment}, {enable_laddering})

名前	説明	データタイプ
in_features	アノテーションが作成される対象のコンターラインフィーチャクラス。	Feature Layer
out_geodatabase	出力フィーチャクラスが保存されるワークスペース。ワークスペースには、既存のジオデータベースまたは既存のフィーチャデータセットを指定できます。	Workspace; Feature Dataset
contour_label_field	アノテーションテキストのベースになる、入力レイヤー属性テーブル内のフィールド。	Field
reference_scale_value	アノテーションの参照として使用される縮尺です。これにより、アノテーション内のすべてのシンボルサイズとテキストサイズの基準になる縮尺が設定されます。	Double
out_layer	コンターレイヤー、アノテーションレイヤー、またはマスクレイヤーを格納するグループレイヤー。カタログウィンドウで作業しているときに、レイヤーファイルの保存ツールを使用して出力グループレイヤーをレイヤーファイルに書き込むことができます。 ArcGIS Pro を使用している場合は、オプションダイアログボックスのジオプロセシングタブで開いているマップに出力データセットを追加オプションをオンにしておくと、このツールによってグループレイヤーが表示に追加されます。作成されるグループレイヤーは一時的なもので、ドキュメントを保存しない限り、セッションの終了後は維持されません。	Group Layer
contour_color	出力コンターレイヤーおよびアノテーションフィーチャの色を指定します。 `BLACK`—出力コンターレイヤーおよびアノテーションフィーチャは、黒で描画されます。これがデフォルトです。 `BROWN`—出力コンターレイヤーおよびアノテーションフィーチャは、茶色で描画されます。 `BLUE`—出力コンターレイヤーおよびアノテーションフィーチャは、青色で描画されます。	String
contour_type_field (オプション)	コンターフィーチャのタイプに応じた値を格納する、入力レイヤー属性テーブル内のフィールド。タイプ値ごとにアノテーションクラスが作成されます。	Field
contour_alignment (オプション)	コンター標高に沿ってアノテーションを配置する方法を指定します。アノテーションは、テキストの上部が必ず斜面の上側または下側になるように、標高の上昇に合わせて配置することができます。これらのオプションを選択すると、アノテーションが上下逆に表示されることがあります。また、テキストの向きが上下逆にならないように、コンターアノテーションをページの向きに合わせて配置することもできます。 `PAGE`—また、テキストの向きが上下逆にならないように、アノテーションをページの向きに合わせて配置することもできます。これがデフォルトです。 `UPHILL`—アノテーションは、テキストの上部が必ず斜面の上側になるように、標高の上昇に合わせて配置されます。このオプションを選択すると、アノテーションが上下逆に表示されることがあります。 `DOWNHILL`—アノテーションは、テキストの上部が必ず斜面の下側になるように、標高の上昇に合わせて配置することができます。このオプションを選択すると、アノテーションが上下逆に表示されることがあります。	String
enable_laddering (オプション)	アノテーションを整列させるかどうかを指定します。ラベルを整列させると、テキストが標高の高低に合わせて直線に沿って表示されるようになります。整列されたラベルは、標高の高い方から低い方に向かって並べられ、相互に交わることはなく、1 つの斜面のみに属し、他の斜面と交差しません。 `ENABLE_LADDERING`—アノテーションを標高の高低に合わせて直線に沿って表示します。 `NOT_ENABLE_LADDERING`—アノテーションを標高の高低に合わせて直線に沿って表示しません。これがデフォルトです。	Boolean

派生した出力

名前	説明	データタイプ
out_geodatabase2	出力フィーチャクラスが保存されるワークスペース。	Workspace; Feature Dataset

コードのサンプル

ContourAnnotation の例 1 (Python ウィンドウ)

次のスタンドアロンスクリプトで、ContourAnnotation 関数を使用する方法を示します。

import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.cartography.ContourAnnotation("Contours", "C:/data/data.gdb", "Contour",
                                    50000, "ContourGroupLayer", "BLACK", "",
                                    "PAGE")

ContourAnnotation の例 2 (スタンドアロンスクリプト)

このサンプルでは、ContourWithBarriers 関数を実行します。そのツールからの出力は、ContourAnnotation 関数への入力として使用されます。

# Description: Create a contour with barriers feature class and then create
#              annotation for the contours.
# Requirements: ArcGIS Spatial Analyst extension

# Import system modules
import arcpy

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

# Set local variables
inRaster = "elevation"
inBarrier = "ridges"
inTextFile = ""
explicitValues = "NO_EXPLICIT_VALUES_ONLY"
contourInterval = 200
indexInterval = 1000
contourList = [1500, 3000]
baseContour = 0
outContours = "C:/data/data.gdb/outcontourwithbarriers"

# Run ContourWithBarriers
arcpy.sa.ContourWithBarriers(inRaster, outContours, inBarrier, "POLYLINES",
                             inTextFile, explicitValues, baseContour,
                             contourInterval, indexInterval, contourList)

# Set local variables
inFeatures = "C:/data/data.gdb/outcontourwithbarriers"
inWorkspace = "C:/data/data.gdb"
LabelField = "Contour"
RefScaleValue = 50000
outLayer = "Contours"
Color = "BROWN"
TypeField = "Type"
Alignment = "PAGE"
Laddering = "NOT_ENABLE_LADDERING"

# Run ContourAnnotation
arcpy.cartography.ContourAnnotation(inFeatures, inWorkspace, LabelField,
                                    RefScaleValue, outLayer, Color, TypeField,
                                    Alignment, Laddering)

環境

基準縮尺, 出力座標系, アノテーションテキスト文字列フィールド長

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

コンター アノテーション (カートグラフィ ツール)

サマリー

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック

コンターアノテーション (カートグラフィツール)