Description

Relate objects of two classes based on spatial proximity or overlap. With this module, each object from a collection can only be linked to one other object (see "Relate many-to-many" and "Relate many-to-one" modules for alternatives). The assignments are chosen to give the optimal overall relationship connectivity. As such, an object may not be linked to its own best match if that best match is itself closer still to another object. Related objects are assigned partner relationships and can optionally also be related by a common cluster (parent) object. Measurements associated with this relationship (e.g. distance to the related object) are stored as measurements of the relevant object.

Parameters

Input objects 1 (default = "") First objection collection from the workspace to relate objects for. These objects will be related to the objects from the collection specified by "Input objects 2". Related objects will be given partner relationships and optionally (depending on the state of "Create cluster objects") be related by a common parent cluster object.

Input objects 2 (default = "") Second objection collection from the workspace to relate objects for. These objects will be related to the objects from the collection specified by "Input objects 1". Related objects will be given partner relationships and optionally (depending on the state of "Create cluster objects") be related by a common parent cluster object.

Create cluster objects (default = "true") When selected, new "cluster" objects will be created and added to the workspace. These objects contain no spatial information, but act as links between all objects that were related. Both objects identified as relating to each other are stored as children of the same cluster object.

Output cluster objects (default = "") If storing cluster objects (when "Create cluster objects" is selected), the output cluster objects will be added to the workspace with this name.

Relationship mode (default = "Spatial overlap") Controls the type of calculation used when determining which objects are related: