サーフェス情報の追加（Add Surface Information） (3D Analyst)
サマリ
ポイント、マルチポイント、およびポリライン フィーチャのサーフェスの標高プロパティを内挿します。
使用法
3D フィーチャクラスからの Z 値は無視されます。すべてのフィーチャは、2 次元フィーチャとして処理されます。
-
[出力プロパティ] オプションが入力フィーチャクラスの属性テーブルに書き込まれます。このオプションは、フィーチャのジオメトリによって異なります。次のリストでは、サポートされる各ジオメトリ タイプに利用可能なオプションを示しています。
- ポイント - Z
- マルチポイント - 最小 Z 値、最大 Z 値、平均 Z 値
- ポリライン - 最小 Z 値、最大 Z 値、平均 Z 値、サーフェスの長さ、最小傾斜角、最大傾斜角、平均傾斜角
-
ライン フィーチャの傾斜角の値は、各線分に対するパーセント（グレード）として計算されます。
- 最小傾斜角は、値が 0（水平グレード）に最も近いセグメントから取得されます。
- 最大傾斜角は、最大計算値を持つセグメントから取得されます。
- 平均傾斜角は、各セグメントを 3D 長さによって重み付けした後で、すべての線分の傾斜角を平均して取得されます。そのため、セグメントが長いほど、取得される値に大きな影響があります。
構文
| パラメータ | 説明 | データ タイプ |
in_feature_class |
入力ポイント、マルチポイント、またはポリライン フィーチャクラス | Feature Layer |
in_surface |
The raster, TIN, or terrain surface used for interpolating z-values. | Raster Layer; Terrain Layer; TIN Layer |
out_property | 入力フィーチャクラスの属性テーブルに追加されるサーフェスの標高プロパティです。次のリストでは、利用可能なプロパティのキーワードおよびサポートされるジオメトリ タイプを示しています。
| String |
method （オプション） |
入力フィーチャの Z 値を決定するのに使用される内挿法利用可能なオプションは、次のとおりです。
| String |
sample_distance （オプション） |
Z 値を内挿する間隔です。デフォルトでは、入力サーフェスがラスタの場合、ラスタ セル サイズが使用され、入力がテレインまたは TIN データセットの場合、トライアングル サーフェスの自然最小ノード間隔が使用されます。 | Double |
z_factor （オプション） |
The factor by which elevation values will be multiplied. This is typically used to convert Z linear units that match those of the XY linear units. The default is 1, which leaves elevation values unchanged. | Double |
pyramid_level_resolution （オプション） |
The z-tolerance or window size resolution of the terrain pyramid level that will be used by this tool. The default is 0, or full resolution. | Double |
コードのサンプル
The following sample demonstrates the use of this tool in the Python window:
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.AddSurfaceInformation_3d("points.shp", "my_tin", "Z", "LINEAR")
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''*********************************************************************
Name: AddSurfaceInformation Example
Description: This script demonstrates how to use AddSurfaceInformation
on all 2D feature classes in a target workspace.
*********************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback
try:
arcpy.CheckOutExtension("3D")
# Set Local Variables
env.workspace = 'c:/data'
inSurface = 'fgdb.gdb/municipal/terrain'
pyramid = 5
method = "BILINEAR"
# Create list of feature classes
fcList = arcpy.ListFeatureClasses()
if fcList:
for fc in fcList:
desc = arcpy.Describe(fc)
# Determine if the feature is 2D
if not desc.hasZ:
if desc.shapeType == "Polygon":
# Desired properties separated by semi-colons
Prop = "Z_MIN;Z_MAX"
elif desc.shapeType == "Point":
Prop = "Z"
elif desc.shapeType == "Multipoint":
Prop = "Z_MIN;Z_MAX;Z_MEAN"
elif desc.shapeType == "Polyline":
Prop = "LENGTH_3D"
# Execute AddSurfaceInformation
arcpy.ddd.AddSurfaceInformation(fc, inSurface, Prop,
method, 15, 1, pyramid)
print "Completed adding surface information."
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)