Skip To Content

Reconstruct Tracks

Summary

Creates line or polygon tracks from time-enabled input data.

Illustration

Reconstruct Tracks tool
Time-enabled points reconstructed into tracks.

Usage

  • Features that have a buffer applied will result in polygonal tracks. Input point features that do not have a buffer applied will result in polyline tracks.

  • All output will result in temporally enabled data that represents an interval. The interval start and end time is determined by the first and last time in a track.

  • Unbuffered input point features will only return tracks when there are two or more vertices.

  • Fields used in the buffer expression must be numeric and will be applied using the units of the input's spatial reference. See Buffer expression examples for ArcGIS Enterprise 10.5 and 10.5.1 or Buffer expression examples for ArcGIS Enterprise 10.6 and later for more information. At ArcGIS Enterprise 10.6.1 or later, you can use track-aware equations.

  • By default, only the count of points or polygons in a track will be calculated. Additional statistics can be calculated by specifying the Summary Fields parameter.

  • Use the geodesic method if the tracks will cross the international date line.

  • This geoprocessing tool is powered by ArcGIS GeoAnalytics Server. Analysis is completed on your GeoAnalytics Server, and results are stored in your content in ArcGIS Enterprise.

  • When running GeoAnalytics Server Tools, the analysis is completed on the GeoAnalytics Server. For optimal performance, data should be available to the GeoAnalytics Server through feature layers hosted on your ArcGIS Enterprise portal or through big data file shares. Data that is not local to your GeoAnalytics Server will be moved to your GeoAnalytics Server before analysis begins. This means that it will take longer to run a tool, and in some cases, moving the data from ArcGIS Pro to your GeoAnalytics Server may fail. The threshold for failure depends on your network speeds, as well as the size and complexity of the data. Therefore, it is recommended that you always share your data or create a big data file share.

    Learn more about sharing data to your portal

    Learn more about creating a big data file share through Server Manager

  • Similar analysis can also be completed using the following:

    • The ArcGIS Pro geoprocessing tool Points To Line in the Data Management toolbox.

Syntax

ReconstructTracks(input_layer, output_name, track_fields, method, buffer_type, {buffer_field}, {buffer_expression}, {time_split}, {summary_fields}, {data_store}, {distance_split}, {time_boundary_split}, {time_boundary_reference})
ParameterExplanationData Type
input_layer

The points or polygons to be reconstructed to tracks. The input must be a time-enabled layer that represents an instant in time.

Feature Set
output_name

The name of the output feature service.

String
track_fields
[track_fields,...]

One or more fields that will be used to identify unique tracks.

Field
method

Specifies the criteria that will be used to reconstruct tracks. If a buffer is used, method determines the type of buffer.

  • GEODESIC If the spatial reference is pannable, tracks will cross the date line when appropriate. If the spatial reference is not pannable, tracks will be limited to the coordinate system extent and may not wrap.
  • PLANARThe tracks will never cross the date line.
String
buffer_type

Specifies how the buffer distance will be defined.

  • FIELDA single field will be used to define the buffer distance.
  • EXPRESSIONAn equation using fields and mathematical operators will be used to define the buffer distance.
String
buffer_field
(Optional)

The field that will be used to buffer the input features. Field values are applied in the units of the spatial reference of the input unless you are using a geographic coordinate system, in which case they will be in meters.

Field
buffer_expression
(Optional)

The expression that will be used to buffer input features. Fields must be numeric, and the expression can include [+ - * / ] operators and multiple fields. Calculated values are applied in the units of the spatial reference of the input unless you are using a geographic coordinate system, in which case they will be in meters.

In ArcGIS Enterprise 10.5 and 10.5.1, expressions are formatted as as_kilometers(distance) * 2 + as_meters(15). In ArcGIS Enterprise 10.6 or later, use Arcade expressions such as as_kilometers($feature.distance) * 2 + as_meters(15).

The expression that will be used to buffer input features. Fields must be numeric, and the expression can include [+ - * / ] operators and multiple fields. Calculated values are applied in the units of the spatial reference of the input unless you are using a geographic coordinate system, in which case they will be in meters.

In ArcGIS Enterprise 10.5 and 10.5.1, expressions are formatted as as_kilometers(distance) * 2 + as_meters(15). In ArcGIS Enterprise 10.6 or later, use Arcade expressions such as as_kilometers($feature.distance) * 2 + as_meters(15).

Calculator Expression
time_split
(Optional)

Features that are farther apart in time than the time-split duration will be split into separate tracks.

Time unit
summary_fields
[summary_fields,...]
(Optional)

The statistics that will be calculated on specified fields.

  • COUNT—Calculates the number of nonnull values. It can be used on numeric fields or strings. The count of [null, 0, 2] is 2.
  • SUM—The sum of numeric values in a field. The sum of [null, null, 3] is 3.
  • MEAN—The mean of numeric values. The mean of [0,2, null] is 1.
  • MIN—The minimum value of a numeric field. The minimum of [0, 2, null] is 0.
  • MAX—The maximum value of a numeric field. The maximum value of [0, 2, null] is 2.
  • STDDEV—The standard deviation of a numeric field. The standard deviation of [1] is null. The standard deviation of [null, 1,1,1] is null.
  • VAR—The variance of a numeric field in a track. The variance of [1] is null. The variance of [null, 1,1,1] is null.
  • RANGE—The range of a numeric field. This is calculated as the minimum value subtracted from the maximum value. The range of [0, null, 1] is 1. The range of [null, 4] is 0.
  • ANY—A sample string from a field of type string.

Value Table
data_store
(Optional)

Specifies the ArcGIS Data Store where the output will be saved. The default is SPATIOTEMPORAL_DATA_STORE. All results stored to the SPATIOTEMPORAL_DATA_STORE will be stored in WGS84. Results stored in a RELATIONAL_DATA_STORE will maintain their coordinate system.

  • SPATIOTEMPORAL_DATA_STOREOutput will be stored in a spatiotemporal big data store. This is the default.
  • RELATIONAL_DATA_STOREOutput will be stored in a relational data store.
String
distance_split
(Optional)

Features that are farther apart in distance than the distance split value will be split into separate tracks. This parameter is only available with ArcGIS Enterprise 10.6 and later.

Linear Unit
time_boundary_split
(Optional)

A time span to split your input data into for analysis. A time boundary allows you to analyze values within a defined time span. For example, if you use a time boundary of 1 day, starting on January 1, 1980 tracks will be will be split at the beginning of every day. This parameter is only available with ArcGIS Enterprise 10.7 and later.

Time Unit
time_boundary_reference
(Optional)

The reference time used to split your input data into for analysis. Time boundaries will be created for the whole span of the data, and the reference time does not need to occur at the start. If no reference time is used, January 1, 1970 is used. This parameter is only available with ArcGIS Enterprise 10.7 and later.

Date

Derived Output

NameExplanationData Type
output

The output line or polygon tracks.

Feature Set

Code sample

ReconstructTracks example 1 (Python window)

The following Python window script demonstrates how to use the ReconstructTracks tool.

#-------------------------------------------------------------------------------
# Name: ReconstructTracks.py
# Description: Reconstruct hurricane points into hurricane tracks, where each location is buffered by the wind speed * 100

# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Hurricanes/MapServer/0"
trackIdentifier = "EVENTID"
outFS = "HurricaneTracks"
bufferExpression = "WINDSPEED * 100"
statistics = [["PRESSURE", "MEAN"]]

# Execute Reconstruct Tracks
arcpy.geoanalytics.ReconstructTracks(inFeatures, outFS, trackIdentifier, 
                                     "GEODESIC", "EXPRESSION", None, 
                                     bufferExpression, None, statistics)

Environments

Output Coordinate System

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.

Licensing information

  • Basic: Requires ArcGIS GeoAnalytics Server
  • Standard: Requires ArcGIS GeoAnalytics Server
  • Advanced: Requires ArcGIS GeoAnalytics Server

Related topics