Skip to main content

Your first Workflow Run

We are finally there, we can run our first workflow. In this section we will run our first workflow, that we designed in the previous section. Remember it will take an image , max project it, threshold it and then measure the fraction of the image that is below the threshold, to estimate the fraction of the image that is not covered by cells. In this section you will learn:

  • How to run a workflow
  • How to monitor the progress of a workflow
  • How to inspect the result of a workflow
Immediate Execution

In the latest version of Arkitekt, workflows and tasks can be executed immediately without a prior reservation step. The system handles the provisioning of resources automatically.

Run our analysis​

And now we can finally run our analysis. Lets start by navigating to the "Data" tab. Lets use the same image as we used in the previous section.

  1. Navigate to our data in the Data tab

Lets inspect our data in the "Data" tab. We should see our data in the "Data" tab. (If you are doing this part of the tutorial, on another day you might need to open the "Home", sidebar and step back one day to see your data.)

  1. Drag and Drop or right click the image the @mikro/representation we want to convert

This time in our Action menu we will see a new option. "Analysis Run", this is our first Workflow Action. Lets drop on it (or click it).

  1. You are prompted with a dialog.

This dialog is our first encounter with an Arkitekt Assign dialog. Here Arkitekt will ask us to confirm the assignment.

  1. This is new!

You might notice that you are immediately transported to the Run page, where you can inspect the progress and result. Its a bit fast. But you can always go back in time. Just click on the live button in the bottom left, corner. And you will be transported back in time and you can scan through the history of your run (current bug, you might need to refresh the page (right clikc -> refresh) to scan)

The Run Page

Everytime you run a workflow, Arkitekt will create a Run for you. This run will keep track of the progress of your workflow, and will also keep track of the result of your workflow. A run is not only an indicator of the live progress of your workflow, but will also be your go to point to inspect the processing pipeline and potential debug entrypoint. All data is linked in your run and can be exported (e.g. in your methods section just like here). You can find your latest runs in the Workflow tab.

When double clicking on the node in replay or live mode in a run, you can inspect the data flowing through the graph. Not to helpful here, but very much so in the advanced workflows.

Lets inspect our image​

But lets not only look at our workflow. Just like we did in the previous section, we can also inspect our image. Lets start by clicking on the Data tab.

While you click on your image, you will now see that there is derived images that are linked to your image. These are the images that are created throughout the workflow. Just explore this datagraph. You can click on the images and inspect them.

The Data Graph vs the Provenance Graph

Interestingly there is two types of graphs that are linked to your data. The Data Graph and the Provenance Graph. The Data Graph is the graph that is created through interlinking of data by the application itself (e.g. a thresholding algorithm can decide to declare that the thresholded image is a derivative of the original image). The Provenance Graph is however a graph that is created through keeping track which Node task created an image. If you click on the Provenance icon you will see a reference to the Assignation (i.e. the Task) that created that image. And that task will in turn have a reference to the Workflow Assignation that created it.