Spatial Analyst のライセンスで利用可能。
3D Analyst のライセンスで利用可能。
使用法
出力ラスターの周囲のセルのセル中心が、(入力ポイントによって定義された) 凸包の外側に存在する場合、これらのセルには NoData 値が割り当てられます。入力ポイントがこれらの周囲のセルのいずれかの内部に存在し、セルの中心が凸包の外側に存在する場合も、セルには NoData 値が割り当てられます。
[出力セル サイズ] は、数値で定義するか、既存のラスター データセットから取得できます。セル サイズがパラメーター値として明示的に指定されていない場合、[セル サイズ] 環境が指定されていれば、そこから取得されます。パラメーターのセル サイズも環境のセル サイズも指定されておらず、[スナップ対象ラスター] 環境が設定されている場合には、スナップ ラスターのセル サイズが使用されます。何も指定されていない場合、セル サイズは範囲の幅または高さ (どちらか短い方) を 250 で割って求められます。この範囲は環境で指定された [出力座標系] にあります。
セル サイズが数値によって指定されている場合、このツールは出力ラスターに対してこの値を直接使用します。
セル サイズがラスター データセットを使用して指定されている場合、パラメーターはセル サイズの値ではなくラスター データセットのパスを示します。データセットの空間参照が出力空間参照と同じである場合、解析ではラスター データセットのセル サイズが直接使用されます。データセットの空間参照が出力空間参照と異なる場合は、選択された [セル サイズ投影法] に基づいて投影されます。
入力データセットには X、Y 座標が同じである位置に複数のポイントが存在することがあります。共通の位置にあるポイントの値が同じである場合、それは重複とみなされて出力には影響しません。値が異なる場合は、一致ポイントと見なされます。
このデータ条件の処理方法は各種内挿ツールによって異なることがあります。たとえば、最初に遭遇した一致ポイントが計算に使用されることも、最後に遭遇した一致ポイントが計算に使用されることもあります。そのため、出力ラスター内のある位置に予想とは異なる値が出力される可能性があります。対策としては、このような一致ポイントを削除したデータを用意しておくことです。[Spatial Statistics] ツールボックスの [イベントの集計 (Collect Events)] ツールは、データ内の一致ポイントを特定するのに役立ちます。
NULL 値をサポートするデータ形式 (ファイル ジオデータベース フィーチャクラスなど) では、入力として使用すると、NULL 値は無視されます。
このツールの入力ポイントには、約 1500 万という制限があります。入力フィーチャクラスに含まれるポイント数が膨大 (約 1500 万以上) になると、ツールが結果を作成できなくなる可能性があります。
この制限を回避するためには、調査領域を複数のセクションで処理し、結果をモザイク処理して 1 つの大きなラスター データセットを作成します。セクション間に重なり合う部分があることを確認します。あるいは、テレイン データセット使用して、無数の計測ポイントによって構成されているポイントとサーフェスを格納して視覚化することもできます。
入力データは、地理座標系ではなく、投影座標系で作成することをお勧めします。
ArcGIS 3D Analyst エクステンション が利用できる場合、TIN データセットを使用する別のアプローチがあります。まず、ソース データから TIN サーフェスを作成します。次に、[TIN → ラスター (TIN To Raster)] ツールの [Natural Neighbors] オプションを使用して、作成された TIN をラスターに変換します。これは、ブレークラインまたは不規則な形状のデータ エリアが存在する場合に特に便利です。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
構文
NaturalNeighbor(in_point_features, z_field, {cell_size})| パラメーター | 説明 | データ タイプ |
in_point_features | サーフェス ラスターとして内挿する Z 値を含む入力ポイント フィーチャ。 | Feature Layer |
z_field | 各ポイントの高さまたは大きさの値を保持するフィールド。 これは数値フィールドまたは、入力ポイント フィーチャが Z 値を含む場合は Shape フィールドです。 | Field |
cell_size (オプション) | 作成される出力ラスターのセル サイズ。 このパラメーターは、数値で定義するか、既存のラスター データセットから取得できます。セル サイズがパラメーター値として明示的に指定されていない場合、指定されていれば、環境のセル サイズ値が使用されます。そうでない場合は、追加のルールを使用して別の入力から計算されます。詳細については、使用方法をご参照ください。 | Analysis Cell Size |
戻り値
| 名前 | 説明 | データ タイプ |
| out_raster | 内挿された出力サーフェス ラスター。 常に浮動小数点ラスターです。 | Raster |
コードのサンプル
この例では、ポイント シェープファイルを入力として、内挿したサーフェスを TIFF ラスターとして出力します。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNaturalNeighbor = NaturalNeighbor("ozone_pts.shp", "ozone", 2000)
outNaturalNeighbor.save("C:/sapyexamples/output/nnout.tif")この例では、ポイント シェープファイルを入力として、内挿したサーフェスを GRID ラスターとして出力します。
# Name: NaturalNeighbor_Ex_02.py
# Description: Interpolate a series of point features onto a
# rectangular raster using Natural Neighbor interpolation.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inPointFeatures = "ca_ozone_pts.shp"
zField = "ozone"
cellSize = 40000
# Execute NaturalNeighbor
outNatNbr = NaturalNeighbor(inPointFeatures, zField, cellSize)
# Save the output
outNatNbr.save("C:/sapyexamples/output/nnout02")環境
ライセンス情報
- Basic: 次のものが必要 Spatial Analyst または 3D Analyst
- Standard: 次のものが必要 Spatial Analyst または 3D Analyst
- Advanced: 次のものが必要 Spatial Analyst または 3D Analyst