概要
テレイン データセットに 1 つ以上のフィーチャクラスを追加します。
使用法
入力フィーチャは、テレイン データセットと同じフィーチャ データセットに置く必要があります。
テレイン データセットでは、1 つ以上のピラミッド レベルが定義済みである必要があります。
テレインに追加されるフィーチャに関連付けられているサーフェス タイプによっては、[テレインの構築 (Build Terrain)] を使用してテレイン データセットを再構築する必要がある場合があります。データセットの再構築が必要かどうかは、ArcCatalog のテレイン データセットの [プロパティ] ダイアログ ボックスと、ArcMap 内のテレイン レイヤーの [プロパティ] ダイアログ ボックスの両方に表示されます。
フィーチャに単純化されたジオメトリが含まれ、予想される表示縮尺で視覚的に関連している場合のみ、ブレークラインとポリゴンのサーフェス フィーチャ タイプの概観図オプションを有効化することを検討します。たとえば、ブレークラインは概観図表示では十分見やすいとは言えないが、クリップ ポリゴンを使うと見やすいという場合です。境界フィーチャが詳細な場合は頂点を間引きして、より低解像度の表示を概観図に使用します。詳細なフィーチャは、詳細な解像度により適した表示縮尺で使用してください。
エンタープライズ ジオデータベースに格納されるテレイン データセットの場合:
- 対象のテレインをバージョン対応登録することはできません。
- 入力フィーチャクラスをバージョン対応登録することはできません。
構文
arcpy.ddd.AddFeatureClassToTerrain(in_terrain, in_features)
| パラメーター | 説明 | データ タイプ |
in_terrain | フィーチャクラスが追加されるテレインです。テレイン データセットでは、1 つ以上のピラミッド レベルが作成済みである必要があります。 | Terrain Layer |
in_features [[in_features, height_field, SF_type, group, min_resolution, max_resolution, overview, embed, embed_name, embed_fields, anchor],...] | テレインに追加されるフィーチャクラスを指定します。各フィーチャはテレインと同じフィーチャ データセットに存在し、次のプロパティを通じてロールが定義される必要があります。
| Value Table |
派生した出力
| 名前 | 説明 | データ タイプ |
| derived_out_terrain | 更新されたテレイン。 | テレイン レイヤー |
コードのサンプル
AddFeatureClassToTerrain (テレインにフィーチャクラスを追加) の例 1 (Python ウィンドウ)
次のサンプルは、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)
AddFeatureClassToTerrain (テレインにフィーチャクラスを追加) の例 2 (スタンドアロン スクリプト)
次のサンプルは、スタンドアロン 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")
環境
ライセンス情報
- Basic: 次のものが必要 3D Analyst
- Standard: 次のものが必要 3D Analyst
- Advanced: 次のものが必要 3D Analyst