Collapse Container rule reference

The Collapse Container rule is used to simplify diagrams by collapsing all contents related to containers that may exist in diagrams.

The Collapse Container rule collapses the containers by source class or object table and, optionally, filters them based on their attributes.

In diagrams where all containers have been collapsed, note the following:

  • Point containers in the network—for example, structure junctions, distribution or transmission assemblies, and container junction objects—are not represented as polygons in the diagrams; they are represented as collapsed diagram junctions.
  • Noncontent lines, which are connected content points that have been collapsed, have been reconnected to the collapsed diagram junctions.
  • Linear containers, which are connected diagram polygon containers that have been collapsed, have been reconnected to the collapsed diagram junctions.
  • Content features or objects related to point or linear containers in the network are no longer visually represented in the diagram, but they are kept track of on the collapsed diagram junctions or collapsed diagram edges.

Collapse Container rule process

The following example, Diagram 1, shows how the Collapse Container rule processes container features or objects and content features or objects that are present in diagrams by default:

Sample diagram 1 content before collapsing its containers
Diagram 1 is shown before the Collapse Container rule execution.
Sample diagram 1 content after collapsing its containers
Diagram 1 is shown after the Collapse Container rule execution.

The first image above shows a sample diagram before the Collapse Container rule execution. This diagram displays a structure edge, LC1, connecting two structure junctions, PC1 and PC2, with all or part of their related content features or objects. The container structure junctions are represented as diagram polygon containers around their contents. The structure edge is represented in the diagram with all or part of its related contents.

The second image above shows the diagram after the Collapse Container rule execution. During the rule execution, all contents in the diagram are collapsed onto their related containers:

  • The J1 to J8 content junctions and E3 to E6 content edges related to the PC1 and PC2 polygon containers are no longer visible in the diagram after the rule execution. They are collapsed into related containers that are transformed into point containers by the rule. The rule kept track of them; each of those content features and objects is now associated with its related collapsed diagram junctions, PC1 or PC2.
  • Any E1 and E2 content lines related to the linear container LC1 are no longer visible in the diagram after the rule execution. They are automatically collapsed into the LC1 collapsed diagram edge, which is reconnected to the collapsed diagram junctions by the rule. Each of those content lines is now associated with that LC1 diagram edge.

The next table shows another sample where noncontent lines connect content junctions:

Sample diagram 2 content before collapsing its containers
Diagram 2 is shown before the Collapse Container rule execution.
Sample diagram 2 content after collapsing its containers without aggregating reconnected edges
Result A—Diagram 2 is shown after the Collapse Container rule execution without aggregating reconnected edges.
Sample diagram 2 content after collapsing its containers and aggregating reconnected edges
Result B—Diagram 2 is shown after the Collapse Container rule execution with reconnected edges aggregated.

The first image above shows a second sample diagram before the Collapse Container rule execution. In this case, the diagram displays container structure junctions represented as diagram polygon containers, PC1 and PC2, around their contents. Two noncontent lines, E1 and E2, are connected to two content junctions in each diagram polygon container.

The next two images, Result A and Result B, show the same diagram after running the Collapse Container rule when it is set up in two different ways:

  • Sample Diagram 2, Result A and Result B—Whatever the rule settings, the J1 to J8 content junctions and E3 to E6 content edges related to the PC1 and PC2 diagram polygon containers are no longer visible in the resulting diagrams after the rule execution. They are collapsed onto their related containers that are transformed into collapsed diagram junctions by the rule. The rule kept track of them; each of those content features and objects is now associated with its related collapsed diagram junctions, PC1 or PC2.
  • Sample Diagram 2, Result A—The rule is set up to not aggregate reconnected edges. The noncontent lines, E1 and E2, are kept in the diagram and reconnected to PC1 and PC2.
  • Sample Diagram 2, Result B—The rule is set up to aggregate reconnected edges. These edges are replaced by a reduction edge, R1, that aggregates all of them.

Collapse Container rule configuration

There are two tools to add a Collapse Container rule to a template—Add Collapse Container Rule and Add Collapse Container By Attribute Rule:

  • The Add Collapse Container Rule tool is used to configure the automatic collapse of all containers based on specific network source classes or object tables. It allows you to specify a list of network source classes or object tables and configure either the collapse of each network feature or network object belonging to those source classes or tables, or the collapse of any network features or network objects that are out of the specified source classes or tables.
  • The Add Collapse Container By Attribute Rule tool is used to configure the collapse of containers based on one particular network source class or object table by filtering those containers on their attributes.

Related topics