10.64. Create Data Group

Group (Subgroup)

Core (Generation)

Description

This Filter creates a new empty DataGroup at a user-specified location in the Data Structure. The new DataGroup contains nothing initially; subsequent filters can add child objects to it.

What is a DataGroup?

A DataGroup is a general-purpose container. Unlike an Attribute Matrix, a DataGroup can hold any DataObject of any size – geometries, attribute matrices, arrays of varying sizes, even other DataGroups. There is no shared-tuple-shape contract.

Use a DataGroup when you need to organize heterogeneous data, such as a logical grouping of unrelated arrays or geometries. Use Create Attribute Matrix instead when all the arrays you are grouping share a common tuple shape and represent values over the same domain.

Required Input Sources

  • Parent Data Object Path – an existing DataGroup, Attribute Matrix, or Geometry under which the new DataGroup will be created. The top-level of the Data Structure can also be selected.

Output Data Object(s)

Parameter Name

Parameter Type

Parameter Notes

Description

DataObject Path

DataGroupCreation

The complete path to the DataObject being created

Example Pipelines

DREAM3D-NX Help

If you need help, need to file a bug report or want to request a new feature, please head over to the DREAM3DNX-Issues GitHub site where the community of DREAM3D-NX users can help answer your questions.