3D Analyst のライセンスで利用可能。
テレイン データセットが参照するポイント フィーチャにポイントを追加します。
このツールを使用すると、テレイン データセットは無効になります。ポイントまたはマルチポイントを追加した後に、[テレインの構築 (Build Terrain)] を実行します。
テレインが SDE に存在する場合は、バージョン対応登録されている必要があります。
| ラベル | 説明 | データ タイプ |
入力テレイン | 処理対象のテレイン データセット。 | Terrain Layer |
入力テレイン データ ソース | ポイントまたはマルチポイントの追加先となるテレイン データセットで使用されるフィーチャクラスです。 | String |
入力ポイント | テレイン データセットの追加データ ソースとして追加するポイントまたはマルチポイントのフィーチャクラスです。 | Feature Layer |
対象地域 (AOI) (オプション) | ポリゴン フィーチャクラスまたは範囲の値を指定して、ポイント フィーチャを追加する領域を定義します。このパラメーターは、デフォルトでは空になっています。デフォルトでは、入力フィーチャクラスからすべてのポイントがテレイン フィーチャに読み込まれます。 | Extent; Feature Layer |
| ラベル | 説明 | データ タイプ |
| 更新された入力テレイン | 更新されたテレイン。 | テレイン レイヤー |
arcpy.ddd.AppendTerrainPoints(in_terrain, terrain_feature_class, in_point_features, {polygon_features_or_extent})| 名前 | 説明 | データ タイプ |
in_terrain | 処理対象のテレイン データセット。 | Terrain Layer |
terrain_feature_class | ポイントまたはマルチポイントの追加先となるテレイン データセットで使用されるフィーチャクラスです。 このパラメーターに必要なのは、フィーチャクラスの名前のみで、絶対パスは不要です。 | String |
in_point_features | テレイン データセットの追加データ ソースとして追加するポイントまたはマルチポイントのフィーチャクラスです。 | Feature Layer |
polygon_features_or_extent (オプション) | ポリゴン フィーチャクラスまたは arcpy.Extent オブジェクトを指定して、ポイント フィーチャを追加する領域を定義します。このパラメーターは、デフォルトでは空になっています。デフォルトでは、入力フィーチャクラスからすべてのポイントがテレイン フィーチャに読み込まれます。 | Extent; Feature Layer |
| 名前 | 説明 | データ タイプ |
| derived_out_terrain | 更新されたテレイン。 | テレイン レイヤー |
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
arcpy.env.workspace = 'C:/data'
arcpy.ddd.AppendTerrainPoints('sample.gdb/featuredataset/terrain',
'existing_points', 'new_points.shp')次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。
'''****************************************************************************
Name: Update Terrain
Description: This script demonstrates how to update a terrain dataset
with new elevation measurements obtained from Lidar by
importing LAS files to multipoint features, then appending the
new points to another multipoint feature that participates in a
terrain. The terrain's pyramids are modified to optimize its
draw speed.
****************************************************************************'''
# Import system modules
import arcpy
try:
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set Variables
inTerrain = "sample.gdb/featuredataset/terrain"
currentPts = "existing_points"
lasFiles = ['las/NE_Philly.las',
'las/NW_Philly.las']
newPts = 'in_memory/update_pts'
# Define spatial reference of LAS files using factory code
# for NAD_1983_StatePlane_Pennsylvania_South
lasSR = arcpy.SpatialReference(2272)
arcpy.AddMessage("Converting LAS files to multipoint features...")
arcpy.ddd.LASToMultipoint(lasFiles, newPts, 1.5, 2, 1,
'INTENSITY', lasSR)
arcpy.AddMessage("Appending LAS points to {0}..."\
.format(currentPts))
arcpy.ddd.AppendTerrainPoints(inTerrain, currentPts, newPts)
arcpy.AddMessage("Changing terrain pyramid reference scales...")
arcpy.ddd.ChangeTerrainReferenceScale(inTerrain, 1000, 500)
arcpy.ddd.ChangeTerrainReferenceScale(inTerrain, 2500, 2000)
arcpy.AddMessage("Adding terrain pyramid level...")
arcpy.ddd.AddTerrainPyramidLevel(inTerrain, "", "4 4500")
arcpy.AddMessage("Changing pyramid resolution bounds for breaklines...")
arcpy.ddd.ChangeTerrainResolutionBounds(inTerrain, "breaklines", 5, 4)
arcpy.AddMessage("Building terrain...")
arcpy.ddd.BuildTerrain(inTerrain)
arcpy.AddMessage("Completed updates.")
except arcpy.ExecuteError:
print(arcpy.GetMessages())
except Exception as err:
print(err)