Краткая информация
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.
Использование
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 value Description 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.
Синтаксис
CalculateRouteConcurrencies_locref (in_route_features, out_table, {in_tvd}, {find_dominance})
Параметр | Объяснение | Тип данных |
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 (Дополнительный) | The temporal view date for the network. | Date |
find_dominance (Дополнительный) | Indicates whether to use route dominance rules configured for in_network.
| Boolean |
Пример кода
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")
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Roads and Highways
- ArcGIS Desktop Standard: Требует Roads and Highways
- ArcGIS Desktop Advanced: Требует Roads and Highways