5.6.1 Altering the depth and breadth of graphs

For large graphs, you may find that you want to alter the maximum depth and breadth in order to simplify the information shown. Each graph pane has its own depth and breadth setting, which is used for all graphs drawn in it. These are available in the Max Expansion panel of the graph layout tabs in the Preferences dialog.

The depth and breadth of a graph are depicted in Depth and breadth of graphs.

Figure 5.6 Depth and breadth of graphs

Choose a number from the Depth list to change the maximum depth of graphs in a given tool. The depth of a graph is the number of generations of node which are displayed. Most graphs have a default initial depth of 2, which means that you must expand any nodes you want to investigate by expanding them yourself. The default value is 2.

Note that the maximum depth setting is ignored for nodes which you have expanded or collapsed. See Expanding and collapsing graphs.

Choose a number from the Breadth list to change the maximum breadth of a given tool. The breadth of a graph is the number of child nodes which are displayed for each parent. If there are more children than can be displayed (the maximum breadth setting is less than the number of children for a given node) an extra node is visible. This node is labeled " ... ", followed by the number of nodes that remain undisplayed. Nonetheless you can expand this node by the Expand Nodes command allowing you to display the additional children without having to alter the maximum breadth setting for the whole graph. By default, the maximum breadth is set to None, so that all the children for a node are displayed, no matter how many there are. An example of this feature is shown in Displaying children hidden by the maximum breadth setting below, where the maximum breadth has been set to 3.

Figure 5.7 Displaying children hidden by the maximum breadth setting

To ensure that all available information is graphed in a given tool, set both the maximum depth and maximum breadth to None.

Common LispWorks User Guide (Macintosh version) - 21 Feb 2008