サーフェス コンター(Surface Contour) (3D Analyst)
図
使用法
出力フィーチャクラスは 2D であるため、コンター値を持つ属性を含みます。
-
間隔とベース コンターのオプションを使用して、出力フィーチャクラスの範囲と解像度を調整します。
-
出力コンター フィールド データを使用して、フィーチャクラスを 3D に変換します。
-
特定の状況で、TIN サーフェスを使用してコンターを作成するときに、最後に有効なコンター ラインが作成されないことがあります。これは、コンピュータのコンター作成ソフトウェアに共通なアルゴリズムによる制限です。有効なコンターをすべて確実に生成するには、[ベース コンター] フィールドに非常に小さい負の値を加算して、データを少し移動します。
[Z 係数] パラメータは、ラスタおよび TIN の結果にのみ影響し、テレイン データセットには影響しません。テレイン データセットで作業している場合は、Z 係数を適用済みのコンター間隔を指定できます。たとえば、コンター間隔を 1 フィートにしたいときにテレイン データセット サーフェスがメートル単位である場合は、コンター間隔を 0.3048 に指定します。また、[テレイン → ラスタ(Terrain to Raster)] または [テレイン → TIN(Terrain To TIN)] ジオプロセシング ツールを使用して、テレイン データセットをラスタまたは TIN に変換することもできます。
構文
パラメータ | 説明 | データ タイプ |
in_surface |
入力 テレインまたは TIN データセット。 | Terrain Layer; TIN Layer |
out_feature_class |
出力フィーチャクラス。 | Feature Class |
interval |
コンターの間隔。 | Double |
base_contour (オプション) |
インデックス間隔とともに基準高度を使用して、生成するコンターを決定します。基準高度は、インデックス間隔を加算または減算する際の基準です。デフォルトでは、ベース コンターは 0.0 です。 | Double |
contour_field (オプション) |
出力フィーチャクラスの各ラインに関連付けられたコンター値を格納するフィールド。 | String |
contour_field_precision (オプション) |
コンター フィールドの精度。0 は整数を指定し、1 ~ 9 の数値はフィールドに含まれる小数点以下の桁数を表します。デフォルトでは、フィールドは整数(0)です。 | Long |
index_interval (オプション) |
インデックス コンター間の標高の差分を指定するオプションの値。この値は通常、コンター間隔の 5 倍です。このパラメータを使用して、[インデックス間隔フィールド] で定義された整数フィールドを出力フィーチャクラスの属性テーブルに追加します。ここでは 1 の値でインデックス コンターが定義されます。 | Double |
index_interval_field (オプション) |
等値線がインデックス コンターであるかどうかを指定するフィールドの名前。これは、[インデックス間隔] が定義されている場合のみ使用します。デフォルトでは、フィールド名は「インデックス」です。 | String |
z_factor (オプション) |
サーフェスの高さを乗算して、Z 単位を XY 単位に変換するための係数を指定します。[Z 係数] パラメータは、ラスタおよび TIN の結果にのみ影響し、テレイン データセットには影響しません。 | Double |
pyramid_level_resolution (オプション) |
このツールが使用するテレイン ピラミッド レベルの Z 許容値またはウィンドウサイズの解像度。デフォルト値は 0(最大解像度)です。 | Double |
コードのサンプル
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.SurfaceContour_3d("sample.gdb/featuredataset/terrain", "contour.shp", 10)
次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。
'''****************************************************************************
Name: SurfaceContour Example
Description: This script demonstrates how to use the
SurfaceContour tool.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
inSurface = "sample.gdb/featuredataset/terrain"
outContour = arcpy.CreateUniqueName("contour.shp")
#Execute SurfaceContour
arcpy.SurfaceContour_3d(inSurface, outContour, 10)
del inSurface, outContour, arcpy