Std DependencyGraph/fr

Description
Le graphique de dépendance affiche les dépendances entre les objets du document actif sous forme de graphe. Contrairement à l'arborescence de l'onglet Modèle, les objets sont listés en ordre chronologique inverse, le premier objet créé se trouvant au bas du graphe.

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, sous FreeCAD 0.16, un modèle créé exclusivement dans l'atelier PartDesign devrait 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 édité. Il se met automatiquement à jour si des changements sont apportés au modèle.



Installation
Pour utiliser le graphique de dépendances, un logiciel de tierce-partie nommé Graphviz doit d'abord être installé. S'il n'est pas installé, ou s'il est installé dans un emplacement non conventionnel, FreeCAD affichera ce dialogue :

Windows
Téléchargez l'installateur graphviz-2.xx.msi depuis la page de téléchargement puis lancez l'installation.

Mac/OSX
Vous pouvez installer graphviz à l'aide du gestionnaire de paquets Homebrew :

Cela installe les fichiers binaires de graphviz dans /usr/local/bin. Malheureusement, il n'est pas possible d'y naviguer depuis la boîte de dialogue qui s'ouvre lorsque le menu Outils → Graphique de dépendance... de FreeCAD est ouvert la première fois. Quand cette boîte de dialogue s'ouvre, utilisez les touches Cmd+Maj+G pour obtenir un champ de saisie pour le chemin. Saisissez

puis confirmez le champ de saisie et l'invite de dialogue.

Au cas où les fichiers Graphviz seraient installés à un autre emplacement, tentez de trouver le programme avec la commande

Le résultat ressemblera à

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

Linux
Dans la plupart des distributions Linux (Debian/Ubuntu, Fedora, OpenSUSE), il suffit d'installer le paquet graphviz depuis les dépôts. Toutefois, tout comme pour macOS, dans certains cas les fichiers binaires de 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 diriger FreeCAD vers ce répertoire.

Configuration
Vous n'avez besoin d'aucune configuration des préférences de FreeCAD. Si toutefois FreeCAD ne peut pas trouver l'utilitaire "dot" (du paquet Graphviz), alors une boîte de dialogue s'ouvre et demande à l'utilisateur son chemin: spécifiez alors le dossier qui contient l'exécutable "dot", ne sélectionnez pas "dot" lui-même. FreeCAD tente alors de relancer le graphique de dépendance et en cas de succès, la valeur est écrite automatiquement dans les paramètres de l'utilisateur.

Utilisation

 * 1) Aller dans le menu Outils → Graphique de dépendance...
 * 2) Un nouvel onglet titré Graphique de dépendance s'ouvre par dessus la vue 3D.
 * 3) Utiliser la molette de la souris pour agrandir ou réduire l'affichage.
 * 4) Utiliser la barre de défilement horizontale pour déplacer la vue latéralement.

Enregistrer/Exporter
Vous pouvez sauvegarder / exporter le graphique de dépendance affiché sous un format d'image. Pendant que l'onglet Graphique de dépendance est à l'avant-plan :
 * Il suffit de choisir Fichier → Enregistrer sous pour sauvegarder le graphique comme une image (PNG / BMP / GIF / JPG), un graphique vectoriel (SVG) ou comme document PDF.
 * Fichier → Exporter ou Outils → Enregistrer l'image ne fonctionne pas.

General principles

 * The graph shows objects in reverse chronological order, from the bottom to the top.
 * The direction of arrows showing dependencies should always point down, from the child object to the parent object. An arrow pointing up indicates a cyclic dependency, an issue that needs to be resolved.
 * A sketch that contains links to external geometry will have a number with an "x" suffix besides the arrow linking it to its parent, showing the number of external geometry linked in the sketch.
 * Objects can have dependencies to multiple parents. For example, for a model built in PartDesign, a Pocket may be linked to its Sketch and to the Pad feature that came before it.
 * Disallowed dependencies (for example, between a Draft/Part operation and an element inside a PartDesign Body) will show with a red arrow. This type of link usually shows a "Links go out of allowed scope" error in the report view.
 * Part container and PartDesign Body enclose their content inside a frame with a randomly colored background. Their Origin also enclose their content (standard planes and axes) in a frame.
 * Group is displayed as a single element linked to its content.

Limitations

 * The dependency graph cannot help with issues caused by topological naming. If a sketch switches faces of a feature after an edit, it is still linked to the feature; even if some features are broken, the dependency graph will remain unchanged.
 * A bug in v0.17/v0.18 causes a Body to disappear from the graph and its content to disseminate if a Part or Draft object is created from the Body. This otherwise does not affect the model.