Grouper Element

Group slot

The Group slot specifies a slot that is used to group the input data. The list of available values of the parameter depend on the slots of workflow elements which produce data in the workflow before the Grouper element. There is a special Unset value. When it is selected, only one group is created.

Group operation

The Group operation specifies criteria to group data supplied to the Group slot. It can take the following values:

• By value - input data are compared by value (a group is created for each unique value, it can contain one or several identical values)
• By identity - input data are compared by internal data ID (all values are unique)
• By name - input data are compared by their names

By value group operation is available for group slots of types Sequence, Set of annotations, MSA, Plain text, Source URL. By identity and By name group operations are available for group slots of type Sequence only.

Output slots

When data supplied to the Group slot are divided into different groups the associated data are also got into a group. The possible associated data depend on the workflow. For example, a Sequence Reader element contains slots Sequence and Set of annotations. These data are associated as annotations belong to a sequence. Another example of associated data are sequence markers created by the Sequence Marker element. The associated data, therefore, can be additionally handled (i.e. merged) by the Grouperelement. The action that can be performed on the associated data depends on their type. In any case to output handled associated data you need to create a new output slot in theGrouper element. To create it click the Add button in the Grouper’s Parameters area. The following dialog appears:

In the dialog you should select a Source data slot (i.e. a slot with the associated data) and input a name of the new slot. Click the OK button. A new dialog appears that specifies how the associated data should be merged. The view of the dialog and the available merge actions for different types of the Source data slot are the following:

• For a Set of annotations slot the New Annotations Action dialog appears:

You can merge annotations into one annotation table and, optionally, filter duplicated annotations. Also, you can shift annotations. To do it, you need to create another output slot with type Sequence and Merge into one sequence option selected (see below). In other words you need to merge all sequences in a group into one sequence. In this case you select the corresponding sequence slot in the New Annotations Action dialog and each set of annotations in a group is shifted according to the corresponding sequence in the group. As the result you have one sequence and one set of annotations allocated on the whole sequence.

• For Source URL and Plain text slots the New String Action dialog appears:

Using this dialog you can merge strings into one string. Optionally, you can specify an additional strings separator.

• For a Sequence slot the New Sequence Action dialog appears:

You can either merge all sequences in a group into one sequence or create a multiple sequence alignment. In the first case you need to specify the Merged sequence name and you can select the number of unknown characters between the merged sequences. In the second case you need to specify the alignment name. To filter duplicated sequence check the corresponding check box.

• For a MSA slot the New Alignment Action dialog appears:

Input the alignment name in this dialog. To filter duplicated rows check the corresponding check box.

To edit a created slot, select it in the Parameters area of the Grouper element and click the Edit button. To remove the slot, select it and click the Remove button.