Reconstruct Tracks (GeoAnalytics)

Summary

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

Illustration

Time-enabled points reconstructed into tracks.

Parameters

Dialog

Label	Explanation	Data Type
Input Layer	The points or polygons to be reconstructed into 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	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, the Method parameter determines the type of buffer. Geodesic— If the spatial reference can be panned, tracks will cross the date line when appropriate. If the spatial reference cannot be panned, tracks will be limited to the coordinate system extent and may not wrap. Planar—Planar buffers will be created.	String
Buffer Type	Specifies how the buffer distance will be defined. Field—A single field will be used to define the buffer distance. Expression—An 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).	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 (Optional)	The statistics that will be calculated on specified fields. Count—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. Standard Deviation—The standard deviation of a numeric field. The standard deviation of [1] is null. The standard deviation of [null, 1,1,1] is null. Variance—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. First—The first value of a specified field in a track. This option is available with ArcGIS Enterprise 10.8.1. Last—The last value of a specified field in a track. This option is available with ArcGIS Enterprise 10.8.1. The statistics that will be calculated on specified fields. COUNT—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. FIRST—The first value of a specified field in a track. This option is available with ArcGIS Enterprise 10.8.1. LAST—The last value of a specified field in a track. This option is available with ArcGIS Enterprise 10.8.1.	Value Table
Data Store (Optional)	Specifies the ArcGIS Data Store where the output will be saved. The default is Spatiotemporal big data store. All results stored in a spatiotemporal big data store will be stored in WGS84. Results stored in a relational data store will maintain their coordinate system. Spatiotemporal big data store—Output will be stored in a spatiotemporal big data store. This is the default. Relational data store—Output 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 the 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 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 the input data into for analysis. Time boundaries will be created for the entire span of the data, and the reference time does not need to occur at the start. If no reference time is specified, January 1, 1970, is used. This parameter is only available with ArcGIS Enterprise 10.7 and later.	Date
Split Expression (Optional)	An expression that splits tracks based on values, geometry or time values. Expressions that validate to true will be split. This parameter is only available with ArcGIS Enterprise 10.9 and later.	Calculator Expression
Split Type (Optional)	Specifies how the track segment between two features is created when a track is split. The split type is applied to split expressions, distance splits, and time splits. This parameter is only available with ArcGIS Enterprise 10.9 and later. Gap—No segment is created between the two features. This is the default. Finish After—A segment is created between the two features that ends after the split. Start Before—A segment is created between the two features that ends before the split.	String

Derived Output

Label	Explanation	Data Type
Output Feature Class	The output line or polygon tracks.	Feature Set

Python

arcpy.geoanalytics.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}, {split_expression}, {split_type})

Name	Explanation	Data Type
input_layer	The points or polygons to be reconstructed into 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, the method parameter determines the type of buffer. GEODESIC— If the spatial reference can be panned, tracks will cross the date line when appropriate. If the spatial reference cannot be panned, tracks will be limited to the coordinate system extent and may not wrap. PLANAR—The tracks will not cross the date line.	String
buffer_type	Specifies how the buffer distance will be defined. FIELD—A single field will be used to define the buffer distance. EXPRESSION—An 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—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. FIRST—The first value of a specified field in a track. This option is available with ArcGIS Enterprise 10.8.1. LAST—The last value of a specified field in a track. This option is available with ArcGIS Enterprise 10.8.1.	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 in a spatiotemporal big data store will be stored in WGS84. Results stored in a relational data store will maintain their coordinate system. SPATIOTEMPORAL_DATA_STORE—Output will be stored in a spatiotemporal big data store. This is the default. RELATIONAL_DATA_STORE—Output 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 the 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 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 the input data into for analysis. Time boundaries will be created for the entire span of the data, and the reference time does not need to occur at the start. If no reference time is specified, January 1, 1970, is used. This parameter is only available with ArcGIS Enterprise 10.7 and later.	Date
split_expression (Optional)	An expression that splits tracks based on values, geometry or time values. Expressions that validate to true will be split. This parameter is only available with ArcGIS Enterprise 10.9 and later.	Calculator Expression
split_type (Optional)	Specifies how the track segment between two features is created when a track is split. The split type is applied to split expressions, distance splits, and time splits. This parameter is only available with ArcGIS Enterprise 10.9 and later. GAP—No segment is created between the two features. This is the default. FINISH_LAST—A segment is created between the two features that ends after the split. START_NEXT—A segment is created between the two features that ends before the split.	String

Derived Output

Name	Explanation	Data Type
output	The output line or polygon tracks.	Feature Set

Code sample

ReconstructTracks example 1 (stand-alone script)

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, Extent, Current Workspace

Special cases

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