Agregar diseño Distribución lineal (Diagrama de red)

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 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 un diagrama basado en la 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
Ubicación de cruces
(Opcional)

Especifica cómo se moverán los cruces.

  • Distancia igualTodos los cruces con dos ejes conectados se moverán de forma que las distancias que los separan y sus dos cruces conectados sean iguales. Esta es la opción predeterminada.
  • Distancia definida por el usuarioTodos los cruces con dos ejes conectados se moverán de forma que exista una distancia mínima (el valor del parámetro Desviación mínima) entre ellos y el otro extremo de los ejes a los que se conectan. Ocurre al final del proceso del algoritmo de diseño.
  • Distancia iterativaTodos los cruces con dos ejes conectados se moverán ligeramente en función de los valores de los parámetros Número de iteraciones y Desviación máxima.
String
Valores de espaciado interpretados como unidades absolutas en el sistema de coordenadas del diagrama
(Opcional)

Especifica cómo se interpretarán los parámetros que representan distancias.

  • Activado: el algoritmo de diseño interpretará los valores de distancia como unidades lineales.
  • Desactivado: el algoritmo de diseño interpretará los valores de distancia como unidades relativas a una estimación de la media de los tamaños de los cruces de la extensión del diagrama actual. Esta es la opción predeterminada.

Boolean
Desviación máxima
(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 iteraciones adicionales. Este parámetro solo se puede usar con el tipo de colocación de cruce Distancia iterativa y unidades absolutas.

Linear Unit
Desviación máxima
(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 iteraciones adicionales. Este parámetro solo se puede usar con el tipo de colocación de cruce Distancia iterativa y unidades proporcionales.

Double
Desviación mínima
(Opcional)

La distancia mínima que separará a cada cruce con dos ejes conectados, respecto de sus dos extremos de eje después de ejecutar el algoritmo de 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 Distancia definida por el usuario y unidades absolutas.

Linear Unit
Desviación mínima
(Opcional)

La distancia mínima que separará a cada cruce con dos ejes conectados, respecto de sus dos extremos de eje después de ejecutar el algoritmo de 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 Distancia definida por el usuario y unidades proporcionales.

Double
Número de iteraciones
(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 Distancia iterativa.

Long
Conservar ruta
(Opcional)

Especifica la forma en que se procesarán los vértices situados a lo largo de los ejes.

  • Activado: se conservarán todos los vértices situados a lo largo de los ejes conectados y se agregarán nuevos vértices en las ubicaciones originales de los cruces movidos. Esta es la opción predeterminada.
  • Desactivado: los vértices a lo largo de los ejes no se conservan.

Boolean
Mover hojas
(Opcional)

Especifica si los cruces de hoja, es decir, los cruces con una sola conexión, se moverán durante el proceso del algoritmo de diseño.

  • Activado: los cruces de hoja se mueven.
  • Desactivado: los cruces de hoja no se mueven. Esta es la configuración predeterminada, 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.

Boolean
Ampliar hojas
(Opcional)

Especifica si se ampliarán los cruces de hoja.

  • Activado: los cruces de hoja se ampliarán. El valor del parámetro Desviación máxima de expansión especifica la distancia máxima cuyos cruces de hoja pueden ampliarse para alejarse de los cruces a los que se conectan.
  • Desactivado: los cruces de hoja no se ampliarán. Esta es la configuración predeterminada, 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.

Boolean
Desviación máxima de expansión
(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 iteraciones adicionales. Este parámetro solo se puede usar con el parámetro Ampliar hojas y unidades absolutas.

Linear Unit
Desviación máxima de expansión
(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 iteraciones adicionales. Este parámetro solo se puede usar con el parámetro Ampliar hojas y unidades proporcionales.

Double

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.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})
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
junction_placement_type
(Opcional)

Especifica cómo se moverán los cruces.

  • EQUAL_DISTANCETodos los cruces con dos ejes conectados se moverán de forma que las distancias que los separan y sus dos cruces conectados sean iguales. Esta es la opción predeterminada.
  • USER_DEFINE_DISTANCETodos los cruces con dos ejes conectados se moverán de forma que exista una distancia mínima (el valor del parámetro minimum_shift_) entre ellos y el otro extremo de los ejes a los que se conectan. Ocurre al final del proceso del algoritmo de diseño.
  • ITERATIVE_DISTANCETodos los cruces con dos ejes conectados se moverán ligeramente en función de los valores de los parámetros iterations_number y maximum_shift_.
String
is_unit_absolute
(Opcional)

Especifica cómo se interpretarán los parámetros que representan distancias.

  • ABSOLUTE_UNITEl algoritmo de diseño interpretará los valores de distancia como unidades lineales.
  • PROPORTIONAL_UNITEl algoritmo de diseño interpretará los valores de distancia como unidades relativas a una estimación de la media de los tamaños de los cruces de la extensión del diagrama actual. Esta es la opción predeterminada.
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 iteraciones adicionales. 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 iteraciones adicionales. 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 extremos de eje después de ejecutar el algoritmo de 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 extremos de eje después de ejecutar el algoritmo de 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.

  • PRESERVE_PATHSe conservarán todos los vértices situados a lo largo de los ejes conectados y se agregarán nuevos vértices en las ubicaciones originales de los cruces movidos. Esta es la opción predeterminada.
  • IGNORE_PATHLos vértices a lo largo de los ejes no se conservan.
Boolean
are_leaves_moved
(Opcional)

Especifica si los cruces de hoja, es decir, los cruces con una sola conexión, se moverán durante el proceso del algoritmo de diseño.

  • MOVE_LEAVESLos cruces de hoja se mueven.
  • DO_NOT_MOVE_LEAVESLos cruces de hoja no se mueven. Esta es la configuración predeterminada, 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.
Boolean
are_leaves_expanded
(Opcional)

Especifica si se ampliarán los cruces de hoja:

  • EXPAND_LEAVESLos cruces de hoja se ampliarán. El valor del parámetro expand_shift_absolute especifica la distancia máxima cuyos cruces de hoja pueden ampliarse para alejarse de los cruces a los que se conectan.
  • DO_NOT_EXPAND_LEAVESLos cruces de hoja no se ampliarán. Esta es la configuración predeterminada, 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.
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 iteraciones adicionales. 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 iteraciones adicionales. Este parámetro solo se puede usar con el parámetro Ampliar hojas y unidades proporcionales.

Double

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 AddLinearDispatchLayout (ventana de Python)

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

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados