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

ライセンス レベル:BasicStandardAdvanced

サマリ

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

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

使用法

構文

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

出力コンター レイヤおよびアノテーション フィーチャの色

  • BLACK出力コンター レイヤおよびアノテーション フィーチャは、黒で描画されます。これがデフォルトです。
  • BROWN出力コンター レイヤおよびアノテーション フィーチャは、茶色で描画されます。
  • BLUE出力コンター レイヤおよびアノテーション フィーチャは、青色で描画されます。
String
contour_type_field
(オプション)

コンター フィーチャのタイプに応じた値を格納する、入力レイヤ属性テーブル内のフィールド。タイプ値ごとにアノテーションクラスが作成されます。

Field
contour_alignment
(オプション)

アノテーションは、テキストの上部が必ず斜面の上側になるように、標高の上昇に合わせて配置することができます。このオプションを選択すると、アノテーションが上下逆に表示されることがあります。また、テキストの向きが上下逆にならないように、コンター アノテーションをページの向きに合わせて配置することもできます。

  • PAGE また、テキストの向きが上下逆にならないように、アノテーションをページの向きに合わせて配置することもできます。 これがデフォルトです。
  • UPHILLアノテーションは、テキストの上部が必ず斜面の上側になるように、標高の上昇に合わせて配置することができます。このオプションを選択すると、アノテーションが上下逆に表示されることがあります。
String
enable_laddering
(オプション)

ラベルを整列させると、テキストが標高の高低に合わせて直線に沿って表示されるようになります。整列されたラベルは、標高の高い方から低い方に向かって並べられ、相互に交わることはなく、1 つの斜面のみに属し、他の斜面と交差しません。

  • ENABLE_LADDERINGアノテーションを標高の高低に合わせて直線に沿って表示します。
  • NOT_ENABLE_LADDERINGアノテーションを標高の高低に合わせて直線に沿って表示しません。これがデフォルトです。
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 for Desktop Basic: ○
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
9/14/2013