ローカル多項式内挿 (Geostatistical Analyst ツール)

サマリー

指定した重複近傍内で、指定した次数 (0 次、1 次、2 次、3 次など) の多項式に適合させて出力サーフェスを生成します。

使用法

データセットが短期ばらつきを示している場合は、ローカル多項式内挿 を使用します。
グローバル多項式内挿 はスムージングサーフェスを作成し、データセット内の長距離トレンドを把握するのに役立ちますが、地球科学の分野では、対象の変数に長距離トレンドだけでなく短距離変動が存在することがよくあります。データセットが短期ばらつきを示している場合、ローカル多項式内挿 マップで短期ばらつきを捉えることができます。

ラベル	説明	データタイプ
入力フィーチャ	内挿する Z 値を含む入力ポイントフィーチャ。	Feature Layer
Z 値フィールド	各ポイントの高さまたは大きさの値を保持するフィールド。これは数値フィールドまたは、入力フィーチャが Z 値または M 値を含む場合は Shape フィールドです。	Field
出力地球統計レイヤー (オプション)	地球統計レイヤーが生成されます。このレイヤーは、出力ラスターが要求されていない場合にのみ必須の出力です。	Geostatistical Layer
出力ラスター (オプション)	出力ラスター。このラスターは、出力地球統計レイヤーが要求されていない場合にのみ必須の出力です。	Raster Dataset
出力セルサイズ (オプション)	作成する出力ラスターのセルサイズ。この値は、環境のセルサイズパラメーターで明示的に設定できます。設定されていない場合、入力空間参照において、入力ポイントフィーチャの範囲の幅または高さ (どちらか短い方) を 250 で割った値になります。	Analysis Cell Size
多項式次数 (オプション)	多項式の次数。	Long
検索近傍 (オプション)	出力の制御に使用する周辺のポイントを定義します。標準がデフォルトです。標準長軸— 近傍検索の長軸の値。短軸— 近傍検索の短軸の値。角度— 変動ウィンドウの軸 (円) または長軸 (楕円) の回転角度。最大近傍— 未知の位置の値を推定する際に使用される最大近傍数。最小近傍— 未知の位置の値を推定する際に使用される最小近傍数。セクタータイプ— 近傍のジオメトリー。 1 セクター— 単一の楕円。 4 セクター—4 つのセクターに分割された楕円。 4 セクター (回転)—4 つのセクターに分割され、45 度回転した楕円。 8 セクター—8 つのセクターに分割された楕円。スムージング長軸— 近傍検索の長軸の値。短軸— 近傍検索の短軸の値。角度— 変動ウィンドウの軸 (円) または長軸 (楕円) の回転角度。スムージング係数— スムージング内挿オプションを使用すると、外側の楕円と内側の楕円が、長軸にスムージング係数を掛けた距離に作成されます。最小楕円の外側かつ最大楕円の内側にあるポイントは、シグモイド関数を使用して 0 〜 1 の値で重み付けされます。標準円形半径— 検索円の半径の長さ。角度— 変動ウィンドウの軸 (円) または長軸 (楕円) の回転角度。最大近傍— 未知の位置の値を推定する際に使用される最大近傍数。最小近傍— 未知の位置の値を推定する際に使用される最小近傍数。セクタータイプ— 近傍のジオメトリー。 1 セクター— 単一の楕円。 4 セクター—4 つのセクターに分割された楕円。 4 セクター (回転)—4 つのセクターに分割され、45 度回転した楕円。 8 セクター—8 つのセクターに分割された楕円。スムージング円形半径— 検索円の半径の長さ。スムージング係数— スムージング内挿オプションを使用すると、外側の楕円と内側の楕円が、長軸にスムージング係数を掛けた距離に作成されます。最小楕円の外側かつ最大楕円の内側にあるポイントは、シグモイド関数を使用して 0 〜 1 の値で重み付けされます。	Geostatistical Search Neighborhood
カーネル関数 (オプション)	シミュレーションで使用したカーネル関数。指数—関数は比例的に成長または減衰します。ガウス—プラス無限大またはマイナス無限大に向かって急速に落ち込む釣鐘状の関数。 4 次—4 次多項式関数。 Epanechnikov—不連続の放物線関数。 5 次多項式—5 次多項式関数。定数—指標関数。	String
バンド幅 (オプション)	推定に使用するデータポイントで最も遠いポイントまでの距離の指定に使用されます。バンド幅を広げると、推定バイアスは増加し、推定分散は減少します。	Double
空間条件数の閾値を使用 (オプション)	推定が安定していない場合の推定値および推定標準誤差の作成を制御するオプション。このオプションは、多項式の次数が 1、2、3 の場合のみ使用できます。オン—推定が安定していない位置では、推定値および推定標準誤差は作成されません。オフ—推定値は、推定が安定していないエリアを含めて、すべての位置で作成されます。これがデフォルトです。	Boolean
空間条件数の閾値 (オプション)	すべての可逆正方行列には、一次方程式の解が行列の係数の小さな変更に関してどの程度不正確になるかを示す条件数が存在しています。 (不正確なデータが原因の場合もあります)。条件数が大きいと、行列の係数の小さな変更が、解ベクターに大きな変更をもたらします。	Double
加重フィールド (オプション)	観測値を強調する際に使用されます。加重が大きいほど、推定に与える影響も大きくなります。観測値が一致した場合、最も信頼性の高い計測値に最も大きい加重が割り当てられます。	Field
出力サーフェスタイプ (オプション)	内挿結果を保存するサーフェスタイプ。推定—内挿された値から推定サーフェスが生成されます。推定の標準誤差—内挿された値の標準誤差から標準誤差サーフェスが生成されます。条件数—空間条件数サーフェスは、特定の位置での計算の安定性を示します。条件数が多いほど推定が不安定になるため、条件数が多い場所はアーティファクトが発生しやすく、推定値が不安定になる場合があります。	String

arcpy.ga.LocalPolynomialInterpolation(in_features, z_field, {out_ga_layer}, {out_raster}, {cell_size}, {power}, {search_neighborhood}, {kernel_function}, {bandwidth}, {use_condition_number}, {condition_number}, {weight_field}, {output_type})

名前	説明	データタイプ
in_features	内挿する Z 値を含む入力ポイントフィーチャ。	Feature Layer
z_field	各ポイントの高さまたは大きさの値を保持するフィールド。これは数値フィールドまたは、入力フィーチャが Z 値または M 値を含む場合は Shape フィールドです。	Field
out_ga_layer (オプション)	地球統計レイヤーが生成されます。このレイヤーは、出力ラスターが要求されていない場合にのみ必須の出力です。	Geostatistical Layer
out_raster (オプション)	出力ラスター。このラスターは、出力地球統計レイヤーが要求されていない場合にのみ必須の出力です。	Raster Dataset
cell_size (オプション)	作成する出力ラスターのセルサイズ。この値は、環境のセルサイズパラメーターで明示的に設定できます。設定されていない場合、入力空間参照において、入力ポイントフィーチャの範囲の幅または高さ (どちらか短い方) を 250 で割った値になります。	Analysis Cell Size
power (オプション)	多項式の次数。	Long
search_neighborhood (オプション)	出力の制御に使用する周辺のポイントを定義します。標準がデフォルトです。検索近傍クラスには、SearchNeighborhoodStandard、SearchNeighborhoodSmooth、SearchNeighborhoodStandardCircular、SearchNeighborhoodSmoothCircular があります。標準 `majorSemiaxis`—近傍検索の長軸の値。 `minorSemiaxis`—近傍検索の短軸の値。 `angle`—変動ウィンドウの軸 (円) または長軸 (楕円) の回転角度。 `nbrMax`—未知の位置の値を推定する際に使用される最大近傍数。 `nbrMin`—未知の位置の値を推定する際に使用される最小近傍数。 `sectorType`—近傍のジオメトリ。 `ONE_SECTOR`—単一の楕円。 `FOUR_SECTORS`—4 つのセクターに分割された楕円。 `FOUR_SECTORS_SHIFTED`—4 つのセクターに分割され、45 度回転した楕円。 `EIGHT_SECTORS`—8 つのセクターに分割された楕円。スムージング `majorSemiaxis`—近傍検索の長軸の値。 `minorSemiaxis`—近傍検索の短軸の値。 `angle`—変動ウィンドウの軸 (円) または長軸 (楕円) の回転角度。 `smoothFactor`—スムージング内挿オプションを使用すると、外側の楕円と内側の楕円が、長軸にスムージング係数を掛けた距離に作成されます。最小楕円の外側かつ最大楕円の内側にあるポイントは、シグモイド関数を使用して 0 〜 1 の値で重み付けされます。標準円形 `radius`—検索円の半径の長さ。 `angle`—変動ウィンドウの軸 (円) または長軸 (楕円) の回転角度。 `nbrMax`—未知の位置の値を推定する際に使用される最大近傍数。 `nbrMin`—未知の位置の値を推定する際に使用される最小近傍数。 `sectorType`—近傍のジオメトリ。 `ONE_SECTOR`—単一の楕円。 `FOUR_SECTORS`—4 つのセクターに分割された楕円。 `FOUR_SECTORS_SHIFTED`—4 つのセクターに分割され、45 度回転した楕円。 `EIGHT_SECTORS`—8 つのセクターに分割された楕円。スムージング円形 `radius`—検索円の半径の長さ。 `smoothFactor`—スムージング内挿オプションを使用すると、外側の楕円と内側の楕円が、長軸にスムージング係数を掛けた距離に作成されます。最小楕円の外側かつ最大楕円の内側にあるポイントは、シグモイド関数を使用して 0 〜 1 の値で重み付けされます。	Geostatistical Search Neighborhood
kernel_function (オプション)	シミュレーションで使用したカーネル関数。 `EXPONENTIAL`—関数は比例的に成長または減衰します。 `GAUSSIAN`—プラス無限大またはマイナス無限大に向かって急速に落ち込む釣鐘状の関数。 `QUARTIC`—4 次多項式関数。 `EPANECHNIKOV`—不連続の放物線関数。 `POLYNOMIAL5`—5 次多項式関数。 `CONSTANT`—指標関数。	String
bandwidth (オプション)	推定に使用するデータポイントで最も遠いポイントまでの距離の指定に使用されます。バンド幅を広げると、推定バイアスは増加し、推定分散は減少します。	Double
use_condition_number (オプション)	推定が安定していない場合の推定値および推定標準誤差の作成を制御するオプション。このオプションは、多項式の次数が 1、2、3 の場合のみ使用できます。 `USE_CONDITION_NUMBER`—推定が安定していない位置では、推定値および推定標準誤差は作成されません。 `NO_USE_CONDITION_NUMBER`—推定値は、推定が安定していないエリアを含めて、すべての位置で作成されます。これがデフォルトです。	Boolean
condition_number (オプション)	すべての可逆正方行列には、一次方程式の解が行列の係数の小さな変更に関してどの程度不正確になるかを示す条件数が存在しています。 (不正確なデータが原因の場合もあります)。条件数が大きいと、行列の係数の小さな変更が、解ベクターに大きな変更をもたらします。	Double
weight_field (オプション)	観測値を強調する際に使用されます。加重が大きいほど、推定に与える影響も大きくなります。観測値が一致した場合、最も信頼性の高い計測値に最も大きい加重が割り当てられます。	Field
output_type (オプション)	内挿結果を保存するサーフェスタイプ。出力サーフェスのタイプについては、「内挿モデルが生成できる出力サーフェスのタイプ」をご参照ください。 `PREDICTION`—内挿された値から推定サーフェスが生成されます。 `PREDICTION_STANDARD_ERROR`—内挿された値の標準誤差から標準誤差サーフェスが生成されます。 `CONDITION_NUMBER`—空間条件数サーフェスは、特定の位置での計算の安定性を示します。条件数が多いほど推定が不安定になるため、条件数が多い場所はアーティファクトが発生しやすく、推定値が不安定になる場合があります。	String

コードのサンプル

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

ポイントフィーチャを四角形ラスターに内挿します。

import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
arcpy.ga.LocalPolynomialInterpolation(
    "ca_ozone_pts", "OZONE", "outLPI", "C:/gapyexamples/output/lpiout", "2000",
    "2", arcpy.SearchNeighborhoodSmooth(300000, 300000, 0, 0.5), "QUARTIC",
    "", "", "", "", "PREDICTION")

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

ポイントフィーチャを四角形ラスターに内挿します。

# Name: LocalPolynomialInterpolation_Example_02.py
# Description: Local Polynomial interpolation fits many polynomials, each
#              within specified overlapping neighborhoods.
# Requirements: Geostatistical Analyst extension

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/gapyexamples/data"

# Set local variables
inPointFeatures = "ca_ozone_pts.shp"
zField = "ozone"
outLayer = "outLPI"
outRaster = "C:/gapyexamples/output/lpiout"
cellSize = 2000.0
power = 2
kernelFunction = "QUARTIC"
bandwidth = ""
useConNumber = ""
conNumber = ""
weightField = ""
outSurface = "PREDICTION"

# Set variables for search neighborhood
majSemiaxis = 300000
minSemiaxis = 300000
angle = 0
smoothFactor = 0.5
searchNeighbourhood = arcpy.SearchNeighborhoodSmooth(majSemiaxis, minSemiaxis,
                                                     angle, smoothFactor)

# Run LocalPolynomialInterpolation
arcpy.ga.LocalPolynomialInterpolation(inPointFeatures, zField, outLayer, outRaster,
                                      cellSize, power, searchNeighbourhood,
                                      kernelFunction, bandwidth, useConNumber,
                                      conNumber, weightField, outSurface)

環境

セルサイズ, コインシデントポイント, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力座標系, 並列処理ファクター, スナップ対象ラスター

ライセンス情報

Basic: Geostatistical Analyst が必要
Standard: Geostatistical Analyst が必要
Advanced: Geostatistical Analyst が必要

ローカル多項式内挿 (Geostatistical Analyst ツール)

サマリー

使用法

パラメーター

環境

ライセンス情報

関連トピック