サマリー
コンター フィーチャ用のアノテーションを作成します。
このツールは入力コンター フィーチャに基づいて、対応するマスク ポリゴンを使用してアノテーション フィーチャクラスを作成します。
使用法
このツールの出力はグループ レイヤーです。グループ レイヤーには入力コンター フィーチャ、アノテーション レイヤー、またマスク ポリゴンが格納されます。
同じレイヤー名が指定されるか、出力の上書きが明示的に許可された場合は、既存のグループ レイヤーが上書きされます。
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
この [タイプ] フィールドには、[コンター タイプ フィールド] パラメーターの入力として使用できます。各タイプのアノテーション用に別個のアノテーション クラスが作成されます。
構文
ContourAnnotation_cartography (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 | コンター レイヤー、アノテーション レイヤー、またはマスク レイヤーを格納するグループ レイヤー。ArcCatalog での作業中は、[レイヤー ファイルの保存 (Save To Layer File)] ツールを使用して出力グループ レイヤーをレイヤー ファイルに書き込むことができます。ArcMap を使用している場合は、ジオプロセシング オプションでこのオプションをオンにしておくと、ツールによってグループ レイヤーが表示に追加されます。作成されるグループ レイヤーは一時的なもので、ドキュメントを保存しない限り、セッションの終了後は維持されません。 | Group Layer |
contour_color | 出力コンター レイヤーおよびアノテーション フィーチャの色
| String |
contour_type_field (オプション) | コンター フィーチャのタイプに応じた値を格納する、入力レイヤー属性テーブル内のフィールド。タイプ値ごとにアノテーションクラスが作成されます。 | Field |
contour_alignment (オプション) | アノテーションは、テキストの上部が必ず斜面の上側になるように、標高の上昇に合わせて配置することができます。このオプションを選択すると、アノテーションが上下逆に表示されることがあります。また、テキストの向きが上下逆にならないように、コンター アノテーションをページの向きに合わせて配置することもできます。
| String |
enable_laddering (オプション) | ラベルを整列させると、テキストが標高の高低に合わせて直線に沿って表示されるようになります。整列されたラベルは、標高の高い方から低い方に向かって並べられ、相互に交わることはなく、1 つの斜面のみに属し、他の斜面と交差しません。
| Boolean |
コードのサンプル
ContourAnnotation (コンター アノテーション) の例 (Python ウィンドウ)
次のスタンドアロン スクリプトは、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", "")
ContourAnnotation (コンター アノテーション) の例 2 (ワークフロー スクリプト)
このサンプルでは、[入力バリア設定を含むコンター (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)
環境
ライセンス情報
- ArcGIS Desktop Basic: はい
- ArcGIS Desktop Standard: はい
- ArcGIS Desktop Advanced: はい