Skip To Content

Remove Overlapping Centerlines

Mit der Location Referencing-Lizenz verfügbar.

Zusammenfassung

Removes overlapping centerline sections to ensure that there is one common centerline in cases where 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 can result when any of the following occur:

  • A network with concurrent routes is loaded
  • An additional network is loaded
  • Ad-hoc user centerline editing

Hinweis:

While the Remove Overlapping Centerlines tool can be run any time after a 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 your LRS. If additional columns are modeled on the centerlines, some centerline attributes may be lost when the tool is run.

Abbildung

Centerline sequence records before and after Remove Overlapping Centerlines
Centerlines C1 and C2 overlap until the middle of centerline C1. After running the Remove Overlapping Centerlines tool, the overlapping portion is removed, while centerline C3 is created and associated with routes R1 and R2 in the Centerline Sequence table.

Verwendung

  • An LRS dataset is required to run this tool. To create an LRS dataset, add the Calibration Point, Centerline, and Redline layers to a feature dataset, and then run the Modify LRS tool with the geodatabase as the input.

  • 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 in conjunction, 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. For more information about how cluster tolerance is used in ArcGIS topological operations, see Understanding Geometric Processing in ArcGIS.

  • This tool ignores z-values on the centerlines during its calculations. For example, if two centerlines do not overlap in 3D space but do overlap in 2D, they will be considered overlapping by the tool.

Syntax

RemoveOverlappingCenterlines(in_centerline_features)
ParameterErklärungDatentyp
in_centerline_features

An input layer or feature class representing an LRS centerline.

Feature Layer

Abgeleitete Ausgabe

NameErklärungDatentyp
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

Codebeispiel

RemoveOverlappingCenterlines example 1 (Python window)

The following Python window script demonstrates how to use the RemoveOverlappingCenterlines function in immediate mode.

# Name: RemoveOverlappingCenterlines_inline.py
# Description: This script demonstrates how to use RemoveOverlappingCenterlines in immediate mode.
# Requires: ArcGIS Pipeline 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)
RemoveOverlappingCenterlines example 2 (stand-alone script)

The following stand-alone script demonstrates how to use the RemoveOverlappingCenterlines function.

# Name: RemoveOverlappingCenterlines_standalone.py
# Description: This script demonstrates how to use RemoveOverlappingCenterlines in standalone mode.
# Requires: ArcGIS Pipeline Referencing

# Import arcpy module
import arcpy

# Check out the license
arcpy.CheckOutExtension("LocationReferencing")

# Set local variables
# input Centerline layer
in_centerline_features = "C:\\Data\Sample.gdb\\Centerline"

# Process: RemoveOverlappingCenterlines
arcpy.RemoveOverlappingCenterlines_locref(in_centerline_features)
RemoveOverlappingCenterlines example 3 (stand-alone script)

The following stand-alone script demonstrates how to use RemoveOverlappingCenterlines in a feature service.

# Name: RemoveOverlappingCenterlines_Pro_Ex3.py
# Description: This script demonstrates how to use remove overlapping centerlines in stand alone mode using a feature service. It is recommended to work in a version and post it into the  default version.
# Requires: LocationReferencing license.

# Import arcpy module.
import arcpy

# Check out the license.
arcpy.CheckOutExtension("LocationReferencing")


##Input centerline is in feature service.  Signing in portal 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.RemoveOverlappingCenterlines_locref(in_centerline_features)

Umgebungen

Faktor für parallele Verarbeitung

The default value for this environment, if left blank, is 100%. Any absolute value for the environment is always clamped between 0 and the number of logical cores in that machine.

Lizenzinformationen

  • Basic: Erfordert ArcGIS Location Referencing
  • Standard: Erfordert ArcGIS Location Referencing
  • Advanced: Erfordert ArcGIS Location Referencing

Verwandte Themen