Python ArcGIS landtrendr_analysis用法及代碼示例

本文簡要介紹 python 語言中 arcgis.raster.functions.landtrendr_analysis 的用法。

用法:

arcgis.raster.functions.landtrendr_analysis(raster, processing_band=None, snapping_date='06-30', max_num_segments=5, vertex_count_overshoot=2, spike_threshold=0.9, recovery_threshold=0.25, prevent_one_year_recovery=True, increasing_recovery_trend=True, min_num_observations=6, best_model_proportion=1.25, pvalue_threshold=0.01, output_other_bands=False)

返回：

應用了函數的輸出柵格。

函數使用基於 Landsat 的幹擾和恢複趨勢檢測 (LandTrendr) 方法評估像素值隨時間的變化，並生成包含模型結果的變化分析柵格。

注意：

此柵格函數僅支持與 detect_change_using_change_analysis_raster 函數結合使用。要保留輸出，請將 landtrendr_analysis 函數的輸出作為 detect_change_using_change_analysis_raster() 方法的輸入，並在結果層上使用 save() 方法。

Parameter	Description
raster	必需的 Raster / ImageryLayer 對象。輸入多維柵格。
processing_band	可選字符串。用於分割像素值軌跡隨時間變化的波段。選擇最能捕捉您想要觀察的特征變化的波段。 例子： “Band_1”
snapping_date	可選字符串。用於在輸入多維數據集中為每一年選擇切片的日期。將選擇日期最接近捕捉日期的切片。如果輸入數據集包含sub-yearly 數據，則此參數是必需的。 默認值為“06-30”(或 6 月 30 日)，大約在一個日曆年的中間。 例子： “06-30”
max_num_segments	可選整數。適合每個像素的時間序列的最大分段數。默認值為 5。 例子： 5
vertex_count_overshoot	可選整數。 max_num_segments + 1 之外的額外頂點數，可用於在識別頂點的初始階段擬合模型。稍後在建模過程中，附加頂點的數量將減少到max_num_segments + 1。默認為2。 例子： 2
spike_threshold	可選浮點數。用於抑製像素值軌跡中的尖峰或異常的閾值。該值必須介於 0 和 1 之間，其中 1 表示無阻尼。默認值為 0.9。 例子： 0.9
recovery_threshold	可選浮點數。回收閾值，以年為單位。如果某個段的恢複率快於 1/恢複閾值，則該段將被丟棄並且不包含在時間序列模型中。該值必須介於 0 和 1 之間。默認值為 0.25。 例子： 0.25
prevent_one_year_recovery	可選的布爾值。指定是否將排除顯示一年恢複的段。 真 - 表現出一年恢複的細分將被排除在外。這是默認設置。 錯誤 - 不排除表現出一年恢複的細分。 例子： True
increasing_recovery_trend	可選的布爾值。指定恢複是否具有增加(正)趨勢。 真 - 複蘇有增加的趨勢。這是默認設置。 False - 複蘇呈下降趨勢。 例子： True
min_num_observations	可選整數。執行擬合所需的最小有效觀察數。輸入多維數據集中的年數必須等於或大於此值。默認值為 6。 例子： 6
best_model_proportion	可選浮點數。最佳模型比例值。在模型選擇過程中，該工具將計算每個模型的 p 值，並根據該比例值選擇具有最多頂點的模型，同時保持最小(最顯著)的 p 值。值為 1 表示模型具有最低的 p 值，但頂點數量可能不多。默認值為 1.25。 例子： 1.25
pvalue_threshold	可選浮點數。要選擇的模型的 p 值閾值。在模型擬合的初始階段檢測到頂點後，該工具將擬合每個線段並計算 p 值以確定模型的顯著性。在下一次迭代中，模型會將段數減少 1 並重新計算 p 值。這將繼續下去，如果 p 值小於此參數中指定的值，則將選擇模型，並且工具將停止搜索更好的模型。如果未選擇此類模型，該工具將選擇 p 值小於最低 p 值 × 最佳模型比例值的模型。默認值為 0.01。 例子： 0.01
output_other_bands	可選的布爾值。指定是否將其他波段包括在分段過程中。 True - 將包括其他頻段。 processing_band 參數中指定的初始分割波段的分割和頂點信息也將擬合到多波段圖像中的剩餘波段。模型結果將首先包括分割波段，然後是其餘波段。 False - 不包括其他頻段。這是默認設置。 例子： True

例子：

# Usage Example 1:
landtrendr_analysis_op = landtrendr_analysis(raster=input_multidimensional_raster,
                                             processing_band="Band_1"
                                            )