Calcular concurrencias de rutas (Location Referencing)

Resumen

Calcula y notifica las secciones de ruta concurrente en una red LRS.

Uso

  • Solo se buscarán secciones de ruta superpuestas si las rutas comparten la misma línea de centro. Esta herramienta no identifica rutas superpuestas topológicamente que utilizan líneas de centro diferentes.

  • Los GUID de Id. de sección son únicos para cada sección concurrente de la red, lo que significa que cada ruta en una sección concurrente tendrá un registro con el mismo Id. de sección que las otras rutas en esa sección concurrente.

  • El campo DominantFlag tiene dos posibles valores.

    • 0: ruta subordinada en la sección concurrente
    • 1: ruta predominante en la sección concurrente

  • El campo DominantError puede tener los siguientes valores:

    • 0: no ha ocurrido ningún error al calcular la ruta predominante en la sección concurrente.
    • 1: dos o más rutas tienen el mismo valor de atributo para la sección concurrente. La ruta predominante se seleccionó aleatoriamente.
    • 2: había valores nulos o no había valores para el atributo o los atributos utilizados para calcular la ruta predominante en la sección concurrente.
    • 3: había demasiados valores para el atributo o los atributos utilizados para calcular la ruta predominante en la sección concurrente.
    • 4: una de dos condiciones estuvieron presente en la sección concurrente: la ruta no se calibró en la sección concurrente o la línea central que compone la sección concurrente no se alineó con la geometría de la ruta.
  • Si el parámetro Incluir geometría está activado, el dataset de salida será una clase de entidad. De lo contrario, el dataset de salida será una tabla.

  • Especifique un valor en el parámetro Fecha de vista temporal para calcular la concurrencia en ese punto en el tiempo. Si deja este campo en blanco, se muestra la concurrencia en todo el tiempo.

  • Se recomienda que configure reglas de predominio de ruta para una red LRS mediante la herramienta Configurar reglas de predominio de ruta antes de ejecutar esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de ruta de entrada

Clase de entidad de red LRS en la que se calcularán las concurrencias de rutas.

Feature Layer
Dataset de salida

Tabla o clase de entidad en la que se publicarán los resultados calculados.

Table
Fecha de vista temporal
(Opcional)

Fecha de vista temporal de la red, si se especifica una. Al dejar este campo en blanco se muestra siempre.

Date
Establecer el predominio de la ruta según las reglas de prioridad
(Opcional)

Especifica si se utilizarán las reglas de predominio de ruta configuradas para establecer el predominio.

  • Activado: las reglas de predominio de ruta configuradas se utilizarán para determinar la ruta predominante en cada sección concurrente. Esta es la opción predeterminada.
  • Desactivado: las reglas de predominio de ruta configuradas no se utilizarán para determinar la ruta predominante en cada sección concurrente.
Boolean
Incluir geometría
(Opcional)

Especifica si se incluirá la geometría en el dataset de salida.

  • Activado: la geometría se incluirá en el dataset de salida.
  • Desactivado: la geometría no se incluirá en el dataset de salida. Esta es la opción predeterminada.
Boolean

arcpy.locref.CalculateRouteConcurrencies(in_route_features, out_dataset, {tvd}, {find_dominance}, {include_geometry})
NombreExplicaciónTipo de datos
in_route_features

Clase de entidad de red LRS en la que se calcularán las concurrencias de rutas.

Feature Layer
out_dataset

Tabla o clase de entidad en la que se publicarán los resultados calculados.

Table
tvd
(Opcional)

Fecha de vista temporal de la red, si se especifica una. Al dejar este campo en blanco se muestra siempre.

Date
find_dominance
(Opcional)

Especifica si se utilizarán las reglas de predominio de ruta configuradas para establecer el predominio.

  • FIND_DOMINANCELas reglas de predominio de ruta configuradas se utilizarán para determinar la ruta predominante en cada sección concurrente. Esta es la opción predeterminada.
  • NO_FIND_DOMINANCELas reglas de predominio de ruta configuradas no se utilizarán para determinar la ruta predominante en cada sección concurrente.
Boolean
include_geometry
(Opcional)

Especifica si se incluirá la geometría en el dataset de salida.

  • EXCLUDE_GEOMETRYLa geometría no se incluirá en el dataset de salida. Esta es la opción predeterminada.
  • INCLUDE_GEOMETRYLa geometría se incluirá en el dataset de salida.
Boolean

Muestra de código

Ejemplo 1 de CalculateRouteConcurrencies (script independiente)

Muestra cómo utilizar la función CalculateRouteConcurrencies como un script independiente.

# Name: CalculateRouteConcurrencies_Pro_ex1.py
# Description: Calculates and reports concurrent route sections in an LRS Network in a stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local tool variables
in_route_features = r"C:\Data\SampleData.gdb\LRS\NonlineNetwork"
out_dataset = r"C:\Data\SampleData.gdb\LRS\ConcurrentRoutes"
tvd = ""
find_dominance = "FIND_DOMINANCE"
include_geometry = "INCLUDE_GEOMETRY"

# Execute the tool
arcpy.locref.CalculateRouteConcurrencies(in_route_features, out_dataset, tvd, find_dominance, include_geometry)

# Check in licenses
arcpy.CheckInExtension('LocationReferencing')
Ejemplo 2 de CalculateRouteConcurrencies (ventana de Python)

Muestra cómo utilizar la función CalculateRouteConcurrencies en la ventana de Python.

# Name: CalculateRouteConcurrencies_Pro_ex2.py
# Description: Calculates and reports concurrent route sections in an LRS Network in the Python window.
# Requirements: ArcGIS Location Referencing

# Local tool variables
in_route_features = r"C:\Data\SampleData.gdb\LRS\NonlineNetwork"
out_dataset = r"C:\Data\SampleData.gdb\LRS\ConcurrentRoutes"
tvd = "06/09/2021"
find_dominance = "NO_FIND_DOMINANCE"
include_geometry = "EXCLUDE_GEOMETRY"

# Execute the tool
arcpy.locref.CalculateRouteConcurrencies(in_route_features, out_dataset, tvd, find_dominance, include_geometry)

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