コンター アノテーション（Contour Annotation） (カートグラフィ)
サマリ
コンター フィーチャ用のアノテーションを作成します。
このツールは入力コンター フィーチャに基づいて、対応するマスク ポリゴンを使用してアノテーション フィーチャクラスを作成します。
使用法
このツールの出力はグループ レイヤです。グループ レイヤには入力コンター フィーチャ、アノテーション レイヤ、またマスク ポリゴンが格納されます。
同じレイヤ名が指定されるか、出力の上書きが明示的に許可された場合は、既存のグループ レイヤが上書きされます。
-
ArcCatalog または ModelBuilder で作業をしている場合は、[レイヤ ファイルの保存（Save To Layer File）] ツールを使用して、出力グループ レイヤをレイヤ ファイルに書き込むことができます。ArcMap を使用している場合は、ジオプロセシング オプションでこのオプションをオンにしておくと、ツールによってグループ レイヤが表示に追加されます。作成されるグループ レイヤは一時的なもので、ドキュメントを保存しない限り、セッションの終了後は維持されません。
ArcCatalog で作成されたグループ レイヤは、[レイヤ ファイルの保存（Save To Layer File）] ツールを使用してレイヤ ファイルに保存しておかない限り、ArcMap で使用できません。
このツールを単一コンター フィーチャクラスに対して複数回にわたって実行しても、アノテーション フィーチャクラスは上書きされません。この例では、アノテーション フィーチャクラスの末尾に番号が付加されます（例: ContourAnno、ContourAnno_1、... など）。
アノテーション フィーチャの周囲に 2 ポイント マージンで各マスクが作成されます。マスク タイプは完全に簡略化です。つまり、マスクはジェネラライズされたポリゴンであり、アノテーションの正確な形状を表します。
コンター レイヤおよび出力アノテーションの色は、黒、茶および青の 3 色からいずれかを選択します。
[入力バリア設定を含むコンター（Contour with Barriers）] ツールを使用して作成されたコンターには、[タイプ] フィールドが含まれます。[タイプ] フィールドには、次の値の 1 つまたは複数が含まれています。
1 for contours 2 for indexed contours 3 for explicit contoursこの [タイプ] フィールドには、[コンター タイプ フィールド] パラメータの入力として使用できます。各タイプのアノテーション用に別個のアノテーション クラスが作成されます。
構文
| パラメータ | 説明 | データ タイプ |
in_features | アノテーションが作成される対象のコンター ライン フィーチャクラス | Feature Layer |
out_geodatabase |
出力フィーチャクラスが保存されるワークスペース。ワークスペースには、既存のジオデータベースまたは既存のフィーチャ データセットを指定できます。 | Workspace; Feature Dataset |
contour_label_field |
アノテーション テキストのベースになる、入力レイヤ属性テーブル内のフィールド | Field |
reference_scale_value |
アノテーションの参照として使用する縮尺を入力します。これにより、アノテーション内のすべてのシンボル サイズとテキスト サイズの基準になる縮尺が設定されます。 | Double |
out_layer |
コンター レイヤ、アノテーション レイヤ、またはマスク レイヤを格納するグループ レイヤ。ArcCatalog での作業中は、[レイヤ ファイルの保存（Save To Layer File）] ツールを使用して出力グループ レイヤをレイヤ ファイルに書き込むことができます。ArcMap を使用している場合は、ジオプロセシング オプションでこのオプションをオンにしておくと、ツールによってグループ レイヤが表示に追加されます。作成されるグループ レイヤは一時的なもので、ドキュメントを保存しない限り、セッションの終了後は維持されません。 | Group Layer |
contour_color |
出力コンター レイヤおよびアノテーション フィーチャの色
| String |
contour_type_field (オプション) |
コンター フィーチャのタイプに応じた値を格納する、入力レイヤ属性テーブル内のフィールド。タイプ値ごとにアノテーションクラスが作成されます。 | Field |
contour_alignment (オプション) |
アノテーションは、テキストの上部が必ず斜面の上側になるように、標高の上昇に合わせて配置することができます。このオプションを選択すると、アノテーションが上下逆に表示されることがあります。また、テキストの向きが上下逆にならないように、コンター アノテーションをページの向きに合わせて配置することもできます。
| String |
enable_laddering (オプション) | ラベルを整列させると、テキストが標高の高低に合わせて直線に沿って表示されるようになります。整列されたラベルは、標高の高い方から低い方に向かって並べられ、相互に交わることはなく、1 つの斜面のみに属し、他の斜面と交差しません。
| Boolean |
コードのサンプル
次のスタンドアロン スクリプトは、ContourAnnotation（コンター アノテーション）関数の使用方法を示しています。
import arcpy
from arcpy import env
env.workspace = "C:/data/data.gdb"
arcpy.ContourAnnotation_cartography("Contours", "C:/data/data.gdb", "Contour", 50000, "ContourGroupLayer", "BLACK",
"", "PAGE", "")
このサンプルでは、[入力バリア設定を含むコンター（Contour with Barriers）] コマンドを実行します。そのツールからの出力は、ContourAnnotation（コンター アノテーション）ツールへの入力として使用されます。
# Name: ContourAnnotation_Example2.py
# Description: Create a contour with barriers feature class and then create annotation for the contours.
# Requirements: ArcGIS Spatial Analyst エクステンション
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
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"
# Check out the ArcGIS ArcGIS Spatial Analyst エクステンション license
arcpy.CheckOutExtension("Spatial")
# Execute 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"
# Execute ContourAnnotation
arcpy.ContourAnnotation_cartography(inFeatures, inWorkspace, LabelField, RefScaleValue, outLayer, Color,
TypeField, Alignment, Laddering)