Résumé
Organise les jonctions et les tronçons du diagramme de manière hiérarchisée le long d'une ligne principale.
Pour en savoir plus sur l’algorithme de mise en page d’arborescence de ligne 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 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.
Les jonctions racine et finale peuvent être spécifiées dans le diagramme de telle sorte que l’algorithme de mise en page de l’arborescence principale génère une ligne principale commençant à une jonction racine spécifique et se terminant à une jonction finale spécifique.
- Par défaut, lorsqu’aucune jonction racine et finale n’est définie, l’algorithme identifie la jonction du diagramme associée au plus petit indice de topologie du réseau. En commençant par cette jonction représentant la racine, l’algorithme recherche une ligne composée du plus grand nombre des tronçons : la ligne principale.
- Lorsqu’une jonction racine est définie, la ligne principale est l’une des branches composées du plus grand nombre de tronçons et commençant par cette jonction racine.
- Lorsque les jonctions racine et finale sont définies et qu’il existe un chemin d’accès entre elles, la ligne principale est la branche composée du plus grand nombre de tronçons de diagramme commençant par cette jonction racine et se terminant à cette jonction finale.
Si le diagramme schématique se compose de plusieurs parties de réseau déconnectées, vous pouvez être amené à définir plusieurs jonctions racines et finales, par exemple une pour chaque partie du réseau.
Plusieurs jonctions qui appartiennent à la même partie de diagramme connectée peuvent être également spécifiées comme racines. Elles sont toutes alignées le long du même axe perpendiculairement à la direction de l’arborescence et s’affichent en tant que points de départ différents d’une branche de l’arborescence du diagramme. Pour les jonctions finales, bien que rien ne vous empêche de préciser plusieurs extrémités sur la même pièce de diagramme connectée, le système n’identifie que l’une d’entre elles comme jonction finale.
Si une jonction finale est précisée, mais qu’aucune jonction racine ne l’est, la jonction finale est ignorée.
Pensez à appliquer la mise en page en mode asynchrone sur le serveur lors de l’exploitation de très grands diagrammes.
Syntaxe
arcpy.nd.ApplyMainlineTreeLayout(in_network_diagram_layer, {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}, {run_async}, {offset_absolute}, {offset_proportional})| Paramètre | Explication | Type 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 :
| Boolean |
tree_direction (Facultatif) | Indique la direction de la ligne principale.
| 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.
| String |
is_unit_absolute (Facultatif) | Définit la façon dont les paramètres représentant les distances sont interprétés.
| 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.7. 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é.
| 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.
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 :
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.
| String |
run_async (Facultatif) | Détermine si l’algorithme de mise en page s’exécute en mode asynchrone ou synchrone sur le serveur.
| 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
| Nom | Explication | Type de données |
| out_network_diagram_layer | La couche de diagramme de réseau mise à jour. | Couche de diagramme |
Exemple de code
Appliquez l’algorithme Mise en page d’arborescence de ligne principale au diagramme nommé Diagramme temporaire.
import arcpy
arcpy.ApplyMainlineTreeLayout_nd("Temporary Diagram", "PRESERVE_CONTAINERS",
"FROM_LEFT_TO_RIGHT", "BOTH_SIDES",
"ABSOLUTE_UNIT", "100 Feet", "" , "100 Feet",
"", "200 Feet", "", "", 30, "ORTHOGONAL_EDGES",
"RUN_SYNCHRONOUSLY", "10 Feet", "")Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?