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

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 フィールド、CLASS_NAME フィールド、CLASSNAME フィールド、1 つの文字列フィールドのいずれかが必要です。

パラメーター

ラベル	説明	データタイプ
From ラスター	解析対象の初期または古いラスター。	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String
To ラスター	解析対象の最終または新しいラスター。これは、初期ラスターと比較されるラスターです。	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

戻り値

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

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

名前	説明	データタイプ
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

戻り値

名前	説明	データタイプ
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

サマリー

使用法

パラメーター

戻り値

戻り値

コードのサンプル

環境

特殊なケース

ライセンス情報

関連トピック

このトピックの内容