ArcMap

Calculate Route Concurrencies

Summary

Calculates and reports the concurrent route segments in an LRS Network.

Concurrent route segments are reported with measures for each route and the time range of the concurrent route segments. The route dominance rules for the LRS Network can be used to determine the dominant route in each concurrent section.

Usage

  • The output feature class contains the following fields: NetworkID, RouteID, SectionID, FromMeasure, ToMeasure, FromDate, ToDate, DominantFlag, and DominantError.

  • The DominantFlag column has two potential values. A record with a value of 1 is the dominant route in the concurrent section. Any route with a value of 0 is the subordinate route in the concurrent section.

  • If Input Route Features is a layer, any time-related definition filters should be removed.

  • The DominantError column has five potential values.

    Dominant Error valueDescription

    0

    No error when calculating the dominant route in the concurrent section.

    1

    Two or more routes have 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 are present in the concurrent section: the route is not calibrated in the concurrent section or the centerline that composes the concurrent section doesn't align with the geometry of the route.

  • The SectionID GUIDs in the output are new and not associated with any existing GUIDs used throughout ArcGIS Roads and Highways. The GUIDs are unique for each concurrent section in the network, meaning that each route and measure portion in a given concurrent section will have a record with the same GUID.

  • If routes in a concurrent section are calibrated in opposite directions, the nondominant route or routes will have a larger From measure than To measure.

  • Overlapping route segments will only be found if the routes share the same centerline. This tool will not identify topologically overlapping routes that use different centerlines.

  • It is recommended that you run the Remove Duplicate Centerline Geometry tool before running this tool.

Syntax

arcpy.locref.CalculateRouteConcurrencies(in_route_features, out_table, {in_tvd}, {find_dominance})
ParameterExplanationData Type
in_route_features

The network containing the routes on which concurrencies will be calculated.

Feature Layer
out_table

The table to be created, containing all the concurrent sections in the Source LRS Network.

Table
in_tvd
(Optional)

The temporal view date for the network.

Date
find_dominance
(Optional)

Indicates whether to use route dominance rules configured for in_network.

  • FIND_DOMINANCE —Uses route dominance rules configured to determine the dominant route in each concurrent section. This is the default.
  • NO_FIND_DOMINANCE —Does not use route dominance rules configured to determine the dominant route in each concurrent section.
Boolean

Code sample

CalculateRouteConcurrencies example 1 (Python window)

Demonstrates how to use the CalculateRouteConcurrencies tool in the Python window.

# Name: CalculateRouteConcurrencies_arcmap.py
# Description: Identifies all the route concurrencies in a given network.

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("Highways")

# tool variables
in_network = r"C:\Data\NY_Data.gdb\LRSN_MilePoint"
out_table = r"C:\Data\NY_Data.gdb\ConcurrenciesOutput"
in_tvd = ""
find_dominance = "FIND_DOMINANCE"

# set current workspace
arcpy.env.workspace = "C:/Data/NY_Data.gdb"

# execute the tool
arcpy.CalculateRouteConcurrencies_locref(in_network, out_table, in_tvd, find_dominance)
CalculateRouteConcurrencies example 2 (stand-alone script)

Demonstrates how to use the CalculateRouteConcurrencies tool as a stand-alone Python script.

# Name: CalculateRouteConcurrencies.py
# Description: Identifies all the route concurrencies in a given network.

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("Highways")

# Local variables
network = r"C:\Data\NY_Data.gdb\LRSN_MilePoint"
output_table = r"C:\Data\NY_Data.gdb\Concurrencies_Output"

# Execute the tool
arcpy.CalculateRouteConcurrencies_locref(network, output_table, "", "FIND_DOMINANCE")

Environments

Licensing information

  • Basic: Requires Roads and Highways
  • Standard: Requires Roads and Highways
  • Advanced: Requires Roads and Highways

Related topics