Aplicar diseño de línea principal relativa (Diagrama de red)

Resumen

Organiza las entidades de diagrama de red en el diagrama activo a lo largo de líneas rectas paralelas.

Más información acerca del algoritmo de diseño Línea principal relativa

Precaución:

Si tiene una sesión de edición abierta, debe guardar sus ediciones antes de ejecutar esta herramienta. Con ello se garantiza que el diagrama refleje los cambios más recientes aplicados a la topología de red en la base de datos. Si no guarda las ediciones, estas no se reflejarán en el diagrama.

Nota:

Todos los algoritmos de diseño incluyen valores predeterminados para los parámetros. Los valores predeterminados de los parámetros son los que se usan mientras no se especifique otro valor. Si el diagrama de red de entrada se basa en una plantilla para la cual este diseño tiene configurado otro valor de parámetro, se utiliza en su lugar este valor.

Uso

  • Esta herramienta no se admite al trabajar con una conexión de base de datos a una red de servicios o red de trazado de una geodatabase corporativa. Debe usar el servicio de red de servicios o red de trazado publicado relacionado o una red de servicios o red de trazado de una geodatabase de archivos.

  • La capa de diagrama de red de entrada debe provenir de una red de servicios o una red de trazado de una geodatabase de archivos o un servicio de diagramas de red.

  • Este diseño organiza las entidades de diagrama de red en el diagrama activo a lo largo de líneas rectas paralelas, en las que todos los ejes conectados tienen el mismo valor de atributo. También coloca las ramas de esas líneas, conservando sus direcciones respecto a las líneas rectas y las distancias proporcionales a la distancia inicial y relativa entre sí.

  • Este algoritmo necesita atributos de red con valores específicos en las clases de línea de red para identificar los ejes que componen cada línea recta, además de clasificar cada eje para darle prioridad en el proceso o excluirlo del mismo.

  • Este diseño se puede aplicar a cualquier dato que haga referencia a líneas paralelas, incluso si no se ha diseñado para vías ferroviarias.

  • Es posible establecer los marcadores de raíz para especificar los puntos de los cruces donde comienzan las líneas rectas. Si no se establece ninguna raíz, el algoritmo busca primero cruces que están conectados con un único eje que se puede considerar el punto de partida de una línea recta. A partir de estos candidatos a cruces, el cruce raíz será en el que comience la línea recta más larga.

  • Plantéese aplicar el diseño en modo asíncrono en el servidor al trabajar en diagramas muy grandes.

Sintaxis

arcpy.nd.ApplyRelativeMainlineLayout(in_network_diagram_layer, line_attribute, {mainline_direction}, {offset_between_branches}, {breakpoint_angle}, {type_attribute}, {mainline_values}, {branch_values}, {excluded_values}, {is_compressing}, {compression_ratio}, {minimal_distance}, {alignment_attribute}, {initial_distances}, {length_attribute}, {run_async})
ParámetroExplicaciónTipo de datos
in_network_diagram_layer

El diagrama de red al que se aplica el diseño.

Diagram Layer
line_attribute

El nombre del atributo de red que se usará para identificar las líneas que comprenden las líneas rectas. Este atributo de red debe existir en las clases de línea de red. Sus valores deben ser los mismos para todos los ejes que comprenden una línea recta, por ejemplo, Línea 1, Línea 2 y así sucesivamente.

String
mainline_direction
(Opcional)

Especifica la dirección de la línea principal.

  • FROM_LEFT_TO_RIGHTLa línea principal se dibuja como una línea horizontal que comienza a la izquierda y termina a la derecha. Esta es la opción predeterminada.
  • FROM_TOP_TO_BOTTOMLa línea principal se dibuja como una línea vertical que comienza arriba y termina abajo.
String
offset_between_branches
(Opcional)

El espaciado entre dos ramas adyacentes a lo largo del eje perpendicular respecto a la dirección de las líneas.

Linear Unit
breakpoint_angle
(Opcional)

El ángulo que se usará para colocar el punto de descanso en las ramas. Es un valor entre 30 y 90 grados que se combina con el valor de parámetro offset_between_branches para calcular su posición. Si el valor del ángulo de punto de descanso es de 90 grados, cada rama se muestra de forma ortogonal.

Double
type_attribute
(Opcional)

El nombre del atributo de red que se usará para calificar las líneas. Es posible que este atributo de red exista en las clases de línea de red.

Nota:

Los valores de los parámetros type_attribute y line_attribute pueden ser los mismos.

String
mainline_values
[mainline_values,...]
(Opcional)

Los valores type_attribute que identifican las líneas principales. Si existen tales valores, deben ser los mismos para todos los ejes que comprendan las líneas principales, independientemente de sus tablas de objetos de eje o clases de línea de entidad de red relacionadas.

Value Table
branch_values
[branch_values,...]
(Opcional)

Los valores type_attribute que identifican las ramas.

Value Table
excluded_values
[excluded_values,...]
(Opcional)

Valores de type_attribute que identifican los ejes que se excluirán de las líneas rectas (cruces o escaleras).

Value Table
is_compressing
(Opcional)

Especifica si el gráfico se comprimirá.

  • USE_COMPRESSIONSe utilizará compresión. Se ejecuta un paso adicional al final del proceso para reducir las distancias entre grupos adyacentes de cruces vecinos a lo largo de la dirección al mismo tiempo que se mantiene un posicionamiento relativo entre dichos grupos. Los cruces vecinos están cerca geográficamente unos de otros sin estar conectados de forma directa.
  • DO_NOT_USE_COMPRESSIONNo se utilizará la compresión. Esta es la opción predeterminada.
Boolean
compression_ratio
(Opcional)

Un valor entre 0 y 100 que se aplica a la longitud de cualquier eje después de restar la distancia mínima de su longitud. Si compression_ratio es 100, la distancia entre cada grupo de cruces detectado será igual que la distancia mínima.

Double
minimal_distance
(Opcional)

La distancia mínima entre dos grupos adyacentes de cruces vecinos. Esta distancia mínima también se usa para agrupar cruces vecinos en función de su proyección a lo largo del eje de dirección. Dos cruces que se proyecten en este eje pertenecerán al mismo grupo si la distancia entre los dos puntos proyectados es menor que esta distancia.

Linear Unit
alignment_attribute
(Opcional)

El nombre del atributo de red que se usará para alinear las líneas divididas. El algoritmo alinea las líneas con el mismo valor de atributo.

String
initial_distances
(Opcional)

Especifica cómo se evaluará la longitud de los ejes de diagrama. Esta longitud determina la posición de los cruces a lo largo de la dirección. Las distancias entre los cruces conectados a lo largo de la dirección no son equidistantes, son relativas unas a otras y dependen de la longitud del eje actual y de la del eje más corto.

  • FROM_CURRENT_EDGE_GEOMETRY Las distancias se calcularán desde la geometría del eje actual. Esta es la opción predeterminada.
  • FROM_ATTRIBUTE_EDGELas distancias se calcularán desde un atributo determinado que ya exista en un eje.
String
length_attribute
(Opcional)

Atributo de red desde el cual se calcularán las distancias si initial_distances es FROM_ATTRIBUTE_EDGE.

String
run_async
(Opcional)

Especifica si el algoritmo de diseño se ejecutará de forma asíncrona o síncrona en el servidor.

  • RUN_ASYNCHRONOUSLYEl algoritmo de diseño se ejecutará de forma asíncrona en el servidor. Esta opción dedica recursos del servidor a ejecutar el algoritmo de diseño con un tiempo límite más largo. Se recomienda la ejecución asíncrona al ejecutar diseños que tardan y podrían rebasar el tiempo límite del servidor (por ejemplo, ejes parcialmente superpuestos) y al aplicar diagramas grandes (más de 25.000 entidades).
  • RUN_SYNCHRONOUSLYEl algoritmo de diseño se ejecutará de forma síncrona en el servidor. Puede fallar sin completarse si su ejecución supera el tiempo límite de servicio: 600 segundos de manera predeterminada. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_network_diagram_layer

El diagrama de red actualizado.

Capa de diagrama

Muestra de código

Ejemplo de ApplyRelativeMainlineLayout (ventana de Python)

Aplicar el diseño Línea principal relativa al diagrama denominado Diagrama temporal.

import arcpy
arcpy.ApplyRelativeMainlineLayout_nd("Temporary Diagram", "LineTrack", 
                                  "FROM_LEFT_RIGHT", 2, 45, "RUN_SYNCHRONOUSLY")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados