计算动态统计数据 (GeoAnalytics Server 工具)

汇总

计算启用时间的要素类中点的动态统计数据。

旧版本：

即将在 ArcGIS Enterprise 中弃用 ArcGIS GeoAnalytics Server 扩展模块。 GeoAnalytics Server 的最终版本已随 ArcGIS Enterprise 11.3 一同发布。可通过 ArcGIS Enterprise 11.3 及较早版本获取此地理处理工具。

插图

用法

此地理处理工具适用于 ArcGIS Enterprise 10.9 或更高版本。
计算动态统计数据的结果为输入点的副本，其中每个计算的统计数据对应一个新字段。
可指定一个或多个字段来识别唯一实体，也称为轨迹。追踪由一个或多个追踪字段的唯一组合表示。例如，如果将 flightID 和 Destination 字段用作轨迹标识符，则 ID007、Solden、ID007 和 Tokoyo 要素将分别处于两个独立的轨迹，原因是其 Destination 字段值不同。
默认情况下，将尽可能为每个输入点计算所有受支持的统计数据。或者，可选择一组或多组统计数据，以使用动态统计数据参数进行计算。

将为距离组计算以下统计数据字段：
- Distance—从先前观测点行驶到当前观测点的距离。
- TotDistance—轨迹历史记录窗口中观测点之间的行驶距离总和。
- MinDistance—轨迹历史记录窗口中观测点之间的最小行驶距离。
- MaxDistance—轨迹历史记录窗口中观测点之间的最大行驶距离。
- AvgDistance—轨迹历史记录窗口中观测点之间的平均行驶距离。
将为速度组计算以下统计数据字段：
- Speed—从先前观测点行驶到当前观测点的速度。
- MinSpeed—轨迹历史记录窗口中观测点之间的最小速度。
- MaxSpeed—轨迹历史记录窗口中观测点之间的最大速度。
- AvgSpeed—轨迹历史记录窗口中观测点之间的距离总和除以轨迹历史记录窗口中观测点之间的持续时间总和。
将为加速度组计算以下统计数据字段：
- Acceleration—当前速度与先前速度之间的差值除以当前持续时间。
- MinAcceleration—在轨迹历史记录窗口中计算的最小加速度。
- MaxAcceleration—在轨迹历史记录窗口中计算的最大加速度。
- AvgAcceleration—轨迹历史记录窗口中当前速度与第一个速度之间的差值除以轨迹历史记录窗口中观测点之间的持续时间总和。
将为持续时间组计算以下统计数据字段：
- Duration—自前一观测点起经历的时间。
- TotDuration—轨迹历史记录窗口中持续时间的总和。
- MinDuration—轨迹历史记录窗口中的最短持续时间。
- MaxDuration—轨迹历史记录窗口中的最长持续时间。
- AvgDuration—轨迹历史记录窗口中的持续时间总和除以轨迹历史记录窗口中计算的持续时间数。
将为高程组计算以下统计数据字段：
- Elevation—观测点的当前高程。
- ElevChange—当前高程与先前高程之差。
- TotElevChange—轨迹历史记录窗口中点之间的高程变化总和。其必须为负值。
- MinElevation—轨迹历史记录窗口中的最小高程。
- MaxElevation—轨迹历史记录窗口中的最大高程。
- AvgElevation—轨迹历史记录窗口中的高程总和除以轨迹历史记录窗口中的观测点数。
将为坡度组计算以下统计数据字段：
- Slope—当前观测点和先前观测点之间的高程变化与距离之比。
- MinSlope—轨迹历史记录窗口中的最小坡度。
- MaxSlope—轨迹历史记录窗口中的最大坡度。
- AvgSlope—轨迹历史记录窗口中的坡度总和除以轨迹历史记录窗口中计算的坡度数。
将为空闲组计算以下统计数据字段：
- Idling—如果当前观测点与先前观测点之间的距离小于空闲距离容差参数值，并且当前观测点与先前观测点之间的持续时间大于空闲时间容差参数值，则为 True。如果不满足这两个条件之一或全部，则为 False。
- TotIdleTime—轨迹历史记录窗口中符合空闲条件的持续时间总和。
- PctIdleTime—检测到处于空闲状态的时间的百分比。
将为方位角组计算以下统计数据字段：
- Bearing—从先前观测点到当前观测点的行驶角度。
将使用由轨迹历史记录窗口参数定义的当前观测点和多个先前观测点计算以 Min、Max、Avg 或 Tot 开头的统计数据。其他统计数据始终仅使用当前观测点和先前观测点进行计算，而不考虑轨迹历史记录窗口值。例如，如果将轨迹历史记录窗口值设置为 5 并请求速度统计数据组，则将使用当前观测点与前 4 个观测点计算每个观测点的 MinSpeed、MaxSpeed 和 AvgSpeed 字段，而仅使用当前观测点与先前观测点计算每个点的 Speed 字段。 轨迹历史记录窗口参数值必须大于 1。默认值为 3。

下图显示了具有六个点要素的轨迹。将根据每个要素的高程、距离和时间计算统计数据。

一条表示时间的线，沿线有六个点，每个点标注有时间和距离

下表汇总了上图的统计数据计算。所有计算均在点 5 处进行，并且轨迹历史记录窗口为 3。如果观测点在 1 分钟内的移动距离小于 32 米，则该观测点视为空闲。


统计数据	公式	示例
距离		35 m
总距离		80 + 30 + 35 = 145 m
速度	距离/持续时间	35 / 60 = 0.58 m/s
平均速度	总距离/总持续时间	145 / 180 m/s
加速度		(0.58 – 0.5) / 60 = 0.001 m/s2
平均加速度	（速度（最后一个）– 速度（第一个））/（总持续时间）	(0.58 – 1.33) / 60 = -0.01 m/s2
持续时间		60 s
总持续时间		60 + 60 + 60 = 180 s
高程		5 m
高程变化		5 – 4 = 1 m
总高程变化		5 – 0 = 5 m
坡度	高程变化/距离	1 / 35
平均坡度	总高程变化/总距离	5 / 145
空闲		False
总空闲时间		60 s
空闲时间百分比		1 / 3
方位角		0

如果轨迹历史记录中的观测点数小于轨迹历史记录窗口参数值，将使用轨迹历史记录中的所有观测点来计算以 Min、Max、Avg 或 Tot 开头的统计数据。
不会为每个轨迹的第一个要素计算统计数据。不会为每个轨迹中的前两个要素计算加速度组中的统计数据。
结果值将采用距离单位、持续时间单位、速度单位、加速度单位和高程单位参数指定的单位。
计算大轨迹的统计数据时，可以使用时间界限分割参数将大轨迹分割成较小的轨迹以提高性能。
该地理处理工具由 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 创建大数据文件共享的详细信息
可执行以下任意或全部操作来提高计算动态统计数据工具的性能：
- 设置范围环境，以便仅分析感兴趣的数据。
- 降低轨迹历史记录窗口参数值。
- 使用时间界限分割参数按定义的时间间隔分割大轨迹。
- 使用与分析运行位置同属本地的数据。

标注	说明	数据类型
输入图层	将计算动态统计数据的启用时间的点要素。	Feature Set
输出名称	结果图层的名称。	String
轨迹字段	将用于标识不同实体的一个或多个字段。	Field
轨迹历史记录窗口（可选）	将用于汇总统计数据的观测点数（包括当前观测点）。默认值为 3，这意味着将使用当前观测点和前两个观测点在轨迹的每个点上计算汇总统计数据。此参数不会影响瞬时统计数据或空闲分类。	Long
动态统计数据（可选）	指定包含将计算并写入结果的统计数据的组。如果未指定任何值，则将计算所有组的所有统计数据。距离—将计算轨迹历史记录窗口中当前观测点和先前观测点之间的距离以及最大距离、最小距离、平均距离和总距离。持续时间—将计算轨迹历史记录窗口中当前观测点和先前观测点之间的持续时间以及最大持续时间、最小持续时间、平均持续时间和总持续时间。速度—将计算轨迹历史记录窗口中当前观测点和先前观测点之间的行驶速度以及最大行驶速度、最小行驶速度和平均行驶速度。加速度—将计算轨迹历史记录窗口中当前速度和先前速度之间的加速度以及最大加速度、最小加速度和平均加速度。高程—将计算轨迹历史记录窗口中的当前高程、当前高程和先前高程之间的高程变化以及最大高程变化、最小高程变化、平均高程变化和总高程变化。坡度—将计算轨迹历史记录窗口中当前观测点和先前观测点之间的坡度以及最大坡度、最小坡度和平均坡度。空闲—将确定实体当前是否处于空闲状态，并计算轨迹历史记录窗口中的空闲时间百分比和总空闲时间。方位角—将计算先前观测点与当前观测点之间的行驶角度。	String
距离法（可选）	指定在计算动态统计数据时将使用的距离测量方法。测地线—将使用测地线距离。平面—将使用平面距离。这是默认设置。	String
空闲距离容差（可选）	轨迹中的两个连续点视为空闲时可以分开的最大距离。此参数与空闲时间容差参数配合使用以确定实体是否空闲。如果为动态统计数据参数指定了空闲统计数据组，或者如果将计算所有组中的统计数据，则空闲距离容差参数为必需项。	Linear Unit
空闲时间容差（可选）	轨迹中的两个连续点视为空闲时必须彼此靠近的最小持续时间。此参数与空闲距离容差参数配合使用以确定实体是否空闲。如果为动态统计数据参数指定了空闲统计数据组，或者如果将计算所有组中的统计数据，则空闲时间容差参数为必需项。	Time Unit
时间界限分割（可选）	用于分割输入数据以进行分析的时间跨度。您可通过时间界限分析定义的时间跨度内的值。例如，如果您使用始于 1980 年 1 月 1 日的 1 天的时间界限，则轨迹将在每天开始时被分割。此参数仅适用于 ArcGIS Enterprise 10.7 及更高版本。	Time Unit
时间界限参考（可选）	用于分割输入数据以进行分析的参考时间。将为整个数据跨度创建时间界限，且不需要在开始时产生参考时间。如果未指定参考时间，则将使用 1970 年 1 月 1 日。此参数仅适用于 ArcGIS Enterprise 10.7 及更高版本。	Date
距离单位（可选）	指定输出要素类中距离值所使用的测量单位。米—测量单位将为米。这是默认设置。千米—测量单位将为千米。美国测量英里—测量单位将为美国测量英里。美国测量海里—测量单位将为美国测量海里。美国测量码—测量单位将为美国测量码。美国测量英尺—测量单位将为美国测量英尺。法定英里—测量单位将为法定英里。国际海里—测量单位将为国际海里。国际码—测量单位将为国际码。国际英尺—测量单位将为国际英尺。	String
持续时间单位（可选）	指定将用于输出要素类中持续时间值的测量单位。年—测量单位将为年。月—测量单位将为月。周—测量单位将为周。天—测量单位将为天。小时—测量单位将为小时。分—测量单位将为分钟。秒—测量单位将为秒。这是默认设置。毫秒—测量单位将为毫秒。	String
速度单位	指定将用于输出要素类中速度值的测量单位。米/秒—测量单位将为米/秒。这是默认设置。英里/小时—测量单位将为英里/小时。千米/小时—测量单位将为千米/小时。英尺/秒—测量单位将为英尺/秒。海里/小时—测量单位将为海里/小时。	String
加速度单位（可选）	指定将用于输出要素类中加速度值的测量单位。米/平方秒—测量单位将为米/平方秒。这是默认设置。英尺/平方秒—测量单位将为英尺/平方秒。	String
高程单位（可选）	指定将用于输出要素类中高程值的测量单位。米—测量单位将为米。这是默认设置。千米—测量单位将为美国测量千米。美国测量英里—测量单位将为美国测量英里。美国测量码—测量单位将为美国测量码。美国测量英尺—测量单位将为美国测量英尺。法定英里—测量单位将为法定英里。国际码—测量单位将为国际码。国际英尺—测量单位将为国际英尺。	String
数据存储（可选）	指定将用于存储输出的 ArcGIS Data Store。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。时空大数据存储—输出将存储在时空大数据存储中。这是默认设置。关系数据存储—输出将存储在关系数据存储中。	String

派生输出

标注	说明	数据类型
输出要素图层	具有运动统计数据的输出点要素。	Feature Set

arcpy.geoanalytics.CalculateMotionStatistics(input_layer, output_name, track_fields, {track_history_window}, {motion_statistics}, {distance_method}, {idle_dist_tolerance}, {idle_time_tolerance}, {time_boundary_split}, {time_boundary_reference}, {distance_unit}, {duration_unit}, speed_unit, {acceleration_unit}, {elevation_unit}, {data_store})

名称	说明	数据类型
input_layer	将计算动态统计数据的启用时间的点要素。	Feature Set
output_name	结果图层的名称。	String
track_fields [track_fields,...]	将用于标识不同实体的一个或多个字段。	Field
track_history_window （可选）	将用于汇总统计数据的观测点数（包括当前观测点）。默认值为 3，这意味着将使用当前观测点和前两个观测点在轨迹的每个点上计算汇总统计数据。此参数不会影响瞬时统计数据或空闲分类。	Long
motion_statistics [motion_statistics,...] （可选）	指定包含将计算并写入结果的统计数据的组。如果未指定任何值，则将计算所有组的所有统计数据。 `DISTANCE`—将计算轨迹历史记录窗口中当前观测点和先前观测点之间的距离以及最大距离、最小距离、平均距离和总距离。 `DURATION`—将计算轨迹历史记录窗口中当前观测点和先前观测点之间的持续时间以及最大持续时间、最小持续时间、平均持续时间和总持续时间。 `SPEED`—将计算轨迹历史记录窗口中当前观测点和先前观测点之间的行驶速度以及最大行驶速度、最小行驶速度和平均行驶速度。 `ACCELERATION`—将计算轨迹历史记录窗口中当前速度和先前速度之间的加速度以及最大加速度、最小加速度和平均加速度。 `ELEVATION`—将计算轨迹历史记录窗口中的当前高程、当前高程和先前高程之间的高程变化以及最大高程变化、最小高程变化、平均高程变化和总高程变化。 `SLOPE`—将计算轨迹历史记录窗口中当前观测点和先前观测点之间的坡度以及最大坡度、最小坡度和平均坡度。 `IDLE`—将确定实体当前是否处于空闲状态，并计算轨迹历史记录窗口中的空闲时间百分比和总空闲时间。 `BEARING`—将计算先前观测点与当前观测点之间的行驶角度。	String
distance_method （可选）	指定在计算动态统计数据时将使用的距离测量方法。 `GEODESIC`—将使用测地线距离。 `PLANAR`—将使用平面距离。这是默认设置。	String
idle_dist_tolerance （可选）	轨迹中的两个连续点视为空闲时可以分开的最大距离。此参数与 `idle_time_tolerance` 参数配合使用以确定实体是否空闲。如果为 `motion_statistics` 参数指定了 `IDLE` 统计数据组，或者如果将计算所有组中的统计数据，则 `idle_dist_tolerance` 参数为必需项。	Linear Unit
idle_time_tolerance （可选）	轨迹中的两个连续点视为空闲时必须彼此靠近的最小持续时间。此参数与 `idle_dist_tolerance` 参数配合使用以确定实体是否空闲。如果为 `motion_statistics` 参数指定了 `IDLE` 统计数据组，或者如果将计算所有组中的统计数据，则 `idle_time_tolerance` 参数为必需项。	Time Unit
time_boundary_split （可选）	用于分割输入数据以进行分析的时间跨度。您可通过时间界限分析定义的时间跨度内的值。例如，如果您使用始于 1980 年 1 月 1 日的 1 天的时间界限，则轨迹将在每天开始时被分割。此参数仅适用于 ArcGIS Enterprise 10.7 及更高版本。	Time Unit
time_boundary_reference （可选）	用于分割输入数据以进行分析的参考时间。将为整个数据跨度创建时间界限，且不需要在开始时产生参考时间。如果未指定参考时间，则将使用 1970 年 1 月 1 日。此参数仅适用于 ArcGIS Enterprise 10.7 及更高版本。	Date
distance_unit （可选）	指定输出要素类中距离值所使用的测量单位。 `METERS`—测量单位将为米。这是默认设置。 `KILOMETERS`—测量单位将为千米。 `MILES`—测量单位将为美国测量英里。 `NAUTICAL_MILES`—测量单位将为美国测量海里。 `YARDS`—测量单位将为美国测量码。 `FEET`—测量单位将为美国测量英尺。 `MILES_INT`—测量单位将为法定英里。 `NAUTICAL_MILES_INT`—测量单位将为国际海里。 `YARDS_INT`—测量单位将为国际码。 `FEET_INT`—测量单位将为国际英尺。	String
duration_unit （可选）	指定将用于输出要素类中持续时间值的测量单位。 `YEARS`—测量单位将为年。 `MONTHS`—测量单位将为月。 `WEEKS`—测量单位将为周。 `DAYS`—测量单位将为天。 `HOURS`—测量单位将为小时。 `MINUTES`—测量单位将为分钟。 `SECONDS`—测量单位将为秒。这是默认设置。 `MILLISECONDS`—测量单位将为毫秒。	String
speed_unit	指定将用于输出要素类中速度值的测量单位。 `METERS_PER_SECOND`—测量单位将为米/秒。这是默认设置。 `MILES_PER_HOUR`—测量单位将为英里/小时。 `KILOMETERS_PER_HOUR`—测量单位将为千米/小时。 `FEET_PER_SECOND`—测量单位将为英尺/秒。 `NAUTICAL_MILES_PER_HOUR`—测量单位将为海里/小时。	String
acceleration_unit （可选）	指定将用于输出要素类中加速度值的测量单位。 `METERS_PER_SECOND_SQUARED`—测量单位将为米/平方秒。这是默认设置。 `FEET_PER_SECOND_SQUARED`—测量单位将为英尺/平方秒。	String
elevation_unit （可选）	指定将用于输出要素类中高程值的测量单位。 `METERS`—测量单位将为米。这是默认设置。 `KILOMETERS`—测量单位将为美国测量千米。 `MILES`—测量单位将为美国测量英里。 `YARDS`—测量单位将为美国测量码。 `FEET`—测量单位将为美国测量英尺。 `MILES_INT`—测量单位将为法定英里。 `YARDS_INT`—测量单位将为国际码。 `FEET_INT`—测量单位将为国际英尺。	String
data_store （可选）	指定将用于存储输出的 ArcGIS Data Store。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。 `SPATIOTEMPORAL_DATA_STORE`—输出将存储在时空大数据存储中。这是默认设置。 `RELATIONAL_DATA_STORE`—输出将存储在关系数据存储中。	String

派生输出

名称	说明	数据类型
output	具有运动统计数据的输出点要素。	Feature Set

代码示例

CalculateMotionStatistics 示例（独立脚本）

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

# Name: CalculateMotionStatistics.py
# Description: Calculate speed, acceleration, and bearing for hurricane tracks.
# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://mydomain.com/server/rest/services/DataStoreCatalogs/bigDataFileShares_Hurricanes/BigDataCatalogServer/all"
out = "Hurricanes_MotionStats"
trackField = "name"

# Run Calculate Motion Statistics
arcpy.geoanalytics.CalculateMotionStatistics(inFeatures, out, trackField, 5,
                                             ["SPEED", "ACCELERATION", "BEARING"],
                                             "GEODESIC")

环境

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

特殊情况

输出坐标系: The coordinate system that will be used for analysis. Analysis will be completed in the input coordinate system unless specified by this parameter. For GeoAnalytics Tools, final results will be stored in the spatiotemporal data store in WGS84.

许可信息

基本: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.9
标准: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.9
高级: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.9

计算动态统计数据 (GeoAnalytics Server 工具)

汇总

旧版本：

插图

用法

参数

派生输出

环境

特殊情况

许可信息

相关主题