トレンド (Trend) (Spatial Analyst)—ArcGIS Pro

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

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

サマリー

トレンド解析の手法を使用してポイントからラスターサーフェスを内挿します。

使用法

多項式の次数が増えるほど、当てはめるサーフェスの複雑さは増していきます。多項式の次数を高くすることで、必ずしも正確なサーフェスが生成されるとは限りません。正確なサーフェスが生成されるかどうかは、データによって異なります。
[回帰分析の手法] の [ロジスティック] オプションでは、入力ポイントフィーチャの Z 値フィールドに 0 および 1 のコードを指定します。
[出力セルサイズ] パラメーターは、数値で定義することも、既存のラスターデータセットから取得することもできます。セルサイズがパラメーター値として明示的に指定されていない場合、[セルサイズ] 環境が指定されていれば、そこから取得されます。パラメーターのセルサイズも環境のセルサイズも指定されておらず、[スナップ対象ラスター] 環境が設定されている場合には、スナップラスターのセルサイズが使用されます。何も指定されていない場合、セルサイズは範囲の幅または高さ (どちらか短い方) を 250 で割って求められます。この範囲は環境で指定された出力座標系にあります。
セルサイズが数値によって指定されている場合、このツールは出力ラスターに対してこの値を直接使用します。
セルサイズがラスターデータセットを使用して指定されている場合、パラメーターはセルサイズの値ではなくラスターデータセットのパスを示します。データセットの空間参照が出力空間参照と同じである場合、解析ではラスターデータセットのセルサイズが直接使用されます。データセットの空間参照が出力空間参照と異なる場合、指定した [セルサイズ投影法] の値に基づいて投影されます。
オプションの RMS ファイル出力には、内挿の RMS (二乗平均平方根) 誤差の情報が含まれます。この情報を使用して、RMS 誤差が最小になるように次数を変更することで、多項式の最適な次数を決定できます。 RMS ファイルの詳細については、「トレンド (Trend) の仕組み」トピックをご参照ください。
入力データセットには X、Y 座標が同じである位置に複数のポイントが存在することがあります。共通の位置にあるポイントの値が同じである場合、それは重複とみなされて出力には影響しません。値が異なる場合は、一致ポイントと見なされます。
このデータ条件の処理方法は各種内挿ツールによって異なることがあります。たとえば、最初に遭遇した一致ポイントが計算に使用されることも、最後に遭遇した一致ポイントが計算に使用されることもあります。そのため、出力ラスター内のある位置に予想とは異なる値が出力される可能性があります。対策としては、このような一致ポイントを削除したデータを用意しておくことです。[Spatial Statistics] ツールボックスの [イベントの集計 (Collect Events)] ツールは、データ内の一致ポイントを特定するのに役立ちます。
NULL 値をサポートするデータ形式 (ファイルジオデータベースフィーチャクラスなど) では、入力として使用すると、NULL 値は無視されます。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。

パラメーター

ラベル	説明	データタイプ
入力ポイントフィーチャ	サーフェスラスターとして内挿する Z 値を含む入力ポイントフィーチャ。	Feature Layer
Z 値フィールド	各ポイントの高さまたは大きさの値を保持するフィールド。これは数値フィールドまたは、入力ポイントフィーチャが Z 値を含む場合は Shape フィールドです。回帰分析の手法がロジスティックの場合、フィールドには 0 または 1 のみを指定できます。	Field
出力セルサイズ (オプション)	作成される出力ラスターのセルサイズ。このパラメーターは、数値で定義するか、既存のラスターデータセットから取得できます。セルサイズがパラメーター値として明示的に指定されていない場合、指定されていれば、環境のセルサイズ値が使用されます。そうでない場合は、追加のルールを使用して別の入力から計算されます。詳細については、使用方法をご参照ください。	Analysis Cell Size
多項式の次数 (オプション)	多項式の次数。 1 ～ 12 の整数にする必要があります。 1 を指定するとポイントは平面で近似され、値を大きくするほど複雑なサーフェスとなります。デフォルトは 1 です。	Long
回帰分析のタイプ (オプション)	実行する回帰分析のタイプ。リニア—多項式回帰分析を実行して、最小二乗サーフェスで入力ポイントを近似します。この方法は連続したデータタイプに適用できます。ロジスティック—ロジスティックトレンドサーフェス分析を実行します。バイナリ (二値) のデータタイプに対して、連続確率サーフェスを生成します。	String
出力 RMS ファイル (オプション)	内挿の RMS 誤差とカイ二乗に関する情報を含む出力テキストファイルのファイル名。拡張子は「.txt」にする必要があります。	File

戻り値

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

ラベル

説明

データタイプ

出力ラスター

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

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

Raster

Trend(in_point_features, z_field, {cell_size}, {order}, {regression_type}, {out_rms_file})

名前	説明	データタイプ
in_point_features	サーフェスラスターとして内挿する Z 値を含む入力ポイントフィーチャ。	Feature Layer
z_field	各ポイントの高さまたは大きさの値を保持するフィールド。これは数値フィールドまたは、入力ポイントフィーチャが Z 値を含む場合は Shape フィールドです。回帰分析の手法がロジスティックの場合、フィールドには 0 または 1 のみを指定できます。	Field
cell_size (オプション)	作成される出力ラスターのセルサイズ。このパラメーターは、数値で定義するか、既存のラスターデータセットから取得できます。セルサイズがパラメーター値として明示的に指定されていない場合、指定されていれば、環境のセルサイズ値が使用されます。そうでない場合は、追加のルールを使用して別の入力から計算されます。詳細については、使用方法をご参照ください。	Analysis Cell Size
order (オプション)	多項式の次数。 1 ～ 12 の整数にする必要があります。 1 を指定するとポイントは平面で近似され、値を大きくするほど複雑なサーフェスとなります。デフォルトは 1 です。	Long
regression_type (オプション)	実行する回帰分析のタイプ。 LINEAR—多項式回帰分析を実行して、最小二乗サーフェスで入力ポイントを近似します。この方法は連続したデータタイプに適用できます。 LOGISTIC—ロジスティックトレンドサーフェス分析を実行します。バイナリ (二値) のデータタイプに対して、連続確率サーフェスを生成します。	String
out_rms_file (オプション)	内挿の RMS 誤差とカイ二乗に関する情報を含む出力テキストファイルのファイル名。拡張子は「.txt」にする必要があります。	File

戻り値

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

名前

説明

データタイプ

out_raster

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

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

Raster

コードのサンプル

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

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

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTrend = Trend("ozone_pts.shp", "ozone", 2000, 2, "LINEAR")
outTrend.save("C:/sapyexamples/output/trendout.tif")

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

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

# Name: Trend_Ex_02.py
# Description: Interpolate a series of point features 
#    onto a rectangular raster using a trend technique.
# 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 = 2000.0
PolynomialOrder = 2
regressionType = "LINEAR"


# Execute Trend
outTrend = Trend(inPointFeatures, zField, cellSize, 
                 PolynomialOrder, regressionType)

# Save the output 
outTrend.save("C:/sapyexamples/output/trendout02")

環境

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

ライセンス情報

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

サマリー

使用法

パラメーター

戻り値

戻り値

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容