返回顶部

创建时空立方体 (GeoAnalytics)

在本主题中

  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息

摘要

通过将一组点聚合到时空立方图格的方法将其汇总到 netCDF 数据结构中。 在每个立方图格内计算点计数并聚合指定属性。 对于所有立方图格位置，评估计数趋势和汇总字段值。

旧版本：

ArcGIS GeoAnalytics Server 扩展模块在 ArcGIS Enterprise 中处于弃用状态。 GeoAnalytics Server 的最终版本包含在 ArcGIS Enterprise 11.3 中。 可通过 ArcGIS Enterprise 11.3 及较早版本获取此地理处理工具。

插图

“创建时空立方体”工具图示

使用情况

  • 此工具可将点图层要素聚合到时空立方图格中。 所创建的数据结构可被视为由时空立方图格组成的一个三维立方体，其中 x 和 y 维度表示空间，t 维度表示时间。

    三维立方体中的时空立方图格

  • 每个立方图格在空间 (x,y) 和时间 (t) 中都有固定位置。 覆盖同一个 (x, y) 区域的立方图格共用同一个位置 ID。 包含相同持续时间的立方图格共用相同的时间步长 ID。 由于即使点数据并非矩形，立方体始终为矩形，因此某些位置的所有时间步长的点计数也将为零。 对于许多分析，只有带有数据的位置（至少一个时间步长的至少一个点计数大于 1）将包括在分析中。

    时空立方体中的位置

  • 时空立方体中每个立方图格都具有 LOCATION_ID、time_step_ID 和 COUNT 字段值以及创建立方体后聚合的所有汇总字段值。 与同一物理位置相关的立方图格将共享同一位置 ID，这些立方图格组合起来可表示时间序列。 与同一时间步长间隔相关的立方图格将共享同一时间步长 ID，这些立方图格组合起来可构成时间片。 每个立方图格的计数值反映在相关时间步长间隔内出现在相关位置的点的数量。

  • 点图层参数必须为点，例如犯罪或火灾、疾病事件、客户销售数据或交通事故。 每个点都必须具有与其关联的日期。 此工具最少需要 60 个点和多个时间戳。 如果指定的参数将导致立方体具有二十多亿个立方图格，则此工具将无法执行。

  • 此工具需要使用投影数据来准确测量距离。

  • 此工具的输出是表示输入点的 netCDF。 生成的时空立方体将会直接下载到您运行分析的机器中。 具体位置将在工具信息中指定。

  • 数据集具有等间距的时间分布是很常见的情况。 例如，您的年度数据可能全部位于每年的 1 月 1 日，或者月度数据时间戳全部是每月的第一天。 此类数据通常被称为固定样本数据。 通过样本数据，时间偏差计算将经常显示非常大的百分比。 这属于预期行为，因为每个立方图格仅覆盖给定的时间步长中的一个特定时间单位。 例如，如果您选择 1 年作为时间间隔，并且您的数据分布在每年的 1 月 1 日，则每个立方图格将仅覆盖一年中的一天。 这是可以接受的，因为其适用于每一立方图格。 由于立方图格创建参数，而不是真实数据分布，时间偏差仅表示特定立方图格时出现问题。 重要的是基于数据分布就每个立方图格的预期覆盖评估时间偏差。

  • 输出报告中的时间偏差计算的是不存在任何数据的时间跨度的百分比。 例如，空立方图格的时间偏差为 100%。 对于时间跨度为 1 个月、时间间隔对齐为结束时间，且第一个时间步长只有后两周具有数据的立方图格，其第一个时间步长中的时间偏差为 50%。 对于时间跨度为 1 个月、时间间隔对齐为开始时间，且最后一个时间步长只有前两周具有数据的立方图格，其最后一个时间步长中的时间偏差为 50%。

  • 时空立方体创建完成后，无法再对立方体的空间范围进行扩展。

  • 参考时间参数可以是日期和时间值或仅为日期值，但不可仅为时间值。

  • 请使用对您的分析有意义的距离间隔。 存在一个导致点数据中基础模式丢失的过大距离间隔，且存在一个立方体以零计数填充的过小距离间隔，请在这两者之间找到一个平衡点。

  • 在聚合计数数据和汇总字段值上执行的趋势分析是以 Mann-Kendall 统计为基础的。

  • 使用此工具可对属性聚合执行以下统计运算：总和、平均值、最小值、最大值和标准差。

  • 通过 SPATIAL_NEIGHBORS 填充空立方图格时，将使用二阶将（其中包括相邻要素和相邻要素的相邻要素）Queens Case 邻接（基于边和角的邻接）。 使用此选项填充空立方图格最少需要 4 个空间相邻要素。

  • 通过 SPACE_TIME_NEIGHBORS 填充空立方图格时，将使用二阶将（其中包括相邻要素和相邻要素的相邻要素）Queens Case 邻接（基于边和角的邻接）。 此外，通过向前和向后移动 2 个时间步长将时间相邻要素用于将作为空间相邻要素的每个立方图格。 使用此选项填充空立方图格最少需要 13 个时空相邻要素。

  • 通过 TEMPORAL_TREND 填充空立方图格时，给定位置的前两个时间段和后两个时间段在其立方图格中必须具有值，以便对该位置的其他时间段进行插值。

  • 任何汇总字段记录中出现的空值都将导致从分析中排除这些要素。 如果每个立方图格中的点数均为分析策略的一部分，需要考虑创建单独的立方体，针对计数（不含汇总字段）创建一个，并针对汇总字段创建一个。 如果每个汇总字段的空值集不相同，需要考虑为每个汇总字段创建一个单独的立方体。

  • 此地理处理工具由 ArcGIS GeoAnalytics Server 作为支持。 GeoAnalytics Server 上的分析已完成，结果将存储在 ArcGIS Enterprise 的内容中。

  • 当运行 GeoAnalytics Server 工具时，GeoAnalytics Server 上的分析已完成。 要获得最佳性能，通过 ArcGIS Enterprise 门户上托管的要素图层或通过大数据文件共享，可以将数据用于 GeoAnalytics Server。 在分析开始之前，非 GeoAnalytics Server 本地数据将被转移到您的 GeoAnalytics Server。 这意味着运行工具需要更长时间，并且在某些情况下，从 ArcGIS Pro 到 GeoAnalytics Server 移动数据可能会失败。 失败的阈值取决于网络速度，以及数据的大小和复杂性。 建议您始终共享数据或创建大数据文件共享。

    了解有关将数据共享至您的门户的详细信息。

    了解有关通过 Server Manager 创建大数据文件共享的详细信息

  • 还可使用以下方法完成相似性分析：

    • 时空模式挖掘工具箱中的通过聚合点创建时空立方体工具。

参数

对话框Python

标注说明数据类型
点图层

将聚合到时空立方图格的输入点要素类。

Feature Set
输出名称

将创建输出 netCDF 数据立方体以包含输入要素点数据的计数和汇总。

String
距离间隔

立方图格尺寸将用于聚合点图层。 将对相同距离间隔和时间间隔内的所有点进行聚合。

确定立方图格大小的距离。

Linear Unit
时间间隔

用来表示单个时间步长的秒数、分钟数、小时数、天数、周数或年数。 将对相同时间间隔和距离间隔内的所有点进行聚合。 此参数的有效条目示例为 1 周、13 天或 1 个月。

Time Unit
时间间隔对齐
(可选)

指定如何根据时间间隔（Python 中的 time_step_interval）参数进行聚合。

  • 结束时间—时间步长将与最后一次时间事件对齐，并向后聚合时间。
  • 开始时间—时间步长将与第一次时间事件对齐，并向前聚合时间。
  • 参考时间—时间步长将与指定日期或时间对齐。 如果输入要素中的所有点具有的时间戳大于指定的参考时间（或时间戳刚好位于输入要素的开始时间），则时间步长间隔将以该参考时间为起始时间，并向前聚合时间（与使用起始时间对齐的情况相同）。 如果输入要素中的所有点具有的时间戳小于指定的参考时间（或时间戳刚好位于输入要素的结束时间），则时间步长间隔将以该参考时间为结束时间，并向后聚合时间（与使用结束时间对齐的情况相同）。 如果指定的参考时间处于数据时间范围的中间，则将以提供的参考时间结束创建时间步长间隔（与使用结束时间对齐的情况相同）；其他间隔将在参考时间前后进行创建，直到覆盖数据的完整时间范围为止。
String
参考时间
(可选)

将用于对齐时间步长间隔的日期或时间。 例如，如果要按星期从星期一至星期天对数据进行归类，请将星期天的午夜设置为参考时间，以确保立方图格在星期天和星期一之间的午夜进行划分。

Date
汇总字段
(可选)

包含将用于在聚合到时空立方体时计算指定统计数据的属性值的数值字段。 可以指定多项统计和字段组合。 空值将被排除在所有统计计算之外。

Value Table

派生输出

标注说明数据类型
输出文件

聚合的时空立方体。

File

arcpy.geoanalytics.CreateSpaceTimeCube(point_layer, output_name, distance_interval, time_step_interval, {time_step_interval_alignment}, {reference_time}, {summary_fields})
名称说明数据类型
point_layer

将聚合到时空立方图格的输入点要素类。

Feature Set
output_name

将创建输出 netCDF 数据立方体以包含输入要素点数据的计数和汇总。

String
distance_interval

确定立方图格大小的距离。

立方图格尺寸将用于聚合 point_layer。 将对相同 distance_interval 和 time_step_interval 内的所有点进行聚合。

Linear Unit
time_step_interval

用来表示单个时间步长的秒数、分钟数、小时数、天数、周数或年数。 将对位于同一 time_step_interval 和 distance_interval 内的所有点进行聚合。 此参数的有效条目示例为 1 周、13 天或 1 个月。

Time Unit
time_step_interval_alignment
(可选)

指定如何根据时间间隔（Python 中的 time_step_interval）参数进行聚合。

  • END_TIME—时间步长将与最后一次时间事件对齐，并向后聚合时间。
  • START_TIME—时间步长将与第一次时间事件对齐，并向前聚合时间。
  • REFERENCE_TIME—时间步长将与指定日期或时间对齐。 如果输入要素中的所有点具有的时间戳大于指定的参考时间（或时间戳刚好位于输入要素的开始时间），则时间步长间隔将以该参考时间为起始时间，并向前聚合时间（与使用起始时间对齐的情况相同）。 如果输入要素中的所有点具有的时间戳小于指定的参考时间（或时间戳刚好位于输入要素的结束时间），则时间步长间隔将以该参考时间为结束时间，并向后聚合时间（与使用结束时间对齐的情况相同）。 如果指定的参考时间处于数据时间范围的中间，则将以提供的参考时间结束创建时间步长间隔（与使用结束时间对齐的情况相同）；其他间隔将在参考时间前后进行创建，直到覆盖数据的完整时间范围为止。
String
reference_time
(可选)

将用于对齐时间步长间隔的日期或时间。 例如，如果要按星期从星期一至星期天对数据进行归类，请将星期天的午夜设置为参考时间，以确保立方图格在星期天和星期一之间的午夜进行划分。

Date
summary_fields
[summary_fields,...]
(可选)

包含将用于在聚合到时空立方体时计算指定统计数据的属性值的数值字段。 可以指定多项统计和字段组合。 空值将被排除在所有统计计算之外。

Value Table

派生输出

名称说明数据类型
output

聚合的时空立方体。

File

代码示例

CreateSpaceTimeCube（独立脚本）

以下 Python 脚本演示了如何使用 CreateSpaceTimeCube 函数。

#-------------------------------------------------------------------------------
# Name: CreateSpaceTimeCube.py
# Description: Create a cube representing the counts of Crimes

# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Crimes/BigDataCatalogServer/Chicago"
outCube = "CrimeCube.nc"

# Run Create Space Time Cube
arcpy.geoanalytics.CreateSpaceTimeCube(inFeatures, outCube, "1 Kilometers", 
                                       "1 Weeks", "START_TIME")

环境

输出坐标系, 范围, 当前工作空间

特殊情况

输出坐标系

将用于分析的坐标系。 除非由该参数进行指定，否则将基于输入坐标系完成分析。 对于 GeoAnalytics Tools，最终结果将存储于 WGS84 中的时空数据存储之内。

许可信息

  • Basic: 需要 ArcGIS GeoAnalytics Server
  • Standard: 需要 ArcGIS GeoAnalytics Server
  • Advanced: 需要 ArcGIS GeoAnalytics Server

相关主题

  • 分析模式工具集概述
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息