Std DependencyGraph/pl: Difference between revisions

From FreeCAD Documentation
(Created page with "Może on być przydatny przy analizie dokumentu FreeCAD i lokalizowaniu rozwidleń w drzewie. Układ grafu zależności zależy od tego, w którym środowisku pracy zostały u...")
(Created page with "Graf zależności jest wyłącznie narzędziem wizualizacji, dlatego nie można go edytować. Podlega automatycznej aktualizacji w przypadku wprowadzenia zmian w modelu.")
Line 23: Line 23:
Może on być przydatny przy analizie dokumentu FreeCAD i lokalizowaniu rozwidleń w drzewie. Układ grafu zależności zależy od tego, w którym środowisku pracy zostały utworzone obiekty w dokumencie. Na przykład model wykonany wyłącznie w środowisku [[PartDesign_Workbench/pl|Projekt Części]] może wyświetlać liniowy wykres zależności z jedną pionową gałęzią. Model wykonany za pomocą działań w środowisku [[Part_Workbench/pl|Część]] będzie miał wiele gałęzi, ale dla pojedynczej części połączą się one u góry po przeprowadzonych operacjach [[Part_Boolean/pl|logicznych]]. Jeśli tak się nie stanie, oznacza to, że są to osobne obiekty.
Może on być przydatny przy analizie dokumentu FreeCAD i lokalizowaniu rozwidleń w drzewie. Układ grafu zależności zależy od tego, w którym środowisku pracy zostały utworzone obiekty w dokumencie. Na przykład model wykonany wyłącznie w środowisku [[PartDesign_Workbench/pl|Projekt Części]] może wyświetlać liniowy wykres zależności z jedną pionową gałęzią. Model wykonany za pomocą działań w środowisku [[Part_Workbench/pl|Część]] będzie miał wiele gałęzi, ale dla pojedynczej części połączą się one u góry po przeprowadzonych operacjach [[Part_Boolean/pl|logicznych]]. Jeśli tak się nie stanie, oznacza to, że są to osobne obiekty.


Graf zależności jest wyłącznie narzędziem wizualizacji, dlatego nie można go edytować. Podlega automatycznej aktualizacji w przypadku wprowadzenia zmian w modelu.
The dependency graph is purely a visualization tool, therefore it cannot be edited. It automatically updates if changes are made to the model.


[[Image:Std_DependencyGraph_example.svg|400px]]
[[Image:Std_DependencyGraph_example.svg|400px]]

Revision as of 19:25, 14 December 2022

Std: Graf zależności

Lokalizacja w menu
Przybory → Graf zależności ...
Środowisko pracy
wszystkie
Domyślny skrót
brak
Wprowadzono w wersji
-
Zobacz także
brak

Opis

Polecenie Graf zależności wyświetla zależności pomiędzy obiektami w aktywnym dokumencie w postaci wykresu zależności. W przeciwieństwie do Widoku drzewa, obiekty są wymienione w odwrotnym porządku chronologicznym, z obiektem utworzonym jako pierwszy na dole.

Może on być przydatny przy analizie dokumentu FreeCAD i lokalizowaniu rozwidleń w drzewie. Układ grafu zależności zależy od tego, w którym środowisku pracy zostały utworzone obiekty w dokumencie. Na przykład model wykonany wyłącznie w środowisku Projekt Części może wyświetlać liniowy wykres zależności z jedną pionową gałęzią. Model wykonany za pomocą działań w środowisku Część będzie miał wiele gałęzi, ale dla pojedynczej części połączą się one u góry po przeprowadzonych operacjach logicznych. Jeśli tak się nie stanie, oznacza to, że są to osobne obiekty.

Graf zależności jest wyłącznie narzędziem wizualizacji, dlatego nie można go edytować. Podlega automatycznej aktualizacji w przypadku wprowadzenia zmian w modelu.

Example of a dependency graph with a PartDesign body on the left and an object created with Part operations on the right

Instalacja

To use the command a third-party software named Graphviz needs to be installed. If you do not have it pre-installed or it is installed in an unconventional location, FreeCAD will display the following dialog:

Windows

Download the graphviz-2.xx installer from the Graphviz Download page and launch it to install it. Some older versions seem to have issues displaying the graph; version 2.38 and newer are known to be reliable. You can find all graphviz releases on Gitlab.

Mac / OSX

You can install graphviz using Homebrew. (While installing Homebrew, don't get nervous, if MacOS asks you to install updates, e.g. for the Xcode commandline tools. These updates are performed later by the installation process.)

brew install graphviz

This installs the graphviz binaries under /usr/local/bin for macOS on Intel, and /opt/homebrew for macOS on Apple Silicon/ARM. FreeCAD will look there all by itself. If the program is not found there you are asked to enter the path. Unfortunately we can't navigate directly there from the file dialog that comes up from Tools → Dependency graph.... When you get the file selection dialog you have two possibilities: You can use the key combination Cmd+Shift+. which will show you all the hidden items. Or you use the keys Cmd+Shift+G to get an input field for the path. Enter

/usr/local/bin

lub

/opt/homebrew/bin

and confirm the input field and the file selection dialog.

In case the Graphviz binaries are installed in a non-standard location try to find the program with the command

type dot

It will output something like

dot is /usr/local/bin/dot

And therefore you can tell FreeCAD to look in that directory.

Linux

On most Linux distributions (Debian/Ubuntu, Fedora, OpenSUSE), you just need to install the graphviz package from the repositories. However, similar to the Mac/OSX, in cases where the Graphviz binaries are installed in a non-standard location, try to find the program with the command:

type dot

It may output something like

dot is /usr/local/bin/dot

And therefore you can point FreeCAD to look in that directory.

Użycie

  1. Select the Tools → Dependency graph... option from the menu.
  2. A new tab titled Dependency graph opens in the Main view area.
  3. Use the mouse scroll wheel to zoom in or out.
  4. Use the sliders at the bottom and at the right of the screen to pan the view. Alternatively (introduced in version 0.19) hold down the left mouse button and move the mouse.

Zapis

You can save a dependency graph:

  1. Make sure the Dependency graph tab is in the foreground.
  2. Select the File → Save or File → Save As option from the menu.
  3. Enter a filename and select the file type (*.png, *.bmp, *.gif, *.jpg, *.svg or *.pdf).
  4. Press the Save button.

General principles

  • The graph shows objects in reverse chronological order.
  • 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 geometries 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.
  • A Part container and PartDesign Body enclose their content inside a frame with a randomly colored background. Their Origin also encloses its content (standard planes and axes) in a frame.
  • A Groups is displayed as a single element linked to its content.

Limitations

  • The dependency graph cannot help with the topological naming problem. 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.