シェープの内挿 (Interpolate Shape) (3D Analyst)

3D Analyst のライセンスで利用可能。

Spatial Analyst のライセンスで利用可能。

概要

サーフェスから Z 値を内挿することによって、3D フィーチャを作成します。

[シェープの内挿 (Interpolate Shape)] ツールの詳細

[シェープの内挿 (Interpolate Shape)] の図

使用法

  • Natural Neighbor 内挿法を使用する場合は、サーフェス内のデータ ポイントの平均ポイント間隔の半分以上のサンプリング距離を指定することを検討してください。

  • [頂点のみを内挿] オプションを使用すると、頂点がサーフェスのデータ エリアの外側にあるフィーチャが出力に含まれなくなります。ただし、入力サーフェスがラスターであり、最近隣内挿法を使用している場合を除きます。

構文

arcpy.3d.InterpolateShape(in_surface, in_feature_class, out_feature_class, {sample_distance}, {z_factor}, {method}, {vertices_only}, {pyramid_level_resolution}, {preserve_features})
パラメーター説明データ タイプ
in_surface

Z 値の内挿に使用するサーフェス。

LAS Dataset Layer; Mosaic 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 です。この場合、標高値は変更されません。入力サーフェスの空間参照に距離単位の指定された Z 測地基準系がある場合、このパラメーターは無効になります。

Double
method
(オプション)

入力フィーチャの標高値を決定するのに使用される内挿方法です。利用できるオプションは、使用されているサーフェス タイプによって異なります。

  • BILINEAR共一次内挿法を使用して、入力ポイントの値を決定します。これは、入力がラスター サーフェスの場合のデフォルト設定です。
  • NEAREST最近隣内挿法を使用して、入力ポイントの値を決定します。この方法を使用すると、サーフェスの値が入力フィーチャの頂点でのみ内挿されます。このオプションは、ラスター サーフェスにしか使用できません。
  • LINEAR TIN、テレイン、および LAS データセットのデフォルトの内挿法。入力ポイントの XY 位置を含む三角形によって定義される平面から標高を取得します。
  • 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
vertices_only
(オプション)

サンプル距離のオプションを無視して、入力フィーチャの頂点に沿ってのみ内挿を実行するかどうかを指定します。

  • DENSIFYサンプリング距離を使用して内挿します。これがデフォルトです。
  • VERTICES_ONLY頂点に沿って内挿します。
Boolean
pyramid_level_resolution
(オプション)

このツールが使用するテレイン ピラミッド レベルの Z 許容値またはウィンドウサイズの解像度。デフォルト値は 0 (最大解像度) です。

Double
preserve_features
(オプション)

1 つまたは複数の頂点がラスターのデータ エリアの外側にあるフィーチャを出力で維持するかどうかを指定します。このパラメーターを使用できるのは、入力サーフェスがラスターであり、最近隣内挿法を使用している場合に限ります。

  • PRESERVEラスター サーフェスの外側にある各頂点の Z 値は、そのラスター サーフェスの内側にある頂点に対して算出された Z 値の傾向から取得されます。
  • EXCLUDE1 つ以上の頂点がラスター サーフェスの外側にあるフィーチャが出力でスキップされます。これがデフォルトです。
Boolean

コードのサンプル

InterpolateShape (シェープの内挿) の例 1 (Python ウィンドウ)

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

arcpy.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

# Set local variables
inWorkspace = arcpy.GetParameterAsText(0)
surface = arcpy.GetParameterAsText(1)

try:
    # Set default workspace
    arcpy.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))
    
except arcpy.ExecuteError:
    print(arcpy.GetMessages())
    
except Exception as err:
    print(err)

ライセンス情報

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

関連トピック