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.

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.

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

  • Heredado:

    Se recomienda no utilizar el parámetro Registrar cambios de calibración para actualizaciones de localización de eventos, ya que ya no es compatible y no funciona. Sin embargo, se mantendrá para garantizar la compatibilidad con versiones anteriores de scripts y modelos.

Parámetros

EtiquetaExplicaciónTipo 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)
Heredado:

Este parámetro ya no es compatible. Se ignorará cualquier valor proporcionado.

Boolean

Salida derivada

EtiquetaExplicaciónTipo 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

arcpy.locref.GenerateRoutes(in_route_features, {record_calibration_changes})
NombreExplicaciónTipo 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)
Heredado:

Este parámetro ya no es compatible. Se ignorará cualquier valor proporcionado.

Boolean

Salida derivada

NombreExplicaciónTipo 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

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

# Local variables
in_route_features = "LineNetwork"

# Execute the tool
arcpy.locref.GenerateRoutes(in_route_features)
Ejemplo 2 de GenerateRoutes (script independiente)

Muestra cómo utilizar la función GenerateRoutes en una secuencia de comandos de Python independiente.

# Name: GenerateRoutes_ex2.py
# Description: Re-creates shapes and applies calibration changes for route features in an LRS Network.
# Requires: 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'

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

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Ejemplo 3 de GenerateRoutes (script independiente)

Demuestra cómo utilizar la función GenerateRoutes en una secuencia de comandos de Python independiente en un servicio de entidades.

# Name: GenerateRoutes_Pro_Ex3.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 into 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_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

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

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

Entornos

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)

Temas relacionados