Resumen
Crea una configuración de trazado de red en la red de trazado.
Las configuraciones de trazado de red le permiten configurar y almacenar las propiedades de trazados complejos para su reutilización y uso compartido. Las configuraciones de trazado de red almacenadas en una red de trazado se pueden cargar y ejecutar desde la herramienta Trazado o compartir mediante un servicio de mapas consumido por un mapa web o una aplicación de campo.
Más información sobre cómo agregar una configuración de trazado de red
Uso
La red de trazado de entrada debe ser una versión 2 o posterior.
Al trabajar con una geodatabase corporativa, la red de trazado de entrada debe proceder de un servicio de red de trazado.
La cuenta del portal conectada se muestra como la creadora de la configuración del trazado de red.
La autenticación del sistema operativo se utiliza para almacenar el creador de una configuración de trazado cuando se trabaja con una red de trazado en una geodatabase de archivos.
Sintaxis
arcpy.tn.AddTraceConfiguration(in_trace_network, trace_config_name, trace_type, {description}, {tags}, {path_direction}, {shortest_path_network_attribute_name}, {include_barriers}, {validate_consistency}, {ignore_barriers_at_starting_points}, {allow_indeterminate_flow}, {condition_barriers}, {function_barriers}, {traversability_scope}, {functions}, {output_conditions}, {result_types})
Parámetro | Explicación | Tipo de datos |
in_trace_network | La red de trazado que contendrá la nueva configuración de trazado de red. | Trace Network; Trace Network Layer |
trace_config_name | El nombre de la configuración del trazado de red. | String |
trace_type | Especifica el tipo de trazado de red que se configurará.
| String |
description (Opcional) | La descripción de la configuración del trazado de red. | String |
tags [tags,...] (Opcional) | Un conjunto de etiquetas utilizadas para identificar la configuración del trazado de red. Las etiquetas se pueden utilizar en búsquedas e indexación. | String |
path_direction (Opcional) | Especifica la dirección de la ruta de trazado. El coste de recorrer la ruta se determina en función del valor del parámetro shortest_path_network_attribute_name. Este parámetro solo se respeta al ejecutar un trazado de tipo SHORTEST_PATH.
| String |
shortest_path_network_attribute_name (Opcional) | El nombre del atributo de red utilizado para calcular la ruta. Al ejecutar el tipo de trazado de ruta más corta, la ruta más corta se calcula utilizando un atributo de red, por ejemplo, la longitud de forma. Es posible conseguir rutas basadas tanto en el coste como en la distancia. Este parámetro es obligatorio si se ejecuta un trazado de ruta más corta. | String |
include_barriers (Opcional) | Especifica si las entidades de barrera de transitabilidad se incluirán en los resultados del seguimiento.
| Boolean |
validate_consistency (Opcional) | Especifica si se devuelve un error si se encuentran áreas sin validar en cualquiera de las entidades recorridas. Esta es la única forma de garantizar que un trazado pase por las entidades que presentan un estado coherente en la red. Para eliminar áreas sin validar, valide la topología de red.
| Boolean |
ignore_barriers_at_starting_points (Opcional) | Especifica si las barreras de la configuración de trazado se ignorarán en los puntos de partida.
| Boolean |
allow_indeterminate_flow (Opcional) | Especifica si se realizará un trazado de las entidades que presentan un flujo indeterminado o no inicializado. Este parámetro solo se respeta al ejecutar un trazado aguas arriba o aguas abajo.
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (Opcional) | Define una condición de barrera de transitabilidad en entidades basadas en una comparación con un atributo de red. Una condición de barrera utiliza un atributo de red, un operador y un tipo, y un valor de atributo. Por ejemplo, el trazado se detiene cuando una entidad tiene el atributo Code igual que el valor específico de ArtificialPath. Cuando una entidad cumple esta condición, el seguimiento se detiene. Si está utilizando más de un atributo, puede usar el componente Combine Using para definir una condición Y u O. Los componentes de condición de barrera son los siguientes:
Los componentes de Operator son los siguientes:
Los componentes de Type son los siguientes:
Los componentes de Combine Using son los siguientes:
| Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Opcional) | Define una barrera de transitabilidad en entidades basadas en una función. Las barreras de función se pueden utilizar, por ejemplo, para restringir cuánto se desplaza el trazado desde el punto de partida o para definir un valor máximo en el que se detiene un trazado. Por ejemplo, la longitud de cada línea recorrida se suma a la distancia total recorrida hasta ese momento. Cuando la longitud total recorrida alcanza el valor especificado, el seguimiento se detiene. Los componentes de barrera de función son los siguientes:
Los componentes de Function son los siguientes:
Los componentes de Operator son los siguientes:
Los componentes de Use Local Values son los siguientes:
| Value Table |
traversability_scope (Opcional) | Especifica si la transitabilidad se aplicará a cruces, ejes o ambos. Por ejemplo, en una red de rutas recreativas, si se define una condición de barrera para detener el trazado si el tipo de ruta es de grava y el alcance de la transitabilidad se define como solo cruces, el trazado no se detendrá ni siquiera si se encuentra con una ruta de grava, porque el tipo de ruta solo es aplicable a los ejes. Es decir, este parámetro indica al trazado si debe ignorar los cruces, ignorar los ejes o incluir tanto los cruces como los ejes en el trazado.
| String |
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (Opcional) | La función de cálculo que se aplicará al resultado del trazado de red. Los componentes de funciones son los siguientes:
Las opciones del componente Function son las siguientes:
Por ejemplo, una entidad de punto de partida tiene un valor de 20. La siguiente entidad tiene el valor 30. Si está usando la función MIN, el resultado es 20. MAX es 30, ADD es 50, AVERAGE es 25, COUNT es 2 y SUBTRACT es -10. Las opciones del componente Filter Operator son las siguientes:
Las opciones del componente Filter Type son las siguientes:
| Value Table |
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (Opcional) | Los tipos de entidades que se devolverán en función de un atributo de red. Por ejemplo, en un trazado configurado para excluir todo excepto las entidades Toma, las entidades procesadas por el trazado que no tengan asignado el atributo Toma no se incluyen en los resultados. Las entidades procesadas por el trazado que sí la tengan se devuelven en el conjunto de selección de resultado. Si se utiliza más de un atributo, puede usar la opción Combine Using para definir una condición Y u O. Los componentes de condiciones de salida son los siguientes:
Las opciones del componente Operator son las siguientes:
Las opciones del componente Type son las siguientes:
Las opciones del componente Combine Using son las siguientes:
| Value Table |
result_types [result_types,...] (Opcional) | Especifica el tipo de resultados que devolverá el trazado.
| String |
Salida derivada
Nombre | Explicación | Tipo de datos |
updated_trace_network | La red de trazado actualizada. | Red de trazado |
Muestra de código
Este script de ejemplo agrega una configuración de trazado de red denominada Upstream_HUC12 a una red de trazado denominada HydroNetwork.
import arcpy
arcpy.AddTraceConfiguration_un(
r"HydroNetwork", "Upstream_HUC12", "UPSTREAM",
"Upstream trace for HUC12_allow indeterminate", "HUC12;Upstream",
"NO_DIRECTION", '', "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY",
"DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", "TRACE_INDETERMINATE_FLOW",
None, None, "BOTH_JUNCTIONS_AND_EDGES", None, None, None)
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí