Input and output

Besides connecting the elements together, you have to decide what the input and the output of the workflow should be. We will first look at specification of the output, which is done by right-clicking the output box of any tool and selecting Use as Workflow Output as shown in figure 34.12.

Image workflow_output
Figure 34.12: Selecting a workflow output.

You can mark several outputs this way throughout the workflow. Note that no intermediate results are saved unless they are marked as workflow output34.1.

By double-clicking the output box, you can specify how the result should be named as shown in figure 34.13.

Image workflow_output_name
Figure 34.13: Specifying naming of a workflow output.

In this dialog you can enter a name for the output result, and you can make use of two dynamic placeholders for creating this name (press Shift + F1 to get assistance):

An example of a meaningful name to a variant track could be {2} variant track as shown in figure 34.14. If your workflow input is named Sample 1, the result would be Sample 1 variant track.

Image workflowoutputvarianttrack
Figure 34.14: Providing a custom name for the result.

In addition to output, you also have to specify where the data should go into the workflow by adding an element called Workflow Input. This can be done by:

At this point you have only prepared the workflow for receiving input data, but not specified which data to use as input. To be able to do this you must first save the workflow. When this has been done, the button labeled Run is enabled which allows you to start executing the workflow. When you click on the button labeled Run you will be asked to provide the input data.

Multiple input files can be used when:

Please note that once the multiple input feature is used in a workflow, it is not possible to run the workflow in batch mode. Please also note that the input elements can be renamed, which is useful if you want to be able to discriminate the elements in the process description shown during workflow execution.

You can also choose the order in which inputs will be processed by right clicking on the input parameter box at the top of the element. The feature 'order inputs' is enabled as soon as 2 or more inputs have been connected to the element (see figure 34.15). It will open a small window in which you can move the different inputs up and down (see figure 34.16). From now on there the order of the inputs will be displayed on the branches connecting inputs to elements.

Image orderinputs1
Figure 34.15: Right-click on the input parameter box to see the 'order inputs' function.

Image orderinputs2
Figure 34.16: Define the inputs order.

The example in figure 34.17 shows how to generate a track list in a workflow. Any track based on a compatible genome can be added to the same track list. This includes reference tracks as well as track results generated by elements of that workflow. In the latter case, only those for which a workflow output element has been configured can be included in a track list.

Image workflow_create_track_list
Figure 34.17: Generation of a track list including data generated within the Workflow, as well as data held in the Workbench.



Footnotes

... output34.1
When the workflow is executed, all the intermediate results are indeed saved temporarily but they are automatically deleted when the workflow is completed. If a part of the workflow fails, the intermediate results are not deleted.