Python ArcGIS create_space_time_cube用法及代碼示例

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

用法:

arcgis.geoanalytics.analyze_patterns.create_space_time_cube(point_layer, bin_size, bin_size_unit, time_step_interval, time_step_interval_unit, time_step_alignment=None, time_step_reference=None, summary_fields=None, output_name=None, context=None, gis=None, future=False)

返回：

帶有 url 的字典，其中包含輸出時空立方體 (netCDF) 數據文件的路徑。當您瀏覽到輸出 url 時，您的 netCDF 將自動下載到您的本地計算機。

create_space_time_cube 適用於啟用時間的點要素圖層。它將數據聚合到 space-time 個 bin 的三維立方體中。在確定space-time bin 關係中的點時，會計算有關space-time bin 中所有點的統計信息並將其分配給 bin。最基本的統計數據是 bin 內的點數，但您也可以計算其他統計數據。例如，假設您有一個城市犯罪的點特征，並且您想在空間和時間上匯總犯罪數量。您可以為數據集計算space-time立方體，並使用立方體進一步分析新興熱點和冷點等趨勢。

Parameter	Description
point_layer	所需的點要素圖層。將聚合到由 bin_size 和 bin_size_unit 參數指定的地理大小以及由 time_step_interval 和 time_step_interval_unit 參數指定的時間大小的箱中的點要素。請參閱特征輸入。 注意： input_layer 必須至少有 60 個函數。 注意： 使用 bin 進行分析需要投影坐標係。將圖層聚合到 bin 中時，輸入圖層或處理範圍 (processSR) 必須具有投影坐標係。在 10.5.1、10.6 和 10.6.1 中，如果在運行分析時未指定投影坐標係，將使用世界圓柱等麵積 (WKID 54034) 投影。在 10.7 或更高版本中，如果在運行分析時未指定投影坐標係，則會根據數據範圍選取投影。
bin_size	所需浮點數。 point_layer 將聚合到的 bin 的距離。
bin_size_unit	必需的字符串。 point_layer 將聚合到的 bin 的距離單位。 選擇清單： Feet Yards Miles Meters Kilometers NauticalMiles
time_step_interval	必需的整數。指定時間段持續時間的數值。 注意： create_space_time_cube 必須至少有 10 個時間片。
time_step_interval_unit	必需的字符串。指定時間段的持續時間單位的數值。 選擇清單： Years Months Weeks Days Hours Minutes Seconds Milliseconds
time_step_alignment	可選字符串。定義如何根據給定的時間間隔進行聚合。選項如下： 選擇清單： StartTime - Time is aligned to the first feature in time EndTime - Time is aligned to the last feature in time ReferenceTime - Time is aligned a specified time
time_step_reference(如果time_step_alignment 是參考時間則為必需)	可選的日期時間。如果在 time_step_alignment 中指定了 ReferenceTime，則指定參考時間以將時間箱對齊到的日期。
summary_fields	定義字段名稱、統計摘要類型以及要為每個 space-time bin 內的所有點計算的空值的填充選項的可選字典列表。請注意，始終返回每個 bin 內的點數。默認情況下，返回所有統計信息。 格式： [{"statisticType": "statistic type", "onStatisticField": "field name", "fillType": "fill type"}, {"statisticType": "statistic type", "onStatisticField": "fieldName2", "fillType": "fill type"}] statisticType 是以下數字字段之一： 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. Stddev - Finds the standard deviation of all the points in each polygon. 對於字符串字段，statisticType 如下： Count - Totals the number of strings for all the points in each polygon. onStatisticField是輸入點圖層中的字段名稱。 fillType 是以下之一： zeros - Fills missing values with zeros. This is most appropriate for fields representing counts. spatialNeighbors - Fills missing values by averaging the spatial neighbors. Neighbors are determined by a second degree queens contiguity. spaceTimeNeighbors - Fills missing values by averaging the space-time neighbors. Neighbors are determined by a second degree queens contiguity in both space and time. temporalTrend - Interpolates values using a univariate spline.
output_name	必需的字符串。該任務將創建結果的時空立方體 (netCDF)。您定義時空立方體的名稱。
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.
gis	可選，運行此工具的 GIS 。如果未指定，則使用活動 GIS。
future	可選布爾值。如果是 true ，將返回一個 future 對象，並且進程不會等待任務完成。默認為 false ，表示等待結果。

例子：

# Usage Example: To aggregate Chicago homicides date layer into 3-dimensional cubes of 5 miles bin.
create_space_time_cube(point_layer=lyr,
                       bin_size=5,
                       bin_size_unit="Miles",
                       time_step_interval=1,
                       time_step_interval_unit="Days",
                       time_step_alignment='StartTime',
                       time_step_reference=datetime(1995, 10, 4),
                       summary_fields=[{"statisticType": "Mean", "onStatisticField" : "Beat", "fillType" : "temporalTrend" }],
                       output_name="spacecube")