Relate one-to-one
Relate objects of two classes based on spatial proximity or overlap.
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
| Parameter | Description |
|---|---|
| Input objects 1 | 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 | 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 | 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 | 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 | Controls the type of calculation used when determining which objects are related:
|
| Maximum separation | If "Relationship mode" is set to "Centroid separation", this is the maximum separation two objects can have and still be related. |
| Calibrated units | When selected, spatial values are assumed to be specified in calibrated units (as defined by the "Input control" parameter "Spatial unit"). Otherwise, pixel units are assumed. |
| Minimum overlap of object 1 (%) | If "Relationship mode" is set to "Spatial overlap", this is the minimum percentage overlap the first object must have with the other object for the two objects to be related. |
| Minimum overlap of object 2 (%) | If "Relationship mode" is set to "Spatial overlap", this is the minimum percentage overlap the second object must have with the other object for the two objects to be related. |
| Only link objects in same frame | When selected, objects must be in the same time frame for them to be linked. |