Modificar reglas de calibración de red (Location Referencing)

Resumen

Modifica las reglas de calibración de red para una red LRS.

Al crear una red LRS, puede elegir cómo se calibran las rutas con huecos al crear o editar rutas. Con esta herramienta, puede configurar reglas de calibración para una red una vez creada la Red LRS y durante el proceso de carga de datos.

Más información sobre cómo crear y modificar una red LRS en ArcGIS Pipeline Referencing o cómo crear y modificar una red LRS en ArcGIS Roads and Highways.

Puede utilizar cualquiera de los siguientes métodos para calibrar rutas con huecos físicos:

• Escalonar incremento
• Agregar incremento
• Distancia euclidiana

Cada método producirá un valor de calibración diferente para una ruta con huecos físicos creados con las herramientas de edición de LRS. El siguiente ejemplo muestra la calibración de una ruta creada a partir de una línea central con huecos físicos para cada método de calibración y la calibración de una ruta con retirada entre la medición 0,5 y 1 para cada método de calibración.

En el escenario de retirar ruta, se crea un hueco físico entre las mediciones 0,5 y 1. Las reglas de calibración solo se aplican si se introduce un hueco físico debido a una actividad de edición y no afectan a los huecos existentes. En el ejemplo, el hueco entre las mediciones 2 y 2,5 no se ve afectado por la retirada.

Uso

• En las tablas siguientes se muestran los resultados de la calibración de huecos mediante los paneles Crear ruta y Retirar ruta después de configurar reglas con esta herramienta.

  Crear una ruta con huecos físicos

  Crear ruta	Ejemplo de calibración	Descripción
  Escalonar incremento de 0,1		Se agrega un valor de medición de 0,1 a la primera medición después de cada hueco físico.
  Agregar incremento de 0,1		Se agrega un valor de medición de 0,1 a cada medición después de cada hueco físico.
  Distancia euclidiana		Después de cada hueco físico, se agrega a la primera medición un valor de medición igual a la distancia en línea recta del hueco físico.

  Retirar una ruta entre las mediciones 0,5 y 1

  Retirar ruta	Ejemplo de calibración	Descripción
  La ruta antes de la retirada crea un hueco físico		La parte de retirada de una ruta se muestra antes de crear un hueco físico con Retirar.
  Escalonar incremento de 0,1		Se agrega un valor de medición de 0,1 a la primera medición después del hueco físico.
  Agregar incremento de 0,1		Se agrega un valor de medición de 0,1 a cada medición después del hueco físico introducido debido a la retirada.
  Distancia euclidiana		Después del hueco físico introducido debido a la retirada, se agrega a la primera medición un valor de medición igual a la distancia en línea recta del hueco físico.

• Esta herramienta admite la definición de la regla de calibración de huecos y el desplazamiento de calibración para la red especificada.

• Normalmente, las reglas de calibración de red se pueden modificar una vez creada la red. El cambio de la regla de calibración aplicará la nueva regla solo a las rutas que se editen o carguen en el futuro. Todas las rutas editadas o cargadas anteriormente no respetarán la nueva regla de calibración. Respetan la regla de calibración establecida en el momento de su creación o edición.

• Puede utilizar la opción Tal cual del parámetro Regla de calibración para conservar el método de calibración de huecos existente con una opción para cambiar solo el valor de desplazamiento de calibración conforme al requisito.

• El parámetro Desplazamiento de calibración se debe establecer en los métodos de agregar incremento y escalonar incremento. Los valores deben ser numéricos, con o sin decimales; no se pueden usar valores negativos.

• El valor del parámetro Desplazamiento de calibración no puede ser menor o igual que la tolerancia m de la red. Puede ser cero o mayor que el valor de tolerancia m de la red.

• Si se define el valor del parámetro Desplazamiento de calibración en cero (0) se generará una ruta sin huecos en la medición de calibración en huecos físicos.

• La regla de calibración de huecos predeterminada para una red LRS es Escalonar incremento con un valor de desplazamiento de 0.

• Esta herramienta no es compatible con servicios de entidades.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Clase de entidad de red LRS	La clase de entidad de red LRS de entrada.	Feature Layer
Regla de calibración (Opcional)	Especifica el método que se utilizará para definir mediciones de huecos de calibración. Tal cual—El método definido existente en la red se utilizará al cambiar el valor de desplazamiento de calibración. Agregar distancia euclidiana—Se calculará y agregará la distancia euclidiana, o en línea recta, en cada hueco físico a lo largo de una ruta editada. Escalonar incremento—Se definirá un valor que se ajustará, o escalonará, en cada hueco físico de la ruta. Esta es la opción predeterminada. Agregar incremento—Se definirá un valor y se agregará a cada medición de una ruta en cada hueco físico, además de la longitud total de las mediciones inicial y final de la ruta.	String
Desplazamiento de calibración (Opcional)	El valor del método Agregar incremento o Escalonar incremento del parámetro Ruta de calibración. El valor de incremento debe ser numérico y puede incluir decimales.	Double
Actualizar mediciones de ruta en realineación cartográfica (Opcional)	Especifica si se deben recalibrar o no las mediciones de ruta basadas en cambios de longitud en la realineación cartográfica. Tal cual—Se utilizará el método definido existente en la red. Esta es la opción predeterminada. Habilitar—Habilite la recalibración de las mediciones de ruta en función de los cambios de longitud de la realineación cartográfica. Deshabilitar—Deshabilite la recalibración de las mediciones de ruta en función de los cambios de longitud de la realineación cartográfica.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Clase de entidad de red de salida	La capa de entidad de red actualizada.	Feature Layer

Python

arcpy.locref.ModifyNetworkCalibrationRules(in_feature_class, {calibration_rule}, {calibration_offset}, {update_measure_cartorealign})

Nombre	Explicación	Tipo de datos
in_feature_class	La clase de entidad de red LRS de entrada.	Feature Layer
calibration_rule (Opcional)	Especifica el método que se utilizará para definir mediciones de huecos de calibración. AS_IS—El método definido existente en la red se utilizará al cambiar el valor de desplazamiento de calibración. ADDING_EUCLIDEAN_DISTANCE—Se calculará y agregará la distancia euclidiana, o en línea recta, en cada hueco físico a lo largo de una ruta editada. STEPPING_INCREMENT—Se definirá un valor que se ajustará, o escalonará, en cada hueco físico de la ruta. Esta es la opción predeterminada. ADDING_INCREMENT—Se definirá un valor y se agregará a cada medición de una ruta en cada hueco físico, además de la longitud total de las mediciones inicial y final de la ruta.	String
calibration_offset (Opcional)	El valor del método Agregar incremento o Escalonar incremento del parámetro Ruta de calibración. El valor de incremento debe ser numérico y puede incluir decimales.	Double
update_measure_cartorealign (Opcional)	Especifica si se deben recalibrar o no las mediciones de ruta basadas en cambios de longitud en la realineación cartográfica. AS_IS—Se utilizará el método definido existente en la red. Esta es la opción predeterminada. ENABLE—Habilite la recalibración de las mediciones de ruta en función de los cambios de longitud de la realineación cartográfica. DISABLE—Deshabilite la recalibración de las mediciones de ruta en función de los cambios de longitud de la realineación cartográfica.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_feature_class	La capa de entidad de red actualizada.	Feature Layer

Muestra de código

Ejemplo de ModifyNetworkCalibrationRules 1 (ventana de Python)

El siguiente script muestra cómo utilizar la función ModifyNetworkCalibrationRules en la ventana de Python.

#Name: ModifyNetworkCalibrationRules_ex1.py
#Description: Use the ModifyNetworkCalibrationRules geoprocessing tool in the Python window.
#Requires: ArcGIS Location Referencing

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

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

# Tool variables
in_network_class = r"C:\Data\Lrs.gdb\LRS\LRSNetwork"
calibration_rule = "ADDING_INCREMENT"
calibration_offset = 0.1
recalibrate_route_measures_based_on_length_change_in_cartorealign = "ENABLE"

# Execute the tool
arcpy.locref.ModifyNetworkCalibrationRules(in_network_class, calibration_rule, calibration_offset, recalibrate_route_measures_based_on_length_change_in_cartorealign)

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

Ejemplo de ModifyNetworkCalibrationRules 2 (script independiente)

En el siguiente script se muestra cómo utilizar la función ModifyNetworkCalibrationRules como un script independiente de Python.

#Name: ModifyNetworkCalibrationRules_ex2.py
#Description: This script demonstrates how to use ModifyNetworkCalibrationRules geoprocessing tool in stand-alone Python script.
#Requires: ArcGIS Location Referencing license

#Import arcpy module
import arcpy

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

# Tool variables
in_network_class = r"C:\Data\Lrs.gdb\LRS\LRSNetwork"
calibration_rule = "ADDING_INCREMENT"
calibration_offset = 0.1
recalibrate_route_measures_based_on_length_change_in_cartorealign = "ENABLE"

# Execute the tool
arcpy.locref.ModifyNetworkCalibrationRules(in_network_class, calibration_rule, calibration_offset, recalibrate_route_measures_based_on_length_change_in_cartorealign)

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

Entornos

Espacio de trabajo actual

Información de licenciamiento

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