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