Merge

_images/Merge_54.png

Merge two or more segmentations.

Signals

Inputs:

  • Segmentation (multiple)

    Any number of segmentations that should be merged together

Outputs:

  • Merged data

    Merged segmentation

Description

This widget takes several input segmentations, successively copies each segment of each input segmentation to form a new segmentation, and sends this segmentation to its output connections.

Merge widget

Figure 1: Merge widget.

The Options section allows the user to import and label segments. The Import labels with key checkbox enables the user to create for each input segmentation an annotation whose value is the segmentation label (as displayed in the list) and whose key is specified by the user in the text field on the right of the checkbox. Similarly, the Auto-number with key checkbox enables the program to automatically number the output segments and to associate the number to the annotation key specified in the text field on the right. The Copy annotations checkbox copies every input segmentation annotation to the output segmentation.

[1] The Fuse duplicate segments checkbox enables the program to fuse into a single segment several distinct segments whose addresses are the same; the annotations associated to the fused segments are all copied in the single resulting segment. [2]

The Send button triggers the emission of a segmentation to the output connection(s). When it is selected, the Send automatically checkbox disables the button and the widget attempts to automatically emit a segmentation at every modification of its interface or when its input data are modified (by deletion or addition of a connection, or because modified data is received through an existing connection).

The Cancel button interrupts the current process and therefore returns the widget to its precedent state.

Below the Send button, the user finds the number of segments in the output segmentation, or the reasons why no segmentation is emitted (no input data, no label specified for the output segmentation, etc.).

Messages

Information

<n> segments sent to output.

This confirms that the widget has operated properly.

Warnings

Widget needs input.

The widget instance is not able to emit data to output because it receives none on its input channel(s).

Settings were (or Input has) changed, please click ‘Send’ when ready.

Settings and/or input have changed but the Send automatically checkbox has not been selected, so the user is prompted to click the Send button (or equivalently check the box) in order for computation and data emission to proceed.

Please enter an annotation key for auto-numbering.

The Auto-number with key checkbox has been selected and an annotation key must be specified in the text field on the right in order for computation and data emission to proceed.

Please enter an annotation key for imported labels.

The Import labels with key checkbox has been selected and an annotation key must be specified in the text field on the right in order for computation and data emission to proceed.

Operation cancelled by user.

The user has cancelled the operation.

Examples

See also

Footnotes