クリギング (Kriging) (Spatial Analyst)—ArcGIS Pro

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

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

サマリー

クリギングによりポイントからラスターサーフェスを内挿します。

[Empirical Bayesian Kriging] ツールは強化された機能や性能を提供しています。

クリギングの詳細

使用法

クリギングは、プロセッサに負荷がかかる処理です。実行速度は、入力データセット内のポイント数と検索ウィンドウのサイズによって決まります。
オプション出力である予測分散ラスター内の値が小さいことは、予測値の信頼度が高いことを示しています。値が大きい場合は、もっと多くのデータポイントが必要かもしれません。
ユニバーサルクリギングのタイプは、構造コンポーネントが存在していることと、ローカルトレンドが場所によって異なっていることが前提になっています。
[セミバリオグラムプロパティ] では、クリギングに使用するセミバリオグラムを制御できます。 [ラグサイズ] のデフォルト値は、デフォルトの出力セルサイズに初期設定されます。 [メジャーレンジ]、[部分シル]、[ナゲット] については、何も指定されていなければデフォルト値が最初に計算されます。
オプションの出力予測分散ラスターには、各出力ラスターセルのクリギング分散が格納されます。クリギングエラーが標準的に分散しているとすると、セルの実際の Z 値が、予測ラスター値±分散ラスター内の値の平方根× 2 の範囲内にある可能性は、95.5 パーセントです。
[出力セルサイズ] パラメーターは、数値で定義することも、既存のラスターデータセットから取得することもできます。セルサイズがパラメーター値として明示的に指定されていない場合、セルサイズ環境が指定されていれば、そこから取得されます。パラメーターのセルサイズも環境のセルサイズも指定されておらず、[スナップ対象ラスター] 環境が設定されている場合には、スナップラスターのセルサイズが使用されます。何も指定されていない場合、セルサイズは範囲の幅または高さ (どちらか短い方) を 250 で割って求められます。この範囲は環境で指定された出力座標系にあります。
セルサイズが数値によって指定されている場合、このツールは出力ラスターに対してこの値を直接使用します。
セルサイズがラスターデータセットを使用して指定されている場合、パラメーターはセルサイズの値ではなくラスターデータセットのパスを示します。データセットの空間参照が出力空間参照と同じである場合、解析ではラスターデータセットのセルサイズが直接使用されます。データセットの空間参照が出力空間参照と異なる場合、指定した [セルサイズ投影法] の値に基づいて投影されます。
入力データセットには X、Y 座標が同じである位置に複数のポイントが存在することがあります。共通の位置にあるポイントの値が同じである場合、それは重複とみなされて出力には影響しません。値が異なる場合は、一致ポイントと見なされます。
このデータ条件の処理方法は各種内挿ツールによって異なることがあります。たとえば、最初に遭遇した一致ポイントが計算に使用されることも、最後に遭遇した一致ポイントが計算に使用されることもあります。そのため、出力ラスター内のある位置に予想とは異なる値が出力される可能性があります。対策としては、このような一致ポイントを削除したデータを用意しておくことです。空間統計ツールボックスの [イベントの集計 (Collect Events)] ツールは、データ内の一致ポイントを特定するのに役立ちます。
NULL 値をサポートするデータ形式 (ファイルジオデータベースフィーチャクラスなど) では、入力として使用すると、NULL 値は無視されます。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。

パラメーター

ラベル	説明	データタイプ
入力ポイントフィーチャ	サーフェスラスターとして内挿する Z 値を含む入力ポイントフィーチャ。	Feature Layer
Z 値フィールド	各ポイントの高さまたは大きさの値を保持するフィールド。これは数値フィールドまたは、入力ポイントフィーチャが Z 値を含む場合は Shape フィールドです。	Field
セミバリオグラムプロパティ	使用するセミバリオグラムモデル。クリギング手法には、Ordinary モデルと Universal モデルの 2 種類があります。 Ordinary モデルクリギングでは以下のセミバリオグラムモデルを使用できます: [Spherical] - 球セミバリオグラムモデル。これがデフォルトです。 [Circular] - 円セミバリオグラムモデル。 [Exponential] - 指数セミバリオグラムモデル。 [Gaussian] - ガウス分布 (正規分布) セミバリオグラムモデル。 [Linear] - シルのある線形セミバリオグラムモデル。 Universal モデルクリギングでは以下のセミバリオグラムモデルを使用できます: [Linear with Linear drift] - 直線ドリフトのある Universal モデルクリギング。 [Linear with Quadratic drift] - 二次ドリフトのある Universal モデルクリギング。 [詳細パラメーター] ダイアログボックスで使用できるオプションがあります。そのようなパラメーターは次のとおりです: [Lag size] - デフォルトは、出力ラスターのセルサイズです。 [Major range] - 相関がほとんど、またはまったくなくなる距離を表します。 [Partial sill] - ナゲットとシルの差分。 [Nugget] - 空間縮尺で検出できない誤差とばらつきを表します。ナゲット効果は原点での不連続として現れます。	KrigingModel
出力セルサイズ (オプション)	作成される出力ラスターのセルサイズ。このパラメーターは、数値で定義するか、既存のラスターデータセットから取得できます。セルサイズがパラメーター値として明示的に指定されていない場合、指定されていれば、環境のセルサイズ値が使用されます。そうでない場合は、追加のルールを使用して別の入力から計算されます。詳細については、使用方法をご参照ください。	Analysis Cell Size
検索範囲 (オプション)	どの入力ポイントを使用して出力ラスターの各セル値を内挿するかを定義します。次の 2 つのオプションがあります。 [可変] と [固定] です。デフォルトは [可変] です。変数可変検索範囲を使用して、指定された数の入力サンプルポイントを見つけて内挿します。 [ポイント数] - 内挿実行時に使用する最近接にある入力サンプルポイントの数を指定する整数値。デフォルトは 12 です。 [最大距離] - 最近接入力サンプルポイントの検索範囲を制限する距離をマップの単位で指定します。デフォルト値は範囲の対角線の長さです。固定指定された固定距離内にあるすべての入力ポイントが内挿に使用されます。 [距離] - 距離を半径として指定します。その距離内にある入力サンプルポイントが内挿実行時に使用されます。半径の値はマップの単位で表します。デフォルトの半径は、出力ラスターのセルサイズの 5 倍です。 [最小ポイント数] - 内挿に使用する最小ポイント数を定義する整数値。デフォルト値は 0 です。指定した距離内に必要な数のポイントがない場合は、指定した最小数のポイントが見つかるまで検索距離が大きくなります。検索範囲を大きくする必要がある場合、検索範囲は、その範囲内で [最小ポイント数] のポイントが見つかるまで、あるいはその範囲が出力ラスターの下限 (南) と上限 (北) のどちらかまたは両方を超えるまで大きくなります。上記の条件を満たさない位置には No Data が割り当てられます。	Radius
出力予測分散ラスター (オプション)	オプションの出力ラスターで、各セルにはその位置に対する予測のバリアンス値が格納されます。	Raster Dataset

戻り値

ラベル	説明	データタイプ
出力サーフェスラスター	内挿された出力サーフェスラスター。常に浮動小数点ラスターです。	Raster

ラベル

説明

データタイプ

出力サーフェスラスター

内挿された出力サーフェスラスター。

常に浮動小数点ラスターです。

Raster

Kriging(in_point_features, z_field, semiVariogram_props, {cell_size}, {search_radius}, {out_variance_prediction_raster})

名前	説明	データタイプ
in_point_features	サーフェスラスターとして内挿する Z 値を含む入力ポイントフィーチャ。	Feature Layer
z_field	各ポイントの高さまたは大きさの値を保持するフィールド。これは数値フィールドまたは、入力ポイントフィーチャが Z 値を含む場合は Shape フィールドです。	Field
semiVariogram_props kriging_model	KrigingModel クラスはどのクリギングモデルを使用するかを定義します。 KrigingModel クラスには、次の 2 つのタイプがあります。 KrigingModelOrdinary メソッドでは 5 種類のセミバリオグラムが使用できます。 KrigingModelUniversal メソッドでは 2 種類のセミバリオグラムが使用できます。 KrigingModelOrdinary ({semivariogramType}, {lagSize}, {majorRange}, {partialSill}, {nugget}) semivariogramType - 使用するセミバリオグラムモデル。使用可能なモデルは次のとおりです: SPHERICAL - 球セミバリオグラムモデル。これがデフォルトです。 CIRCULAR - 円セミバリオグラムモデル。 EXPONENTIAL - 指数セミバリオグラムモデル。 GAUSSIAN - ガウス分布 (正規分布) セミバリオグラムモデル。 LINEAR - シルのある線形セミバリオグラムモデル。 KrigingModelUniversal ({semivariogramType}, {lagSize}, {majorRange}, {partialSill}, {nugget}) semivariogramType - 使用するセミバリオグラムモデル。使用可能なモデルは次のとおりです: LINEARDRIFT - 直線ドリフトのある Universal モデルクリギング。 QUADRATICDRIFT - 二次ドリフトのある Universal モデルクリギング。 {semivariogramType} の後のパラメーターは Ordinary モデルと Universal モデルとで共通です。 lagSize - デフォルトは、出力ラスターのセルサイズです。 majorRange - 相関がほとんど、またはまったくなくなる距離を表します。 partialSill - ナゲットとシルの差分。 nugget - 空間縮尺で検出できない誤差とばらつきを表します。ナゲット効果は原点での不連続として現れます。	KrigingModel
cell_size (オプション)	作成される出力ラスターのセルサイズ。このパラメーターは、数値で定義するか、既存のラスターデータセットから取得できます。セルサイズがパラメーター値として明示的に指定されていない場合、指定されていれば、環境のセルサイズ値が使用されます。そうでない場合は、追加のルールを使用して別の入力から計算されます。詳細については、使用方法をご参照ください。	Analysis Cell Size
search_radius (オプション)	Radius クラスは、どの入力ポイントを使用して出力ラスターの各セル値を内挿するかを定義します。 Radius クラスには、次の 2 つのタイプがあります。RadiusVariable と RadiusFixed です。可変検索範囲は、指定された数の入力サンプルポイントを見つけて内挿するときに使用されます。固定タイプでは、指定された固定距離内にあるすべての入力ポイントが内挿に使用されます。デフォルトは可変タイプです。 RadiusVariable ({numberofPoints}, {maxDistance}) {numberofPoints} - 内挿実行時に使用する最近接入力サンプルポイントの数を指定する整数値。デフォルトは 12 です。 {maxDistance} - 最近接入力サンプルポイントの検索範囲を制限する距離をマップ単位で指定します。デフォルト値は範囲の対角線の長さです。 RadiusFixed ({distance}, {minNumberofPoints}) {distance} - 距離を半径として指定します。その距離内にある入力サンプルポイントが内挿実行時に使用されます。半径の値はマップの単位で表します。デフォルトの半径は、出力ラスターのセルサイズの 5 倍です。 {minNumberofPoints} - 内挿に使用する最小ポイント数を定義する整数値。デフォルト値は 0 です。指定した距離内に必要な数のポイントがない場合は、指定した最小数のポイントが見つかるまで検索距離が大きくなります。検索範囲を大きくする必要がある場合、検索範囲は、その範囲内で {minNumberofPoints} のポイントが見つかるまで、あるいはその範囲が出力ラスターの下限 (南) と上限 (北) のどちらかまたは両方を超えるまで大きくなります。上記の条件を満たさない位置には No Data が割り当てられます。	Radius
out_variance_prediction_raster (オプション)	オプションの出力ラスターで、各セルにはその位置に対する予測のバリアンス値が格納されます。	Raster Dataset

戻り値

名前	説明	データタイプ
out_surface_raster	内挿された出力サーフェスラスター。常に浮動小数点ラスターです。	Raster

名前

説明

データタイプ

out_surface_raster

内挿された出力サーフェスラスター。

常に浮動小数点ラスターです。

Raster

コードのサンプル

Kriging の例 1 (Python ウィンドウ)

この例では、ポイントシェープファイルを入力として、内挿したサーフェスを GRID ラスターとして出力します。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outKrig = Kriging("ozone_pts.shp", "OZONE", KrigingModelOrdinary("CIRCULAR", 2000, 2.6, 542, 0), 2000, RadiusFixed(20000, 1))
outKrig.save("c:/sapyexamples/output/krigout")

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

この例では、ポイントシェープファイルを入力として、内挿したサーフェスを GRID ラスターとして出力します。

# Name: Kriging_Ex_02.py
# Description: Interpolates a surface from points using kriging.
# 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
inFeatures = "ca_ozone_pts.shp"
field = "OZONE"
cellSize = 2000
outVarRaster = "C:/sapyexamples/output/outvariance"
lagSize = 2000
majorRange = 2.6
partialSill = 542
nugget = 0

# Set complex variables
kModelOrdinary = KrigingModelOrdinary("CIRCULAR", lagSize,
                                majorRange, partialSill, nugget)
kRadius = RadiusFixed(20000, 1)



# Execute Kriging
outKriging = Kriging(inFeatures, field, kModelOrdinary, cellSize,
                     kRadius, outVarRaster)

# Save the output 
outKriging.save("C:/sapyexamples/output/krigoutput02")

環境

自動コミット, セルサイズ, セルサイズ投影法, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力データのコンフィグレーションキーワード, 出力座標系, テンポラリワークスペース, スナップ対象ラスター, タイルサイズ

ライセンス情報

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

サマリー

使用法

パラメーター

戻り値

戻り値

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容