Label | Explanation | Data Type |
Input Route Features | The LRS Network feature class in which route concurrencies will be calculated. | Feature Layer |
Output Dataset | The feature class or table to which the calculated results will be posted. | Table |
Temporal View Date (Optional) | The temporal view date for the network, if one is specified. Leaving this field blank shows all time. | Date |
Set route dominance based on priority rules (Optional) | Specifies whether configured route dominance rules will be used to set dominance.
| Boolean |
Include Geometry (Optional) | Specifies whether geometry will be included in the output dataset.
| Boolean |
Summary
Calculates and reports concurrent route sections in an LRS Network.
Usage
Overlapping route sections will only be found if the routes share the same centerline. This tool does not identify topologically overlapping routes that use different centerlines.
Section ID GUIDs are unique for each concurrent section in the network, meaning that each route in a concurrent section will have a record with the same section ID as the other routes in that concurrent section.
The DominantFlag field has two potential values.
- 0—A subordinate route in the concurrent section
- 1—The dominant route in the concurrent section
The DominantError field has the following potential values:
- 0—No error occurred when calculating the dominant route in the concurrent section.
- 1—Two or more routes had the same attribute value for the concurrent section. The dominant route was randomly selected.
- 2—Null or no values were present for the attribute or attributes used to calculate the dominant route in the concurrent section.
- 3—Too many values were present for the attribute or attributes used to calculate the dominant route in the concurrent section.
- 4—One of two conditions were present in the concurrent section: the route was not calibrated in the concurrent section or the centerline that composes the concurrent section did not align with the geometry of the route.
If the Include Geometry parameter is checked, the output dataset will be a feature class. Otherwise, the output dataset will be a table.
Specify a Temporal View Date parameter value to calculate concurrency for that point in time. Leaving this field blank shows concurrency across all time.
It is recommended that you configure route dominance rules for an LRS Network using the Configure Route Dominance Rules tool before running this tool.
Parameters
arcpy.locref.CalculateRouteConcurrencies(in_route_features, out_dataset, {tvd}, {find_dominance}, {include_geometry})
Name | Explanation | Data Type |
in_route_features | The LRS Network feature class in which route concurrencies will be calculated. | Feature Layer |
out_dataset | The feature class or table to which the calculated results will be posted. | Table |
tvd (Optional) | The temporal view date for the network, if one is specified. Leaving this field blank shows all time. | Date |
find_dominance (Optional) | Specifies whether configured route dominance rules will be used to set dominance.
| Boolean |
include_geometry (Optional) | Specifies whether geometry will be included in the output dataset.
| Boolean |
Code sample
Demonstrates how to use the CalculateRouteConcurrencies function as a stand-alone script.
# Name: CalculateRouteConcurrencies_Pro_ex1.py
# Description: Calculates and reports concurrent route sections in an LRS Network in a stand-alone script.
# Requirements: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")
# Local tool variables
in_route_features = r"C:\Data\SampleData.gdb\LRS\NonlineNetwork"
out_dataset = r"C:\Data\SampleData.gdb\LRS\ConcurrentRoutes"
tvd = ""
find_dominance = "FIND_DOMINANCE"
include_geometry = "INCLUDE_GEOMETRY"
# Execute the tool
arcpy.locref.CalculateRouteConcurrencies(in_route_features, out_dataset, tvd, find_dominance, include_geometry)
# Check in licenses
arcpy.CheckInExtension('LocationReferencing')
Demonstrates how to use the CalculateRouteConcurrencies function in the Python window.
# Name: CalculateRouteConcurrencies_Pro_ex2.py
# Description: Calculates and reports concurrent route sections in an LRS Network in the Python window.
# Requirements: ArcGIS Location Referencing
# Local tool variables
in_route_features = r"C:\Data\SampleData.gdb\LRS\NonlineNetwork"
out_dataset = r"C:\Data\SampleData.gdb\LRS\ConcurrentRoutes"
tvd = "06/09/2021"
find_dominance = "NO_FIND_DOMINANCE"
include_geometry = "EXCLUDE_GEOMETRY"
# Execute the tool
arcpy.locref.CalculateRouteConcurrencies(in_route_features, out_dataset, tvd, find_dominance, include_geometry)
Environments
Licensing information
- Basic: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
- Standard: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
- Advanced: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)