Appliquer la mise en page principale relative (Diagramme de réseau)

Synthèse

Dispose les entités de diagramme de réseau dans le diagramme actif le long de lignes droites parallèles.

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

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 en 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 de distribution ou du réseau de traces publié associé, ou à un réseau de distribution ou de traces dans une géodatabase fichier ou mobile.

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

  • Cette mise en page organise les entités de diagramme réseau du diagramme actif le long de lignes droites parallèles, avec tous les tronçons connectés qui possèdent la même valeur attributaire. Elle place également les branches de ces lignes, en conservant leur sens par rapport aux lignes droites, mais également les distances par rapport à la distance initiale et entre elles.

  • Cet algorithme nécessite des attributs de réseau avec des valeurs spécifiques sur les classes de lignes réseau afin d’identifier les segments qui composent chaque ligne droite et de classer chaque tronçon de façon à ce qu’il soit hiérarchisé ou exclus pendant le processus.

  • Cette mise en page peut s’appliquer à toutes les données faisant référence à des lignes parallèles, même si elle n’a pas été conçue pour des voies ferrées.

  • Vous pouvez définir des indicateurs racines pour spécifier les points des jonctions où les lignes droites commencent. Si aucune racine n’est définie, l’algorithme recherche d’abord des jonctions qui sont connectées à un tronçon unique pouvant être considéré comme point de départ d’une ligne droite. Depuis ces jonctions candidates, la jonction racine sera celle qui initie la plus longue ligne droite.

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

Paramètres

ÉtiquetteExplicationType de données
Couche de diagramme de réseau en entrée

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

Diagram Layer
Attribut de ligne

Le nom de l’attribut de réseau qui sera utilisé pour identifier les lignes qui composent les lignes droites. Cet attribut de réseau doit se trouver dans les classes linéaires du réseau. Ses valeurs doivent être les mêmes pour tous les tronçons qui forment une ligne droite, par exemple, Ligne 1, Ligne 2 et ainsi de suite.

String
Sens
(Facultatif)

Indique la direction de la ligne principale.

  • De gauche à droiteLa 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 haut en basLa ligne principale est tracée sous forme d’une ligne verticale en commençant par le haut et en terminant par le bas.
String
Décalage entre les branches
(Facultatif)

L’espacement entre deux branches adjacentes le long de l’axe perpendiculaire à la direction des lignes.

Linear Unit
Angle du point de rupture (en degrés)
(Facultatif)

L’angle qui sera utilisé pour positionner le point de rupture sur les branches. Il s’agit d’une valeur comprise entre 30 et 90 degrés qui est combinée avec la valeur du paramètre Offset Between Branches (Décalage entre les branches) pour calculer cette position. Lorsque la valeur de l’angle du point de rupture est de 90 degrés, chaque branche s’affiche orthogonalement.

Double
Attribut de type
(Facultatif)

Le nom de l’attribut de réseau qui sera utilisé pour qualifier les lignes. Cet attribut de réseau peut se trouver dans les classes linéaires du réseau.

Remarque :

Les valeurs des paramètres Type Attribute (Attribut de type) et Line Attribute (Attribut de ligne) peuvent être identiques.

String
Valeurs des lignes principales
(Facultatif)

Les valeurs Type Attribute (Attribut de type) qui identifient les lignes principales. Lorsque ces valeurs existent, elles doivent être identiques pour n’importe quel tronçon formant les lignes principales, quelles que soient leurs classes linéaires d’entités de réseau ou tables d’objets de tronçons associées.

Value Table
Valeurs des branches
(Facultatif)

Les valeurs Type Attribute (Attribut de type) qui identifient les branches.

Value Table
Valeurs exclues
(Facultatif)

Les valeurs Type Attribute (Attribut de type) qui identifient les tronçons qui seront exclus des lignes droites (croisements ou échelles).

Value Table
Compression le long de la direction
(Facultatif)

Indique si le diagramme est compressé.

  • Activé : la compression est utilisée. Une étape supplémentaire est exécutée à la fin du processus pour réduire les distances entre des groupes adjacents de jonctions voisines le long de la direction tout en conservant la position relative entre ces groupes. Les jonctions voisines sont des jonctions géographiquement proches les unes des autres sans être directement connectées.
  • Désactivé : la compression n’est pas utilisée. Il s’agit de l’option par défaut.

Boolean
Ratio (%)
(Facultatif)

Une valeur comprise entre 0 et 100 qui est appliquée à la longueur de n’importe quel tronçon après avoir soustrait la distance minimale de sa longueur. Lorsque Ratio (%) est égal à 100, la distance entre chaque groupe de jonctions détecté est égale à la distance minimale.

Double
Distance minimale
(Facultatif)

La distance minimale entre deux groupes adjacents de jonctions voisines. Cette distance minimale permet également de regrouper des jonctions voisines en fonction de leur projection le long de l’axe de direction. Deux jonctions projetées sur cet axe appartiendront au même groupe lorsque la distance entre les deux points projetés est inférieure à cette distance.

Linear Unit
Attribut d’alignement
(Facultatif)

Le nom de l’attribut de réseau qui sera utilisé pour aligner les lignes fractionnées. L’algorithme aligne les lignes avec la même valeur attributaire.

String
Distances initiales
(Facultatif)

Indique le mode d’évaluation de la longueur des tronçons de diagramme. Cette longueur détermine les positions des jonctions le long de la direction. Les distances entre les jonctions connectées le long de la direction ne sont pas équidistantes ; elles sont relatives les unes par rapport aux autres et dépendent de la longueur du tronçon actuel et de la longueur du tronçon le plus court.

  • À partir de la géométrie du tronçon actuel Les distances sont calculées à partir de la géométrie du tronçon actuel. Il s’agit de l’option par défaut.
  • À partir du tronçon attributaireLes distances sont calculées à partir d’un attribut donné présent sur un tronçon.
String
Attribut de longueur
(Facultatif)

L’attribut de réseau à partir duquel les distances sont calculées lorsque le paramètre Initial Distances (Distances initiales) est défini sur From attribute edge (À partir du tronçon attributaire).

String
Exécuter en mode asynchrone sur le serveur
(Facultatif)

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

  • Activé : l’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 susceptibles de dépasser le délai d’expiration du serveur (par exemple, Tronçons de superposition partielle) et de l’application à de grands diagrammes (comportant plus de 25 000 entités).
  • Désactivé : détermine si l’algorithme de mise en page s’exécute en mode synchrone sur le serveur. Peut échouer si son exécution dépasse le délai d’expiration du service (600 secondes par défaut). Il s’agit de l’option par défaut.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Diagramme de réseau en sortie

Le diagramme de réseau actualisé.

Couche de diagramme

arcpy.nd.ApplyRelativeMainlineLayout(in_network_diagram_layer, line_attribute, {mainline_direction}, {offset_between_branches}, {breakpoint_angle}, {type_attribute}, {mainline_values}, {branch_values}, {excluded_values}, {is_compressing}, {compression_ratio}, {minimal_distance}, {alignment_attribute}, {initial_distances}, {length_attribute}, {run_async})
NomExplicationType de données
in_network_diagram_layer

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

Diagram Layer
line_attribute

Le nom de l’attribut de réseau qui sera utilisé pour identifier les lignes qui composent les lignes droites. Cet attribut de réseau doit se trouver dans les classes linéaires du réseau. Ses valeurs doivent être les mêmes pour tous les tronçons qui forment une ligne droite, par exemple, Ligne 1, Ligne 2 et ainsi de suite.

String
mainline_direction
(Facultatif)

Indique la direction de la ligne principale.

  • FROM_LEFT_TO_RIGHTLa 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_TOP_TO_BOTTOMLa ligne principale est tracée sous forme d’une ligne verticale en commençant par le haut et en terminant par le bas.
String
offset_between_branches
(Facultatif)

L’espacement entre deux branches adjacentes le long de l’axe perpendiculaire à la direction des lignes.

Linear Unit
breakpoint_angle
(Facultatif)

L’angle qui sera utilisé pour positionner le point de rupture sur les branches. Il s’agit d’une valeur comprise entre 30 et 90 degrés qui est combinée avec la valeur du paramètre offset_between_branches pour calculer cette position. Lorsque la valeur de l’angle du point de rupture est de 90 degrés, chaque branche s’affiche orthogonalement.

Double
type_attribute
(Facultatif)

Le nom de l’attribut de réseau qui sera utilisé pour qualifier les lignes. Cet attribut de réseau peut se trouver dans les classes linéaires du réseau.

Remarque :

Les valeurs des paramètres type_attribute et line_attribute peuvent être identiques.

String
mainline_values
[mainline_values,...]
(Facultatif)

Les valeurs type_attribute qui identifient les lignes principales. Lorsque ces valeurs existent, elles doivent être identiques pour n’importe quel tronçon formant les lignes principales, quelles que soient leurs classes linéaires d’entités de réseau ou tables d’objets de tronçons associées.

Value Table
branch_values
[branch_values,...]
(Facultatif)

Les valeurs type_attribute qui identifient les branches.

Value Table
excluded_values
[excluded_values,...]
(Facultatif)

Les valeurs type_attribute qui identifient les tronçons qui seront exclus des lignes droites (croisements ou échelles).

Value Table
is_compressing
(Facultatif)

Indique si le diagramme est compressé.

  • USE_COMPRESSIONLa compression est réutilisée. Une étape supplémentaire est exécutée à la fin du processus pour réduire les distances entre des groupes adjacents de jonctions voisines le long de la direction tout en conservant la position relative entre ces groupes. Les jonctions voisines sont des jonctions géographiquement proches les unes des autres sans être directement connectées.
  • DO_NOT_USE_COMPRESSIONLa compression n’est pas utilisée. Il s’agit de l’option par défaut.
Boolean
compression_ratio
(Facultatif)

Une valeur comprise entre 0 et 100 qui est appliquée à la longueur de n’importe quel tronçon après avoir soustrait la distance minimale de sa longueur. Lorsque compression_ratio est égal à 100, la distance entre chaque groupe de nœuds détecté est égale à la distance minimale.

Double
minimal_distance
(Facultatif)

La distance minimale entre deux groupes adjacents de jonctions voisines. Cette distance minimale permet également de regrouper des jonctions voisines en fonction de leur projection le long de l’axe de direction. Deux jonctions projetées sur cet axe appartiendront au même groupe lorsque la distance entre les deux points projetés est inférieure à cette distance.

Linear Unit
alignment_attribute
(Facultatif)

Le nom de l’attribut de réseau qui sera utilisé pour aligner les lignes fractionnées. L’algorithme aligne les lignes avec la même valeur attributaire.

String
initial_distances
(Facultatif)

Indique le mode d’évaluation de la longueur des tronçons de diagramme. Cette longueur détermine les positions des jonctions le long de la direction. Les distances entre les jonctions connectées le long de la direction ne sont pas équidistantes ; elles sont relatives les unes par rapport aux autres et dépendent de la longueur du tronçon actuel et de la longueur du tronçon le plus court.

  • FROM_CURRENT_EDGE_GEOMETRY Les distances sont calculées à partir de la géométrie du tronçon actuel. Il s’agit de l’option par défaut.
  • FROM_ATTRIBUTE_EDGELes distances sont calculées à partir d’un attribut donné présent sur un tronçon.
String
length_attribute
(Facultatif)

L’attribut de réseau à partir duquel les distances sont calculées lorsque le paramètre initial_distances est défini sur FROM_ATTRIBUTE_EDGE.

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 susceptibles de dépasser le délai d’expiration du serveur (par exemple, 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 (600 secondes par défaut). Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
out_network_diagram_layer

Le diagramme de réseau actualisé.

Couche de diagramme

Exemple de code

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

Appliquez la mise en page principale relative au diagramme nommé Diagramme temporaire.

import arcpy
arcpy.ApplyRelativeMainlineLayout_nd("Temporary Diagram", "LineTrack", 
                                  "FROM_LEFT_RIGHT", 2, 45, "RUN_SYNCHRONOUSLY")

Environnements

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

Informations de licence

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

Rubriques connexes