テレインにフィーチャクラスを追加 (3D Analyst)
サマリ
テレイン データセットに 1 つ以上のフィーチャクラスを追加します。
使用法
-
入力フィーチャクラスは、テレイン データセットと同じフィーチャ データセットに置く必要があります。
-
テレイン データセットは、1 つ以上のピラミッド レベルが作成済みでなくてはいけません。
-
テレインに追加されるフィーチャに関連付けられているサーフェス タイプによっては、[テレインの構築（Build Terrain）] を使用してテレイン データセットを再構築する必要がある場合があります。ArcCatalog のテレイン データセットの [プロパティ] ダイアログ ボックス、および ArcMap のテレイン レイヤの [プロパティ] ダイアログ ボックスを確認すると、データセットの再構築が必要かどうかがわかります。
-
SDE に格納されるテレイン データセットの場合:
- 対象のテレインをバージョン対応登録することはできません。
- 入力フィーチャクラスをバージョン対応登録することはできません。
構文
| パラメータ | 説明 | データ タイプ |
in_terrain |
フィーチャクラスが追加されるテレインです。テレイン データセットは、1 つ以上のピラミッド レベルが作成済みでなくてはいけません。 | Terrain Layer |
in_features [[in_feature_class, height_source, SF_type, group, min_resolution, max_resolution, overview, embedded, embedded_fields, anchored],...] |
テレインに追加されるフィーチャクラスです。各フィーチャクラスは、テレインと同じフィーチャ データセットに置く必要があります。また、テレイン内でのフィーチャのロールを定義するプロパティを指定しなければなりません。 デフォルトの列幅が小さすぎる場合は、ダイアログ ボックスのサイズを変更して幅を広げることができます。 フィーチャクラスのプロパティ: in_feature_class - テレイン データセットに追加する入力フィーチャクラスの名前です。 height_source - フィーチャの高さの値を指定するフィールドです。すべての数値フィールドが、利用可能なオプションとして表示されます。フィーチャクラスが Z 対応の場合、フィーチャのジオメトリ フィールドがリストに表示され、デフォルト値として選択されます。フィーチャクラスが Z 対応でない場合、デフォルトでキーワード「<なし>」が指定されます。Z 値のないフィーチャには高さがないので、その値はサーフェスから内挿されてから追加されます。 SF_type - サーフェス フィーチャ タイプを表します。これは、サーフェスを三角形分割する際のフィーチャの処理方法を指定します。オプションとして、標高点、ブレークライン、および複数のポリゴン タイプがあります。ブレークラインとポリゴンにはハードおよびソフト修飾子もあり、これらは、サーフェスがフィーチャ上で滑らかに交差する（ソフト）か、鋭い裂け目が生じる可能性がある（ハード）かを内挿法に示します。 group - 主題が類似するデータで、同じ地理フィーチャを異なる詳細レベルで表しているものは、グループに分類して配置されます。同じグループに属するフィーチャクラスには、同じ値が割り当てられます。たとえば、調査領域の境界フィーチャが 2 つあり、1 つには大きな縮尺用の非常に詳細な境界が含まれ、もう 一方には粗い境界が含まれている場合、それぞれの表示縮尺で重複する部分ができないように、どちらも同じグループに割り当てられます。このパラメータは、ブレークラインとポリゴンのサーフェス タイプにのみ適用されます。 min_resolution および max_resolution - テレイン データセットでフィーチャに適用されるピラミッド解像度の範囲を定義します。これらのパラメータは、ブレークラインとポリゴンのサーフェス タイプにのみ適用されます。 overview - フィーチャクラスにテレイン データセットの概観図表示を適用するかどうかを示します。これは、全体表示される場合にデフォルトで描画される最も解像度の低い表示です。表示パフォーマンスを最大にするには、概観図で表示されるフィーチャクラスに単純化したジオメトリを含めるようにします。たとえば、ブレークラインは概観図表示では十分見やすいとはいえない場合もありますが、クリップ ポリゴンは有益です。境界フィーチャが詳細な場合は頂点を間引きして、より低解像度の表示を概観図に使用します。より詳細なピラミッド解像度レベルでは、詳細なバージョンを使用する必要があります。このパラメータは、ブレークラインとポリゴンのサーフェス タイプにのみ適用されます。 embedded - フィーチャクラスがテレイン データセットに埋め込まれるかどうかを示します。このオプションを TRUE に設定すると、フィーチャのポイントのコピーが作成されます。埋め込みフィーチャには、テレイン データセットに関連するツールからのみアクセス可能です。ただし、ArcCatalog で直接表示することはできません。また、Add Data ブラウザで選択することもできません。このオプションはマルチポイント フィーチャクラスにのみ適用されます。 embedded_fields - 埋め込みフィーチャクラスとともに格納される LIDAR 属性を特定します。[LAS → マルチポイント（LAS to Multipoint）] ツールを使用すると、マルチポイント フィーチャクラスの LIDAR 属性を格納できます。 anchored - ポイント フィーチャクラスが、すべてのテレイン ピラミッド レベルを通じて固定されるかどうかを指定します。アンカー位置は、テレイン サーフェスで保持されるために、フィルタ処理および間引きの対象外です。このオプションはシングルポイント フィーチャクラスにのみ適用されます。 | Value Table |
コードのサンプル
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
params = "terrain.gdb/terrainFDS/points2 SHAPE masspoints 2 0 10 true false "\
"points_embed <None> false"
arcpy.AddFeatureClassToTerrain_3d("test.gdb/featuredataset/terrain", params)
次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。
"""****************************************************************************
Name: Create Terrain from TIN
Description: This script demonstrates how to create a terrain dataset using
features extracted from a TIN. It is particularly useful in
situations where the source data used in the TIN is not available,
and the amount of data stored in the TIN proves to be too large
for the TIN. The terrain's scalability will allow improved
display performance and faster analysis. The script is designed
to work as a script tool with 5 input arguments.
****************************************************************************"""
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env
# Set local variables
tin = arcpy.GetParameterAsText(0) # TIN used to create terrain
gdbLocation = arcpy.GetParameterAsText(1) # Folder that will store terran GDB
gdbName = arcpy.GetParameterAsText(2) # Name of terrain GDB
fdName = arcpy.GetParameterAsText(3) # Name of feature dataset
terrainName = arcpy.GetParameterAsText(4) # Name of terrain
try:
arcpy.CheckOutExtension("3D")
# Create the file gdb that will store the feature dataset
arcpy.management.CreateFileGDB(gdbLocation, gdbName)
gdb = '{0}/{1}'.format(gdbLocation, gdbName)
# Obtain spatial reference from TIN
SR = arcpy.Describe(tin).spatialReference
# Create the feature dataset that will store the terrain
arcpy.management.CreateFeatureDataset(gdb, fdName, SR)
fd = '{0}/{1}'.format(gdb, fdName)
# Export TIN elements to feature classes for terrain
arcpy.AddMessage("Exporting TIN footprint to define terrain boundary...")
boundary = "{0}/boundary".format(fd)
# Execute TinDomain
arcpy.ddd.TinDomain(tin, tinDomain, 'POLYGON')
arcpy.AddMessage("Exporting TIN breaklines...")
breaklines = "{0}/breaklines".format(fd)
# Execute TinLine
arcpy.ddd.TinLine(tin, breaklines, "Code")
arcpy.AddMessage("Exporting TIN nodes...")
masspoints = "{0}/masspoints".format(fd)
# Execute TinNode
arcpy.ddd.TinNode(sourceTIN, TIN_nodes)
arcpy.AddMessage("Creating terrain dataset...")
terrain = "terrain_from_tin"
# Execute CreateTerrain
arcpy.ddd.CreateTerrain(fd, terrainName, 10, 50000, "",
"WINDOWSIZE", "ZMEAN", "NONE", 1)
arcpy.AddMessage("Adding terrain pyramid levels...")
terrain = "{0}/{1}".format(fd, terrainName)
pyramids = ["20 5000", "25 10000", "35 25000", "50 50000"]
# Execute AddTerrainPyramidLevel
arcpy.ddd.AddTerrainPyramidLevel(terrain, "", pyramids)
arcpy.AddMessage("Adding features to terrain...")
inFeatures = "{0} Shape softclip 1 0 10 true false boundary_embed <None> "\
"false; {1} Shape masspoints 1 0 50 true false points_embed "\
"<None> false; {2} Shape softline 1 0 25 false false lines_embed "\
"<None> false".format(boundary, masspoints, breaklines)
# Execute AddFeatureClassToTerrain
arcpy.ddd.AddFeatureClassToTerrain(terrain, inFeatures)
arcpy.AddMessage("Building terrain...")
# Execute BuildTerrain
arcpy.ddd.BuildTerrain(terrain, "NO_UPDATE_EXTENT")
arcpy.GetMessages()
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = "PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}"\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = "ArcPy ERRORS:\n {0}\n".format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)
finally:
arcpy.CheckInExtension("3D")