Running tools

Launching tools and workflows involves the same series of general actions:

There are several ways to launch a tool or installed workflow:

Using the Quick Launch tool to start jobs

The Quick Launch tool, shown in figure 12.1, is started by clicking on the Launch button (Image launch_16_n_p) in the toolbar. It can also be launched using the keyboard shortcut Ctrl + Shift + T (Image command_key_web + Shift + T on Mac), or by going to the Toolbox menu at the top of the Workbench and selecting the top option, Launch (Image launch_16_n_p).

Image quicklaunch-genomics
Figure 12.1: Tools and installed workflows can be quickly found and launched using the Quick Launch tool.

In the Quick Launch dialog, you can type terms in the text field at the top. This will filter for tools and installed workflows with matches to these terms in the name, description or Toolbox location. For tools where names have been changed between Workbench versions, searches using old names will still filter for the relevant tool. Using single or double quotes (' or ") will find a literal quote of the searched term.

In the example shown in figure 12.2, typing create shows a list of tools involving the word create. The arrow keys or mouse can be used for selecting and starting a tool from this list.

Image quicklaunch-typing-genomics
Figure 12.2: Typing in the search field at the top will filter the list of tools to launch.

Click on the Favorites tab to see the subset of tools that are frequently used, or have been selected as favorites (see Favorites tab).

Configuring and submitting jobs

When you launch a tool or an installed workflow, a wizard pops up. The general order of the steps presented via launch wizards are:

  1. Specify the execution environment.
  2. Select the input data.
  3. Configure the available options for the tool.
  4. Specify how the results should be handled.

You can move forward and back through the wizard steps by clicking the buttons Next and Previous, respectively, which are present at the bottom of the wizard. Clicking on the Help button in the bottom left corner of the launch wizard opens the documentation for the tool being launched.

The rest of this section covers the general launch wizard steps in more detail.

Specify the execution environment

If more than one execution environment is available, and a default selection has not already been set, the first wizard step will offer a list of the available environments.

For example, if you are logged into a CLC Server, or if you have the CLC Cloud Module installed and an AWS Connection has been configured with credentials giving access to a CLC Genomics Cloud setup, you are offered the option of running the job in different execution environments (figure 12.3).

Image wb_select_execution_environment
Figure 12.3: This Workbench has the CLC Cloud Module installed and has an active AWS Connection to a CLC Genomics Cloud setup. Thus, this job could be run on the Workbench, or run on AWS by selecting the option CLC Genomics Cloud.

Information on about launching jobs on a CLC Server is provided in Running a tool on a CLC Server.

Select the input data for analysis tools

When selecting data to use as input to a tool, a view of the Navigation Area is presented, listing the elements that could be selected as input, as well as folders (figure 12.4). The data types that can be used as input for a given tool are described in the manual section about that tool.

Image runjob1
Figure 12.4: You can select input files for the tool from the Navigation Area view presented on the left hand side of the wizard window.

Selected elements will be listed in the right hand pane. To select the inputs, you can:

To remove entries from the "Selected elements" list, double-click on them or select them with a single click and then click on the left hand arrow.

When multiple elements are selected, most analysis tools will analyze them together, as a single input, unless the "Batch" option at the bottom is checked. With the "Batch option checked, the tool is run multiple times, once for each "batch unit", which may be a data element, or a folder containing data elements or containing folders of elements. Batch processing is described in Batch processing.

Select the input data for import tools

Selecting files for import is described in Import of data and graphics. It is generally similar to selecting input for analysis tools, but involves selecting files from a file system or remote location. Many import selection wizards also support drag-and-drop for selecting files to import.

Configure the available options for the tool

Depending on the tool, there may be one or more wizard steps containing options affecting how the tool behaves (figure 12.5).

Clicking on the Reset button resets the values for the options in that wizard step to their default values.

Image runjob2
Figure 12.5: An example of a "Set parameters" wizard step.

Specify how the results should be handled

Handling results is described in Handling results.