Configurar reglas de predominio de ruta (Location Referencing)

Resumen

Configura un conjunto de reglas para determinar la ruta predominante en una red en la que hay rutas concurrentes.

Uso

• La opción Numérico del parámetro Tipo de orden solo admite números como, por ejemplo, 1, 2, 11, 22. La opción Alfanumérico admite números y texto, por ejemplo, 1, 2, 11, 22 y 1, 11A, 22A, 22B.

• Cuando se configuran varios campos mediante el parámetro Campos, los valores de campo se concatenan en el orden en el que se agregaron los campos. Por ejemplo, si el campo RouteType se agrega primero y tiene un valor de SR, y el campo RouteNumber se agrega segundo y tiene un valor de 18, el campo concatenado resultante es SR18.

  Por ejemplo, si SR18 es un Id. de ruta de varios campos que consta de los campos RouteType (SR) y RouteNumber (18), seleccione RouteType y RouteNumber en el parámetro Campos.

• Cuando se especifica el parámetro Excepciones, el predominio de la ruta se determina primero al hacer coincidir las excepciones en el orden en que aparecen en la lista y después por las reglas configuradas. Los valores del campo de excepción están separados por comas.

  Por ejemplo, si se configuran valores de Excepciones para Ruta3, Ruta7 y Ruta9, estas excepciones se consideran rutas predominantes en el orden mostrado antes de tener en cuenta cualquier regla configurada.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Clase de entidad de red LRS	Clase de entidad de entrada. Solo se puede utilizar una clase de entidad de red LRS registrada.	Feature Layer
Configurar tipo	Especifica el tipo de configuración que se aplicará al valor del parámetro Clase de entidad de red LRS. Agregar—Se agregará una nueva regla a la configuración. Actualizar—Solo se actualizará una regla existente. Eliminar—Se eliminará una regla existente.	String
Nombre de regla	Nombre de la regla que se agregará, actualizará o eliminará. El nombre de la regla puede contener hasta 30 caracteres.	String
Nombre de regla actualizado (Opcional)	Nombre actualizado de la regla. Este parámetro solo se utiliza cuando Actualizar se especifica como el valor del parámetro Configurar tipo.	String
Nombre de la tabla de origen (Opcional)	Tabla de eventos de origen o clase de entidad registrada en el valor del parámetro Clase de entidad de red LRS. Como alternativa, se puede utilizar la clase de entidad de red. Solo se admiten eventos de línea que no son intermedios.	String
Campos (Opcional)	Alias de campo de atributo en la tabla de origen. Si se utilizan varios campos, se concatenarán.	String
Método de ordenación (Opcional)	Especifica si la ordenación del predominio de ruta estará determinada por valores menores o mayores.	String
Tipo de pedido (Opcional)	Especifica el tipo de orden que se usará al evaluar cadenas de caracteres numéricos o alfanuméricos.	String
Excepciones priorizadas (Opcional)	Una lista separada por comas de excepciones proporcionadas por el usuario.	String

Salida derivada

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

Python

arcpy.locref.ConfigureRouteDominanceRules(in_feature_class, configure_type, rule_name, {updated_rule_name}, {source_table_name}, {fields}, {order_method}, {order_type}, {prioritized_exceptions})

Nombre	Explicación	Tipo de datos
in_feature_class	Clase de entidad de entrada. Solo se puede utilizar una clase de entidad de red LRS registrada.	Feature Layer
configure_type	Especifica el tipo de configuración que se aplicará al valor del parámetro in_feature_class. ADD—Se agregará una nueva regla a la configuración. UPDATE—Solo se actualizará una regla existente. DELETE—Se eliminará una regla existente.	String
rule_name	Nombre de la regla que se agregará, actualizará o eliminará. El nombre de la regla puede contener hasta 30 caracteres.	String
updated_rule_name (Opcional)	Nombre actualizado de la regla. Este parámetro solo se utiliza cuando se especifica UPDATE como valor del parámetro configure_type.	String
source_table_name (Opcional)	Tabla de eventos de origen o clase de entidad registrada en el valor del parámetro in_feature_class. Como alternativa, se puede utilizar la clase de entidad de red. Solo se admiten eventos de línea que no son intermedios.	String
fields [fields,...] (Opcional)	Alias de campo de atributo en la tabla de origen. Si se utilizan varios campos, se concatenarán.	String
order_method (Opcional)	Especifica si la ordenación del predominio de ruta estará determinada por valores menores o mayores.	String
order_type (Opcional)	Especifica el tipo de orden que se usará al evaluar cadenas de caracteres numéricos o alfanuméricos.	String
prioritized_exceptions (Opcional)	Una lista separada por comas de excepciones proporcionadas por el usuario.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_feature_class	Clase de entidad de red LRS actualizada.	Feature Layer

Muestra de código

Ejemplo 1 de ConfigureRouteDominanceRules (ventana de Python)

Muestra cómo agregar una regla de predominio de ruta mediante la función ConfigureRouteDominanceRules en la ventana de Python.

# Name: ConfigureRouteDominanceRules_Pro_ex1.py
# Description: Adds a rule to determine the dominant route in a network 
# where there are concurrent routes.
# Requirements: ArcGIS Location Referencing

# Local tool variables
in_feature_class = "C:\\LRdata\\LR.SDE\\LRSDataset\\RouteNetwork"
configure_type = "ADD"
rule_name = "Rule6"
updated_rule_name = ""
source_table_name = "FunctionalClass"
fields = "FunctionalClass"
order_method = "LESSER"
order_type = "NUMERIC"
prioritized_exceptions = ""

# Execute the tool
arcpy.locref.ConfigureRouteDominanceRules(in_feature_class, configure_type, rule_name, 
                                          updated_rule_name, source_table_name, fields, 
                                          order_method, order_type, prioritized_exceptions)

Ejemplo 2 de ConfigureRouteDominanceRules (ventana de Python)

Muestra cómo actualizar una regla de predominio de ruta mediante el uso de la función ConfigureRouteDominanceRules en la ventana de Python.

# Name: ConfigureRouteDominanceRules_Pro_ex2.py
# Description: Updates a rule to determine the dominant route in a network 
# where there are concurrent routes.
# Requirements: ArcGIS Location Referencing

# Local tool variables
in_feature_class = "C:\\LRdata\\LR.SDE\\LRSDataset\\RouteNetwork"
configure_type = "UPDATE"
rule_name = "Rule6"
updated_rule_name = "Rule7"
source_table_name = "FunctionalClass"
fields = "FunctionalClass"
order_method = "GREATER"
order_type = "NUMERIC"
prioritized_exceptions = ""

# Execute the tool
arcpy.locref.ConfigureRouteDominanceRules(in_feature_class, configure_type, rule_name, 
                                          updated_rule_name, source_table_name, fields, 
                                          order_method, order_type, prioritized_exceptions)

Ejemplo 3 de ConfigureRouteDominanceRules (script independiente)

Muestra cómo eliminar una regla de predominio de ruta mediante el uso de la función ConfigureRouteDominanceRules en un script independiente.

# Name: ConfigureRouteDominanceRules_Pro_ex3.py
# Description: Deletes a route dominance rule from the configured rules as 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_feature_class = "C:\\LRdata\\LR.SDE\\LRSDataset\\RouteNetwork"
configure_type = "DELETE"
rule_name = "Rule3"
updated_rule_name = ""
source_table_name = ""
fields = None
order_method = ""
order_type = ""
prioritized_exceptions = ""

# Execute the tool
arcpy.locref.ConfigureRouteDominanceRules(in_feature_class, configure_type, rule_name, 
                                          updated_rule_name, source_table_name, fields, 
                                          order_method, order_type, prioritized_exceptions)

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

Ejemplo 4 de ConfigureRouteDominanceRules (script independiente)

Muestra cómo agregar una regla de predominio de ruta con excepciones mediante el uso de la función ConfigureRouteDominanceRules en un script independiente.

# Name: ConfigureRouteDominanceRules_Pro_ex4.py
# Description: Add a rule as a stand-alone script with prioritized exceptions 
# to determine the dominant route in a network with concurrent routes.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local tool variables
in_feature_class = "C:\\LRdata\\LR.SDE\\LRSDataset\\RouteNetwork"
configure_type = "ADD"
rule_name = "Rule8"
updated_rule_name = ""
source_table_name = "RouteNetwork"
fields = "RouteName"
order_method = "LESSER"
order_type = "ALPHANUMERIC"
prioritized_exceptions = "US62"

# Execute the tool
arcpy.locref.ConfigureRouteDominanceRules(in_feature_class, configure_type, rule_name, 
                                          updated_rule_name, source_table_name, fields, 
                                          order_method, order_type, prioritized_exceptions)

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

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

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)