Merge related objects

Combine coordinates from related objects into a single object.

Description

Combine coordinates from related objects into a single object. This module can either add coordinates from all child objects into the associated parent or create entirely new merged objects. New merged objects can either contain just coordinates from child objects, or from the parent and its children. Any duplicate coordinates arising from overlapping child objects will only be stored once.

Note: If updating the parent objects, any previously-measured object properties may be invalid (i.e. they are not updated). To update such measurements it's necessary to re-run the relevant measurement modules.

Parameters

Parameter	Description
Parent objects	Input parent objects for merging. If "Output mode" is set to "Merge children into parent" all the coordinates from child objects will be added to this object. However, if operating in "Create new object" mode and "Merge mode" is set to "Merge parents and children", coordinates from parent objects will be added to the new merged objects.
Child objects	Child objects of the input parent. If "Output mode" is set to "Merge children into parent" all the coordinates from these objects will be added to their respective parent. However, if operating in "Create new object" coordinates from these objects will be added to the new merged objects.
Output mode	Controls where the merged object coordinates are output to: "Create new object" For each input parent, a new merged object will be created. These merged objects are themselves children of the parent object. "Merge children into parent" Combined coordinates (original coordinates from parent and coordinates of children) are added to this parent object. Note: In this mode the coordinates of the parent object are being updated, so any previously-measured object properties may be invalid (i.e. they are not updated). To update such measurements it's necessary to re-run the relevant measurement modules.
Output overlapping objects	If outputting new merged objects (as opposed to updating the parent), objects will be stored with this reference name.
Merge mode	When in "Create new object" mode, this parameter controls what coordinates are added to the new merged objects: "Merge children only" Only coordinates from child objects are added to the merged object. In this mode, coordinates for the parent are ignored. "Merge parents and children" Coordinates from both the parent and child objects are added to the new merged object.