Agregar diseño Línea principal relativa (Diagrama de red)

Resumen

Agrega el algoritmo del diseño Línea principal relativa a la lista de diseños que se encadenarán automáticamente al final de la generación de diagramas en función de una plantilla determinada. Esta herramienta también predetermina los parámetros del algoritmo del diseño Línea principal relativa para cualquier diagrama basado en esa plantilla.

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í.

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

Precaución:

Esta herramienta es una herramienta de configuración y administración.

Nota:

Esta herramienta afecta a la coherencia de cualquier diagrama existente basado en la plantilla de diagrama de entrada. Todos los diagramas existentes se vuelven incoherentes y permanecen abiertos con un icono de advertencia de coherencia Diagrama para actualizar hasta que se actualicen.

Uso

  • Esta herramienta no se admite al trabajar con un servicio de red de servicios o red de trazado. Debe utilizar una red de servicios o red de trazado de una geodatabase de archivos o móvil o una conexión de base de datos a una red de servicios o red de trazado de una geodatabase corporativa. Al trabajar con una geodatabase corporativa, existen estos requisitos:

  • Para predeterminar los parámetros de algoritmo de diseño para cualquier diagrama pasado en una plantilla de diagrama, desactive el parámetro Activo (is_active = "INACTIVE" en Python).

  • Ejecute la herramienta con Activo activado (is_active = "ACTIVE" en Python) si desea que el algoritmo de diseño se agregue a la lista de diseños que se encadenarán automáticamente al final de la generación del diagrama basándose en la plantilla de diagrama de entrada.

Parámetros

EtiquetaExplicaciónTipo de datos
Red de entrada

La red de servicios o red de trazado que contiene la plantilla de diagrama que se modificará.

Utility Network; Trace Network
Plantilla de diagrama de entrada

El nombre de la plantilla de diagrama que se modificará.

String
Activo

Indica si el algoritmo de diseño se ejecutará automáticamente al generar diagramas basados en la plantilla especificada.

  • Activado: el algoritmo de diseño agregado se ejecutará automáticamente durante la generación de cualquier diagrama que se base en el valor del parámetro Plantilla de diagrama de entrada. Esta es la opción predeterminada.

    Los valores de parámetro especificados para el algoritmo de diseño se utilizan para ejecutar el diseño durante la generación de diagramas. También se cargan de forma predeterminada cuando se va a ejecutar el algoritmo en cualquier diagrama basado en la plantilla de entrada.

  • Desactivado: todos los valores de parámetros especificados actualmente para el algoritmo de diseño agregado se cargarán de forma predeterminada cuando se va a ejecutar el algoritmo en cualquier diagrama basado en la plantilla de entrada.

Boolean
Atributo de línea

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
Dirección
(Opcional)

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

  • De izquierda a derechaLa 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.
  • De arriba abajoLa línea principal se dibuja como una línea vertical que comienza arriba y termina abajo.
String
Desplazamiento entre ramas
(Opcional)

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

Linear Unit
Ángulo de punto de descanso (en grados)
(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 Desplazamiento entre ramas 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
Atributo de tipo
(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 Atributo de tipo y Atributo de línea pueden ser iguales.

String
Valores de línea principal
(Opcional)

Los valores Atributo de tipo 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
Valores de rama
(Opcional)

Los valores de Atributo de tipo que identifican las ramas.

Value Table
Valores excluidos
(Opcional)

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

Value Table
Compresión a lo largo de la dirección
(Opcional)

Especifica si el gráfico se comprimirá.

  • Activado: se utilizará la 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.
  • Desactivado: no se utilizará la compresión. Esta es la opción predeterminada.

Boolean
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 Ratio (%) es 100, la distancia entre cada grupo de cruces detectado será igual que la distancia mínima.

Double
Distancia mínima
(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
Atributo de alineación
(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
Distancias iniciales
(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.

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

El atributo de red desde el cual se miden las distancias si Distancias iniciales es Desde eje de atributo.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Red de salida

La red de servicios o red de trazado actualizada.

Red de servicios; red de trazado
Plantilla de diagrama de salida

El nombre de la plantilla de diagrama.

Cadena

arcpy.nd.AddRelativeMainlineLayout(in_utility_network, template_name, is_active, 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})
NombreExplicaciónTipo de datos
in_utility_network

La red de servicios o red de trazado que contiene la plantilla de diagrama que se modificará.

Utility Network; Trace Network
template_name

El nombre de la plantilla de diagrama que se modificará.

String
is_active

Indica si el algoritmo de diseño se ejecutará automáticamente al generar diagramas basados en la plantilla especificada.

  • ACTIVEEl algoritmo de diseño agregado se ejecutará automáticamente durante la generación de cualquier diagrama que se base en el valor del parámetro template_name. Esta es la opción predeterminada.Los valores de parámetro especificados para el algoritmo de diseño se utilizan para ejecutar el diseño durante la generación de diagramas. También se cargan de forma predeterminada cuando se va a ejecutar el algoritmo en cualquier diagrama basado en la plantilla de entrada.
  • INACTIVETodos los valores de parámetros especificados actualmente para el algoritmo de diseño agregado se cargarán de forma predeterminada cuando se va a ejecutar el algoritmo en cualquier diagrama basado en la plantilla de entrada.
Boolean
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

Salida derivada

NombreExplicaciónTipo de datos
out_utility_network

La red de servicios o red de trazado actualizada.

Red de servicios; red de trazado
out_template_name

El nombre de la plantilla de diagrama.

Cadena

Muestra de código

Ejemplo de AddRelativeMainlineLayout (ventana de Python)

Agregar el diseño Línea principal relativa como diseño automático a la plantilla MyTemplate1 en relación con la red de entrada.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddRelativeMainlineLayout_nd(input_Network, input_DiagramTemplate, 
                               "ACTIVE", "LineTrack",
                               "FROM_LEFT_RIGHT", 2, 45)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados