Aplicar diseño Envío lineal (Diagrama de red)

Resumen

Agrega espacio entre los cruces de diagrama que están visualmente demasiado cerca, se superponen o coinciden.

Más información acerca del algoritmo de diseño Envío lineal

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

  • Este algoritmo también separa los ejes de diagrama conectados a los cruces de destino. Se tiene en cuenta la valencia de estos cruces, es decir, se puede conservar el número de ejes adyacentes, así como las rutas de eje.

  • Este diseño resulta especialmente útil para los sectores del agua, las aguas residuales y el gas, pero se puede implementar también en otras.

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

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de diagrama de red de entrada

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

Diagram Layer
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 (valor del parámetro Desviación mínima) entre ellos y el otro extremo de los ejes a los que se conectan. Se produce al final de la ejecución del diseño.
  • Distancia iterativaTodos los cruces con dos ejes conectados se moverán ligeramente en función del valor 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 siguientes iteraciones. 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 siguientes iteraciones. 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 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 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 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 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 la ejecución del algoritmo.

  • 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ónespecifica 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 siguientes iteraciones. 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 siguientes iteraciones. Este parámetro solo se puede usar con el parámetro Ampliar hojas y unidades proporcionales.

Double
Ejecutar en modo asíncrono en el servidor
(Opcional)

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

  • Activado: el 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).
  • Desactivado: el 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

EtiquetaExplicaciónTipo de datos
Diagrama de red de salida

La capa de diagrama de red actualizada.

Capa de diagrama

arcpy.nd.ApplyLinearDispatchLayout(in_network_diagram_layer, {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}, {run_async})
NombreExplicaciónTipo de datos
in_network_diagram_layer

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

Diagram Layer
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 (valor del parámetro minimum_shift_) entre ellos y el otro extremo de los ejes a los que se conectan. Se produce al final de la ejecución del diseño.
  • ITERATIVE_DISTANCETodos los cruces con dos ejes conectados se moverán ligeramente en función del valor 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 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.

  • 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 la ejecución del algoritmo.

  • 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 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
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

La capa de diagrama de red actualizada.

Capa de diagrama

Muestra de código

Ejemplo de ApplyLinearDispatchLayout (ventana de Python)

Aplicar el algoritmo de diseño Envío lineal al diagrama denominado Diagrama temporal.

import arcpy
arcpy.ApplyLinearDispatchLayout_nd("Temporary Diagram", "ITERATIVE_DISTANCE", 
                                   "ABSOLUTE_UNIT", "15 Feet", "", "2 Feet", 
                                   "", 10, "PRESERVE_PATH", "DO_NOT_MOVE_LEAVES", 
                                   "DO_NOT_EXPAND_LEAVES", "2 Feet", 2, 
                                   "RUN_SYNCHRONOUSLY")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados