Ajouter une mise en page d'arborescence de ligne principale (Diagramme de réseau)

Synthèse

Ajoute l’algorithme de mise en page d'arborescence de ligne 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 d'arborescence de ligne principale pour tout diagramme selon ce modèle.

Cet algorithme de mise en page organise hiérarchiquement les jonctions et les tronçons dans un diagramme de réseau en entrée le long d’une ligne principale et place ses branches associées de chaque côté, sur la gauche ou sur la droite de la ligne principale.

Pour en savoir plus sur l’algorithme de mise en page d’arborescence de ligne 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 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 technique ou un réseau de traçages dans une géodatabase fichier ou une connexion de base de données à un réseau technique ou à un réseau de traces dans une géodatabase d’entreprise. Lorsque vous utilisez une géodatabase d’entreprise, tenez compte des exigences suivantes :

  • La valeur du paramètre Input Network (Réseau en entrée) doit provenir d’une connexion à une base de données établie en tant que propriétaire du réseau technique de la base de données ou propriétaire du réseau de traces de la base de données.
  • Le compte connecté au portail ArcGIS Enterprise doit être celui du propriétaire du réseau technique du portail ou du propriétaire du réseau de traces du portail.
  • Cet outil doit être connecté à la version par défaut qui doit être publique et non protégée.

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

• Exécutez l’outil avec le paramètre Active (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

Boîte de dialogue

Étiquette	Explication	Type de données
Réseau en entrée	Réseau de distribution ou réseau de traçages 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
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é. Activé : l'algorithme de mise en page ajouté sera automatiquement exécuté lors de la génération de tout diagramme basé sur le modèle de diagramme en entrée (Input Diagram Template). 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 s’exécute sur le graphique supérieur du diagramme de telle sorte que les conteneurs sont préservés. Désactivé : l’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
Direction de l’arborescence (Facultatif)	Indique la direction de la ligne principale. De gauche à droite—La ligne principale est tracée sous forme d’une ligne horizontale en commençant par la gauche et en terminant par la droite. Il s’agit de l’option par défaut. De droite à gauche—La ligne principale est tracée sous forme d’une ligne horizontale en commençant par la droite et en terminant par la gauche. De bas en haut—La ligne principale est tracée sous forme d’une ligne verticale en commençant par le bas et en terminant par le haut. De haut en bas—La ligne principale est tracée sous forme d’une ligne verticale en commençant par le haut et en terminant par le bas.	String
Placement des branches (Facultatif)	Spécifie la manière dont les branches de la ligne principale seront placées relativement en fonction de sa direction. Des deux côtés—Les branches seront placées à gauche et à droite de la ligne principale. Il s’agit de l’option par défaut. A gauche—Les branches seront placées uniquement à gauche de la ligne principale. A droite—Les branches seront placées uniquement à droite de la ligne principale.	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 toutes les valeurs de distance comme des unités linéaires. Désactivé : L’algorithme de mise en page interprète les valeurs de distance comme des unités relatives d’une estimation de la moyenne des tailles de jonction dans le diagramme lors de sa génération. Il s’agit de l’option par défaut.	Boolean
Entre les jonctions et perpendiculaire à la direction (Facultatif)	Espace entre les jonctions du diagramme qui sont affichées le long de l’axe perpendiculaire à la ligne principale. La valeur par défaut est 2 dans le 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 le long de l’axe perpendiculaire à la ligne principale. 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 la ligne principale, mais aussi espace entre les jonctions du diagramme qui sont affichées le long de l’axe parallèle à cette ligne principale. Ce paramètre peut uniquement être utilisé avec les unités absolues. La valeur par défaut est 2 dans les unités du système de coordonnées du diagramme.	Linear Unit
Entre les jonctions et dans la direction (Facultatif)	Espace entre les jonctions du diagramme qui sont affichées le long de la ligne principale, mais aussi espace entre les jonctions du diagramme qui sont affichées le long de l’axe parallèle à cette ligne principale. Ce paramètre est utilisé avec des unités proportionnelles. La valeur par défaut est 2.	Double
Entre des diagrammes disjoints (Facultatif)	Espace minimum qui sépare les entités appartenant aux graphiques disjoints lorsque le diagramme contient de tels graphiques. Ce paramètre est utilisé avec des unités absolues. La valeur par défaut est 4 dans les unités du système de coordonnées du diagramme.	Linear Unit
Entre des diagrammes disjoints (Facultatif)	Espace minimum qui sépare les entités appartenant aux graphiques disjoints lorsque le diagramme contient de tels graphiques. Ce paramètre est utilisé avec des unités proportionnelles. La valeur par défaut est 4.	Double
Afficher les tronçons orthogonalement (Facultatif)		Boolean
Position relative du point de rupture (%) (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
Type d’affichage des segments (Facultatif)	Détermine le type d’affichage des tronçons de diagramme associés aux branches de l’arborescence. Tronçons réguliers—Tous 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 orthogonaux—Tous les tronçons de diagramme associés aux branches de l’arborescence s'afficheront avec les angles appropriés. Tronçons courbes—Tous 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 permettant de séparer des segments superposés lorsque vous utilisez des unités absolues et que l’option Edge Display Type (Type d’affichage des tronçons) est définie sur Orthogonal edges (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 permettant de séparer des segments superposés lorsque vous utilisez des unités proportionnelles et que l’option Edge Display Type (Type d’affichage des tronçons) est définie sur Orthogonal edges (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

Étiquette	Explication	Type de données
Réseau en sortie	réseau de distribution ou réseau de traçage mis à jour.	Réseau technique ; réseau de parcours
Modèle de diagramme en sortie	Nom du modèle de diagramme.	Chaîne

Python

arcpy.nd.AddMainlineTreeLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {tree_direction}, {branches_placement}, {is_unit_absolute}, {perpendicular_absolute}, {perpendicular_proportional}, {along_absolute}, {along_proportional}, {disjoined_graph_absolute}, {disjoined_graph_proportional}, {are_edges_orthogonal}, {breakpoint_position}, {edge_display_type}, {offset_absolute}, {offset_proportional})

Nom	Explication	Type de données
in_utility_network	Réseau de distribution ou réseau de traçages 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é. ACTIVE—L'algorithme de mise en page ajouté sera automatiquement exécuté lors de la génération de tout diagramme selon le 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. INACTIVE—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
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_CONTAINERS—L’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
tree_direction (Facultatif)	Indique la direction de la ligne principale. FROM_LEFT_TO_RIGHT—La ligne principale est tracée sous forme d’une ligne horizontale en commençant par la gauche et en terminant par la droite. Il s’agit de l’option par défaut. FROM_RIGHT_TO_LEFT—La ligne principale est tracée sous forme d’une ligne horizontale en commençant par la droite et en terminant par la gauche. FROM_BOTTOM_TO_TOP—La ligne principale est tracée sous forme d’une ligne verticale en commençant par le bas et en terminant par le haut. FROM_TOP_TO_BOTTOM—La ligne principale est tracée sous forme d’une ligne verticale en commençant par le haut et en terminant par le bas.	String
branches_placement (Facultatif)	Spécifie la manière dont les branches de la ligne principale seront placées relativement en fonction de sa direction. BOTH_SIDES—Les branches seront placées à gauche et à droite de la ligne principale. Il s’agit de l’option par défaut. LEFT_SIDE—Les branches seront placées uniquement à gauche de la ligne principale. RIGHT_SIDE—Les branches seront placées uniquement à droite de la ligne principale.	String
is_unit_absolute (Facultatif)	Définit la façon dont les paramètres représentant les distances sont interprétés. ABSOLUTE_UNIT—L'algorithme de mise en page interprétera toutes les valeurs de distance comme des unités linéaires. PROPORTIONAL_UNIT—L’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
perpendicular_absolute (Facultatif)	Espace entre les jonctions du diagramme qui sont affichées le long de l’axe perpendiculaire à la ligne principale. La valeur par défaut est 2 dans le 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 le long de l’axe perpendiculaire à la ligne principale. 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 la ligne principale, mais aussi espace entre les jonctions du diagramme qui sont affichées le long de l’axe parallèle à cette ligne principale. Ce paramètre peut uniquement être utilisé avec les unités absolues. La valeur par défaut est 2 dans les unités du système de coordonnées du diagramme.	Linear Unit
along_proportional (Facultatif)	Espace entre les jonctions du diagramme qui sont affichées le long de la ligne principale, mais aussi espace entre les jonctions du diagramme qui sont affichées le long de l’axe parallèle à cette ligne principale. Ce paramètre est utilisé avec des unités proportionnelles. La valeur par défaut est 2.	Double
disjoined_graph_absolute (Facultatif)	Espace minimum qui sépare les entités appartenant aux graphiques disjoints lorsque le diagramme contient de tels graphiques. Ce paramètre est utilisé avec des unités absolues. La valeur par défaut est 4 dans les unités du système de coordonnées du diagramme.	Linear Unit
disjoined_graph_proportional (Facultatif)	Espace minimum qui sépare les entités appartenant aux graphiques disjoints lorsque le diagramme contient de tels graphiques. Ce paramètre est utilisé avec des unités proportionnelles. La valeur par défaut est 4.	Double
are_edges_orthogonal (Facultatif)	Définit la façon dont les tronçons de diagramme associés aux branches de l’arborescence sont affichés. Héritage : Ce paramètre est déconseillé dans ArcGIS Pro 2.8. Il est systématiquement ignoré quelle que soit sa valeur lorsque le paramètre edge_display_type est spécifié. Toutefois, pour préserver la compatibilité avec ArcGIS Pro 2.1, ce paramètre reste activé si le paramètre edge_display_type n’est pas spécifié. ORTHOGONAL_EDGES—Tous les tronçons de diagramme associés aux branches de l’arborescence s'afficheront avec les angles appropriés. SLANTED_EDGES—Tous 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.	Boolean
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_EDGES—Tous 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_EDGES—Tous les tronçons de diagramme associés aux branches de l’arborescence s'afficheront avec les angles appropriés. CURVED_EDGES—Tous les tronçons de diagramme associés aux branches de l’arborescence s'afficheront sous forme de courbes.	String
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 obtenue

Nom	Explication	Type de données
out_utility_network	réseau de distribution ou réseau de traçage 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 AddMainLineTreeLayout (fenêtre Python)

Cet exemple ajoute l’algorithme de mise en page d’arborescence de ligne principale en tant que mise en page automatique au modèle MyTemplate1 existant dans un réseau donné.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddMainlineTreeLayout_nd(input_Network, input_DiagramTemplate, 
                               "ACTIVE", "PRESERVE_CONTAINERS", 
                               "FROM_LEFT_TO_RIGHT", "BOTH_SIDES", 
                               "ABSOLUTE_UNIT", "100 Feet", "", "100 Feet", "", 
                               "200 Feet", "", "", 30, "ORTHOGONAL_EDGES", 
                               "10 Feet")

Environnements

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

Informations de licence

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