Available with Location Referencing license.
Removes overlapping centerline sections to ensure that there is one common centerline when centerline geometry overlaps.
The ArcGIS Location Referencing minimum schema models route concurrencies by having routes share the same centerline associations in the centerline sequence table. Running this tool may result in centerline changes, such as centerline splitting or deletion of duplicated centerline features. It may also update centerline sequence table records so that routes share centerlines.
Overlapping centerlines may result when any of the following occur:
While the Remove Overlapping Centerlines tool can be run any time after an LRS Network is created and data is loaded, consider running it only after you've finished creating all LRS Networks and have loaded all data in the LRS. If additional columns are modeled on the centerlines, some centerline attributes may be lost when the tool is run.
An LRS dataset is required to run this tool.
Learn more about creating an LRS dataset in ArcGIS Pipeline Referencing or creating an LRS dataset in ArcGIS Roads and Highways .
The number of centerline features in the input centerline feature layer may be different after running the tool, depending on the number of overlapping centerlines and the routes associated with them.
This tool uses the topological operations Intersect and Simplify together, which can cause small polyline segments of a length around and above the feature class tolerance to be lost. Associated route shapes may change slightly beyond tolerance as a result of using this tool. Consider starting an edit session in ArcGIS Pro for test runs of the tool using the Enable Undo button in the Geoprocessing pane.
Learn more about how cluster tolerance is used in ArcGIS topological operations
This tool ignores z-values on the centerlines during calculations. For example, if two centerlines do not overlap in 3D space but do overlap in 2D space, they will be considered overlapping.
This tool supports conflict prevention and will attempt to acquire and transfer locks.
Learn more about conflict prevention in ArcGIS Pipeline Referencing or conflict prevention in ArcGIS Roads and Highways.
| Label | Explanation | Data Type |
Input Centerline Features
| An input layer or feature class representing an LRS centerline. | Feature Layer |
| Label | Explanation | Data Type |
| Updated Centerline features | The updated centerline feature layer. | Feature Layer |
| Output Details File | A text file that details the overlapping centerlines removed from the feature layer. | Text File |
arcpy.locref.RemoveOverlappingCenterlines(in_centerline_features)
| Name | Explanation | Data Type |
in_centerline_features | An input layer or feature class representing an LRS centerline. | Feature Layer |
| Name | Explanation | Data Type |
| updated_centerline_features | The updated centerline feature layer. | Feature Layer |
| out_details_file | A text file that details the overlapping centerlines removed from the feature layer. | Text File |
The following Python window script demonstrates how to use the RemoveOverlappingCenterlines function in immediate mode.
# Name: RemoveOverlappingCenterlines_inline.py
# Description: Remove overlapping centerlines in the Python window.
# Requires: ArcGIS Location Referencing
# Tool variables
in_centerline_features = "Centerline"
# Set current workspace
arcpy.env.workspace = "C:\data\Outputs.gdb"
# Execute the tool
arcpy.locref.RemoveOverlappingCenterlines(in_centerline_features)The following stand-alone script demonstrates how to use the RemoveOverlappingCenterlines function.
# Name: RemoveOverlappingCenterlines_standalone.py
# Description: Remove overlapping centerlines in stand-alone mode.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
# Set local variables
# input Centerline layer
in_centerline_features = "C:\\Data\Sample.gdb\\LRS\\Centerline"
# Process: RemoveOverlappingCenterlines
arcpy.locref.RemoveOverlappingCenterlines(in_centerline_features)
# Check in license
arcpy.CheckInExtension('LocationReferencing')The following stand-alone script demonstrates how to use RemoveOverlappingCenterlines in a feature service.
# Name: RemoveOverlappingCenterlines_Pro_Ex3.py
# Description: Remove overlapping centerlines in stand-alone mode using a feature service. It is recommended to work in a version and post it to the default version.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
# Input centerline is in feature service. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')
## Map the input centerline from the feature service. Here, 6 corresponds to the input centerline.
in_centerline_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/6"
# Process: RemoveOverlappingCenterlines
arcpy.locref.RemoveOverlappingCenterlines(in_centerline_features)
# Check in license
arcpy.CheckInExtension('LocationReferencing')The default value for this environment, if left blank, is 0%. Any absolute value for the environment is always clamped between 0 and the number of logical cores in that machine.