iteraplan 5.2 Documentation

Skip to end of metadata
Go to start of metadata


The Nested Cluster Diagram visualizes the relationship between Building Blocks of two different types (an outer and an inner type) by displaying them as boxes and nesting them into each other according to the relationship.

Additionally it allows you to nest Building Blocks of the same type recursively into each other with regards to a self-relationship. The coloring of the boxes may be static or dependent on an attribute of the Building Block they represent. You may also filter the Building Blocks in the diagram. For the inner Building Block Type you may specify to draw Building Blocks without a relationship to any outer Building Block within a separate cluster.

For detailed theoretical information about the Nested Cluster Diagram please take a look to the documentation of the Classic Nesting Cluster Diagram.


Upon initial opening, a Nested Cluster Diagram with a default configuration is presented. All further configuration is done interactively on the diagram. Single click with the left mouse button on a inner or outer element to open the tool area in the top left corner of the diagram. Use the tool area to configure your diagram step by step.

Currently the complete diagram configuration is stored in the browser URL. You might want to use your browsers bookmarking functionality for saving the configuration.

UI reference

  1. Buttons to download the diagram and change the GUI language
  2. Content area
  3. Tool area (here for the inner type)
  4. Top part of the legend showing the outer type 
  5. Bottom part of the legend showing the inner type


Select Building Block Types


Left click on an outer or inner element in the content area to bring up the respective tool area. Use the "Cluster" / "Cluster by" tool area entry to select your desired building bock type. 

Note that iteraplan automatically selects the most suitable relationship between the outer and inner Building Block Type. You can change this relationship of course.

Select exact relationship between outer/inner elements

Often there are several possible paths how the outer and inner element type in the iteraplan meta-model are connected. The exact relationship between outer and inner type can be selected in the tool area via "Path to inner elements" resp. "Path to outer elements", depending on which tool area is currently visible. The change is immediately visible in the diagram.

Nesting by self-relationship

You may configure the Nested Cluster Diagram to nest elements of only one type. This is accomplished by using a self-relationship of this type. To configure such a nesting, select the same building block type for both outer and inner elements. After this you can select the desired exact relation from the tool area.

Additional outer/inner nesting

Indepedently for both the outer and the inner type, an additional level of nesting might be selected. All self-relationships of the respective type are available for this option. Use the entry "Outer nesting" resp. "Inner nesting" from the tool area to choose the desired nesting relation.

Nesting by self-relationship and the additional outer/inner nesting might be combined. Particularly it's possible to select the same self-relationship three times. Be aware that such diagrams are hard to comprehend.


You may filter the both the outer and the inner elements to be displayed within the Nested Cluster Diagram. Via the respective inner/outer tool area you can add a new filter or edit the current filter. See Filtering for details.


Nested Cluster Diagrams can be configured to show additional information via coloring of the elements.

By default, the elements are colored according to their Building Block Type. Via the respective outer/inner tool area you can set an individual coloring. Choose between a numerical and a enumeration based coloring. Once you have selected a specific coloring, you can change the used colors via the legend. Left click on a color bar in the legend to bring up the color picker and choose a new color.

When working with numerical coloring (coloring based on a numerical, non-enumaration attribute) you can change the color gradient by changing the first and last color of the gradient. The intermediate colors are automatically generated.

Partial Diagram

When working with large sets of data only 1000 elements are shown. A note on top of the diagram will tell you when this happens. Whenever a partial diagram is shown, you can download the complete diagram via the "Full Download" button.

You can add more restrictive filters to reduce the number of building blocks. Always be careful with partal diagrams as important parts of the diagram might not be shown. 


Compared to the Nested Cluster Diagram in the classic iteraplan client the following features are currently not supported, but will be added with the next iteraplan release:

  • Attributes as inner or outer element 
  • Showing orphaned inner elements

The following rarely used features from the Nesting cluster diagram in the Classic Client are no longer supported. This is partly because they became obsolete with the new layout and interaction design of the diagram.

  • Filtering according to seals or watchers
  • Ability to configure the default coloring (before setting a custom coloring)
  • Ability to nest Information Systems by Information Flows
  • Choose between line break or text clipping

Consider creating your own custom visualization with the iteraplan Graphics Reactor should you urgently need one of these features.


  • No labels