Image Analyst ライセンスで利用できます。
概要
[CCDC を使用した変化の解析 (Analyze Changes Using CCDC)] ツールまたは [LandTrendr を使用した変化の解析 (Analyze Changes Using LandTrendr)] ツールの出力変化解析ラスターを使用してピクセル変化情報を含むラスターを生成します。
使用法
このツールは、[CCDC を使用した変化の解析 (Analyze Changes Using CCDC)] ツールまたは [LandTrendr を使用した変化の解析 (Analyze Changes Using LandTrendr)] ツールから生成された変化解析ラスターを使用して、変化点情報を含むラスターを生成します。
変化解析ラスターには、各ピクセルが時間の経過とともにどのように変化したかというモデル情報が含まれており、このツールはその情報を解析します。
[変化タイプ] パラメーターは、生成される情報を示しています。情報は、変化解析ラスターから抽出されます。
このツールを [CCDC を使用した変化の解析 (Analyze Changes Using CCDC)] ツールからの出力で実行する場合、以下のオプションから選択できます。
- [最新の変化が発生した時間] - ピクセルに変化フラグが付与された最新の日時。
- [最古の変化が発生した時間] - ピクセルに変化フラグが付与された最も古い日時。
- [最大の変化が発生した時間] - ピクセルにおいて計算された変化が最大だった日時。
- [変化数] - ピクセルが変更された合計回数。
詳細については、「CCDC を使用した変化の解析 (Analyze Changes Using CCDC) ツールの詳細」をご参照ください。
このツールを [LandTrendr を使用した変化の解析 (Analyze Changes Using LandTrendr)] ツールからの出力で実行する場合、以下の追加オプションを利用できます。
- [最長の変化が発生した時間] - ピクセルに変化フラグが付与された日付で、発生期間が最も長かった変化の開始時または終了時の日付。
- [最短の変化が発生した時間] - ピクセルに変化フラグが付与された日付で、発生期間が最も短かった変化の開始時または終了時の日付。
- [最も早い変化が発生した時間] - ピクセルに変化フラグが付与された日付で、最も早く終了した変化の開始時または終了時の日付。
- [最も遅い変化が発生した時間] - ピクセルに変化フラグが付与された日付で、最も遅く終了した変化の開始時または終了時の日付。
詳細については、「LandTrendr を使用した変化の解析 (Analyze Changes Using LandTrendr) ツールの詳細」をご参照ください。
出力はマルチバンド ラスターとなり、各バンドには、選択した変化タイプと指定した最大変化数に応じた変化情報が含まれています。たとえば、[変化タイプ] パラメーターが [最古の変化が発生した時間] に設定され、[最大変化数] パラメーターが「2」に設定されている場合、ツールは全ピクセルの時系列全体で変化が発生した最も古い 2 つの日付を計算します。その結果、最初のバンドには各ピクセルで変化が発生した最も古い日付が含まれ、2 番目のバンドには各ピクセルで変化が発生した 2 番目に古い日付が含まれたラスターが生成されます。
このツールを [LandTrendr を使用した変化の解析 (Analyze Changes Using LandTrendr)] ツールからの出力で実行する場合、[セグメントの日付] パラメーターを使用して変化の開始時と終了時のどちらの日付を抽出するかを選択できます。たとえば、時系列の最新の変化がどのように始まったかを理解するには、[変化タイプ] パラメーターを [最新の変化が発生した時間] に設定し、[セグメントの日付] パラメーターを [セグメント開始時] に設定します。
次のフィルタリング パラメーターを使用して、変化解析ラスターからより具体的な変化日を抽出します。
- [年によるフィルター] - たとえば 5 年間の干ばつによって風景に発生した変化を調べる場合など、特定の期間内に発生した変化を識別します。
- [期間によるフィルター] - たとえば 1 ~ 2 年の間に起こった急激な変化だけを調べる場合など、所定範囲の年の間に発生した変化を識別します。式 end year - start year +1 を使用して関心のある期間を計算できます。時系列のギャップが含まれます。
- [強度によるフィルター] - たとえば植生指数 NDVI の大きな変化だけを調べる場合など、所定強度の変化を識別します。強度は絶対値なので、最小値と最大値を負にすることはできません。変化の方向性を指定するには、[変化方向] パラメーターを使用します。
構文
DetectChangeUsingChangeAnalysisRaster(in_change_analysis_raster, {change_type}, {max_number_changes}, {segment_date}, {change_direction}, {filter_by_year}, {min_year}, {max_year}, {filter_by_duration}, {min_duration}, {max_duration}, {filter_by_magnitude}, {min_magnitude}, {max_magnitude})
パラメーター | 説明 | データ タイプ |
in_change_analysis_raster | [CCDC を使用した変化の解析 (Analyze Changes Using CCDC)] ツールまたは [LandTrendr を使用した変化の解析 (Analyze Changes Using LandTrendr)] ツールから生成された変化解析ラスターです。 | Raster Dataset; Raster Layer; Image Service |
change_type (オプション) | 各ピクセルで計算する変化情報を指定します。
| String |
max_number_changes (オプション) | 計算されるピクセルごとの変化の最大値です。この数は、入力ラスターのバンド数に対応しています。デフォルトは 1 です。この場合、計算される変化日付は 1 つの みで、出力ラスターには 1 つのバンドのみが含まれます。 このパラメーターは、change_type パラメーターが NUM_OF_CHANGES に設定されていると使用できません。 | Long |
segment_date (オプション) | 変化セグメントの開始時の日付を抽出するか、終了時の日付を抽出するかを指定します。 このパラメーターは、入力された変化解析ラスターが [LandTrendr を使用した変化の解析 (Analyze Changes Using LandTrendr)] ツールからの出力である場合にのみ使用できます。
| String |
change_direction (オプション) | 解析に含める変化の方向性を指定します。 このパラメーターは、入力された変化解析ラスターが [LandTrendr を使用した変化の解析 (Analyze Changes Using LandTrendr)] ツールからの出力である場合にのみ使用できます。
| String |
filter_by_year (オプション) | 年の範囲でフィルタリングするかどうかを指定します。
| Boolean |
min_year (オプション) | フィルター結果を使用する最も古い年です。このパラメーターは、filter_by_year パラメーターが FILTER_BY_YEAR に設定されている場合に必要です。 | Long |
max_year (オプション) | フィルター結果を使用する最新の年です。 このパラメーターは、filter_by_year パラメーターが FILTER_BY_YEAR に設定されている場合に必要です。 | Long |
filter_by_duration (オプション) | 変更期間でフィルタリングするかどうかを指定します。 このパラメーターは、入力された変化解析ラスターが [LandTrendr を使用した変化の解析 (Analyze Changes Using LandTrendr)] ツールからの出力である場合にのみ使用できます。
| Boolean |
min_duration (オプション) | 結果に含める連続した年の最小数です。 このパラメーターは、filter_by_duration パラメーターが FILTER_BY_DURATION に設定されている場合に必要です。 | Double |
max_duration (オプション) | 結果に含める連続した年の最大数です。 このパラメーターは、filter_by_duration パラメーターが FILTER_BY_DURATION に設定されている場合に必要です。 | Double |
filter_by_magnitude (オプション) | 変更の強度でフィルタリングするかどうかを指定します。
変更の強度でフィルタリングするかどうかを指定します。
| Boolean |
min_magnitude (オプション) | 結果に含める最小強度です。 このパラメーターは、filter_by_magnitude パラメーターが FILTER_BY_DURATION に設定されている場合に必要です。 | Double |
max_magnitude (オプション) | 結果に含める最大強度です。 このパラメーターは、filter_by_duration パラメーターが FILTER_BY_DURATION に設定されている場合に必要です。 | Double |
戻り値
名前 | 説明 | データ タイプ |
out_raster | 検出された変化情報を含む出力ラスター。 | Raster |
コードのサンプル
この例では、変更が 0.25 から 2 の間の強度であった NDVI 回復の最長期間 (増加値) の終了日を返します。
# Import system modules
import arcpy
from arcpy.ia import *
# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
# Execute
dateOfLongestChange = arcpy.ia.DetectChangeUsingChangeAnalysis(
"LandTrendr_NDVI_Change_Analysis.crf", "TIME_OF_LONGEST_CHANGE", 1, "INCREASE",
"NO_FILTER_BY_YEAR",None,None,"NO_FILTER_BY_DURATION",None,None,"FILTER_BY_MAGNITUDE",
0.25,2)
# Save output
dateOfLongestChange.save(r"C:\data\NDVI_LongestChange.crf")
この例では、Landsat 時系列でピクセルが変更された合計回数を返します。
# Import system modules
import arcpy
from arcpy.ia import *
# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
# Define input parameters
in_change_analysis = r"C:\data\Landsat_ChangeAnalysis.crf"
change_type = "NUM_OF_CHANGES"
# Execute
number_of_changes = arcpy.ia.DetectChangeUsingChangeAnalysis(
in_change_analysis, change_type)
# Save output
number_of_changes.save("C:/data/NumberOfChanges_Landsat.crf")
環境
ライセンス情報
- Basic: 次のものが必要 Image Analyst
- Standard: 次のものが必要 Image Analyst
- Advanced: 次のものが必要 Image Analyst