Appliquer la mise en page de l’anneau principal (Diagramme de réseau)

Résumé

Dispose les entités de diagramme dans un diagramme de réseau autour d’une bouche principale.

Pour en savoir plus sur l’algorithme de mise en page de la boucle principale

Attention :

Si vous avez une session de modification ouverte, vous devez enregistrer vos modifications avant d’exécuter cet outil. Cela garantit que le diagramme reflète les derniers changements apportés à la topologie de réseau dans la base de données. Si vous n'enregistrez pas vos modifications, celles-ci ne seront pas indiquées dans le diagramme.

Remarque :

Chaque algorithme de mise en page inclut des valeurs de paramètre par défaut. Les valeurs de paramètre par défaut seront utilisées sauf mention contraire. Si le diagramme de réseau en entrée est basé sur un modèle pour lequel cette mise ne page a été configurée avec une autre valeur de paramètre, cette valeur est utilisée en lieu et place.

Utilisation

  • Cet outil n’est pas pris en charge si vous utilisez une connexion de base de données à un réseau technique ou à un réseau de traces dans une géodatabase d’entreprise. Vous devez recourir au service du réseau technique ou réseau de traces publié associé, ou à un réseau technique ou à un réseau de traces dans une géodatabase fichier.

  • La couche de diagramme de réseau en entrée doit provenir soit d’un réseau technique ou d’un réseau de traces dans une géodatabase fichier, soit d’un service de diagramme de réseau.

  • Cet algorithme de mise en page organise les entités de diagramme autour de l’anneau principal et dispose hiérarchiquement les entités connectées à chaque jonction de diagramme placées le long de l’anneau principal.

    L’anneau principal correspond à la boucle formée par le plus grand nombre de tronçons dans le diagramme de réseau.

    Si le diagramme de réseau ne contient pas de boucle, l’exécution de l’algorithme de mise en page Anneau principal n’a aucun effet.

  • Cet algorithme de mise en page est généralement utilisé par l’industrie des télécommunications.

  • Lorsque des interruptions sont définies sur les entités de diagramme, l’algorithme de mise en page de l’anneau principal identifie l’anneau principal qui exclura ces entités signalées.

  • Pensez à appliquer la mise en page en mode asynchrone sur le serveur lors de l’exploitation de très grands diagrammes.

Syntaxe

arcpy.nd.ApplyMainRingLayout(in_network_diagram_layer, {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}, {run_async}, {offset_absolute}, {offset_proportional})
ParamètreExplicationType de données
in_network_diagram_layer

Diagramme de réseau auquel la mise en page sera appliquée.

Diagram Layer
are_containers_preserved
(Facultatif)

Précise comment l’algorithme traite les conteneurs :

  • PRESERVE_CONTAINERS L’algorithme de mise en page s’exécute sur le graphique supérieur du diagramme de façon à préserver les conteneurs.
  • IGNORE_CONTAINERSL’algorithme de mise en page s’exécute sur les entités de contenu et sans contenu dans le diagramme. Il s’agit de l’option par défaut.
Boolean
ring_type
(Facultatif)

Spécifie le type d’anneau.

  • ELLIPSELes entités de diagramme de la boucle principale détectée s’affichent autour d’une ellipse. Il s’agit de l’option par défaut.
  • RECTANGLELes entités de diagramme de la boucle principale détectée s’affichent autour d’un rectangle.
String
is_unit_absolute
(Facultatif)

Définit la façon dont les paramètres représentant les distances sont interprétés.

  • ABSOLUTE_UNITL'algorithme de mise en page interprétera toutes les valeurs de distance comme des unités linéaires.
  • PROPORTIONAL_UNITL’algorithme de mise en page interprète toute valeur de distance comme des unités relatives en une estimation de la moyenne pour les tailles de jonction dans l’étendue actuelle du diagramme. Il s’agit de l’option par défaut.
Boolean
ring_width_absolute
(Facultatif)

Largeur de l’anneau. La valeur par défaut est dans les unités du système de coordonnées du diagramme. Ce paramètre peut uniquement être utilisé avec les unités absolues.

Linear Unit
ring_width_proportional
(Facultatif)

Largeur de l’anneau. La valeur par défaut est 50. Ce paramètre peut uniquement être utilisé avec les unités proportionnelles.

Double
ring_height_absolute
(Facultatif)

Hauteur de l’anneau. La valeur par défaut est dans les unités du système de coordonnées du diagramme. Ce paramètre peut uniquement être utilisé avec les unités absolues.

Linear Unit
ring_height_proportional
(Facultatif)

Hauteur de l’anneau. La valeur par défaut est 20. Ce paramètre peut uniquement être utilisé avec les unités proportionnelles.

Double
tree_type
(Facultatif)

Spécifie la manière dont les arborescences issues des jonctions de la boucle principale sont positionnées.

  • BOTH_SIDESChaque arborescence s’affiche le long d’une ligne principale et ses branches associées sont disposées à gauche et à droite de cette ligne principale.
  • LEFT_SIDEChaque arborescence s’affiche de manière hiérarchique le long d’une ligne principale et ses branches associées sont disposées à gauche de cette ligne principale.
  • RIGHT_SIDEChaque arborescence s’affiche de manière hiérarchique le long d’une ligne principale et ses branches associées sont disposées à droite de cette ligne principale.
  • SMART_TREEChaque arborescence s’affiche de manière hiérarchique, sous la forme d’une arborescence dynamique. Il s’agit de l’option par défaut.
String
perpendicular_absolute
(Facultatif)

Espace entre les jonctions du diagramme qui sont affichées perpendiculairement à la direction de l’arborescence et qui appartiennent au même niveau de sous-arborescence. La valeur par défaut est 2 dans les unités du système de coordonnées du diagramme. Ce paramètre peut uniquement être utilisé avec les unités absolues.

Linear Unit
perpendicular_proportional
(Facultatif)

Espace entre les jonctions du diagramme qui sont affichées perpendiculairement à la direction de l’arborescence et qui appartiennent au même niveau de sous-arborescence. La valeur par défaut est 2. Ce paramètre peut uniquement être utilisé avec les unités proportionnelles.

Double
along_absolute
(Facultatif)

Espace entre les jonctions du diagramme qui sont affichées le long de l’arborescence. La valeur par défaut est 2 dans les unités du système de coordonnées du diagramme. Ce paramètre peut uniquement être utilisé avec les unités absolues.

Linear Unit
along_proportional
(Facultatif)

Espace entre les jonctions du diagramme qui sont affichées le long de l’arborescence. La valeur par défaut est 2. Ce paramètre peut uniquement être utilisé avec les unités proportionnelles.

Double
breakpoint_position
(Facultatif)

La position relative du point de rupture insérée dans les tronçons de diagramme lorsque Edge Display Type (Type d’affichage des tronçons) est défini sur Regular edges (Tronçons réguliers) (edge_display_type = "REGULAR_EDGES" dans Python) ou que Edge Display Type (Type d’affichage des tronçons) est défini sur Orthogonal edges (Tronçons orthogonaux) (edge_display_type = "ORTHOGONAL_EDGES" dans Python). Il s'agit d'un pourcentage compris entre 0 et 100.

  • Avec une valeur de la position relative du point de rupture (%) égale à 0, le point de rupture est positionné à la coordonnée x de la jonction De du tronçon et à la coordonnée y de la jonction À du tronçon, pour une arborescence horizontale. Il est positionné à la coordonnée y de la jonction De du tronçon et à la coordonnée x de la jonction À du tronçon, pour une arborescence verticale.
  • Avec une valeur de la position relative du point de rupture (%) égale à 100, aucun point de rupture n’est inséré sur les tronçons de diagramme ; chaque tronçon de diagramme se connecte directement à ses jonctions De et A.
  • Avec une valeur de la position relative du point de rupture (%) égale à N compris entre 0 et 100, le point de rupture est positionné à N % de la longueur du segment [XY], X étant la coordonnée x de la jonction De du tronçon et Y étant la coordonnée y de la jonction À du tronçon, pour une arborescence horizontale. Il est positionné à N % de la longueur du segment [YX], Y étant la coordonnée y de la jonction De du tronçon et X, la coordonnée x de la jonction À du tronçon, pour une arborescence verticale.

La position relative de deux points d’inflexion est insérée le long des tronçons du diagramme pour calculer la géométrie des tronçons lorsque Edge Display Type (Type d’affichage de tronçon) est défini sur Curved edges (Tronçons courbés) (edge_display_type = "CURVED_EDGES" dans Python). Il s'agit d'un pourcentage compris entre 15 et 40. Avec une valeur de la position relative du point de rupture (%) égale à N compris entre 15 et 40 :

  • X étant la coordonnée x de la jonction De du tronçon et Y étant la coordonnée y de la jonction À du tronçon, pour une arborescence horizontale :
    • Le premier point d’inflexion sera positionné à N % de la longueur du segment [XY].
    • Le second point d’inflexion sera positionné à (100 - N) % de la longueur du segment [XY].
  • Y étant la coordonnée y de la jonction De du tronçon et X étant la coordonnée x de la jonction À du tronçon, pour une arborescence verticale :
    • Le premier point d’inflexion sera positionné à N % de la longueur du segment [YX].
    • Le second point d’inflexion sera positionné à (100 - N) % de la longueur du segment [XY].

Remarque :

Le concept des jonctions De et À ci-dessus est relatif à la direction de l’arborescence ; il n’a rien à voir avec la topologie réelle de l’entité de tronçon ou de l’objet tronçon figurant dans le réseau.

Double
edge_display_type
(Facultatif)

Détermine le type d’affichage des tronçons de diagramme associés aux branches de l’arborescence.

  • REGULAR_EDGESTous les tronçons de diagramme associés aux branches de l’arborescence ne s’afficheront pas avec les angles appropriés. Il s’agit de l’option par défaut.
  • ORTHOGONAL_EDGESTous les tronçons de diagramme associés aux branches de l’arborescence s'afficheront avec les angles appropriés.
  • CURVED_EDGESTous les tronçons de diagramme associés aux branches de l’arborescence s'afficheront sous forme de courbes.
String
run_async
(Facultatif)

Détermine si l’algorithme de mise en page s’exécute en mode asynchrone ou synchrone sur le serveur.

  • RUN_ASYNCHRONOUSLYL’algorithme de mise en page s’exécute en mode asynchrone sur le serveur. Cette option consacre les ressources du serveur à l’exécution de l’algorithme de mise en page avec un délai d’expiration plus long. L’exécution asynchrone est conseillée lors de l’exécution de mises en page chronophages et susceptibles de dépasser le délai d’expiration du serveur (par exemple, Partial Overlapping Edges [Tronçons de superposition partielle]) et de l’application à de grands diagrammes (comportant plus de 25 000 entités).
  • RUN_SYNCHRONOUSLYL’algorithme de mise en page s’exécutera en mode synchrone sur le serveur. Peut échouer si son exécution dépasse le délai d’expiration du service, qui est défini, par défaut, sur 600 secondes. Il s’agit de l’option par défaut.
Boolean
offset_absolute
(Facultatif)

Décalage permettant de séparer des segments superposés lorsque is_unit_absolute = "ABSOLUTE_UNIT" et edge_display_type = "ORTHOGONAL_EDGES" sont utilisés. La valeur ne peut pas dépasser 10 pour cent de la valeur la plus faible spécifiée pour les autres paramètres d’espacement. La valeur par défaut est 0.

Linear Unit
offset_proportional
(Facultatif)

Décalage permettant de séparer des segments superposés lorsque is_unit_absolute = "PROPORTIONAL_UNIT" et edge_display_type = "ORTHOGONAL_EDGES" sont utilisés. Il s’agit d’une valeur double qui ne peut dépasser 10 pour cent de la valeur la plus faible spécifiée pour les autres paramètres d’espacement. La valeur par défaut est 0.

Double

Sortie dérivée

NomExplicationType de données
out_network_diagram_layer

La couche de diagramme de réseau mise à jour.

Couche de diagramme

Exemple de code

Exemple d’utilisation de l’outil ApplyMainRingLayout (fenêtre Python)

Cet exemple applique l’algorithme de mise en page de l’arborescence de ligne principale nommé « Temporary Diagram » (Diagramme temporaire).

import arcpy
arcpy.ApplyMainRingLayout_nd("Temporary Diagram", "PRESERVE_CONTAINERS", 
                             "ELLIPSE", "PROPORTIONAL_UNIT", "", 50, "", 20, 
                             "SMART_TREE", "", 2, "", 2, 25, "CURVED_EDGES", 
                             "RUN_SYNCHRONOUSLY")

Environnements

Cet outil n'utilise pas d’environnement de géotraitement.

Informations de licence

  • Basic: Non
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes