ArcMap

Calculate Route Concurrencies

Summary

This tool calculates and reports the concurrent route segments within an LRS Network. These concurrencies are reported with the measures for each concurrent route segment and a time range the concurrency exists. 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 Esri 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. Therefore, the routes that topologically overlap, but which use different centerlines will NOT be found by as overlapping by this tool.

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

Syntax

CalculateRouteConcurrencies_locref (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.

# 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: FindRouteConcurrencies.py
# Description: Identifies all the route concurrencies in a given network.
# Requires: Esri Roads and Highways Solution

# 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

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

Related topics