Grouping nodes (2/2) – JIPipe for ImageJ

Summary

Explains how to use filesystem nodes to automatically detect and load all images in a directory.

Tutorial data

This tutorial has accompanying data. Please download the data if you want to follow the guide.

Tutorial

Project + Data

Preliminary steps

Please follow the previous tutorial about creating groups.

View previous tutorial

Multiple options

There are multiple approaches to achieve the same result. We recommend to check out all of the presented options.

Alternative 1
Alternative 2

Step 1

In order to see the content of the group node, double-click on the node (red arrow 1), which will open the content of the group in a new tab (red arrow 2).

Step 1

Alternatively, select the group node (red arrow 1), go to Parameters (red arrow 2) and select Edit graph (red arrow 3).

The new tab will contain the content of the group, similarly to the previous viewing method.

Step 2

Parameters that belong to the member nodes of the group can be made accessible directly.

Activate the group node (red arrow 1), go to Parameters (red arrow 2) and select Edit parameter references (red arrow 3).

In the new Edit parameters window (red arrow 4) select Add (red arrow 5 and choose Empty group (red arrow 6).

Info

The second option, Node as group, will add all exportable parameters to the list. So, please be aware that there can be many parameters.

Step 3

The new group parameters window (red arrow 1) can be (re)named (red arrow 2), and provided with a description (red arrow 3).

The description editor can be in compact, full or HTML mode (red arrow 4).

Step 4

In order to now add parameters to the group, click on Add parameter reference (red arrow 1) and browse the new Add parameter window (red arrow 2).

Chose e.g. Annotate with path properties (red arrow 3) and select Annotate with size (red arrow 4), Annotate with type (red arrow 5) and Annotate with parent path (red arrow 6), and accept the selection (red arrow 7).

Step 5

The newly added exposed parameters are now visible in the Import image node (red arrow 1) Parameters menu (red arrow 2), where all three exposed parameters (red arrows 3, 4, 5) are now adjustable, without having to open the group graph. Direct editing of the nodes inside the group is still possible via opening the content in a new tab, as show before.

Info

If you obtained the group node from a node template, re-create the template from the modified group node, as changes are not automatically stored inside templates.

Step 6

Observer the cache (red arrow 1). The outcome is the same as it was after executing the individual nodes (red line 2).

Step 7

However, the nodes inside the group do not have their cache saved! When examining the group tab, the content reveals a node for the group input (red arrow 1), the group output (red arrow 2), but selecting the Import image node, e.g., (red arrow 3) will not find a Cache tab (red arrow 4).

Step 8

Info

Consequently, Groups should only be generated, when the selection of nodes that will be unified into a group have already been tested and debugged thoroughly!

Should changing and testing the individual nodes of a group become necessary, the member nodes of the group have to be copied into the main pipeline (red line 1) and tested there the traditional way.