Trazado (Red de trazado)

Resumen

Devuelve entidades seleccionadas en una red de trazado basándose en la conectividad o la transitabilidad desde los puntos de partida especificados.

Las funciones de trazado de la red de trazado le permiten analizar rutas en la red. La transitabilidad se refiere al establecimiento de rutas a través de entidades conectadas que también cumplen requisitos de configuración concretos.

De forma predeterminada, los resultados del trazado se devuelven como una selección e incluyen toda la entidad de línea. Para devolver resultados de entidad parciales, defina el parámetro Tipos de resultados como Agregar geometría. Cuando una barrera o punto de partida se coloca en un cruce con conectividad de punto intermedio, los resultados del trazado devolverán elementos parciales de la entidad de eje. Cuando una barrera se coloca a lo largo de un eje, los resultados del trazado se pueden detener en el cruce más cercano con conectividad de punto intermedio. A continuación, el conjunto de selección resultante o clase de entidad de salida que genera el trazado se puede propagar a otro mapa, a una vista de diagrama de la red, o bien usarse como entrada para otra herramienta u otro trazado.

Más información sobre el trazado de una red de trazado

Uso

  • La topología de red debe estar habilitada.

  • Al trabajar con una geodatabase corporativa, la red de trazado de entrada debe provenir de un servicio de entidades; una red de trazado que provenga de una conexión de base de datos no es compatible.

  • Puesto que la herramienta Trazado depende de la topología de red, no está garantizado que los resultados del trazado sean precisos si existen áreas sin validar en la extensión del trazado. La topología de red del área en la que se desea realizar el trazado debe estar validada para reflejar las ediciones o actualizaciones más recientes de la red.

  • Al trabajar con atributos de red asignados a un campo de fecha para condiciones de barrera, funciones de barrera, funciones y condiciones de salida, formatee el valor de fecha como yyyy-mm-dd hh:mm:ss, por ejemplo, 2020-10-12 18:45:31.

Parámetros

EtiquetaExplicaciónTipo de datos
Red de trazado de entrada

La red de trazado en la que se ejecutará el trazado. Al trabajar con una geodatabase corporativa, la red de trazado de entrada debe provenir de un servicio de entidades; una red de trazado que provenga de una conexión de base de datos no es compatible.

Trace Network; Trace Network Layer
Tipo de trazado de red

Especifica el tipo de trazado que se va a ejecutar.

  • Conectado: se usará un trazado conectado que comienza en uno o varios puntos de partida y se expande hacia fuera a lo largo de entidades conectadas.
  • Aguas arriba: se usará un trazado aguas arriba que descubra entidades aguas arriba desde una ubicación de la red. Este tipo de trazado requiere que la dirección del flujo esté definida.
  • Aguas abajo: se usará un trazado aguas abajo que descubra entidades aguas abajo desde una ubicación de la red. Este tipo de trazado requiere que la dirección del flujo esté definida.
  • Ruta más corta: se usará un trazado de ruta más corta que busque la ruta más corta entre dos puntos de partida en la red, con independencia de la dirección del flujo. El coste de recorrer la ruta se determina en función del atributo de red definido para el parámetro Nombre de atributo de red de ruta más corta.

  • ConectadoSe usará un trazado conectado que comienza en uno o varios puntos de partida y se expande hacia fuera a lo largo de entidades conectadas.
  • Aguas arribaSe usará un trazado aguas arriba que descubra entidades aguas arriba desde una ubicación de la red. Este tipo de trazado requiere que la dirección del flujo esté definida.
  • Aguas abajoSe usará un trazado aguas abajo que descubra entidades aguas abajo desde una ubicación de la red. Este tipo de trazado requiere que la dirección del flujo esté definida.
  • Ruta más cortaSe usará un trazado de ruta más corta que busque la ruta más corta entre dos puntos de partida en la red, con independencia de la dirección del flujo. El coste de recorrer la ruta se determina en función del atributo de red definido para el parámetro shortest_path_network_attribute_name.
String
Puntos de partida

Una capa de entidades creada mediante la herramienta Puntos de partida del panel Ubicaciones de trazado, o bien una tabla o clase de entidad que contiene uno o varios registros que representan los puntos de partida del trazado. La clase de entidad TN_Temp_Starting_Points se utiliza de forma predeterminada y se genera en la geodatabase predeterminada del proyecto cuando crea puntos de partida mediante la herramienta Puntos de partida del panel Ubicaciones de trazado.

Feature Layer; Table View
Barreras
(Opcional)

Una tabla o clase de entidad que contiene una o varias entidades que representan las barreras del trazado que impiden que el trazado vaya más allá de ese punto. La clase de entidad TN_Temp_Barriers se utiliza de forma predeterminada y se genera en la geodatabase predeterminada del proyecto cuando crea barreras mediante la pestaña Barreras del panel Ubicaciones de trazado.

Feature Layer; Table View
Dirección de ruta
(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 Nombre de atributo de red de ruta más corta. Este parámetro solo se respeta al ejecutar un tipo de trazado de Ruta más corta.

  • Sin direcciónSe usará la ruta entre los dos puntos de partida, independientemente de la dirección del flujo. Esta es la opción predeterminada.
  • Ruta aguas arribaSe usará la ruta aguas arriba entre los dos puntos de partida.
  • Ruta aguas abajoSe usará la ruta aguas abajo entre los dos puntos de partida.
String
Nombre de atributo de red de ruta más corta
(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
Incluir entidades de barrera
(Opcional)

Especifica si las entidades de barrera de transitabilidad se incluirán en los resultados del trazado.

  • Activado: las entidades de barrera de transitabilidad se incluirán en los resultados del seguimiento. Esta es la opción predeterminada.
  • Desactivado: las entidades de barrera de transitabilidad no se incluirán en los resultados del seguimiento.
Boolean
Validar coherencia
(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.

  • Activado: el trazado de red devuelve un error si se encuentran áreas sin validar en cualquiera de las entidades recorridas. Esta es la opción predeterminada.
  • Desactivado: el trazado de red devuelve resultados independientemente de si se encuentran áreas sin validar en cualquiera de las entidades recorridas.

Boolean
Ignorar barreras en los puntos de partida
(Opcional)

Especifica si las barreras de la configuración de trazado se ignorarán en los puntos de partida.

  • Activado: las barreras de los puntos de partida se ignorarán en el trazado.
  • Desactivado: las barreras de los puntos de partida no se ignorarán en el trazado. Esta es la opción predeterminada.

Boolean
Permitir flujo indeterminado
(Opcional)

Especifica si se realizará un trazado de las entidades con un flujo indeterminado o no inicializado. Este parámetro solo se respeta al ejecutar un trazado aguas arriba o aguas abajo.

  • Activado: se realizará un trazado de las entidades con una dirección de flujo indeterminada o no inicializada.
  • Desactivado: no se realizará ningún trazado de las entidades con una dirección de flujo indeterminada o no inicializada. Esta es la opción predeterminada.

Boolean
Condición de barrera
(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 parámetro Combinar usando para definir una condición Y u O.

Los componentes de condición de barrera son los siguientes:

  • Nombre: filtre por cualquier atributo de red definido en el sistema.
  • Operador: elija entre una variedad de operadores.
  • Tipo: elija un valor o un atributo de red específicos del valor que se especifica en el componente Nombre.
  • Valor: proporciona un valor específico para un tipo de atributo de entrada que causaría la finalización en función de un valor del operador.
  • Combinar usando: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando una condición Y u O.

Los componentes de Operador son los siguientes:

  • Es igual que: el atributo es igual que el valor.
  • No es igual que: el atributo no es igual que el valor.
  • Es mayor que: el atributo es mayor que el valor.
  • Es mayor o igual que: el atributo es mayor o igual que el valor.
  • Es menor que: el atributo es menor que el valor.
  • Es menor o igual que: el atributo es menor o igual que el valor.

Los componentes de Tipo son los siguientes:

  • Valor específico: filtrar por un valor específico.
  • Atributo de red: filtrar por un atributo de red.

Los componentes de Combinar usando son los siguientes:

  • Y: combinar las condiciones de barrera.
  • O: usar si se cumple alguna de las condiciones de barrera.

  • Es igual queEl atributo es igual que el valor.
  • No es igual queEl atributo no es igual que el valor.
  • Es mayor queEl atributo es mayor que el valor.
  • Es mayor o igual queEl atributo es mayor o igual que el valor.
  • Es menor queEl atributo es menor que el valor.
  • Es menor o igual queEl atributo es menor o igual que el valor.
  • Valor específicoFiltrar por un valor específico.
  • Atributo de redFiltrar por un atributo de red.
  • YCombinar las barreras de condición.
  • OUsar si se cumple alguna de las barreras de condición.
Value Table
Barreras de función
(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:

  • Función: elija entre una variedad de funciones de cálculo.
  • Atributo: filtre por cualquier atributo de red definido en el sistema.
  • Operador: elija entre una variedad de operadores.
  • Valor: indique un valor específico para el tipo de atributo de entrada que, si se descubre, causará la finalización.
  • Usar valores locales: calcule los valores de cada dirección, en lugar de un valor global general. Por ejemplo, una barrera de función calcula la suma de la longitud de forma, en la que el trazado termina si el valor es mayor o igual que 4. En el caso global, después de haber hecho un trazado poligonal de dos ejes con un valor de 2, ya ha alcanzado una longitud de forma cuya suma sea 4, de forma que el trazado finaliza. Si se utilizan valores locales, los valores locales a lo largo de cada ruta cambian y el trazado continúa.

Los componentes de Función son los siguientes:

  • Mínimo: el mínimo de valores de entrada.
  • Máximo: el máximo de valores de entrada.
  • Suma: la suma de los valores de entrada.
  • Promedio: el promedio de los valores de entrada.
  • Recuento: el número de entidades.
  • Resta: la diferencia entre los valores de entrada.

Por ejemplo, tiene una entidad de punto de partida con un valor de 20. La siguiente entidad tiene el valor 30. Si utiliza la función mínimo, el resultado es 20; máximo es 30; suma es 50; promedio es 25; recuento es 2; y resta es -10.

Los componentes de Operador son los siguientes:

  • Es igual que: el atributo es igual que el valor.
  • No es igual que: el atributo no es igual que el valor.
  • Es mayor que: el atributo es mayor que el valor.
  • Es mayor o igual que: el atributo es mayor o igual que el valor.
  • Es menor que: el atributo es menor que el valor.
  • Es menor o igual que: el atributo es menor o igual que el valor.

Los componentes de Usar valores locales son los siguientes:

  • Activado: se utilizarán los valores locales.
  • Desactivado: se utilizarán valores globales. Esta es la opción predeterminada.

  • MediaEl promedio de los valores de entrada.
  • RecuentoEl número de entidades.
  • Máx.El máximo de valores de entrada.
  • Mín.El mínimo de valores de entrada.
  • AgregarSumar los valores.
  • SustraerRestar los valores.
  • Es igual queEl atributo es igual que el valor.
  • No es igual queEl atributo no es igual que el valor.
  • Es mayor queEl atributo es mayor que el valor.
  • Es mayor o igual queEl atributo es mayor o igual que el valor.
  • Es menor queEl atributo es menor que el valor.
  • Es menor o igual queEl atributo es menor o igual que el valor.
Value Table
Aplicar transitabilidad a
(Opcional)

Especifica el tipo de transitabilidad que se aplicará. El alcance de la transitabilidad determina si esta se aplica a los cruces, los ejes o en ambos. Por ejemplo, en una red de rutas recreativas, si se define una condición de barrera para detener un trazado en caso de que un atributo surfacetype contenga un valor de grava y el alcance de la transitabilidad se defina como solo cruces, el trazado no se detendrá ni siquiera si se encuentra con una entidad de eje con este valor en el campo surfacetype, porque el atributo surfacetype solo es aplicable a los ejes.

  • Tanto a los cruces como a los ejesSe aplicará la transitabilidad tanto a los cruces como a los ejes. Esta es la opción predeterminada.
  • Solo a los crucesSolo se aplicará la transitabilidad a los cruces.
  • Solo a los ejesSolo se aplicará la transitabilidad a los ejes.
String
Funciones
(Opcional)

La función o funciones de cálculo que se aplicarán al resultado del trazado de red.

Los componentes de funciones son los siguientes:

  • Función: elija entre una variedad de funciones de cálculo.
  • Atributo: filtre por cualquier atributo de red definido en el sistema.
  • Nombre de filtro: filtre los resultados de la función por nombre de atributo.
  • Operador de filtro: elija entre una variedad de operadores.
  • Tipo de filtro: elija entre una variedad de tipos de filtros.
  • Valor de filtro: indique un valor específico para el atributo de filtro de entrada.

Las opciones del componente Función son las siguientes:

  • Mín: el mínimo de valores de entrada.
  • Máx: el máximo de valores de entrada.
  • Suma: la suma de los valores de entrada.
  • Promedio: el promedio de los valores de entrada.
  • Recuento: el número de entidades.
  • Resta: la diferencia entre los valores de entrada.

Por ejemplo, tiene una entidad de punto de partida con un valor de 20. La siguiente entidad tiene el valor 30. Si está usando la función Mín, el resultado es 20. Máx es 30, Suma es 50, Promedio es 25, Recuento es 2 y Resta es -10.

Las opciones del componente Operador de filtro son las siguientes:

  • Es igual que: el atributo es igual que el valor.
  • No es igual que: el atributo no es igual que el valor.
  • Es mayor que: el atributo es mayor que el valor.
  • Es mayor o igual que: el atributo es mayor o igual que el valor.
  • Es menor que: el atributo es menor que el valor.
  • Es menor o igual que: el atributo es menor o igual que el valor.

Las opciones del componente Tipo de filtro son las siguientes:

  • Valor específico: filtrar por un valor específico.
  • Atributo de red: filtrar por un atributo de red.

  • MediaEl promedio de los valores de entrada.
  • RecuentoEl número de entidades.
  • Máx.El máximo de valores de entrada.
  • Mín.El mínimo de valores de entrada.
  • AgregarLa suma de los valores.
  • SustraerLa diferencia entre los valores.
  • Es igual queEl atributo es igual que el valor.
  • No es igual queEl atributo no es igual que el valor.
  • Es mayor queEl atributo es mayor que el valor.
  • Es mayor o igual queEl atributo es mayor o igual que el valor.
  • Es menor queEl atributo es menor que el valor.El atributo es menor que el valor.
  • Es menor o igual que
Value Table
Condiciones de salida
(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.

Los componentes de condiciones de salida son los siguientes:

  • Nombre: filtre por cualquier atributo de red definido en el sistema.
  • Operador: elija entre una variedad de operadores.
  • Tipo: elija un valor o un atributo de red específicos del valor que se especifica en el componente Nombre.
  • Valor: proporciona un valor específico para un tipo de atributo de entrada que causaría la finalización en función de un valor del operador.
  • Combinar usando: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando una condición Y u O.

Las opciones del componente Operador son las siguientes:

  • Es igual que: el atributo es igual que el valor.
  • No es igual que: el atributo no es igual que el valor.
  • Es mayor que: el atributo es mayor que el valor.
  • Es mayor o igual que: el atributo es mayor o igual que el valor.
  • Es menor que: el atributo es menor que el valor.
  • Es menor o igual que: el atributo es menor o igual que el valor.

Las opciones del componente Tipo son las siguientes:

  • Valor específico: filtrar por un valor específico.
  • Atributo de red: filtrar por un atributo de red.

  • Es igual queEl atributo es igual que el valor.
  • No es igual queEl atributo no es igual que el valor.
  • Es mayor queEl atributo es mayor que el valor.
  • Es mayor o igual queEl atributo es mayor o igual que el valor.
  • Es menor queEl atributo es menor que el valor.El atributo es menor que el valor.
  • Es menor o igual que
Value Table
Tipos de resultados
(Opcional)

Especifica el tipo de resultados que devolverá el trazado.

  • SelecciónLos resultados del trazado se devolverán como una selección definida en las entidades de red adecuadas. Esta es la opción predeterminada.
  • Geometría agregadaLos resultados del trazado se agregarán por tipo de geometría y se almacenarán en clases de entidad que se muestran en capas en el mapa activo.
  • Capas de redLos resultados del trazado de red se agregarán a capas de entidades como un conjunto de selección de una capa de grupo.
  • ConectividadLos resultados del seguimiento se devolverán como un gráfico de conectividad en un archivo .json de salida especificado. Esta opción habilita el parámetro JSON de salida.
  • ElementosLos resultados del seguimiento se devolverán como información basada en entidades en un archivo .json de salida especificado. Esta opción habilita el parámetro JSON de salida.
String
Tipo de selección

Especifica cómo se aplicará la selección y qué hacer si existe una selección actual.

  • Nueva selecciónLa selección resultante reemplazará a la selección actual. Esta es la opción predeterminada.
  • Añadir a selección actualLa selección resultante se agregará a la selección actual, si la hay. Si no existe ninguna selección, coincide con la opción de nueva selección.
  • Eliminar de la selección actualLa selección resultante se quitará de la selección actual. Si no existe ninguna selección, esta opción no tendrá efecto.
  • Seleccionar subconjunto de la selección actualLa selección resultante se combinará con la selección actual. Solo permanecen seleccionados los registros comunes a ambas selecciones.
  • Cambiar la selección actualLa selección resultante se conmutará. Los resultados seleccionados se quitan de la selección actual; los resultados no seleccionados se agregan a la selección actual. Si no existe ninguna selección, coincide con la opción de nueva selección.
String
Borrar todos los resultados anteriores del trazado
(Opcional)

Especifica si el contenido se truncará de las clases de entidad elegidas o se incorporará a ellas para almacenar la geometría agregada. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

  • Activado: las clases de entidad que almacenan geometría agregada de trazado se truncarán. Solo se escribirá la geometría de salida de la operación de trazado actual. Esta es la opción predeterminada.
  • Desactivado: la geometría de salida de la operación de trazado actual se incorporará a las clases de entidad que almacenen geometría agregada.
Boolean
Nombre de trazado
(Opcional)

El nombre de la operación de trazado. Este valor se almacena en el campo TRACENAME de la clase de entidad de salida para ayudar a identificar los resultados del trazado de red. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

String
Puntos agregados
(Opcional)

Una clase de entidad multipunto de salida que contiene la geometría de resultados agregada. De forma predeterminada, el parámetro se rellena con una clase de entidad generada por el sistema denominada Trace_Results_Aggregated_Points que se almacenará en la geodatabase predeterminada del proyecto.

Esta clase de entidad se creará automáticamente si no existe ya. También es posible utilizar una clase de entidad existente para almacenar geometría agregada. Si se utiliza otra clase de entidad que no es la predeterminada, debe ser una clase de entidad multipunto y contener un campo de cadena de caracteres llamado TRACENAME. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

Feature Class
Líneas agregadas
(Opcional)

Una clase de entidad de polilínea de salida que contiene la geometría de resultados agregada. De forma predeterminada, el parámetro se rellena con una clase de entidad generada por el sistema denominada Trace_Results_Aggregated_Lines que se almacenará en la geodatabase predeterminada del proyecto.

Esta clase de entidad se creará automáticamente si no existe ya. También es posible utilizar una clase de entidad existente para almacenar geometría agregada. Si se utiliza otra clase de entidad que no es la predeterminada, debe ser una clase de entidad de polilínea y contener un campo de cadena de caracteres llamado TRACENAME. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

Feature Class
Nombre de capa de grupo de salida
(Opcional)

El nombre de la capa de grupo de salida que contiene capas de entidades con conjuntos de selección de entidades devueltos por el trazado de red. La capa proporciona acceso para trabajar con la salida de un trazado de red en ModelBuilder y Python.

Este parámetro solo se aplica al tipo de resultado de capas de red.

Group Layer
Utilizar configuración de trazado
(Opcional)

Especifica si se utilizará una configuración de trazado de red nominal existente para rellenar los parámetros de la herramienta Trazado.

  • Activado: se utilizará una configuración de trazado de red nominal existente para definir las propiedades del trazado. Se ignorarán todos los parámetros excepto Nombre de configuración de trazado de red, Puntos de partida y Barreras.
  • Desactivado: no se utilizará ninguna configuración de trazado de red nominal existente para definir las propiedades del trazado. Esta es la opción predeterminada.

Nota:

Este parámetro requiere una Versión de red de trazado 2 o posterior.

Boolean
Nombre de configuración de trazado de red
(Opcional)

El nombre de la configuración de trazado que se utilizará para definir las propiedades del trazado. Este parámetro solo está activado cuando el parámetro Utilizar configuración de trazado está activado.

Nota:

Este parámetro requiere una Versión de red de trazado 2 o posterior.

String
JSON de salida
(Opcional)

El nombre y la ubicación del archivo .json que se generará.

File

Salida derivada

EtiquetaExplicaciónTipo de datos
Red de trazado actualizada

La red de trazado actualizada.

Any Value

arcpy.tn.Trace(in_trace_network, trace_type, starting_points, {barriers}, {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}, selection_type, {clear_all_previous_trace_results}, {trace_name}, {aggregated_points}, {aggregated_lines}, {out_network_layer}, {use_trace_config}, {trace_config_name}, {out_json_file})
NombreExplicaciónTipo de datos
in_trace_network

La red de trazado en la que se ejecutará el trazado. Al trabajar con una geodatabase corporativa, la red de trazado de entrada debe provenir de un servicio de entidades; una red de trazado que provenga de una conexión de base de datos no es compatible.

Trace Network; Trace Network Layer
trace_type

Especifica el tipo de trazado que se desea ejecutar.

  • CONNECTEDSe usará un trazado conectado que comienza en uno o varios puntos de partida y se expande hacia fuera a lo largo de entidades conectadas.
  • UPSTREAMSe usará un trazado aguas arriba que descubra entidades aguas arriba desde una ubicación de la red. Este tipo de trazado requiere que la dirección del flujo esté definida.
  • DOWNSTREAMSe usará un trazado aguas abajo que descubra entidades aguas abajo desde una ubicación de la red. Este tipo de trazado requiere que la dirección del flujo esté definida.
  • SHORTEST_PATHSe usará un trazado de ruta más corta que busque la ruta más corta entre dos puntos de partida en la red, con independencia de la dirección del flujo. El coste de recorrer la ruta se determina en función del atributo de red definido para el parámetro shortest_path_network_attribute_name.
String
starting_points

Una capa de entidades creada mediante la herramienta Puntos de partida del panel Ubicaciones de trazado, o bien una tabla o clase de entidad que contiene uno o varios registros que representan los puntos de partida del trazado. La clase de entidad TN_Temp_Starting_Points se utiliza de forma predeterminada y se genera en la geodatabase predeterminada del proyecto cuando crea puntos de partida mediante la herramienta Puntos de partida del panel Ubicaciones de trazado.

Feature Layer; Table View
barriers
(Opcional)

Una tabla o clase de entidad que contiene una o varias entidades que representan las barreras del trazado que impiden que el trazado vaya más allá de ese punto. La clase de entidad TN_Temp_Barriers se utiliza de forma predeterminada y se genera en la geodatabase predeterminada del proyecto cuando crea barreras mediante la pestaña Barreras del panel Ubicaciones de trazado.

Feature Layer; Table View
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.

  • NO_DIRECTIONSe usará la ruta entre los dos puntos de partida, independientemente de la dirección del flujo. Esta es la opción predeterminada.
  • PATH_UPSTREAMSe usará la ruta aguas arriba entre los dos puntos de partida.
  • PATH_DOWNSTREAMSe usará la ruta aguas abajo entre los dos puntos de partida.
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 trazado.

  • INCLUDE_BARRIERSLas entidades de barrera de transitabilidad se incluirán en los resultados del trazado. Esta es la opción predeterminada.
  • EXCLUDE_BARRIERSLas entidades de barrera de transitabilidad no se incluirán en los resultados del trazado.
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.

  • VALIDATE_CONSISTENCYEl trazado de red devuelve un error si se encuentran áreas sin validar en cualquiera de las entidades recorridas. Esta es la opción predeterminada.
  • DO_NOT_VALIDATE_CONSISTENCYEl trazado de red devuelve resultados independientemente de si se encuentran áreas sin validar en cualquiera de las entidades recorridas.
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.

  • IGNORE_BARRIERS_AT_STARTING_POINTSLas barreras de los puntos de partida se ignorarán en el trazado.
  • DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTSLas barreras de los puntos de partida no se ignorarán en el trazado. Esta es la opción predeterminada.
Boolean
allow_indeterminate_flow
(Opcional)

Especifica si se realizará un trazado de las entidades con un flujo indeterminado o no inicializado. Este parámetro solo se respeta al ejecutar un trazado aguas arriba o aguas abajo.

  • TRACE_INDETERMINATE_FLOWSe realizará un trazado de las entidades con una dirección de flujo indeterminada o no inicializada.
  • IGNORE_INDETERMINATE_FLOWNo se realizará ningún trazado de las entidades con una dirección de flujo indeterminada o no inicializada. Esta es la opción predeterminada.
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:

  • Name: filtre por cualquier atributo de red definido en el sistema.
  • Operator: elija entre una variedad de operadores diferentes.
  • Type: elija un valor o un atributo de red específicos del valor que se especifica en el componente Name.
  • Value: proporcione un valor específico para un tipo de atributo de entrada que causaría la finalización en función de un valor del operador.
  • Combine Using: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando una condición Y u O.

Los componentes de Operator son los siguientes:

  • IS_EQUAL_TOEl atributo es igual que el valor.
  • DOES_NOT_EQUALEl atributo no es igual que el valor.
  • IS_GREATER_THANEl atributo es mayor que el valor.
  • IS_GREATER_THAN_OR_EQUAL_TOEl atributo es mayor o igual que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.
  • IS_LESS_THAN_OR_EQUAL_TOEl atributo es menor o igual que el valor.

Los componentes de Type son los siguientes:

  • SPECIFIC_VALUEFiltrar por un valor específico.
  • NETWORK_ATTRIBUTEFiltrar por un atributo de red.

Los componentes de Combine Using son los siguientes:

  • ANDCombinar las barreras de condición.
  • ORUsar si se cumple alguna de las barreras de condición.
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:

  • Function: elija entre una variedad de funciones de cálculo.
  • Attribute: filtre por cualquier atributo de red definido en el sistema.
  • Operator: elija entre una variedad de operadores.
  • Value: indique un valor específico para el tipo de atributo de entrada que, si se descubre, causará la finalización.
  • Use Local Values: calcule valores en todas las direcciones, en lugar de un valor global general. Por ejemplo, una barrera de función calcula la suma de la longitud de forma, en la que el trazado termina si el valor es mayor o igual que 4. En el caso global, después de haber hecho un trazado poligonal de dos ejes con un valor de 2, ya ha alcanzado una longitud de forma cuya suma sea 4, de forma que el trazado finaliza. Si se utilizan valores locales, los valores locales a lo largo de cada ruta cambian y el trazado continúa.

Los componentes de Function son los siguientes:

  • AVERAGEEl promedio de los valores de entrada.
  • COUNTEl número de entidades.
  • MAXEl máximo de valores de entrada.
  • MINEl mínimo de valores de entrada.
  • ADDSumar los valores.
  • SUBTRACTRestar los valores.

Los componentes de Operator son los siguientes:

  • IS_EQUAL_TOEl atributo es igual que el valor.
  • DOES_NOT_EQUALEl atributo no es igual que el valor.
  • IS_GREATER_THANEl atributo es mayor que el valor.
  • IS_GREATER_THAN_OR_EQUAL_TOEl atributo es mayor o igual que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.
  • IS_LESS_THAN_OR_EQUAL_TOEl atributo es menor o igual que el valor.

Los componentes de Use Local Values son los siguientes:

  • TRUEUsar valores locales.
  • FALSEUsar valores globales. Esta es la opción predeterminada.
Value Table
traversability_scope
(Opcional)

Especifica el tipo de transitabilidad que se aplicará. El alcance de la transitabilidad determina si esta se aplica a los cruces, los ejes o en 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.

  • BOTH_JUNCTIONS_AND_EDGESSe aplicará la transitabilidad tanto a los cruces como a los ejes. Esta es la opción predeterminada.
  • JUNCTIONS_ONLYSolo se aplicará la transitabilidad a los cruces.
  • EDGES_ONLYSolo se aplicará la transitabilidad a los ejes.
String
functions
[[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...]
(Opcional)

La función o funciones de cálculo que se aplicarán al resultado del trazado de red.

Los componentes de funciones son los siguientes:

  • Function: elija entre una variedad de funciones de cálculo.
  • Attribute: filtre por cualquier atributo de red definido en el sistema.
  • Filter Name: filtre los resultados de la función por nombre de atributo.
  • Filter Operator: elija entre una variedad de operadores.
  • Filter Type: elija entre una variedad de tipos de filtros.
  • Filter Value: indique un valor específico para el atributo de filtro de entrada.

Las opciones de los componentes de Function son las siguientes:

  • AVERAGEEl promedio de los valores de entrada.
  • COUNTEl número de entidades.
  • MAXEl máximo de valores de entrada.
  • MINEl mínimo de valores de entrada.
  • ADDLa suma de los valores.
  • SUBTRACTLa diferencia entre los valores.

Por ejemplo, tiene una entidad de punto de partida con un valor de 20. La siguiente entidad tiene el valor 30. Si está utilizando 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 de los componentes de Filter Operator son las siguientes:

  • IS_EQUAL_TOEl atributo es igual que el valor.
  • DOES_NOT_EQUALEl atributo no es igual que el valor.
  • IS_GREATER_THANEl atributo es mayor que el valor.
  • IS_GREATER_THAN_OR_EQUAL_TOEl atributo es mayor o igual que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.

Las opciones de los componentes de Filter Type son las siguientes:

  • SPECIFIC_VALUEFiltrar por un valor específico.
  • NETWORK_ATTRIBUTEFiltrar por un atributo de red.
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:

  • Name: filtre por cualquier atributo de red definido en el sistema.
  • Operator: elija entre una variedad de operadores.
  • Type: elija un valor o un atributo de red específicos del valor que se especifica en el componente Name.
  • Value: indique un valor específico de un tipo de atributo de entrada que causaría la finalización en función de un valor del operador.
  • Combine Using: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando una condición Y u O.

Las opciones de los componentes de Operator son las siguientes:

  • IS_EQUAL_TOEl atributo es igual que el valor.
  • DOES_NOT_EQUALEl atributo no es igual que el valor.
  • IS_GREATER_THANEl atributo es mayor que el valor.
  • IS_GREATER_THAN_OR_EQUAL_TOEl atributo es mayor o igual que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.

Las opciones de los componentes de Type son las siguientes:

  • SPECIFIC_VALUEFiltrar por un valor específico.
  • NETWORK_ATTRIBUTEFiltrar por un atributo de red.

Las opciones de los componentes de Combine Using son las siguientes:

  • ANDCombinar las condiciones.
  • ORUsar si se cumple alguna de las condiciones.
Value Table
result_types
[result_types,...]
(Opcional)

Especifica el tipo de resultados que devolverá el trazado.

  • SELECTIONLos resultados del trazado se devolverán como una selección definida en las entidades de red adecuadas. Esta es la opción predeterminada.
  • AGGREGATED_GEOMETRYLos resultados del trazado se agregarán por tipo de geometría y se almacenarán en clases de entidad que se muestran en capas en el mapa activo.
  • NETWORK_LAYERSLos resultados del trazado de red se agregarán a capas de entidades como un conjunto de selección de una capa de grupo.
  • CONNECTIVITYLos resultados del seguimiento se devolverán como un gráfico de conectividad en un archivo .json de salida especificado. Esta opción habilita el parámetro out_json_file.
  • ELEMENTSLos resultados del seguimiento se devolverán como elementos de entidad en un archivo .json de salida especificado. Esta opción habilita el parámetro out_json_file.
String
selection_type

Especifica cómo se aplicará la selección y qué hacer si existe una selección actual.

  • NEW_SELECTIONLa selección resultante reemplazará a la selección actual. Esta es la opción predeterminada.
  • ADD_TO_SELECTIONLa selección resultante se agregará a la selección actual, si la hay. Si no existe ninguna selección, coincide con la opción de nueva selección.
  • REMOVE_FROM_SELECTIONLa selección resultante se quitará de la selección actual. Si no existe ninguna selección, esta opción no tendrá efecto.
  • SUBSET_SELECTIONLa selección resultante se combinará con la selección actual. Solo permanecen seleccionados los registros comunes a ambas selecciones.
  • SWITCH_SELECTIONLa selección resultante se conmutará. Los resultados seleccionados se quitan de la selección actual; los resultados no seleccionados se agregan a la selección actual. Si no existe ninguna selección, coincide con la opción de nueva selección.
String
clear_all_previous_trace_results
(Opcional)

Especifica si el contenido se truncará de las clases de entidad elegidas o se incorporará a ellas para almacenar la geometría agregada. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

  • CLEAR_ALL_PREVIOUS_TRACE_RESULTSLas clases de entidad que almacenan geometría agregada de trazado se truncarán. Solo se escribirá la geometría de salida de la operación de trazado actual. Esta es la opción predeterminada.
  • DO_NOT_CLEAR_ALL_PREVIOUS_TRACE_RESULTSLa geometría de salida de la operación de trazado actual se incorporará a las clases de entidad que almacenen geometría agregada.
Boolean
trace_name
(Opcional)

El nombre de la operación de trazado. Este valor se almacena en el campo TRACENAME de la clase de entidad de salida para ayudar a identificar los resultados del trazado de red. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

String
aggregated_points
(Opcional)

Una clase de entidad multipunto de salida que contiene la geometría de resultados agregada. De forma predeterminada, el parámetro se rellena con una clase de entidad generada por el sistema denominada Trace_Results_Aggregated_Points que se almacenará en la geodatabase predeterminada del proyecto.

Esta clase de entidad se creará automáticamente si no existe ya. También es posible utilizar una clase de entidad existente para almacenar geometría agregada. Si se utiliza otra clase de entidad que no es la predeterminada, debe ser una clase de entidad multipunto y contener un campo de cadena de caracteres llamado TRACENAME. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

Feature Class
aggregated_lines
(Opcional)

Una clase de entidad de polilínea de salida que contiene la geometría de resultados agregada. De forma predeterminada, el parámetro se rellena con una clase de entidad generada por el sistema denominada Trace_Results_Aggregated_Lines que se almacenará en la geodatabase predeterminada del proyecto.

Esta clase de entidad se creará automáticamente si no existe ya. También es posible utilizar una clase de entidad existente para almacenar geometría agregada. Si se utiliza otra clase de entidad que no es la predeterminada, debe ser una clase de entidad de polilínea y contener un campo de cadena de caracteres llamado TRACENAME. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

Feature Class
out_network_layer
(Opcional)

El nombre de la capa de grupo de salida que contiene capas de entidades con conjuntos de selección de entidades devueltos por el trazado de red. La capa proporciona acceso para trabajar con la salida de un trazado de red en ModelBuilder y Python.

Este parámetro solo se aplica al tipo de resultado de capas de red.

Group Layer
use_trace_config
(Opcional)

Especifica si se utilizará una configuración de trazado de red nominal existente para rellenar los parámetros de la herramienta Trazado.

  • USE_TRACE_CONFIGURATIONSe utilizará una configuración de trazado de red nominal existente para definir las propiedades del trazado. Se ignorarán todos los parámetros excepto trace_config_name, starting_points y barriers.
  • DO_NOT_USE_TRACE_CONFIGURATIONNo se utilizará ninguna configuración de trazado de red nominal existente para definir las propiedades del trazado. Esta es la opción predeterminada.
Nota:

Este parámetro requiere una Versión de red de trazado 2 o posterior.

Boolean
trace_config_name
(Opcional)

El nombre de la configuración de trazado que se utilizará para definir las propiedades del trazado. Este parámetro solo está habilitado cuando el parámetro use_trace_config tiene el valor USE_TRACE_CONFIGURATION.

Nota:

Este parámetro requiere una Versión de red de trazado 2 o posterior.

String
out_json_file
(Opcional)

El nombre y la ubicación del archivo .json que se generará.

File

Salida derivada

NombreExplicaciónTipo de datos
updated_trace_network

La red de trazado actualizada.

Any Value

Muestra de código

Ejemplo de Trace (ventana de Python)

Ejecute un trazado aguas abajo en una red de trazado llamada HydroNetwork con la función Trace.

import arcpy
arcpy.Trace_tn(r"C:\MyProject\NHD.gdb\Hydro\HydroNetwork", 
               "DOWNSTREAM", r"C:\MyProject\NHD.gdb\TN_Temp_Starting_Points")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: No
  • Standard: Sí
  • Advanced: Sí

Temas relacionados