サーフェス情報の追加 (Add Surface Information) (3D Analyst)

サマリー

サーフェスから得られる空間情報をフィーチャの属性に追加します。

使用法

• 3D フィーチャからの Z 値は無視されます。 各フィーチャは、そのジオメトリと交差するサーフェスの Z プロパティを集計します。 ポイントはサーフェス上の X,Y 位置から Z 値を取得し、ラインはそのライン上のサーフェスの計測値を内挿することで Z プロパティを取得し、ポリゴンはそのエリア内のサーフェスの Z プロパティを集計します。

• [出力プロパティ] パラメーター オプションが入力フィーチャの属性テーブルに書き込まれます。 それぞれのフィーチャは評価対象のサーフェス プロパティの場所を定義し、報告可能なプロパティのタイプはフィーチャ ジオメトリによって異なります。

  フィーチャ ジオメトリ	サーフェス プロパティ
  ポイント	サーフェス上のポイントの X,Y 座標から内挿された SPOT 標高
  マルチポイント	マルチポイント レコードのすべてのポイントにおける SPOT 標高の最小値、最大値、および平均値
  ポリライン	サーフェスに沿ったラインの 3D 距離 サーフェスに沿ったラインの標高と傾斜角の最小値、最大値、および平均値
  ポリゴン	ポリゴンと重なり合うサーフェスの 3D 面積 サーフェスからの標高と傾斜角の最小値、最大値、および平均値

• 傾斜角値はパーセンテージ単位 (グレード) で計測され、ライン フィーチャの場合はラインのセグメントごとに計算されます。

  • 最小傾斜角は、値が 0 (水平グレード) に最も近いセグメントから取得されます。
  • 最大傾斜角は、最大計算値を持つセグメントから取得されます。
  • ポリラインの平均傾斜角は、各ライン セグメントから傾斜角の加重平均を求めることで取得されます。 加重は各セグメントの 3D 長さに基づきます。 そのため、セグメントが長いほど、取得される計算に大きな影響があります。

• 特異な計測値を持つ一部のサーフェスを傾斜角の計算から除外するには、[ノイズ フィルター] パラメーターを使用します。 ライン フィーチャはサーフェスの断面を捉えた頂点によって分割され、これらのセグメントを長さでフィルタリングすることで、望ましくないサーフェスの計測値によって発生する可能性の高い短いセグメントによる影響を排除します。 同様に、ポリゴン フィーチャの面積フィルターによって、三角形分割したサーフェス内の細長い三角形を傾斜角の計算から除外します。 ラスター サーフェスの場合、面積フィルターを適用した、三角形分割したサーフェスの構築にセルの重心のサブセットが使用されます。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力フィーチャ	1 つ以上のサーフェス プロパティを決定するために場所を定義するポイント、マルチポイント、ポリライン、またはポリゴン フィーチャ。	Feature Layer
入力サーフェス	Z 値の内挿に使用する LAS データセット、モザイク、ラスター、テレイン、または TIN サーフェス。	LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
出力プロパティ	入力フィーチャクラスの属性テーブルに追加されるサーフェスの標高プロパティを指定します。 Z—各シングルポイント フィーチャの X,Y 位置に対して内挿されたサーフェスの Z 値が追加されます。 最小 Z 値—ポリゴンによって定義されたエリア内、ライン上、またはマルチポイント レコード内のポイントに対して内挿された値における、サーフェスの Z の最小値が追加されます。 最大 Z 値—ポリゴンによって定義されたエリア内、ライン上、またはマルチポイント レコード内のポイントに対して内挿された値における、サーフェスの標高の最大値が追加されます。 平均 Z 値—ポリゴンによって定義されたエリア、ライン上、またはマルチポイント レコード内のポイントに対して内挿された値における、サーフェスの標高の平均値が追加されます。 表面積—各ポリゴンによって定義されるリージョンにおける 3D サーフェスの面積が追加されます。 サーフェス長さ—サーフェスに沿ったラインの 3D 距離が追加されます。 最小傾斜角—ラインに沿った、またはポリゴンによって定義されたエリア内の 0 に最も近い傾斜角値が追加されます。 最大傾斜角—ラインに沿った、またはポリゴンによって定義されたエリア内の最大傾斜角値が追加されます。 平均傾斜角—ラインに沿った、またはポリゴンによって定義されたエリア内の平均傾斜角値が追加されます。	String
方法 (オプション)	サーフェスに関する情報の決定に使用される内挿法を指定します。 共一次内挿法—4 つの最近隣セルからセル値を決定するラスター サーフェス限定の内挿法が使用されます。 このオプションは、ラスター サーフェスにのみ利用できます。 ライン—標高は、入力ポイントの X,Y 位置を含むテレイン三角形によって定義される平面から取得されます。 TIN、テレイン、および LAS データセットのデフォルトの内挿法です。 Natural Neighbor—標高は、入力ポイントの Natural Neighbor に、面積に基づく重み付けを行うことによって取得されます。 最小 Z 値を使用—標高は、入力ポイントの Natural Neighbor の中の最小 Z 値から取得されます。 最大 Z 値を使用—標高は、入力ポイントの Natural Neighbor の中の最大 Z 値から取得されます。 最近隣の Z 値を使用—標高は、入力ポイントの Natural Neighbor の中の最近隣値から取得されます。 平均に最も近い Z 値を使用—標高は、入力ポイントのすべての Natural Neighbor の平均に最も近い Z 値から取得されます。	String
サンプリング距離 (オプション)	Z 値を内挿する間隔。 デフォルトでは、入力サーフェスがラスターの場合、ラスター セル サイズが使用され、入力がテレインまたは TIN データセットの場合、トライアングル サーフェスの自然最小ノード間隔が使用されます。	Double
Z 係数 (オプション)	Z 値に乗算する係数。 これは通常、Z リニア単位から XY リニア単位に変換する場合に使用されます。 デフォルトは 1 です。この場合、標高値は変更されません。 入力サーフェスの空間参照に距離単位の指定された Z 測地基準系がある場合、このパラメーターは使用できません。	Double
ピラミッド レベル解像度 (オプション)	使用されるテレイン ピラミッド レベルの Z 許容値またはウィンドウ サイズの解像度。 デフォルト値は 0 (最大解像度) です。	Double
ノイズ フィルタリング (オプション)	特異な計測値を持つ一部のサーフェスを傾斜角の計算から除外するかどうかを指定します。 その他のプロパティは、このパラメーターの影響を受けません。 ライン フィーチャは長さによるフィルターを提供します。3D 長さが指定した値より短いライン セグメントは傾斜角の計算から除外されます。 ポリゴン フィーチャは面積によるフィルターを提供します。指定した値よりも小さい領域をカバーするポリゴンは除外されます。	String

派生した出力

ラベル	説明	データ タイプ
更新された入力フィーチャ	更新された入力フィーチャ。	Feature Layer

Python

arcpy.ddd.AddSurfaceInformation(in_feature_class, in_surface, out_property, {method}, {sample_distance}, {z_factor}, {pyramid_level_resolution}, {noise_filtering})

名前	説明	データ タイプ
in_feature_class	1 つ以上のサーフェス プロパティを決定するために場所を定義するポイント、マルチポイント、ポリライン、またはポリゴン フィーチャ。	Feature Layer
in_surface	Z 値の内挿に使用する LAS データセット、モザイク、ラスター、テレイン、または TIN サーフェス。	LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_property [out_property,...]	入力フィーチャクラスの属性テーブルに追加されるサーフェスの標高プロパティを指定します。 Z—各シングルポイント フィーチャの X,Y 位置に対して内挿されたサーフェスの Z 値が追加されます。 Z_MIN—ポリゴンによって定義されたエリア内、ライン上、またはマルチポイント レコード内のポイントに対して内挿された値における、サーフェスの Z の最小値が追加されます。 Z_MAX—ポリゴンによって定義されたエリア内、ライン上、またはマルチポイント レコード内のポイントに対して内挿された値における、サーフェスの標高の最大値が追加されます。 Z_MEAN—ポリゴンによって定義されたエリア、ライン上、またはマルチポイント レコード内のポイントに対して内挿された値における、サーフェスの標高の平均値が追加されます。 SURFACE_AREA—各ポリゴンによって定義されるリージョンにおける 3D サーフェスの面積が追加されます。 SURFACE_LENGTH—サーフェスに沿ったラインの 3D 距離が追加されます。 MIN_SLOPE—ラインに沿った、またはポリゴンによって定義されたエリア内の 0 に最も近い傾斜角値が追加されます。 MAX_SLOPE—ラインに沿った、またはポリゴンによって定義されたエリア内の最大傾斜角値が追加されます。 AVG_SLOPE—ラインに沿った、またはポリゴンによって定義されたエリア内の平均傾斜角値が追加されます。	String
method (オプション)	サーフェスに関する情報の決定に使用される内挿法を指定します。 BILINEAR—4 つの最近隣セルからセル値を決定するラスター サーフェス限定の内挿法が使用されます。 このオプションは、ラスター サーフェスにのみ利用できます。 LINEAR—標高は、入力ポイントの X,Y 位置を含むテレイン三角形によって定義される平面から取得されます。 TIN、テレイン、および LAS データセットのデフォルトの内挿法です。 NATURAL_NEIGHBORS—標高は、入力ポイントの Natural Neighbor に、面積に基づく重み付けを行うことによって取得されます。 CONFLATE_ZMIN—標高は、入力ポイントの Natural Neighbor の中の最小 Z 値から取得されます。 CONFLATE_ZMAX—標高は、入力ポイントの Natural Neighbor の中の最大 Z 値から取得されます。 CONFLATE_NEAREST—標高は、入力ポイントの Natural Neighbor の中の最近隣値から取得されます。 CONFLATE_CLOSEST_TO_MEAN—標高は、入力ポイントのすべての Natural Neighbor の平均に最も近い Z 値から取得されます。	String
sample_distance (オプション)	Z 値を内挿する間隔。 デフォルトでは、入力サーフェスがラスターの場合、ラスター セル サイズが使用され、入力がテレインまたは TIN データセットの場合、トライアングル サーフェスの自然最小ノード間隔が使用されます。	Double
z_factor (オプション)	Z 値に乗算する係数。 これは通常、Z リニア単位から XY リニア単位に変換する場合に使用されます。 デフォルトは 1 です。この場合、標高値は変更されません。 入力サーフェスの空間参照に距離単位の指定された Z 測地基準系がある場合、このパラメーターは使用できません。	Double
pyramid_level_resolution (オプション)	使用されるテレイン ピラミッド レベルの Z 許容値またはウィンドウ サイズの解像度。 デフォルト値は 0 (最大解像度) です。	Double
noise_filtering (オプション)	特異な計測値を持つ一部のサーフェスを傾斜角の計算から除外するかどうかを指定します。 その他のプロパティは、このパラメーターの影響を受けません。 ライン フィーチャは長さによるフィルターを提供します。3D 長さが指定した値より短いライン セグメントは傾斜角の計算から除外されます。 ポリゴン フィーチャは面積によるフィルターを提供します。指定した値よりも小さい領域をカバーするポリゴンは除外されます。	String

派生した出力

名前	説明	データ タイプ
output_feature_class	更新された入力フィーチャ。	Feature Layer

コードのサンプル

AddSurfaceInformation (サーフェス情報の追加) の例 1 (Python ウィンドウ)

次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。

arcpy.env.workspace = "C:/data"
arcpy.AddSurfaceInformation_3d("points.shp", "my_tin", "Z", "LINEAR")

AddSurfaceInformation (サーフェス情報の追加) の例 2 (スタンドアロン スクリプト)

次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。

'''*********************************************************************
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

# Set Local Variables
arcpy.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.")

環境

現在のワークスペース, 範囲, 地理座標系変換, 自動コミット

特殊なケース

ライセンス情報

• Basic: 次のものが必要 3D Analyst
• Standard: 次のものが必要 3D Analyst
• Advanced: 次のものが必要 3D Analyst