Package Overview

Note: You must have a license for the OPNET Development Kit to use the Layout package.

The Ets Layout package provides an API to automatically lay out node objects within a subnet so as to have a pleasing graphical appearance. The intent is to minimize edge crossings and to lay out nodes relative to one another so that they are well-spaced and create an aesthetically pleasing network.

The only function in this package is used to perform the layout in one step. The caller provides the subnet whose nodes are to be laid out, as well as a layout options structure that helps guide the layout process. The layout options structure is quite complex, but in general the idea is to specify whether nodes are to be laid out to fit within the entire subnet bounds, within a specified area, or within the visible region of the subnet. It also can specify how much effort (CPU time) should be spent in the layout process.

Some nodes can be marked as pinned, specifying that they not be moved from their current locations.

Finally, the idea of clusters can be used to group sets of nodes. Clusters are laid out relative to one another, and then the nodes within each cluster are laid out so that they fit within the cluster bounds (specified in units of the containing subnet). The nodes within a cluster are laid out relative to each other so that they form a pleasing-looking network and have minimal edge crossings.

The layout process redraws links as it performs layout, so the user does not have control over the paths of the link edges themselves.

Note that the layout process does not take border maps or image backgrounds into account. The package makes no attempt to determine whether a node placement is realistic in terms of actual geographic coordinates. For this reason, it is best used when laying out logical network topologies.