サマリ
サーフェスから Z 値を内挿することによって、3D フィーチャを作成します。
図
![[シェープの内挿 (Interpolate Shape)] の図](GUID-395A1FD0-3BB6-4247-B8E5-0AADBE6B2633-web.gif "[シェープの内挿 (Interpolate Shape)] の図")
使用法
Natural Neighbor 内挿法を使用する場合は、サーフェス内のデータ ポイントの平均ポイント間隔の半分以上のサンプリング距離を指定することを検討してください。
[頂点のみを内挿] オプションを使用すると、サーフェスのデータ領域外に存在する頂点を含むフィーチャは出力に含まれません。
構文
InterpolateShape_3d (in_surface, in_feature_class, out_feature_class, {sample_distance}, {z_factor}, {method}, {vertices_only}, {pyramid_level_resolution})| パラメータ | 説明 | データ タイプ |
in_surface | Z 値の内挿に使用する LAS データセット、ラスター、TIN、またはテレイン サーフェス。 | LAS Dataset Layer, Raster Layer; Terrain Layer; TIN Layer |
in_feature_class | 処理対象の入力フィーチャ。 | Feature Layer |
out_feature_class | このツールで生成されるフィーチャクラス。 | Feature Class |
sample_distance (オプション) | Z 値を内挿する間隔です。デフォルトでは、ラスターのデータセットのセル サイズまたは TIN サーフェスの自然最小ノード間隔になります。 | Double |
z_factor (オプション) | Z 値に乗算する係数。これは通常、Z リニア単位から XY リニア単位に変換する場合に使用されます。デフォルトは 1 です。この場合、標高値は変更されません。 | Double |
method (オプション) | 入力フィーチャの標高値を決定するのに使用される内挿方法です。利用できるオプションは、使用されているサーフェス タイプによって異なります。
| String |
vertices_only (オプション) | サンプル距離のオプションを無視して、入力フィーチャの頂点に沿ってのみ内挿を実行するかどうかを指定します。
| Boolean |
pyramid_level_resolution (オプション) | このツールが使用するテレイン ピラミッド レベルの Z 許容値またはウィンドウサイズの解像度。デフォルト値は 0 (最大解像度) です。 | Double |
コードのサンプル
InterpolateShape (シェープの内挿) の例 1 (Python ウィンドウ)
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.InterpolateShape_3d("my_tin", "roads.shp", "roads_interp.shp")
InterpolateShape (シェープの内挿) の例 2 (スタンドアロン スクリプト)
次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。
'''*********************************************************************
Name: InterpolateShape Example
Description: This script demonstrates how to use InterpolateShape
on all 2D features in a target workspace.
*********************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback
# Set local variables
inWorkspace = arcpy.GetParameterAsText(0)
surface = arcpy.GetParameterAsText(1)
try:
arcpy.CheckOutExtension("3D")
# Set default workspace
env.workspace = inWorkspace
# Create list of feature classes in target workspace
fcList = arcpy.ListFeatureClasses()
if fcList:
for fc in fcList:
desc = arcpy.Describe(fc)
# Find 2D features
if not desc.hasZ:
# Set Local Variables
outFC = "{0}_3D.shp".format(desc.basename)
method = "BILINEAR"
# Execute InterpolateShape
arcpy.ddd.InterpolateShape(surface, fc, outFC,
10, 1, method, True)
else:
print "{0} is not a 2D feature.".format(fc)
else:
print "No feature classes were found in {0}.".format(env.workspace)
arcpy.CheckInExtension('3D')
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)
環境
ライセンス情報
- ArcGIS for Desktop Basic: 次のものが必要 3D Analyst
- ArcGIS for Desktop Standard: 次のものが必要 3D Analyst
- ArcGIS for Desktop Advanced: 次のものが必要 3D Analyst