Python ArcGIS reconstruct_tracks用法及代碼示例

本文簡要介紹 python 語言中 arcgis.geoanalytics.summarize_data.reconstruct_tracks 的用法。

用法:

arcgis.geoanalytics.summarize_data.reconstruct_tracks(input_layer, track_fields, method='Planar', buffer_field=None, summary_fields=None, distance_split=None, distance_split_unit=None, time_boundary_split=None, time_boundary_split_unit=None, time_boundary_reference=None, output_name=None, gis=None, time_split=None, time_split_unit=None, context=None, future=False, arcade_split=None, split_boundary=None)

返回：

FeatureLayerCollection

reconstruct_tracks 任務與代表時間點的點或麵要素的time-enabled 圖層一起使用。它首先使用標識符確定哪些特征屬於軌道。使用每個位置的時間，軌道按順序排列並轉換為表示隨時間移動的路徑的線或多邊形。可選地，輸入可以由一個字段緩衝，這將在每個位置創建一個多邊形。這些緩衝點或多邊形(如果輸入是多邊形)然後按順序連接以創建作為多邊形的軌跡，其中寬度代表感興趣的屬性。生成的軌跡具有開始和結束時間，它們表示給定軌跡中第一個和最後一個特征的時間。創建軌跡後，將計算輸入要素的統計數據並將其分配給輸出軌跡。最基本的統計數據是區域內的點數，但也可以計算其他統計數據。 time-enabled 層中的特征可以用以下兩種方式之一表示：

• Instant - A single moment in time

• Interval - A start and end time

例如，假設您每 10 分鍾進行一次颶風的 GPS 測量。每次 GPS 測量都會記錄颶風名稱、位置、記錄時間和風速。您可以使用颶風的名稱作為軌跡標識創建颶風的軌跡，並且將生成所有颶風的軌跡。您可以計算統計數據，例如每次颶風的平均、最大和最小風速，以及每個軌道的測量計數。

Parameter	Description
input_layer	必需的層。將從其構造軌跡的點或麵要素。請參閱特征輸入。
track_fields	必需的字符串。用於識別不同軌道的字段。可以有多個 track_fields 。
method	可選字符串。用於應用重建軌道以及可選地應用緩衝區的方法。有兩種方法可供選擇： Planar - 此方法使用平麵方法連接點，不會越過國際日期變更線。對於緩衝區，此方法應用歐幾裏德緩衝區，適用於投影數據的本地分析。這是默認設置。 Geodesic - 此方法以測地線連接點，並允許軌道跨越國際日期變更線。對於緩衝區，此方法適用於大麵積區域和任何地理坐標係。 默認值為“平麵”。
buffer_field	可選字符串。 input_layer 中包含緩衝區距離或緩衝區表達式的字段。
summary_fields	可選的字典列表。您要計算的字段名稱和統計匯總類型的列表。 注意： 始終返回count。默認情況下，返回所有統計信息。 用法:[{"statisticType" : "<statistic type>", "onStatisticField" : "<field name>" }, ...] onStatisticField is the name of the field in the target layer. statisticType is one of the following: for numeric fields: Count - Totals the number of values of all the points in each polygon. Sum - Adds the total value of all the points in each polygon. Mean - Calculates the average of all the points in each polygon. Min - Finds the smallest value of all the points in each polygon. Max - Finds the largest value of all the points in each polygon. Range - Finds the difference between the Min and Max values. Stddev - Finds the standard deviation of all the points in each polygon. Var - Finds the variance of all the points in each polygon. First - Returns the first value of a specified field in the summarized track. This parameters was introduced at ArcGIS Enterprise 10.8.1. Last - Returns the last value of a specified field in the summarized track. This parameters was introduced at ArcGIS Enterprise 10.8.1. for string fields: Count - Totals the number of strings for all the points in each polygon. Any - Returns a sample string of a point in each polygon.e of all the points in each polygon. First - Returns the first value of a specified field in the summarized track. This parameters was introduced at ArcGIS Enterprise 10.8.1. Last - Returns the last value of a specified field in the summarized track. This parameters was introduced at ArcGIS Enterprise 10.8.1.
time_boundary_split	可選整數。時間邊界允許您在定義的時間跨度內分析值。例如，如果您使用 1 天的時間邊界，則從 1980 年 1 月 1 日開始，將一次分析 1 天的軌道。 ArcGIS Enterprise 10.7 中引入了時間邊界參數。 time_boundary_split 參數定義時間邊界的比例。在上述情況下，這將是 1。
time_boundary_split_unit(如果指定了time_boundary_split，則為必需)	可選字符串。應用於時間邊界的單位。如果提供了 time_boundary_split，則為必需。 選擇清單： Years Months Weeks Days Hours Minutes Seconds Milliseconds
time_boundary_reference	可選的日期時間.日期時間。指定時間邊界對齊的參考時間的日期，以紀元開始的毫秒數表示。僅當設置了 time_boundary_split 和 time_boundary_split_unit 時，此選項才可用。
distance_split	可選浮點數。用於分割軌道的距離。 input_layer 中位於同一軌道中且相距大於此距離的任何要素都將被拆分為新軌道。距離值的單位由distance_split_unit 參數提供。 如果同時使用distance_split 和time_split，則在滿足至少一個條件時拆分軌道。
distance_split_unit(如果指定了distance_split，則為必需)	可選字符串。與 distance_split 中指定的距離值一起使用的距離單位。 選擇清單： Meters Kilometers Feet Miles NauticalMiles Yards
output_name	可選字符串。該任務將創建結果的要素服務。您定義服務的名稱。
gis	可選，運行此工具的 GIS 。如果未指定，則使用活動 GIS。
time_split	可選整數。用於分割音軌的持續時間。 input_layer 中位於同一軌道中且大於此時間的任何要素都將被拆分到新軌道中。距離值的單位由time_split 參數提供。 如果同時使用distance_split 和time_split，則在滿足至少一個條件時拆分軌道。
time_split_unit(如果指定了time_split，則為必需)	可選字符串。與 time_split 中指定的時間距離值一起使用的時間單位。 選擇清單： Years Months Weeks Days Hours Minutes Seconds Milliseconds
context	可選字典。 context 參數包含影響任務執行的其他設置。對於此任務，有四個設置： extent - A bounding box that defines the analysis area. Only those features that intersect the bounding box will be analyzed. processSR - The features will be projected into this coordinate system for analysis. outSR - The features will be projected into this coordinate system after the analysis to be saved. The output spatial reference for the spatiotemporal big data store is always WGS84. dataStore - Results will be saved to the specified data store. For ArcGIS Enterprise, the default is the spatiotemporal big data store.
future	可選布爾值。如果 True ，則返回 GPJob 而不是結果。可以查詢 GPJob 的執行狀態。 默認值為 False 。
arcade_split	可選字符串。基於值、幾何或時間值分割軌跡的表達式。驗證為 true 的表達式將被拆分。此參數僅適用於 ArcGIS Enterprise 10.9 及更高版本。默認值為 None 。
split_boundary	可選字符串。 指定分割軌跡時如何創建兩個要素之間的軌跡段。拆分類型應用於拆分表達式、距離拆分和時間拆分。此參數僅適用於 ArcGIS Enterprise 10.9 及更高版本。 Gap - 兩個特征之間沒有創建段。這是指定None 時的默認值。 FinishLast - 在分割後結束的兩個特征之間創建一個段。 StartNext - 在分割前結束的兩個特征之間創建一個段。 默認值為 None 。

例子：

# Usage Example: To reconstruct hurricane tracks.

tracks = reconstruct_tracks(input_layer=hurricane_lyr,
                            track_fields='season, trackID',
                            method='Geodesic',
                            buffer_field='size',
                            summary_fields=[{"statisticType" : "Range", "onStatisticField" : "Wind" }],
                            distance_split=1,
                            distance_split_unit='Kilometers',
                            time_boundary_split=1,
                            time_boundary_split_unit='Days',
                            output_name='reconstruct hurricane tracks')