Std DependencyGraph/de

Beschreibung
Der Befehl Std Abhängigkeitsgraph zeigt die Abhängigkeiten zwischen Objekten im aktiven Dokument in einem 'Abhängigkeitsdiagramm' an. Im Gegensatz zur Baumansicht werden die Objekte in umgekehrter chronologischer Reihenfolge aufgelistet, wobei das erste erstellte Objekt unten steht.

Es kann bei der Analyse eines FreeCAD-Dokuments und beim Auffinden von Verzweigungen in einem Baum nützlich sein. Das Layout des Abhängigkeitsdiagramms hängt davon ab, welcher Arbeitsbereich verwendet wurde, um die Objekte im Dokument zu erstellen. Beispielsweise kann ein Modell, das ausschließlich im Arbeitsbereich PartDesign erstellt wurde, ein lineares Abhängigkeitsdiagramm mit einem einzigen vertikalen Zweig anzeigen. Ein Modell, das mit Part-Arbeitsgängen erstellt wurde, hat viele Zweige, aber für ein einzelnes Teil schließen sie sich nach Booleschen Verknüpfungen oben an. Wenn dies nicht der Fall ist, bedeutet dies, dass sie separate Objekte sind.

Der Abhängigkeitsgraph ist ein reines Visualisierungswerkzeug, daher kann er nicht bearbeitet werden. Er wird automatisch aktualisiert, wenn Änderungen am Modell vorgenommen werden.



Installation
Um den Befehl verwenden zu können, muss eine Drittanbieter Software namens Graphviz installiert sein. Wenn du diese nicht vorinstalliert hast oder sie an einem unkonventionellen Ort installiert ist, zeigt FreeCAD den folgenden Dialog an:



Windows
Lade das graphviz-2.xx Installationsprogramm von der Graphviz Download Seite herunter und starten es, um es zu installieren. Einige ältere Versionen scheinen Probleme bei der Anzeige des Graphen zu haben; Version 2.38 und neuer sind als zuverlässig bekannt. Du kannst alle Graphviz Versionen auf Gitlab finden.

macOS
Graphviz lässt sich mit Homebrew auf einem System mit macOS Big Sur (11) (oder höher) installieren. Werde bei der Installation von Homebrew nicht nervös, wenn macOS dich auffordert, Updates zu installieren, z.B. für die Xcode Kommandozeilenprogramme. Diese Updates werden später durch den Installationsprozess durchgeführt.

Dies installiert die Graphviz-Binärdateien unter für macOS auf Intel, oder unter  für macOS auf Apple Silicon/ARM. FreeCAD sollte diese Speicherorte automatisch finden. Wird das Graphviz-Program dort nicht gefunden, wird man aufgefordert einen Pfad anzugeben. Leider können wir in dem Dialog, der mit geöffnet wird, nicht direkt zum Programm navigieren. Es gibt zwei Möglichkeiten: die Tastenkombination Cmd+Shift+. zum Anzeigen ausgeblendeter Elemente. Oder die Tastenkombination Cmd+Shift+G, um ein Eingabefeld für den Pfad zu öffnen. Einen dieser Pfade im Terminal eingeben:

oder:

ein und bestätigt das Eingabefeld und den Dateiauswahldialog.

Falls die Graphviz-Binärdateien an einem nicht-standardmäßigen Ort installiert sind, kann man versuchen, das Programm mit folgendem Befehl zu finden:

Es wird etwas ausgegeben wie:

Und man kann FreeCAD anweisen, in diesem Verzeichnis zu suchen.

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
Auf den meisten Linux-Distributionen (Debian/Ubuntu, Fedora, OpenSUSE) muss nur das Paket Graphviz aus den Repositorien installiert werden. Ähnlich wie bei macOS, wenn die Graphviz-Binärdateien an einem nicht standardmäßigen Ort installiert sind, kannman versuchen, das Programm mit folgendem Befehl zu finden:

Sie wird etwas ausgeben wie

Und deshalb kannst du FreeCAD darauf hinweisen, in diesem Verzeichnis zu suchen.

Anwendung
Alternativ halte die linke Maustaste gedrückt und bewege die Maus.
 * 1) Wähle die  Option aus dem Menü.
 * 2) Ein neuer Reiter mit dem Titel Abhängigkeitsdiagramm wird im Hauptansichtsbereich geöffnet.
 * 3) Verwende zum Vergrößern oder Verkleinern das Scrollrad der Maus.
 * 4) Verwende die Schieberegler unten und rechts auf dem Bildschirm, um die Ansicht zu verschieben.

Speichern
Du kannst ein Abhängigkeitsdiagramm speichern:
 * 1) Stelle sicher, dass das Register Abhängigkeitsdiagramm im Vordergrund ist.
 * 2) Wähle die Option  oder  aus dem Menü.
 * 3) Gib einen Dateinamen ein und wähle den Dateityp (*.png, *.bmp, *.gif, *.jpg, *.svg oder *.pdf).
 * 4) Drücke die Taste.



Allgemeine Grundsätze

 * Die Grafik zeigt die Objekte in umgekehrter chronologischer Reihenfolge.
 * Die Richtung der Pfeile, die Abhängigkeiten anzeigen, sollte immer nach unten zeigen, vom untergeordneten Objekt zum übergeordneten Objekt. Ein Pfeil, der nach oben zeigt, weist auf eine zyklische Abhängigkeit hin, ein Problem, das gelöst werden muss.
 * Eine Skizze, die Verknüpfungen zu externe Geometrie enthält, hat eine Zahl mit dem Suffix "x", neben dem Pfeil, der sie mit seinem Vorläufer verbindet, die die Anzahl der in der Skizze verknüpften externen Geometrien anzeigt.
 * Objekte können Abhängigkeiten zu mehreren Vorläufern haben. Beispielsweise kann bei einem Modell, das in PartDesign erstellt wurde, eine Tasche mit ihrer Skizze und mit dem Polster Formelement verknüpft sein, das ihr vorausging.
 * Unzulässige Abhängigkeiten (z.B. zwischen einem Entwurf/Part Vorgang und einem Element innerhalb eines PartDesign Körpers) werden mit einem roten Pfeil angezeigt. Diese Verknüpfungstyp zeigt normalerweise einen 'Verknüpfungen gehen außerhalb des zulässigen Bereichs' Fehler in der Berichtsansicht an.
 * Ein Part Container und PartDesign Körper umschließen ihren Inhalt innerhalb eines Rahmens mit einem zufällig gefärbten Hintergrund. Ihr Ursprung umschließt ebenfalls seinen Inhalt (Standardebenen und -achsen) in einem Rahmen.
 * Ein Gruppen wird als ein einzelnes Element angezeigt, das mit seinem Inhalt verknüpft ist.

Begrenzungen

 * Das Abhängigkeitsdiagramm kann beim topologischen Benennungsproblem nicht helfen. Wenn eine Skizze nach einer Bearbeitung die Flächen eines Formelements wechselt, ist sie immer noch mit dem Formelement verknüpft. Selbst wenn einige Formelemente gebrochen sind, bleibt das Abhängigkeitsdiagramm unverändert.