Overview of Ikomia Workflow Editor

– 10 min read –

What is Ikomia STUDIO ?

Testing and evaluating Computer Vision algorithms quickly and easily is one of the main goals of the Ikomia platform. That is why we provide different levels of use, from nocode Computer Vision with the STUDIO to low-code with the Python API.

What is it ? Ikomia STUDIO is a graph-based editor to create your custom image processing workflow. Add algorithms as process nodes, connect them and you are ready to go.

What does it do and how do I get started ? Here are all important features to build your own workflow in a few clicks. Just follow these steps to easily experience the creation of a Computer Vision solution with STUDIO.

If you first want to see the STUDIO in action? Please consult this blog post or this video.

Create a new workflow

  • By applying a first process on current data

The STUDIO processes images or videos you already loaded in Ikomia. As a result, applying a first algorithm on the current data will automatically create a new workflow and launch the process. Then, the UI will show you the original and processed data in a split view.

  • From scratch

You can start a new workflow even if no data is loaded yet. To do so, click on the new button located in the left pane of the module and fill workflow information as shown below:

Create new workflow

Once created, you can add process nodes by selecting an algorithm from the Ikomia HUB or by clicking on the empty node in the editor. New node is automatically connected to parent node if possible. The way the editor places nodes will be covered in this section. You can always adjust positions and connections manually.

Manage global inputs

Global inputs are persistent data loaded into a project structure. They represent the source data on which the whole workflow is applied. They are slightly different from input data at node level, which can be generated by previous nodes.

The STUDIO can manage a list of global inputs. By default, you will find only one input slot corresponding to the current data (image, video or camera). This slot is reserved, it can’t be deleted.

You can easily add a new input by clicking on the + button when the mouse pointer enters the editor input area. Next, select the data type you want to process, it can be one of the following:

  • Image(s): selection of image(s) already loaded in Ikomia project.
  • Video(s): selection of video(s) already loaded in Ikomia project.
  • Dataset(s): selection of dataset(s) already loaded in Ikomia project. Dataset is here a generic internal term to define a structured set of images or videos.
  • Folder(s): selection of folder(s) in an Ikomia project. It’s an internal structure of a project and does not match a filesystem entry.

Add global input

Note: you may have noticed the possibility to set data list or containers as global input. This is what we call the Batch Mode. To learn more about it, read the article Discover the batch processing mode.

Add a new node

As previously said, a node is the workflow representation of an algorithm. Thus, we need to add different nodes and connect them to build a functional pipeline.


An empty node with the label “Click here to add new process” indicates the insertion location of the future node. The editor updates automatically this location according to the current node and the graph structure. The current node is easy to identify: it appears highlighted and brighter than all others nodes. You can manually change the current node by clicking on the node you want to select.

Inputs, outputs and connections

Each node comes with one or several inputs and can generate outputs (can be none). In order to obtain your workflow, you need to  connect output(s) from parent node(s) to input(s) of child node(s).

The STUDIO provides an automatic connection system based on data types. It will always consider the current node as the parent node. So you should think checking and updating the current node before adding  a new algorithm. For complex scenarios, you may have to create manual connections in the editor by dragging link from source output to target input. Please note that a connection is possible and valid if data types are the same or compatibles. Consequently, the notification center shows a message with additional details if an error occurred.

Within a node, colored circles represent inputs and outputs . They are the begin or end point of node connections. Colors indicate data types, here is the list of possible data types:

Input/output data types

Run the workflow

The module provides several modes to run algorithms across the graph-based workflow:

  • Run workflow: run all nodes.
  • Run workflow from current node: run all nodes of the sub-graph for which the current node is the root node. Parent nodes of the current node are not executed, they must have valid outputs generated from previous run.
  • Run workflow to current node: run all nodes of the sub-graph for which the current node is a leaf. Child nodes of the current task are not executed.

Reminder: current node appears highlighted and brighter in the editor. See here for details.

Visualize data

The STUDIO uses the advanced display capabilities of Ikomia. When the module is active, the main view is divided in two parts: the left one for inputs and the right one for outputs. At any time, user can maximize input or output view with mouse double-click.

First, the left part dedicated to inputs can show two kinds of information for the current node. Therefore, you will find specific buttons to activate these modes in the top toolbar of the module as shown below:

  • original inputs (ie global inputs of the workflow)

Original input view mode

  • current node inputs

Current input view mode

Secondly, the right part adjusts automatically its view according to current algorithm outputs. The layout is designed like this:

  • One tab for each data type.
  • For a given data type, as many displays as output count.

Outputs view

Note: the STUDIO updates views each time a new node is selected and becomes the current one.

Consult workflow information

To complete our module overview, we will focus now on useful information associated with the workflow. You will find it in a multi-tab view located in the right part of the module window.

Algorithm parameters

The STUDIO is a tool dedicated to algorithm testing and evaluation. Hence, tuning parameters is a key feature. To this end, the first tab of the UI element shows parameters associated with the current node. User can adjust them in order to analyze algorithm behavior.

Information page is also accessible from this tab. This page provides algorithm description, author(s), associated scientific paper, version number and various other interesting metadata.

Benchmark metrics

You are provided with basic metrics in the second tab:

  • Process time execution
  • Elapsed time from start to current node
  • Total elapsed time of the workflow

Inputs/outputs description

Finally, the third tab provides additional information around inputs and outputs. This may help understanding how the algorithm works and brings explanations concerning input data types.

Workflow information

We took a quick tour around core features of the STUDIO so that you are ready to browse and test all algorithms from the Ikomia platform. We didn’t describe features exhaustively: we let you discover the module on your own. Among other things, you will find additional features like save, export or load workflows.


Leave a Reply

Avatar placeholder

Your email address will not be published.