Std DependencyGraph/fr

Description
La commande Std Graphique de dépendances affiche les dépendances entre les objets du document actif dans un "graphique de dépendance". Contrairement à la vue en arborescence, les objets sont répertoriés dans l'ordre chronologique inverse, avec le premier objet créé en bas.

Il peut être utile pour analyser un document FreeCAD et localiser des fourches dans l'arborescence. La forme du graphe dépendra de l'atelier utilisé pour créer les objets du document. Par exemple, un modèle créé exclusivement dans l'atelier PartDesign peut afficher un graphique de dépendances linéaire avec une seule branche verticale. Un modèle fait sous l'atelier Part sera formé de plusieurs branches, mais pour une pièce unique, celles-ci se joindront au sommet après des opérations booléennes. Si ce n'est pas le cas alors il s'agit d'objets distincts.

Le graphique de dépendance est purement un outil de visualisation. Il ne peut donc pas être modifié. Il se met automatiquement à jour si des changements sont apportés au modèle.



Installation
Pour utiliser la commande, un logiciel tiers nommé Graphviz doit être installé. Si vous ne l'avez pas préinstallé ou s'il est installé dans un emplacement non conventionnel, FreeCAD affichera la boîte de dialogue suivante :



Windows
Téléchargez le programme d'installation graphviz-2.xx depuis la page page de téléchargement Graphviz puis lancez l'installation. Certaines versions plus anciennes semblent avoir des problèmes pour afficher le graphique. Les versions 2.38 et plus récentes sont connues pour être fiables. Vous pouvez trouver toutes les versions de Graphviz sur Gitlab.

macOS
Vous pouvez installer Graphviz à l'aide de Homebrew si vous êtes en macOS Big Sur (11) (ou supérieur). Lors de l'installation de Homebrew, ne soyez pas nerveux si macOS vous demande d'installer des mises à jour, par exemple pour les outils de ligne de commande Xcode. Ces mises à jour sont effectuées plus tard par le processus d'installation.

Ceci installe les binaires Graphviz sous pour macOS sur Intel, ou  pour macOS sur Apple Silicon/ARM. FreeCAD devrait trouver automatiquement ces emplacements. Si le programme Graphviz n'est pas trouvé, il vous sera demandé de spécifier un chemin. Malheureusement, nous ne pouvons pas naviguer directement vers le programme dans la boîte de dialogue du fichier qui s'affiche à partir de. Deux options s'offrent à vous : vous pouvez utiliser la combinaison de touches Cmd+Shift+. pour afficher les éléments cachés, ou vous pouvez utiliser la combinaison de touches Cmd+Shift+G pour obtenir un champ de saisie pour le chemin. Saisissez l'un de ces chemins dans le terminal :

ou :

et confirmez le champ de saisie et la boîte de dialogue de sélection de fichier.

Dans le cas où les binaires de Graphviz sont installés dans un emplacement non standard, essayez de trouver le programme avec la commande :

Le résultat ressemblera à :

Et vous pouvez dire à FreeCAD de regarder dans ce répertoire.

Si vous n'avez pas macOS Big Sur (11) (ou supérieur), Homebrew ne fonctionnera peut-être pas, mais vous pouvez utiliser MacPorts à la place. Téléchargez simplement la version appropriée pour votre OS. Une fois l'installation terminée, entrez cette commande dans le terminal :

Entrez votre mot de passe et attendez que les dépendances soient téléchargées et installées (cela peut prendre un certain temps).

Les binaires de Graphviz peuvent être sous ou. FreeCAD peut trouver automatiquement le programme Graphviz avec la boîte de dialogue des fichiers qui s'affiche à partir de, sinon entrez cette commande :

Le résultat ressemblera à :

Et vous pouvez dire à FreeCAD de regarder dans ce répertoire comme expliqué précédemment.

Il est également possible de rendre visible le répertoire opt avec cette commande :

puis :

Vous pouvez donc indiquer à FreeCAD de suivre ce chemin. Il a été testé avec succès sur macOS 10.13 (High Sierra).

Linux
Sur la plupart des distributions Linux (Debian/Ubuntu, Fedora, OpenSUSE), il vous suffit d'installer le paquet graphviz depuis les dépôts. Cependant, comme pour macOS, dans les cas où les binaires graphviz sont installés dans un emplacement non standard, essayez de trouver le programme avec la commande :

Le résultat pourrait être

Et vous pouvez ensuite pointer FreeCAD vers ce répertoire.

Utilisation

 * 1) Sélectionnez l'option  du menu.
 * 2) Un nouvel onglet intitulé Graphique de dépendance s'ouvre dans la zone de vue principale.
 * 3) Utilisez la molette de défilement de la souris pour effectuer un zoom avant ou arrière.
 * 4) Utilisez les curseurs en bas et à droite de l'écran pour effectuer un panoramique de la vue. Vous pouvez aussi maintenir le bouton gauche de la souris enfoncé et déplacer la souris.

Enregistrer
Vous pouvez enregistrer un graphique de dépendance :
 * 1) Assurez-vous que l'onglet Graphique des dépendances est au premier plan.
 * 2) Sélectionnez l'option  ou  dans le menu.
 * 3) Saisissez un nom de fichier et sélectionnez le type de fichier (*.png, *.bmp, *.gif, *.jpg, *.svg ou *.pdf).
 * 4) Appuyez sur le bouton.



Principes généraux

 * Le graphe affiche les objets par ordre chronologique inversé, de bas en haut.
 * La direction des flèches indiquant les dépendances doit toujours pointer vers le bas, de l'objet enfant à l'objet parent. Une flèche pointant vers le haut indique une dépendance cyclique, un problème qui doit être résolu.
 * Une esquisse contenant des liens vers des géométries externes aura un numéro avec un suffixe "x" à côté de la flèche la reliant à son parent, indiquant le nombre de géométries externes liées dans l'esquisse.
 * Les objets peuvent avoir des dépendances à plusieurs parents. Par exemple, pour un modèle construit dans l'atelier PartDesign, une cavité (Pocket) peut être liée à son esquisse (Sketch) et à la fonction Protrusion (Pad) qui l’a précédée.
 * Les dépendances non autorisées (par exemple, entre une opération de l'atelier Draft et l'atelier Part et un élément à l'intérieur d'un PartDesign Corps) seront affichées avec une flèche rouge. Ce type de lien affiche généralement une erreur "Links go out of allowed scope" (Liens hors de portée autorisée) dans la vue rapport.
 * Le Part Conteneur et le PartDesign Corps englobent leur contenu dans un encadré avec un arrière-plan de couleur aléatoire. Leur origine englobe également leur contenu (plans et axes standard) dans un encadré.
 * Le Groupe est affiché comme un élément unique lié à son contenu.

Limitations

 * Le graphique de dépendance ne peut pas détecter les problèmes causés par le Problème de dénomination topologique. Si une esquisse change de face après une modification, elle est toujours liée à la fonction. Même si certaines fonctions sont rompues, le graphique de dépendance restera inchangé.