シェープの内挿 (Spatial Analyst ツール)

サマリー

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

シェープの内挿ツールの詳細

図

シェープの内挿ツールの図

使用法

このツールは、入力サーフェスの重なり合う部分から得られる高さの値を使用して、3D フィーチャを作成します。 3D ポリゴンの内部はレンダリングされたときにランダムに定義されるため、3D ポリゴンにはその周長上の z 値のみが格納されます。このため、一般的に、3D ポリゴンは非平面高さ情報を表す場合には適していません。サーフェスの正確な表示を生成するには、ポリゴンを内挿してマルチパッチを作成 ツールを使用します。
サンプリング距離 パラメーターの値に基づいて、曲線またはポリゴンセグメントに頂点が挿入されます。サンプリング距離が定義されていない場合、入力サーフェスから計算されます。ラスターの場合、ラスターのセルサイズがデフォルトのサンプリングサイズになります。 TIN、テレイン、LAS データセットの場合、デフォルトのサンプリングは、トライアングルサーフェスによって生成されるエッジに基づきます。曲線がサンプリングサイズより短い場合、その曲線はその始点と終点を使用して 2 ポイントラインに単純化されます。
Natural Neighbor 内挿法を使用する場合は、サーフェス内のデータポイントの平均ポイント間隔の半分以上のサンプリング距離を指定することを検討してください。
頂点のみを内挿 パラメーターを使用すると、頂点がサーフェスのデータエリアの外側にあるフィーチャが出力に含まれなくなります。ただし、入力サーフェスがラスターであり、最近隣内挿法を使用している場合を除きます。
入力フィーチャクラスに M 値が含まれている場合、出力フィーチャクラスにも M 値が含まれ、元の頂点の M 値は保持されます。

ラベル	説明	データタイプ
入力サーフェス	Z 値の内挿に使用されるサーフェス。	LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer; Image Service
入力フィーチャ	処理対象の入力フィーチャ。	Feature Layer
出力フィーチャクラス	生成されるフィーチャクラス。	Feature Class
サンプリング距離 (オプション)	Z 値を内挿する間隔。デフォルトでは、ラスターのデータセットのセルサイズまたは TIN サーフェスの自然最小ノード間隔になります。	Double
Z 係数 (オプション)	Z 値に乗算する係数。これは通常、Z 距離単位から X、Y 距離単位に変換する場合に使用されます。デフォルトは 1 です。この場合、標高値は変更されません。入力サーフェスの空間参照に距離単位の指定された Z 測地基準系がある場合、このパラメーターは使用できません。	Double
方法 (オプション)	出力フィーチャの標高値を決定するのに使用される内挿方法を指定します。利用できるオプションはサーフェスタイプによって異なります。共一次内挿法—共一次内挿法を使用して、入力ポイントの値が決定されます。これは、入力がラスターサーフェスの場合のデフォルト設定です。最近隣内挿法—最近隣内挿法を使用して、入力ポイントの値が決定されます。この方法では、サーフェスの値が入力フィーチャの頂点でのみ内挿されます。このオプションは、ラスターサーフェスにしか使用できません。リニア—標高値は、入力ポイントの X,Y 位置を含む三角形によって定義される平面から取得されます。これは TIN、テレイン、および LAS データセットのデフォルトの内挿法です。 Natural Neighbor—標高値は、入力ポイントの Natural Neighbor に、面積に基づく重み付けを行うことによって取得されます。最小 Z 値を使用—標高値は、入力ポイントの Natural Neighbor の中の最小 Z 値から取得されます。最大 Z 値を使用—標高値は、入力ポイントの Natural Neighbor の中の最大 Z 値から取得されます。最近隣の Z 値を使用—標高値は、入力ポイントの Natural Neighbor の中の最近隣値から取得されます。平均に最も近い Z 値を使用—標高値は、入力ポイントのすべての Natural Neighbor の平均に最も近い Z 値から取得されます。	String
頂点のみを内挿 (オプション)	サンプル距離のオプションを無視して、入力フィーチャの頂点に沿ってのみ内挿を実行するかどうかを指定します。オン—頂点に沿ってのみ内挿を実行します。オフ—サンプリング距離を使用して内挿を実行します。これがデフォルトです。	Boolean
ピラミッドレベル解像度 (オプション)	使用されるテレインピラミッドレベルの Z 許容値またはウィンドウサイズの解像度。デフォルト値は 0 (最大解像度) です。	Double
一部がサーフェスの外側にあるフィーチャを維持 (オプション)	1 つまたは複数の頂点がラスターのデータエリアの外側にあるフィーチャを出力で維持するかどうかを指定します。このパラメーターを使用できるのは、入力サーフェスがラスターであり、最近隣内挿法を使用している場合に限ります。オン—ラスターサーフェスの外側にある各頂点の Z 値は、そのラスターサーフェスの内側にある頂点に対して算出された Z 値の傾向から取得され、出力で保持されます。オフ—1 つ以上の頂点がラスターサーフェスの外側にあるフィーチャが出力でスキップされます。これがデフォルトです。	Boolean
高密度な頂点の M 値を内挿 (オプション)	頂点の挿入によって追加されたラインおよびポリゴンの頂点の M 値を元の入力頂点から内挿するかどうかを指定します。適用されると、高密度な頂点の M 値が、M 値を持つ 2 つの既存の頂点間の元のセグメントに沿って内挿されます。元の頂点のいずれかに M 値がない場合、そのセグメントに沿って新たに追加されたすべての頂点の M 値が NaN に設定されます。オン—高密度な頂点の M 値を内挿します。オフ—高密度な頂点の M 値を内挿しません。これがデフォルトです。	Boolean

InterpolateShape(in_surface, in_feature_class, out_feature_class, {sample_distance}, {z_factor}, {method}, {vertices_only}, {pyramid_level_resolution}, {preserve_features}, {interpolate_m_value})

名前	説明	データタイプ
in_surface	Z 値の内挿に使用されるサーフェス。	LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer; Image Service
in_feature_class	処理対象の入力フィーチャ。	Feature Layer
out_feature_class	生成されるフィーチャクラス。	Feature Class
sample_distance (オプション)	Z 値を内挿する間隔。デフォルトでは、ラスターのデータセットのセルサイズまたは TIN サーフェスの自然最小ノード間隔になります。	Double
z_factor (オプション)	Z 値に乗算する係数。これは通常、Z 距離単位から X、Y 距離単位に変換する場合に使用されます。デフォルトは 1 です。この場合、標高値は変更されません。入力サーフェスの空間参照に距離単位の指定された Z 測地基準系がある場合、このパラメーターは使用できません。	Double
method (オプション)	出力フィーチャの標高値を決定するのに使用される内挿方法を指定します。利用できるオプションはサーフェスタイプによって異なります。 `BILINEAR`—共一次内挿法を使用して、入力ポイントの値が決定されます。これは、入力がラスターサーフェスの場合のデフォルト設定です。 `NEAREST`—最近隣内挿法を使用して、入力ポイントの値が決定されます。この方法では、サーフェスの値が入力フィーチャの頂点でのみ内挿されます。このオプションは、ラスターサーフェスにしか使用できません。 `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
vertices_only (オプション)	サンプル距離のオプションを無視して、入力フィーチャの頂点に沿ってのみ内挿を実行するかどうかを指定します。 `VERTICES_ONLY`—頂点に沿ってのみ内挿を実行します。 `DENSIFY`—サンプリング距離を使用して内挿を実行します。これがデフォルトです。	Boolean
pyramid_level_resolution (オプション)	使用されるテレインピラミッドレベルの Z 許容値またはウィンドウサイズの解像度。デフォルト値は 0 (最大解像度) です。	Double
preserve_features (オプション)	1 つまたは複数の頂点がラスターのデータエリアの外側にあるフィーチャを出力で維持するかどうかを指定します。このパラメーターを使用できるのは、入力サーフェスがラスターであり、最近隣内挿法を使用している場合に限ります。 `PRESERVE`—ラスターサーフェスの外側にある各頂点の Z 値は、そのラスターサーフェスの内側にある頂点に対して算出された Z 値の傾向から取得され、出力で保持されます。 `EXCLUDE`—1 つ以上の頂点がラスターサーフェスの外側にあるフィーチャが出力でスキップされます。これがデフォルトです。	Boolean
interpolate_m_value (オプション)	頂点の挿入によって追加されたラインおよびポリゴンの頂点の M 値を元の入力頂点から内挿するかどうかを指定します。適用されると、高密度な頂点の M 値が、M 値を持つ 2 つの既存の頂点間の元のセグメントに沿って内挿されます。元の頂点のいずれかに M 値がない場合、そのセグメントに沿って新たに追加されたすべての頂点の M 値が NaN に設定されます。 `INTERPOLATE_M_VALUE`—高密度な頂点の M 値を内挿します。 `NO_INTERPOLATE_M_VALUE`—高密度な頂点の M 値を内挿しません。これがデフォルトです。	Boolean

コードのサンプル

InterpolateShape 例 1 (Python ウィンドウ)

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

from arcpy.sa import *
InterpolateShape("my_tin", "roads.shp", "roads_interp.shp")

InterpolateShape 例 2 (スタンドアロンスクリプト)

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

# Name: InterpolateShape_Ex_02.py
# Description: This script demonstrates how to use InterpolateShape on the 2D
# features in a target workspace.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set the analysis environments
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set the local variables
inFeatureClass = "point.shp"
inSurface = "dtm_tin"
OutFeatureClass = "point_interp.shp"
method = "NEAREST"

# Run the tool
InterpolateShape(inSurface, inFeatureClass, OutFeatureClass, 15, 1, method, True)

環境

現在のワークスペース, スクラッチワークスペース, 範囲, 出力座標系, 地理座標系変換, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値, 出力データのコンフィグレーションキーワード, 自動コミット

ライセンス情報

Basic: Spatial Analyst または 3D Analyst が必要
Standard: Spatial Analyst または 3D Analyst が必要
Advanced: Spatial Analyst または 3D Analyst が必要

シェープの内挿 (Spatial Analyst ツール)

サマリー

図

使用法

パラメーター

環境

ライセンス情報

関連トピック