Resumen
Agrega el algoritmo de diseño Anillo principal a la lista de diseños que se encadenará 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 de diseño Anillo principal para cualquier diagrama basado en esa plantilla.
Este algoritmo de diseño ordena las entidades de diagrama alrededor del anillo principal y dispone jerárquicamente el subconjunto de entidades de diagrama conectadas a cada cruce de diagrama ubicado a lo largo del anillo principal.
Más información acerca del algoritmo de diseño Anillo principal
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 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 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:
- El valor del parámetro Red de entrada debe provenir de una conexión de base de datos establecida como propietaria de la red de servicios de la base de datos o propietaria de la red de trazado de la base de datos.
- La cuenta del portal de ArcGIS Enterprise conectada debe ser la propietaria de la red de servicios del portal o la propietaria de la red de trazado del portal.
- Esta herramienta se debe conectar a la versión predeterminada, que se espera que sea pública y no protegida.
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 (el valor predeterminado) (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.
Sintaxis
arcpy.nd.AddMainRingLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {ring_type}, {is_unit_absolute}, {ring_width_absolute}, {ring_width_proportional}, {ring_height_absolute}, {ring_height_proportional}, {tree_type}, {perpendicular_absolute}, {perpendicular_proportional}, {along_absolute}, {along_proportional}, {breakpoint_position}, {edge_display_type}, {offset_absolute}, {offset_proportional})
Parámetro | Explicación | Tipo de datos |
in_utility_network | La red de servicios o red de trazado que contiene la plantilla de diagrama que se desea modificar. | Utility Network; Trace Network |
template_name | El nombre de la plantilla de diagrama que se desea modificar. | String |
is_active | Indica si el algoritmo de diseño se ejecutará automáticamente al generar diagramas basados en la plantilla especificada.
| Boolean |
are_containers_preserved (Opcional) | Especifica cómo procesará el algoritmo los contenedores.
| Boolean |
ring_type (Opcional) | Especifica el tipo de anillo.
| String |
is_unit_absolute (Opcional) | Especifica cómo se interpretarán los parámetros que representan distancias.
| Boolean |
ring_width_absolute (Opcional) | El ancho del anillo. El valor predeterminado está en las unidades del sistema de coordenadas del diagrama. Este parámetro solo se puede usar con unidades absolutas. | Linear Unit |
ring_width_proportional (Opcional) | El ancho del anillo. El valor predeterminado es 50. Este parámetro solo se puede usar con unidades proporcionales. | Double |
ring_height_absolute (Opcional) | La altura del anillo. El valor predeterminado está en las unidades del sistema de coordenadas del diagrama. Este parámetro solo se puede usar con unidades absolutas. | Linear Unit |
ring_height_proportional (Opcional) | La altura del anillo. El valor predeterminado es 20. Este parámetro solo se puede usar con unidades proporcionales. | Double |
tree_type (Opcional) | Especifica cómo se colocan los árboles que salen de los cruces del anillo principal.
| String |
perpendicular_absolute (Opcional) | El espaciado entre los cruces de diagrama que se visualizan en perpendicular a la dirección del árbol y pertenecen al mismo nivel de subárbol. El valor predeterminado es de 2 en las unidades del sistema de coordenadas del diagrama. Este parámetro solo se puede usar con unidades absolutas. | Linear Unit |
perpendicular_proportional (Opcional) | El espaciado entre los cruces de diagrama que se visualizan en perpendicular a la dirección del árbol y pertenecen al mismo nivel de subárbol. El valor predeterminado es 2. Este parámetro solo se puede usar con unidades proporcionales. | Double |
along_absolute (Opcional) | El espaciado entre los cruces de diagrama que se muestran a lo largo de la dirección del árbol. El valor predeterminado es de 2 en las unidades del sistema de coordenadas del diagrama. Este parámetro solo se puede usar con unidades absolutas. | Linear Unit |
along_proportional (Opcional) | El espaciado entre los cruces de diagrama que se muestran a lo largo de la dirección del árbol. El valor predeterminado es 2. Este parámetro solo se puede usar con unidades proporcionales. | Double |
breakpoint_position (Opcional) | La posición relativa del punto de corte que se insertará a lo largo de los ejes de diagrama cuando Tipo de visualización del eje sea Ejes regulares (edge_display_type = "REGULAR_EDGES" en Python) o Tipo de visualización del eje sea Ejes ortogonales (edge_display_type = "ORTHOGONAL_EDGES" en Python). Se trata de un porcentaje de entre 0 y 100.
La posición relativa de los dos puntos de inflexión que se insertarán a lo largo de los ejes de diagrama para calcular la geometría de los ejes curvados si el Tipo de visualización del eje es Ejes curvados (edge_display_type = "CURVED_EDGES" en Python). Se trata de un porcentaje de entre 15 y 40. Con un valor de N de Posición relativa del punto de corte (%) entre 15 y 40:
Nota:El concepto de los cruces de origen y destino mencionado anteriormente es relativo a la dirección del árbol; no guarda relación alguna con la topología real de la entidad de eje ni con el objeto de eje en la red. | Double |
edge_display_type (Opcional) | Especifica el tipo de visualización de los ejes de diagrama en relación con las ramas del árbol.
| String |
offset_absolute (Opcional) | El desplazamiento utilizado para separar los segmentos superpuestos con is_unit_absolute = "ABSOLUTE_UNIT" y edge_display_type = "ORTHOGONAL_EDGES". El valor no puede rebasar el 10 por ciento del valor más pequeño especificado para los otros parámetros de espaciamiento. El valor predeterminado es 0. | Linear Unit |
offset_proportional (Opcional) | El desplazamiento utilizado para separar los segmentos superpuestos con is_unit_absolute = "PROPORTIONAL_UNIT" y edge_display_type = "ORTHOGONAL_EDGES". Es un valor doble que no puede rebasar el 10 por ciento del valor más pequeño especificado para los otros parámetros de espaciamiento. El valor predeterminado es 0. | Double |
Salida derivada
Nombre | Explicación | Tipo 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
Agregar el algoritmo de diseño Anillo principal 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.AddMainRingLayout_nd(input_Network, "MyTemplate1", "ACTIVE",
"PRESERVE_CONTAINERS", "ELLIPSE",
"PROPORTIONAL_UNIT", "", 50, "", 20, "SMART_TREE",
"", 2, "", 2, 30, "CURVED_EDGES")
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí