DAG view: Difference between revisions

From FreeCAD Documentation
(New page to describe the DAG view.)
 
No edit summary
 
(17 intermediate revisions by 5 users not shown)
Line 2: Line 2:
<translate>
<translate>


== Introduction ==
== Introduction == <!--T:1-->


</translate>
The [[DAG view|DAG view]] is [https://en.wikipedia.org/wiki/Directed_acyclic_graph directed acyclic graph] (DAG) that shows the relationships between different objects in the document. It is meant primarily to show how certain objects depend on others in a complex model with many features and references, such as those that can be created with the [[PartDesign Workbench|PartDesign Workbench]].
{{TOCright}}
<translate>


<!--T:2-->
[[File:FreeCAD_DAG_view.png]]
The [[DAG view|DAG view]] is a [https://en.wikipedia.org/wiki/Directed_acyclic_graph directed acyclic graph] (DAG) that shows the relationships between different objects in the document. It is meant primarily to show how certain objects depend on others in a complex model with many features and references, such as those that can be created with the [[Image:Workbench_PartDesign.svg|24px]] [[PartDesign Workbench|PartDesign Workbench]].


<!--T:3-->
The DAG view resembles the graph that can be produced from a Git repository and its branches. Together with the standard [[tree view|tree view]] and the [[Std_DependencyGraph|dependency graph]], the DAG view is a tool to inspect the parametric history of objects in a document.

== Example == <!--T:16-->

<!--T:17-->
A simple model will be seen with different views.

<!--T:18-->
[[File:FreeCAD_DAG_view_3D.png]]
{{Caption|Model with 2D and 3D shapes.}}

<!--T:4-->
[[File:FreeCAD_DAG_view_Tree_view.png]] [[File:FreeCAD_DAG_view.png|x500px]]

<!--T:19-->
{{Caption|Left: objects shown in the standard [[tree view|tree view]]. Right: objects shown in the DAG view.}}

<!--T:5-->
[[File:FreeCAD_DAG_view_Std_DependencyGraph.png]]

<!--T:6-->
{{Caption|Relationships between the objects shown in the [[Std_DependencyGraph|dependency graph]].}}

== Activating the DAG view == <!--T:7-->

<!--T:8-->
The DAG view was introduced in 0.17 as an experimental feature for power users and developers, so they could troubleshoot complex models; therefore, the DAG view is not available by default.
The DAG view was introduced in 0.17 as an experimental feature for power users and developers, so they could troubleshoot complex models; therefore, the DAG view is not available by default.


<!--T:9-->
To use this view use the [[parameter editor|parameter editor]]. Create the following subgroup if it doesn't exist
To use this view use the [[Std DlgParameter|parameter editor]]. Create the following subgroup if it doesn't exist
* {{incode|BaseApp/Preferences/DockWindows/DAGView}}
* {{incode|BaseApp/Preferences/DockWindows/DAGView}}


<!--T:10-->
then add the parameter {{incode|Enabled}} of type {{incode|Boolean}}, and set it to {{TRUE}}.
then add the parameter {{incode|Enabled}} of type {{incode|Boolean}}, and set it to {{TRUE}}.


<!--T:11-->
Then activate it, {{MenuCommand|View → Panels → DAG view}}.
Restart FreeCAD and activate DAG view: {{MenuCommand|{{StdMenu|[[Std View Menu|View]]}} → Panels → DAG view}}.


<!--T:12-->
See also:
In the [[Std DlgParameter|parameter editor]] you can also change some properties in the following subgroup
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=11276 DAGView]
* {{incode|BaseApp/Preferences/DAGView}}
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=11276 easter egg of PartDesign Next: DAG View]
* FontPointSize - Set size of text font and can help with readability with high DPI displays. Set to 0 for default font size.
* SelectionMode
** 0 - single click selects an item. Ctrl-click to add items to selection.
** 1 - every click adds/removes item to selection.
* Direction - the order in which items are displayed.
** 1 - child on top, parent under it
** -1 - parent on top, children under it


== Links == <!--T:15-->
{{Interface}}

{{Userdocnavi}}
<!--T:13-->
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=11276 DAGView], forum thread presenting the new tool.
* [https://forum.freecadweb.org/viewtopic.php?t=15375 easter egg of PartDesign Next: DAG View], including the view together with the update to PartDesign.
</translate>
</translate>

{{Interface navi{{#translation:}}}}
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 05:49, 15 May 2021

Introduction

The DAG view is a directed acyclic graph (DAG) that shows the relationships between different objects in the document. It is meant primarily to show how certain objects depend on others in a complex model with many features and references, such as those that can be created with the PartDesign Workbench.

The DAG view resembles the graph that can be produced from a Git repository and its branches. Together with the standard tree view and the dependency graph, the DAG view is a tool to inspect the parametric history of objects in a document.

Example

A simple model will be seen with different views.

Model with 2D and 3D shapes.

Left: objects shown in the standard tree view. Right: objects shown in the DAG view.

Relationships between the objects shown in the dependency graph.

Activating the DAG view

The DAG view was introduced in 0.17 as an experimental feature for power users and developers, so they could troubleshoot complex models; therefore, the DAG view is not available by default.

To use this view use the parameter editor. Create the following subgroup if it doesn't exist

  • BaseApp/Preferences/DockWindows/DAGView

then add the parameter Enabled of type Boolean, and set it to true.

Restart FreeCAD and activate DAG view: View → Panels → DAG view.

In the parameter editor you can also change some properties in the following subgroup

  • BaseApp/Preferences/DAGView
  • FontPointSize - Set size of text font and can help with readability with high DPI displays. Set to 0 for default font size.
  • SelectionMode
    • 0 - single click selects an item. Ctrl-click to add items to selection.
    • 1 - every click adds/removes item to selection.
  • Direction - the order in which items are displayed.
    • 1 - child on top, parent under it
    • -1 - parent on top, children under it

Links