Python ArcGIS analyze_changes_using_landtrendr用法及代碼示例

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

用法:

arcgis.raster.analytics.analyze_changes_using_landtrendr(input_multidimensional_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, output_name=None, context=None, *, gis=None, future=False, **kwargs)

返回：

影像圖層項目

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

Parameter	Description
input_multidimensional_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 - 不包括其他頻段。這是默認設置。 例子： 2
output_name	可選的。如果未提供，則由該方法創建影像服務並將其用作輸出柵格。您可以從 GIS 中傳入現有的影像服務項目來使用它。或者，您可以傳入應通過此方法創建的輸出圖像服務的名稱，以用作工具的輸出。如果該名稱的服務已經存在，則會引發 RuntimeError
context	上下文包含影響任務執行的其他設置。 context 參數覆蓋通過arcgis.env 參數設置的值 此函數具有以下設置： Extent(範圍)：定義分析區域的邊界框。 例子： {“extent”: {“xmin”: -122.68, “ymin”: 45.53, “xmax”: -122.45, “ymax”: 45.6, “spatialReference”: {“wkid”: 4326}}} 輸出空間參考 (outSR)：輸出柵格將投影到輸出空間參考中。 Example: {“outSR”: {spatial reference}} 捕捉柵格 (snapRaster)：輸出柵格的像元將與指定的捕捉柵格對齊。 Example: {‘snapRaster’: {‘url’: ‘<image_service_url>’}} 像元大小(cellSize)：輸出柵格將具有由像元大小指定的分辨率。 Example: {‘cellSize’: 11} or {‘cellSize’: {‘url’: <image_service_url>}} or {‘cellSize’: ‘MaxOfIn’} 並行處理因子(parallelProcessingFactor)：控製光柵處理(CPU)服務實例。 Example: Syntax example with a specified number of processing instances: {“parallelProcessingFactor”: “2”} Syntax example with a specified percentage of total processing instances: {“parallelProcessingFactor”: “60%”}
gis	可選的 GIS 對象。如果未指定，則使用當前活動的連接。
future	僅關鍵字參數。可選的布爾值。如果為 True，則結果將是一個 GPJob 對象，並且結果將異步返回。
folder	僅關鍵字參數。可選的 str 或 dict。使用給定的文件夾名稱在門戶中創建一個文件夾(如果不存在)，並將輸出保留在此文件夾中。 create_folder() 返回的字典也可以作為輸入傳入。 例子： {‘username’: ‘user1’, ‘id’: ‘6a3b77c187514ef7873ba73338cf1af8’, ‘title’: ‘trial’}
tiles_only	僅關鍵字參數。可選的布爾值。在 AGOL 上，此函數的默認輸出影像服務是平鋪影像圖層。 要在 ArcGIS Online 上創建動態影像圖層作為輸出，請將 tiles_only 參數設置為 False。 函數在企業版上不支持tiles_only參數，默認生成動態影像圖層。

例子：

# Usage Example 1:
analyze_changes_using_landtrendr_op = analyze_changes_using_landtrendr(input_multidimensional_raster=input_multidimensional_raster,
                                                                   processing_band="Band_1")