Remove Feature rule reference

The Remove Feature rule is used to remove specific network features or network objects represented in diagrams. This rule processes on network source classes or object tables, or on network categories. When the remove operation is configured to process on a network source class or object table, you can filter out these network elements by attributes. The process can also be run for specific connectivity constraints depending on the geometry type of the removed network elements.

It is useful to automatically discard network features or network objects that may be present among the input network elements set during diagram building. For example, to generate diagrams representing the distribution part of a network that is selected in the network map, you can use a diagram template configured with the Remove Feature rule that automatically discards all network features or network objects from the input network elements except distribution lines.

The automatic discard of linear container edges is another common use to avoid having network linear containers and their related contents represented together in diagrams. This allows you to get simplified diagrams.

Remove Feature rule process

The Remove Feature rule doesn't preserve the topology of the graph. If diagram junctions are configured to be removed, the rule will not reconnect their connected edges to any target junction in the way the Reduce Junction rule does; any junction removal will cause its connected edges to also be removed from the resulting diagram.

When removing an edge, any to and from junctions are systematically removed for noncontent junctions that would become detached.

Note:

Junctions that are connected to another edge or edges that participate in a containment association are not removed.

To remove detached junctions, even when they are contents, you must process a Remove Feature rule on the related containers before processing the Remove Feature rule on the edges.

Remove Feature rule configuration

The tools you can use to add a Remove Feature rule on a template—Add Remove Feature Rule, Add Remove Feature By Attribute Rule, and Add Remove Feature By Category Rule—are described as follows:

• Use the Add Remove Feature Rule tool to configure the removal of diagram features based on network source classes or object tables and, optionally, filter by connectivity constraints. You can specify a list of network source classes or object tables and configure either the removal of each diagram feature based on the specified network source classes and object tables, or the removal of any diagram features except those based on the specified network source classes and object tables.
• Use the Add Remove Feature By Attribute Rule tool to configure the removal of diagram features based on one network source class or object table by filtering those features or objects based on their attributes and optional connectivity constraints.
• Use the Add Remove Feature By Category Rule tool to configure the removal of diagram features representing network features or network object tagged with or without particular network categories.

Note:

The Add Remove Feature By Category Rule tool only applies to Utility Network Version 7 and later.

Note:

When a Remove Feature rule is configured on a template at the beginning of its rules list, it discards the initial removed diagram features for the rest of the diagram life cycle at its generation. In this case, the diagram features are deleted from the network diagram tables, allowing space to be saved in the database and increasing performance for diagram operations.

When there is at least one other rule configured to run before a Remove Feature rule, the removed diagram features are kept in the network diagram tables. They are never deleted during the diagram life cycle.

Tip:

When configuring diagram rule by attributes, you can filter out diagram features on network source attribute values regarding the other diagram feature attribute values using the following specific SQL statement: WHERE 'OBJECT' = 'IN_DIAGRAM'. For example, to query the diagram feature with a minimum attribute value in the generated diagram, you can set up any Add <XXX> By Attribute Rule tool with an SQL expression based on the following syntax: <attributeName> = (SELECT MIN(<attributeName>) FROM <networkClassName>) WHERE 'OBJECT' = 'IN_DIAGRAM'.