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

Synthèse

Ajoute l’algorithme de mise en page de la boucle principale à la liste des mises en page à appliquer automatiquement les unes à la suite des autres à la fin de la création des diagrammes selon un modèle donné. Cet outil prédéfinit également les paramètres de l’algorithme de mise en page de la boucle principale pour tout diagramme selon ce modèle.

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.

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

Attention :

Cet outil est un outil de configuration et d’administration.

Remarque :

Cet outil impacte la cohérence des diagrammes existants basés sur le modèle de diagramme en entrée. Tous les diagrammes existants demeurent incohérents et s’ouvrent avec une icône d’avertissement sur la cohérence Diagramme à mettre à jour jusqu’à leur mise à jour.

Utilisation

  • Cet outil n’est pas pris en charge en cas d’utilisation d’un service de réseau technique ou de réseau de traces. Vous devez utiliser un réseau de distribution ou un réseau de traces dans une géodatabase fichier ou mobile, ou une connexion de base de données à un réseau de distribution ou de traces dans une géodatabase d’entreprise. Lorsque vous utilisez une géodatabase d’entreprise, tenez compte des exigences suivantes :

  • Pour prédéfinir les paramètres de l’algorithme de mise en page pour un diagramme basé sur le modèle de diagramme, désactivez le paramètre Actif (is_active = "INACTIVE" dans Python).

  • Exécutez l’outil avec le paramètre Actif sélectionné (is_active = "ACTIVE" dans Python) si vous souhaitez que l’algorithme de mise en page soit ajouté à la liste des mises en page qui seront appliquées automatiquement les unes à la suite des autres à la fin de la génération des diagrammes selon le modèle de diagramme en entrée.

Paramètres

ÉtiquetteExplicationType de données
Réseau en entrée

Réseau de distribution ou de traces contenant le modèle de diagramme à modifier.

Utility Network; Trace Network
Modèle de diagramme en entrée

Nom du modèle de diagramme à modifier.

String
Activé

Détermine si l’algorithme de mise en page est automatiquement exécuté lors de la génération des diagrammes selon le modèle spécifié.

  • Sélectionné : l'algorithme de mise en page ajouté sera automatiquement exécuté lors de la génération de tout diagramme basé sur la valeur du paramètre Modèle de diagramme en entrée. Il s’agit de l’option par défaut.

    Les valeurs de paramètre spécifiées pour l’algorithme de mise en page sont utilisées pour exécuter la mise en page pendant la génération du diagramme. Elles sont également chargées par défaut lorsque l’algorithme doit être exécuté sur un diagramme selon le modèle en entrée.

  • Désactivé : toutes les valeurs de paramètre actuellement spécifiées pour l'algorithme de mise en page ajouté seront chargées par défaut lorsque l’algorithme doit être exécuté sur tout diagramme selon le modèle en entrée.

Boolean
Conserver la mise en page de conteneur
(Facultatif)

Précise comment l’algorithme traite les conteneurs :

  • Activé - L’algorithme de mise en page sera appliqué au graphique supérieur du diagramme de façon à préserver les conteneurs.
  • Désactivé - L’algorithme de mise en page sera appliqué aux entités de contenu et aux entités autres que de contenu dans le diagramme. Il s’agit de l’option par défaut.

Boolean
Type d’anneau
(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
Valeurs d’espacement interprétées comme des valeurs absolues dans le système de coordonnées du diagramme
(Facultatif)

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

  • Activé - L’algorithme de mise en page interprétera les valeurs de distance comme des unités linéaires.
  • Désactivé - L’algorithme de mise en page interprétera les valeurs de distance comme des unités relatives d’une estimation de la moyenne des tailles de jonction dans l’étendue actuelle du diagramme. Il s’agit de l’option par défaut.

Boolean
Largeur d’anneau
(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
Largeur d’anneau
(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
Hauteur d’anneau
(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
Hauteur d’anneau
(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
Type d’arborescence hiérarchique
(Facultatif)

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

  • Deux côtés de l’arborescence de ligne principaleChaque arborescence s’affiche le long d’une ligne principale et ses branches associées sont disposées à gauche et à droite de cette ligne principale.
  • Côté gauche de l’arborescence de ligne principaleChaque 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.
  • Côté droit de l’arborescence de ligne principaleChaque 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.
  • Arbre intelligentChaque 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
Entre les jonctions et perpendiculaire à la direction
(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
Entre les jonctions et perpendiculaire à la direction
(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
Entre les jonctions et dans la direction
(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
Entre les jonctions et dans la direction
(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
Position relative du point de rupture (%)
(Facultatif)

Position relative du point de rupture insérée dans les tronçons de diagramme lorsque Type d’affichage des tronçons a la valeur Tronçons réguliers (edge_display_type = "REGULAR_EDGES" dans Python) ouq que Type d’affichage des tronçons a la valeur 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.

Position relative de deux points d’inflexion insérés le long des tronçons du diagramme pour calculer la géométrie des tronçons courbés lorsque Type d’affichage des tronçons a la valeur 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
Type d’affichage des tronçons
(Facultatif)

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

  • Tronçons réguliersTous 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.
  • Tronçons orthogonauxTous les tronçons de diagramme associés aux branches de l’arborescence s'afficheront avec les angles appropriés.
  • Tronçons courbesTous les tronçons de diagramme associés aux branches de l’arborescence s'afficheront sous forme de courbes.
String
Décalage absolu
(Facultatif)

Décalage utilisé pour séparer des segments superposés lorsque vous utilisez des unités absolues et que l’option Type d’affichage des tronçons est définie sur Tronçons orthogonaux. 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
Décalage proportionnel
(Facultatif)

Décalage utilisé pour séparer des segments superposés lorsque vous utilisez des unités proportionnelles et que l’option Type d’affichage des tronçons est définie sur Tronçons orthogonaux. 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 obtenue

ÉtiquetteExplicationType de données
Réseau en sortie

réseau de distribution ou réseau de traces mis à jour.

Réseau technique ; réseau de parcours
Modèle de diagramme en sortie

Nom du modèle de diagramme.

Chaîne

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})
NomExplicationType de données
in_utility_network

Réseau de distribution ou de traces contenant le modèle de diagramme à modifier.

Utility Network; Trace Network
template_name

Nom du modèle de diagramme à modifier.

String
is_active

Détermine si l’algorithme de mise en page est automatiquement exécuté lors de la génération des diagrammes selon le modèle spécifié.

  • ACTIVEL'algorithme de mise en page ajouté sera automatiquement exécuté lors de la génération de tout diagramme basé sur la valeur du paramètre template_name. Il s’agit de l’option par défaut.Les valeurs de paramètre spécifiées pour l’algorithme de mise en page sont utilisées pour exécuter la mise en page pendant la génération du diagramme. Elles sont également chargées par défaut lorsque l’algorithme doit être exécuté sur un diagramme selon le modèle en entrée.
  • INACTIVEToutes les valeurs de paramètre actuellement spécifiées pour l'algorithme de mise en page ajouté seront chargées par défaut lorsque l’algorithme doit être exécuté sur tout diagramme selon le modèle en entrée.
Boolean
are_containers_preserved
(Facultatif)

Précise comment l’algorithme traite les conteneurs :

  • PRESERVE_CONTAINERSL’algorithme de mise en page sera appliqué au graphique supérieur du diagramme de façon à préserver les conteneurs.
  • IGNORE_CONTAINERSL’algorithme de mise en page sera appliqué aux entités de contenu et aux entités autres que de 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 les valeurs de distance comme des unités linéaires.
  • PROPORTIONAL_UNITL’algorithme de mise en page interprétera les valeurs de distance comme des unités relatives d’une estimation de la moyenne des 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)

Position relative du point de rupture insérée dans les tronçons de diagramme lorsque Type d’affichage des tronçons a la valeur Tronçons réguliers (edge_display_type = "REGULAR_EDGES" dans Python) ouq que Type d’affichage des tronçons a la valeur 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.

Position relative de deux points d’inflexion insérés le long des tronçons du diagramme pour calculer la géométrie des tronçons courbés lorsque Type d’affichage des tronçons a la valeur 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
offset_absolute
(Facultatif)

Décalage utilisé pour 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 utilisé pour 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 obtenue

NomExplicationType de données
out_utility_network

réseau de distribution ou réseau de traces mis à jour.

Réseau technique ; réseau de parcours
out_template_name

Nom du modèle de diagramme.

Chaîne

Exemple de code

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

Ajoutez l’algorithme de mise en page de la boucle principale en tant que mise en page automatique au modèle MyTemplate1 dans le réseau en entrée.

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")

Environnements

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

Informations de licence

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

Rubriques connexes