ラスターの変化の計算 (Compute Change Raster) (Image Analyst)

Image Analyst ライセンスで利用できます。

サマリー

2 つのラスター データセット間の絶対的、相対的、またはカテゴリ的な差異を計算します。

使用法

• このツールは、2 つのラスターを比較して、2 つのラスター間の差分を含む新しいラスターを生成します。 たとえば、このツールを使用して、2001 年から 2020 年にかけて炭素蓄積のピクセル値がどのように変化したのかを確認したり、2010 年から 2015 年にかけて土地被覆がどのように変化したのかを確認したりします。

• ラスターの変化を計算できる計算タイプは、次のとおりです。

  • [差異] - [From ラスター] パラメーターのピクセル値と [To ラスター] パラメーターのピクセル値の間の数学的な差 (減算) が計算されます。

    出力 = (To ラスター) - (From ラスター)

  • [相対的な差分] - 比較される値の数量を考慮に入れて、ピクセル値の差が計算されます。

    出力 = (To ラスター - From ラスター) / max(To ラスター, From ラスター)

  • カテゴリ差分 - 2 つのカテゴリ ラスターまたは主題ラスター間の差。出力には、2 つのラスター間で発生した各クラス遷移が表示されます。

• [カテゴリ差分] 計算タイプから生成される出力は、属性テーブルを含むラスター データセットです。 このテーブルは、トランジション タイプ (例: 森林から市街地まで)、各トランジション タイプに含まれるピクセルの数、各トランジション タイプの推定エリアで構成されます。 エリアは、ピクセル サイズに各トランジション タイプ内のピクセルの数を掛けて求められた値として算出されます。 この単位は、入力ラスター データの距離単位に相当します。

• 2 つのカテゴリ ラスター間の差を計算する場合に、特定のクラスに解析を制限することができます。 たとえば、都市の成長を視覚化するには、[From クラス] リスト内にあるすべてのクラスのうち、[To クラス] リストにある Urban クラスだけを含めます。 結果には、Urban カテゴリに関与した遷移がすべて含まれます。

• 入力ラスターに異なるセル サイズまたは範囲が含まれている場合、[セル サイズ] および [出力範囲] 環境設定でセル サイズと範囲を指定できます。

• [変化の計算方法] パラメーターが [カテゴリ差分] に設定されている場合、[From ラスター] パラメーターと [To ラスター] パラメーターには、Value フィールドまたは ClassValue フィールドに関連付けられたラスター属性テーブルが必要です。 対応するクラス値のクラス名は、出力クラス送信名として使用されます。 このツールでは、標準のフィールド クラス名 CLASS_NAME または CLASSNAME が使用されます。 これらのフィールド名が存在しない場合は、[From ラスターのクラス名フィールド] パラメーターと [To ラスターのクラス名フィールド] パラメーターを使用して定義することができます。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
ラスターから変換	解析対象の初期または古いラスター。	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String
ラスターへ変換	解析対象の最終または新しいラスター。 これは、初期ラスターと比較されるラスターです。	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String
変化の計算方法 (オプション)	2 つのラスター間で実行する計算のタイプを指定します。 差分—ラスターのピクセル値間の数学的な差 (減算) が計算されます。 これがデフォルトです。 相対的な差分—比較されるピクセル値の数量を考慮に入れて、ピクセル値の差が計算されます。 カテゴリ差分—2 つのカテゴリ ラスターまたは主題ラスター間の差が計算されます。出力には、2 つのラスター間で発生したクラス遷移が含まれます。	String
From クラス (オプション)	計算に含める [From ラスター] パラメーターのクラス名のリスト。 クラスが指定されていないと、すべてのクラスが含まれます。 このパラメーターは、[変化の計算方法] パラメーターが [カテゴリ差分] に設定されている場合にアクティブになります。	String
To クラス (オプション)	計算に含める [To ラスター] パラメーターのクラス名のリスト。 クラスが指定されていないと、すべてのクラスが含まれます。 このパラメーターは、[変化の計算方法] パラメーターが [カテゴリ差分] に設定されている場合にアクティブになります。	String
フィルター方法 (オプション)	出力ラスターに分類されるピクセルを指定します。 このパラメーターは、[変化の計算方法] パラメーターが [カテゴリ差分] に設定されている場合にアクティブになります。 変化したピクセルのみ—カテゴリを変更したピクセルのみが出力に分類されます。 カテゴリを変更していないピクセルは「Other」というクラスにグループ化されます。 変化していないピクセルのみ—カテゴリを変更していないピクセルのみが出力に分類されます。 カテゴリを変更したピクセルは「Other」というクラスにグループ化されます。 すべてのピクセル—ピクセルはすべて出力に分類されます。 これがデフォルトです。	String
遷移クラスの色 (オプション)	出力クラスのシンボル表示に使用する色を指定します。 ピクセルがあるクラスから別のクラスに変化すると、出力ピクセルの色は初期クラス タイプ、最終クラス タイプ、または 2 つのタイプのブレンドを表します。 このパラメーターは、[変化の計算方法] パラメーターが [カテゴリ差分] に設定されている場合にアクティブになります。 From 色と To 色の平均—出力クラスの色は From (初期) クラス色と To (最終) クラス色の平均です。 これがデフォルトです。 From 色—出力クラスの色は From (初期) クラス色と一致します。 To 色—出力クラスの色は To (最終) クラス色と一致します。	String
From ラスターのクラス名フィールド (オプション)	[From ラスター] パラメーターの値に含まれているクラス名が格納されるフィールド。 このツールでは、使用する ClassName フィールドまたは Class_Name フィールドが自動的に検索されます。 このパラメーターは、標準のフィールド名が入力値に含まれていない場合に使用します。	Field
To ラスターのクラス名フィールド (オプション)	[To ラスター] パラメーターの値に含まれているクラス名が格納されるフィールド。 このツールでは、使用する ClassName フィールドまたは Class_Name フィールドが自動的に検索されます。 このパラメーターは、標準のフィールド名が入力値に含まれていない場合に使用します。	Field

戻り値

ラベル	説明	データ タイプ
出力ラスター	出力変更ラスター データセット。	Raster

Python

ComputeChangeRaster(from_raster, to_raster, {compute_change_method}, {from_classes}, {to_classes}, {filter_method}, {define_transition_colors}, {from_classname_field}, {to_classname_field})

名前	説明	データ タイプ
from_raster	解析対象の初期または古いラスター。	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String
to_raster	解析対象の最終または新しいラスター。 これは、初期ラスターと比較されるラスターです。	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String
compute_change_method (オプション)	2 つのラスター間で実行する計算のタイプを指定します。 DIFFERENCE—ラスターのピクセル値間の数学的な差 (減算) が計算されます。 これがデフォルトです。 RELATIVE_DIFFERENCE—比較されるピクセル値の数量を考慮に入れて、ピクセル値の差が計算されます。 CATEGORICAL_DIFFERENCE—2 つのカテゴリ ラスターまたは主題ラスター間の差が計算されます。出力には、2 つのラスター間で発生したクラス遷移が含まれます。	String
from_classes [from_classes,...] (オプション)	計算に含める from_raster パラメーターのクラス名のリスト。 クラスが指定されていないと、すべてのクラスが含まれます。 このパラメーターは、compute_change_method パラメーターが CATEGORICAL_DIFFERENCE に設定されている場合にアクティブになります。	String
to_classes [to_classes,...] (オプション)	計算に含める to_raster パラメーターのクラス名のリスト。 クラスが指定されていないと、すべてのクラスが含まれます。 このパラメーターは、compute_change_method パラメーターが CATEGORICAL_DIFFERENCE に設定されている場合にアクティブになります。	String
filter_method (オプション)	出力ラスターに分類されるピクセルを指定します。 このパラメーターは、compute_change_method パラメーターが CATEGORICAL_DIFFERENCE に設定されている場合にアクティブになります。 CHANGED_PIXELS_ONLY—カテゴリを変更したピクセルのみが出力に分類されます。 カテゴリを変更していないピクセルは「Other」というクラスにグループ化されます。 UNCHANGED_PIXELS_ONLY—カテゴリを変更していないピクセルのみが出力に分類されます。 カテゴリを変更したピクセルは「Other」というクラスにグループ化されます。 ALL—ピクセルはすべて出力に分類されます。 これがデフォルトです。	String
define_transition_colors (オプション)	出力クラスのシンボル表示に使用する色を指定します。 ピクセルがあるクラスから別のクラスに変化すると、出力ピクセルの色は初期クラス タイプ、最終クラス タイプ、または 2 つのタイプのブレンドを表します。 このパラメーターは、compute_change_method パラメーターが CATEGORICAL_DIFFERENCE に設定されている場合にアクティブになります。 AVERAGE—出力クラスの色は From (初期) クラス色と To (最終) クラス色の平均です。 これがデフォルトです。 FROM_COLOR—出力クラスの色は From (初期) クラス色と一致します。 TO_COLOR—出力クラスの色は To (最終) クラス色と一致します。	String
from_classname_field (オプション)	[From ラスター] パラメーターの値に含まれているクラス名が格納されるフィールド。 このツールでは、使用する ClassName フィールドまたは Class_Name フィールドが自動的に検索されます。 このパラメーターは、標準のフィールド名が入力値に含まれていない場合に使用します。	Field
to_classname_field (オプション)	to_raster パラメーターの値に含まれているクラス名が格納されるフィールド。 このツールでは、使用する ClassName フィールドまたは Class_Name フィールドが自動的に検索されます。 このパラメーターは、標準のフィールド名が入力値に含まれていない場合に使用します。	Field

戻り値

名前	説明	データ タイプ
out_raster_dataset	出力変更ラスター データセット。	Raster

コードのサンプル

ComputeChangeRaster (ラスターの変化の計算) の例 1 (Python ウィンドウ)

この例では、2000 年と 2020 年の NDVI ピクセル値の差を計算します。

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

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

NDVIchange = arcpy.ia.ComputeChangeRaster(
	"NDVI_2000.tif", "NDVI_2020.tif", "DIFFERENCE")
	
NDVIchange.save("C:/Data/NDVI_2000_2020.tif")

ComputeChangeRaster (ラスターの変化の計算) の例 2 (スタンドアロン スクリプト)

この例では、2000 年と 2020 年の NDVI ピクセル値の相対的な差を計算します。

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

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Define input parameters
FromRaster = "C:/Data/NDVI_2000.tif"
ToRaster = "C:/Data/NDVI_2020.tif"
ChangeType = "RELATIVE_DIFFERENCE"

# Execute - calculate the relative difference in NDVI from 2000 to 2020
NDVIrelativeChange = arcpy.ia.ComputeChangeRaster(
	FromRaster, ToRaster, ChangeType)
	
# Save output
NDVIrelativeChange.save("C:/Data/Relative_NDVI_2000_2020.tif")

ComputeChangeRaster (ラスターの変化の計算) の例 3 (スタンドアロン スクリプト)

この例では、2000 年から 2020 年にかけての土地被膜の変化を計算し、Forest、Agriculture、Water、または Barren クラスから Urban クラスに変化したピクセルのみを抽出します。

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

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")


LandcoverChange = arcpy.ia.ComputeChangeRaster(
	"Landcover_2000.tif", "Landcover_2020.tif", "CATEGORICAL_DIFFERENCE", 
	"'Forest';'Agriculture';'Water';'Barren'", "'Urban'", 
	"CHANGED_PIXELS_ONLY", "AVERAGE")
	
# Save output  
LandcoverChange.save("C:/Data/Landcover_2000_2020.tif")

環境

セル配置, セル サイズ, 圧縮, 現在のワークスペース, 範囲, 地理座標系変換, NoData, 出力データのコンフィグレーション キーワード, 出力座標系, 並列処理ファクター, ピラミッド, ラスターの統計情報, リサンプリング方法, テンポラリ ワークスペース, スナップ対象ラスター, タイル サイズ

特殊なケース

ライセンス情報

• Basic: 次のものが必要 Image Analyst
• Standard: 次のものが必要 Image Analyst
• Advanced: 次のものが必要 Image Analyst