Houdini 19.0 Nodes Geometry nodes Group Promote

Group Promote geometry node

Converts point, primitive, edge, or vertex groups into point, primitive, edge, or vertex groups.

On this page
Since 16.0

Converts between different types of groups. When converting groups, you can use wildcards to convert several groups that match the specified pattern. For more information about the pattern substitution rules, please see Attrib String Edit.


Source geometry

The geometry on which to create the groups.


Number of Promotions

The number of group promotions rules to apply. Promotions are applied in sequence, so if a group was promoted by an earlier rule and matches a later rule, it may be re-promoted.

Convert From

Source group type.


Newly created group type.

Group Name

Group to convert.

New Name

The new name of the converted group. Leave this empty to keep the name of the original group.

Keep Original Group

Do not remove the original group type.

Include Only Elements on the Boundary

This option removes elements from the output group that are not on the boundary. Groups are first converted to the output type, and then only elements on the boundaries of these converted groups are included.

Include Unshared Edges

When selected, geometry edges that are only referenced by a single polygon will be included in the boundary group.

Include All Primitives Sharing Attribute Boundary Points

When selected, all primitives that have at least one point on the attribute boundary will be included in the result. Otherwise, primitives will be required to share an edge with the attribute boundary to be included.

Connectivity Attribute

This option allows treating the boundaries of the supplied attribute(s) as group boundaries. If selected, any connected region boundaries overlapping with the output group will also be included in the resultant boundary.

By default the connectivity attribute is set to UV, however, one can use any attribute to specify connectivity. If the attribute is on either vertices or primitives, it will include edges which have attributes that differ across the edge. If the attribute is on points, it will include edges separating connected regions of points.

When more than one attribute is specified, each will be used to separately specify connectivity, and boundaries will be found as the union of all connected region boundaries.

Include Only Elements Entirely Contained in Original Group

This option allows only primitives that have all of their points or edges in the original point group to be included in the resulting primitive group, when converting from a point group or an edge group to a primitive group.

The same thing applies when converting from a point group or a primitive group to an edge group. Only edges with both points in the original point group will be added to the new group.

When converting from an edge group to a vertex group, this causes only the vertices at the beginning of each edge be included. In other words, each vertex is associated only with outgoing edges when this option is enabled.

Remove Degenerate Bridges

This option removes degenerate bridge elements.

Output as Integer Attribute

When enabled and the To type is Points, Primitives, or Vertices, this converts the output group to an integer attribute with values 0 (not in the group) and 1 (in the group) and then deletes the group.

See also

Group Promote