Resumen
Agrega el algoritmo de diseño Envío lineal 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 de diseño Envío lineal para cualquier diagrama basado en esa plantilla.
Este algoritmo de diseño agrega espacio entre los cruces de diagrama que están visualmente demasiado cerca, se superponen o coinciden. Mueve cruces a lo largo de sus ejes conectados. El movimiento a lo largo de los ejes depende de la posición actual y relativa de cruces y de los parámetros de diseño.
Más información acerca del algoritmo de diseño Envío lineal
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.AddLinearDispatchLayout(in_utility_network, template_name, is_active, {junction_placement_type}, {is_unit_absolute}, {maximum_shift_absolute}, {maximum_shift_proportional}, {minimum_shift_absolute}, {minimum_shift_proportional}, {iterations_number}, {is_path_preserved}, {are_leaves_moved}, {are_leaves_expanded}, {expand_shift_absolute}, {expand_shift_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 |
junction_placement_type (Opcional) | Especifica cómo se moverán los cruces.
| String |
is_unit_absolute (Opcional) | Especifica cómo se interpretarán los parámetros que representan distancias.
| Boolean |
maximum_shift_absolute (Opcional) | La distancia máxima que se espaciará los cruces con dos conexiones, respecto de los cruces a los que se conectan. El valor predeterminado es de 2 en las unidades del sistema de coordenadas del diagrama. Tan pronto como se alcanza esa distancia, los cruces ya no se moverán en las siguientes iteraciones. Este parámetro solo se puede usar con el tipo de colocación de cruce ITERATIVE_DISTANCE y unidades absolutas. | Linear Unit |
maximum_shift_proportional (Opcional) | La distancia máxima que se espaciará los cruces con dos conexiones, respecto de los cruces a los que se conectan. El valor predeterminado es 2. Tan pronto como se alcanza esa distancia, los cruces ya no se moverán en las siguientes iteraciones. Este parámetro solo se puede usar con el tipo de colocación de cruce ITERATIVE_DISTANCE y unidades proporcionales. | Double |
minimum_shift_absolute (Opcional) | La distancia mínima que separará a cada cruce con dos ejes conectados, respecto de sus dos extremidades de eje tras la ejecución del diseño. El valor predeterminado es de 2 en las unidades del sistema de coordenadas del diagrama. Si el valor de este parámetro es demasiado grande, los cruces con dos conexiones se mueven de forma que las distancias entre cada cruce movido y sus extremidades de eje sean iguales a lo largo de la ruta definida por sus dos ejes conectados. Este parámetro solo se puede usar con el tipo de colocación de cruce USER_DEFINE_DISTANCE y unidades absolutas. | Linear Unit |
minimum_shift_proportional (Opcional) | La distancia mínima que separará a cada cruce con dos ejes conectados, respecto de sus dos extremidades de eje tras la ejecución del diseño. El valor predeterminado es 2. Si el valor de este parámetro es demasiado grande, los cruces con dos conexiones se mueven de forma que las distancias entre cada cruce movido y sus extremidades de eje sean iguales a lo largo de la ruta definida por sus dos ejes conectados. Este parámetro se usa con el tipo de colocación de cruce USER_DEFINE_DISTANCE y unidades proporcionales. | Double |
iterations_number (Opcional) | El número de iteraciones que se procesarán. El valor predeterminado es 5. Este parámetro solo se puede usar con el tipo de colocación de cruce ITERATIVE_DISTANCE. | Long |
is_path_preserved (Opcional) | Especifica la forma en que se procesarán los vértices situados a lo largo de los ejes.
| Boolean |
are_leaves_moved (Opcional) | Especifica si los cruces de hoja, es decir, los cruces con una sola conexión, se moverán durante la ejecución del algoritmo.
| Boolean |
are_leaves_expanded (Opcional) | Especifica si se ampliarán los cruces de hoja:
| Boolean |
expand_shift_absolute (Opcional) | La distancia máxima que se espaciarán los cruces de hoja respecto de los cruces a los que se conectan. El valor predeterminado es 2 en las unidades del sistema de coordenadas del diagrama, a no ser que el diagrama de red de entrada se base en una plantilla para la que se haya configurado el algoritmo Diseño de envío lineal con otro valor de parámetro. Tan pronto como se alcanza esa distancia, los cruces de hoja ya no se moverán en las siguientes iteraciones. Este parámetro solo se puede usar con el parámetro Ampliar hojas y unidades absolutas. | Linear Unit |
expand_shift_proportional (Opcional) | La distancia máxima que se espaciará los cruces de hoja respecto de los cruces a los que se conectan. El valor predeterminado es 2, a no ser que el diagrama de red de entrada se base en una plantilla para la que se haya configurado el algoritmo Diseño de envío lineal con otro valor de parámetro. Tan pronto como se alcanza esa distancia, los cruces de hoja ya no se moverán en las siguientes iteraciones. Este parámetro solo se puede usar con el parámetro Ampliar hojas y unidades proporcionales. | 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
Este ejemplo agrega el algoritmo de diseño Envío lineal como diseño automático a la plantilla MyTemplate1 existente para la red de entrada.
import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddLinearDispatchLayout_nd(input_Network, input_DiagramTemplate,
"ACTIVE", "ITERATIVE_DISTANCE", "ABSOLUTE_UNIT",
"15 Feet", "", "2 Feet", "", 10, "PRESERVE_PATH",
"DO_NOT_MOVE_LEAVES", "DO_NOT_EXPAND_LEAVES",
"2 Feet", 2)
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí