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. (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 de Graphviz sous /usr/local/bin pour macOS sur Intel, et /opt/homebrew pour macOS sur Apple Silicon/ARM. FreeCAD va chercher là tout seul. Si le programme n'y est pas trouvé, il vous est demandé d'entrer le chemin. Malheureusement, nous ne pouvons pas y naviguer directement à partir de la boîte de dialogue de sélection de fichier qui s'affiche à partir de. Lorsque vous avez la boîte de dialogue de sélection de fichier, vous avez deux possibilités : vous pouvez utiliser la combinaison de touches Cmd+Shift+. qui vous montrera tous les éléments cachés, ou vous utilisez les touches Cmd+Shift+G pour obtenir un champ de saisie pour le chemin. Validez

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 ensuite diriger FreeCAD vers ce répertoire.

If you don't have macOS Big Sur (11) (or higher) Homebrew might not work, but you can use MacPorts instead. Just download the appropriate version for your OS. Once the installation is complete, enter this command in the Terminal:

Enter your password and wait while the dependencies are downloaded and installed (it can take some time).

The Graphviz binaries may be under or. FreeCAD may automatically find the Graphviz program with the file dialog that comes up from, if not enter this command:

It will output something like:

And you can tell FreeCAD to look in that directory as explained before.

It is also possible to make the opt directory visible with this command:

then:

Therefore you can tell FreeCAD to follow this path. It has been successfully tested on 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é.