Eliminar rutas (Location Referencing)

Disponible con licencia de Location Referencing.

Resumen

Elimina rutas y elementos de datos asociados de la red LRS.

Uso

• Se requiere una licencia de LRS para ejecutar esta herramienta.

  Encontrará más información acerca de crear un dataset LRS en ArcGIS Pipeline Referencing o crear un dataset LRS en ArcGIS Roads and Highways .

• Como parte de la eliminación de rutas, también puede usar la herramienta Eliminar rutas para hacer lo siguiente:

  • Elimine todos los registros de Secuencia de líneas centrales que tengan el routeId de rutas eliminadas.
  • Elimine todos los registros de la tabla lrs_edit_log relacionados con las rutas eliminadas.
  • Opcionalmente, elimine líneas centrales, puntos de calibración y eventos asociados.

    Precaución:

    La ejecución de Eliminar rutas sin utilizar los parámetros Eliminar líneas centrales asociadas, Eliminar puntos de calibración asociados y Eliminar eventos asociados puede dar lugar a que esas líneas centrales, puntos de calibración y eventos no hagan referencia a ninguna ruta.

• La entrada debe ser una clase de entidad de red registrada con una red LRS.

• Seleccione las rutas que se deben eliminar antes de ejecutar la herramienta. La selección de una clase de entidad de red LRS puede realizarse mediante la herramienta Seleccionar o las consultas de definición.

• Si no se ha seleccionado ninguna ruta en la clase de entidad de red LRS, la herramienta fallará.

• Los registros de ruta seleccionados con el mismo routeId se eliminarán a lo largo del tiempo.

• Si se selecciona una ruta en una red de líneas, todas las rutas de la misma línea se eliminarán a lo largo del tiempo.

• Si se activa el parámetro Eliminar puntos de calibración asociados, los puntos de calibración asociados a las rutas se eliminarán a lo largo del tiempo.

• Si el parámetro Eliminar eventos asociados está activado, todos los eventos registrados en la red que tengan el mismo routeId de una ruta eliminada se eliminarán a lo largo del tiempo.

• Si el parámetro Eliminar líneas centrales asociadas está activado, las líneas centrales asociadas con las rutas seleccionadas se eliminarán. Si las líneas centrales se comparten entre redes, estas líneas centrales comunes no se eliminarán.

• Se recomienda que no ejecute esta herramienta en la versión predeterminada de una base de datos.

• Si esta herramienta se ejecuta en una sesión de edición, las rutas eliminadas se pueden deshacer.

Precaución:

Si esta herramienta se ejecuta fuera de una sesión de edición, las rutas eliminadas no se pueden deshacer.

• En el caso de las rutas con un routeId o lineId nulo, la herramienta se ejecutará, pero no se eliminarán los registros.

• La herramienta Eliminar rutas no se puede ejecutar en capas de red en ArcGIS Pro si hay un filtro de hora activado.

• Esta herramienta admite la prevención de conflictos e intentará adquirir y transferir bloqueos.

  Puede obtener más información sobre la prevención de conflictos en ArcGIS Pipeline Referencing o la prevención de conflictos en ArcGIS Roads and Highways.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de ruta de entrada	La clase de entidad de ruta registrada en la red.	Feature Layer
Eliminar puntos de calibración asociados (Opcional)	Especifica si se eliminarán los puntos de calibración asociados con las rutas eliminadas. Activado: se eliminarán los puntos de calibración asociados con las rutas. Desactivado: los puntos de calibración asociados con las rutas no se eliminarán. Esta es la opción predeterminada.	Boolean
Eliminar eventos asociados (Opcional)	Especifica si se eliminarán los eventos asociados con las rutas eliminadas. Activado: los eventos asociados con las rutas se eliminarán. Desactivado: los eventos asociados con las rutas no se eliminarán. Esta es la opción predeterminada.	Boolean
Eliminar líneas centrales asociadas (Opcional)	Especifica si las líneas centrales que se asocian exclusivamente con las rutas eliminadas se eliminarán. Activado: se eliminarán las líneas centrales asociadas exclusivamente a las rutas seleccionadas. Si las líneas centrales se comparten entre redes, estas líneas centrales comunes no se eliminarán. Desactivado: no se eliminarán líneas centrales. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Entidades de ruta actualizadas	Clase de entidad de red LRS actualizada.	Feature Layer
Archivo de resultados de salida	Archivo de texto que detalla las rutas eliminadas de la clase de entidad de red LRS.	Text File
Entidades de ruta derivada de salida	La capa de entidades de ruta derivada actualizada.	Feature Layer

Python

arcpy.locref.DeleteRoutes(in_route_features, {delete_associated_calibration_points}, {delete_associated_events}, {delete_associated_centerlines})

Nombre	Explicación	Tipo de datos
in_route_features	La clase de entidad de ruta registrada en la red.	Feature Layer
delete_associated_calibration_points (Opcional)	Especifica si se eliminarán los puntos de calibración asociados con las rutas eliminadas. DELETE_CALIBRATION_POINTS—Los puntos de calibración asociados con las rutas se eliminarán. NO_DELETE_CALIBRATION_POINTS—Los puntos de calibración asociados con las rutas no se eliminarán. Esta es la opción predeterminada.	Boolean
delete_associated_events (Opcional)	Especifica si se eliminarán los eventos asociados con las rutas eliminadas. DELETE_EVENTS—Los eventos asociados con las rutas se eliminarán. NO_DELETE_EVENTS—Los eventos asociados con las rutas no se eliminarán. Esta es la opción predeterminada.	Boolean
delete_associated_centerlines (Opcional)	Especifica si las líneas centrales que se asocian exclusivamente con las rutas eliminadas se eliminarán. DELETE_CENTERLINES—Las líneas centrales asociadas exclusivamente con las rutas seleccionadas se eliminarán. Si las líneas centrales se comparten entre redes, estas líneas centrales comunes no se eliminarán. NO_DELETE_CENTERLINES—Las líneas centrales no se eliminarán. Esta es la opción predeterminada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
updated_route_features	Clase de entidad de red LRS actualizada.	Feature Layer
out_details_file	Archivo de texto que detalla las rutas eliminadas de la clase de entidad de red LRS.	Text File
out_derived_route_features	La capa de entidades de ruta derivada actualizada.	Feature Layer

Muestra de código

Ejemplo de DeleteRoutes 1 (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función DeleteRoutes de modo inmediato.

# Name: DeleteRoutes_ex1.py
# Description: Delete routes and associated data elements from an LRS Network in the Python window
# Requires: ArcGIS Location Referencing

# Set current workspace
arcpy.env.workspace = "C:\Data\UPDM.gdb"

# Delete Routes tool variables
in_route_features = "PipelineNetwork"
delete_associated_calibration_points = "DELETE_CALIBRATION_POINTS" 
delete_associated_events = "DELETE_EVENTS"
delete_associated_centerlines = "DELETE_CENTERLINES"

# Execute Delete Routes. (Input route features must be selected prior to tool execution)
arcpy.locref.DeleteRoutes(in_route_features, delete_associated_calibration_points, delete_associated_events, delete_associated_centerlines)

Ejemplo de DeleteRoutes 2 (script independiente)

El siguiente script independiente muestra cómo utilizar la función DeleteRoutes.

# Name: DeleteRoutes_ex2.py
# Description: Delete routes and associated data elements from an LRS Network.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Provide the path of database
arcpy.env.workspace = r"C:\Users\Desktop\PipelineReferencing.gdb\LRS\LineNetwork"

# Convert network feature class to layer
arcpy.management.MakeFeatureLayer("LineNetwork", "networklyr")

# Process: Select Layer By Attribute
arcpy.management.SelectLayerByAttribute("networklyr", "NEW_SELECTION", "RouteID = '11316262800'")

# Run Delete Routes tool
arcpy.locref.DeleteRoutes("networklyr", "DELETE_CALIBRATION_POINTS", "DELETE_EVENTS", "DELETE_CENTERLINES")

print("Successfully deleted the selected route...")

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Ejemplo de DeleteRoutes 3 (script independiente)

El siguiente script independiente muestra cómo utilizar la función DeleteRoutes en un servicio de entidades.

# Name: DeleteRoutes_Pro_Ex3.py
# Description: Delete routes in stand-alone mode using a feature service. It is recommended to work in a version and post it into the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Set tool variables
delete_associated_calibration_points = "DELETE_CALIBRATION_POINTS"
delete_associated_events = "DELETE_EVENTS"
delete_associated_centerlines = "DELETE_CENTERLINES"

# Input LRS route network is in a feature service. Sign into portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

## Make a layer of the LRS route network from the feature service for applying selection. Here, 1 corresponds to the LRS route network
in_route_layer = arcpy.management.MakeFeatureLayer("https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1", 'route_layer')

## Process: Select Layer by attribute as required
arcpy.management.SelectLayerByAttribute(in_route_layer, "NEW_SELECTION", "RouteID = 'routeid1'")

# Process : Delete Routes
arcpy.locref.DeleteRoutes( in_route_layer, delete_associated_calibration_points, delete_associated_events, delete_associated_centerlines)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Entornos

Espacio de trabajo actual

Información de licenciamiento

• Basic: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
• Standard: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
• Advanced: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)