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")