Generar rutas (Location Referencing)

Disponible con licencia de Location Referencing.

Resumen

Recrea formas y aplica cambios de calibración para entidades de ruta en una red LRS.

Además, la herramienta puede determinar los cambios de calibración de las rutas para que se puedan procesar los comportamientos de eventos. Estos cambios de calibración pueden deberse a la adición, edición o eliminación de puntos de calibración fuera de las herramientas Referenciación de ubicación en ArcGIS Pro.

Uso

• Introduzca la red LRS cuyas entidades se deben regenerar o necesitan la aplicación de cambios de calibración basándose en la forma de la ruta a partir de la clase de entidad de línea de centro y los valores de medición de la clase de entidad de punto de calibración.

• 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 .

• Si los puntos de calibración se eliminan o se cambia su fecha fuera de las herramientas ArcGIS Location Referencing en ArcGIS Pro, y la opción Generar rutas se ejecuta con el parámetro Registrar cambios de calibración para actualizaciones de localización de eventos activado, cualquier evento dentro del área en la que se eliminó el punto de calibración o cuya fecha haya cambiado tendrá el comportamiento de movimiento en lugar permanencia.

• Si una red derivada se configura utilizando una red de líneas, ejecutar Generar rutas en la red de líneas también actualizará la red derivada.

• Las rutas de la red derivada se generan combinando las formas de ruta de la línea principal.

• Cuando la prevención de conflictos está habilitada para la herramienta, cualquier evento generado por la herramienta se bloqueará.

  • Al trabajar en la versión predeterminada, los bloqueos adquiridos se liberarán automáticamente cuando finaliza la herramienta.
  • Mientras trabaja en una versión secundaria, los bloqueos adquiridos permanecerán en el estado En la publicación cuando finalice la herramienta. El propietario del bloqueo debe publicar o eliminar la versión para liberar los bloqueos.
  • Mientras trabaja en una versión secundaria, si la herramienta se cancela por interrupción, los bloqueos se adquieren y permanecerán en estado reutilizable cuando finalice la herramienta.

• 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	Red LRS para la que se regenerarán las formas de ruta y a la que se aplicarán cambios de calibración.	Feature Layer
Registrar cambios de calibración para actualizaciones de localización de eventos (Opcional)	Especifica si se aplicarán comportamientos de evento. Activado: cualquier punto de calibración creado, modificado o eliminado fuera de las herramientas Location Referencing se aplicará a las rutas de la red; los comportamientos de evento se aplicarán la próxima vez que se ejecute Aplicar comportamientos de evento. Desactivado: los cambios de calibración se aplicarán a las rutas de la red LRS, pero no se aplicará ningún comportamiento de evento. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Entidades de ruta de salida	La capa de entidades de ruta actualizada.	Feature Layer
Entidades de ruta derivada de salida	Red LRS actualizada para la que se han generado formas de ruta y a la que se han aplicado cambios de calibración.	Feature Layer
Archivo de resultados de salida	Archivo de texto que detalla las rutas que se actualizaron en la clase de entidad de red LRS.	Text File

Python

arcpy.locref.GenerateRoutes(in_route_features, {record_calibration_changes})

Nombre	Explicación	Tipo de datos
in_route_features	Red LRS para la que se regenerarán las formas de ruta y a la que se aplicarán cambios de calibración.	Feature Layer
record_calibration_changes (Opcional)	Especifica si se aplicarán comportamientos de evento. RECORD_CALIBRATION_CHANGES—Cualquier punto de calibración creado, modificado o eliminado fuera de las herramientas de Location Referencing se aplicará a las rutas de la red;:los comportamientos de evento se aplicarán la próxima vez que se ejecute Aplicar comportamientos de evento. NO_RECORD_CALIBRATION_CHANGES—Los cambios de calibración se aplicarán a las rutas de la red LRS, pero no se aplicará ningún comportamiento de evento. Esta es la opción predeterminada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
out_route_features	La capa de entidades de ruta actualizada.	Feature Layer
out_derived_route_features	Red LRS actualizada para la que se han generado formas de ruta y a la que se han aplicado cambios de calibración.	Feature Layer
out_details_file	Archivo de texto que detalla las rutas que se actualizaron en la clase de entidad de red LRS.	Text File

Muestra de código

Ejemplo 1 de GenerateRoutes (ventana de Python)

Muestra cómo utilizar la función GenerateRoutes en el modo inmediato.

# Name: GenerateRoutes_ex1.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requires: ArcGIS Location Referencing

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
record_calibration_changes = "NO_RECORD_CALIBRATION_CHANGES"

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

# Execute the tool
arcpy.locref.GenerateRoutes(in_route_features, record_calibration_changes)
arcpy.CheckInExtension('LocationReferencing')

Ejemplo 2 de GenerateRoutes (script independiente)

Muestra cómo utilizar la función GenerateRoutes en un script independiente de Python.

# Name: GenerateRoutes_ex2.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
record_calibration_changes = "RECORD_CALIBRATION_CHANGES"

# Execute the tool
arcpy.locref.GenerateRoutes(in_route_features, record_calibration_changes)

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

Ejemplo 3 de GenerateRoutes (script independiente)

Muestra cómo utilizar la función GenerateRoutes en un script de Python independiente en un servicio de entidades.

# Name: GenerateRoutes_Pro_Ex3.py.py
# Description: Generate 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")

## Input LRS route network 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 LRS route network from the feature service. Here, 1 corresponds to the input LRS route network.
in_route = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Process : Generate Routes.
arcpy.locref.GenerateRoutes(in_route)

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

Entornos

Espacio de trabajo actual, Factor de procesamiento en paralelo

Casos especiales

Factor de procesamiento en paralelo

El valor predeterminado de este entorno, si se deja en blanco, es 0%. Cualquier valor absoluto del entorno siempre se fija entre 0 y el número de núcleos lógicos de esa máquina.

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)