5. Task Controller

The system is able to run specific tasks, e.g. Algorithms, on image data. These tasks are specified as Task Controller (Taco) objects. For information on available Algorithms, consult the Algorithm section of the user manual.

Adding new taco objects or changing existing Taco objects can be done in the admin interface. After logging in to the admin page, visit the Taco_Client section.

Fig. 5.4 Admin taco client

5.1. Taco

To add a new taco, click the Add button (or Add taco), and to change an existing taco, click on the name of the taco you want to change. This will open a new page to edit the taco (Fig. 5.5).

Fig. 5.5 Edit taco

The following fields are shown:

URL*:

The URL to which the taco will send the calls. Each taco call will be posted as a message in a processing queue, and will be picked up by the taco workers.

Algorithm*:

Algorithm which will be applied.

Apply automatically:

A taco can be linked to an Archive. If this checkbox is checked, the taco will be applied automatically to each series that is imported into the archive.

Name*:

The name of the taco.

Extra arguments:

Extra arguments to be passed to the algorithm executable that is specified in the Algorithm field.

* Required fields

After all required fields have been filled in, the taco can be saved, by pressing the Save button.

5.2. Taco call

When an Algorithm is applied to a Series object, a taco call is created. To view existing taco calls, click the Taco calls link shown in (Fig. 5.4). This will open a new page listing all existing taco calls. The taco calls should not be edited or created manually. The taco calls are only available to check the status of the taco calls and look for possible errors. Each of the taco calls contains the following information:

ID:

A unique ID created in the database.

Created:

The timestamp of when the taco call was created.

Finished:

The timestamp of when the taco call was finished.

Series:

The SeriesInstanceUID of the series the taco was applied to.

Success:

The status of the taco call. Values can be succes, not-successful or unknown.

Token:

Each taco call will get a unique token which is used by the processing server to authorize the taco call.

Error message:

If an error occurred during processing of the series, the error message is displayed here.

5.3. Problems

When a taco is started from the browser, it can happen that the user gets the following message: ‘Case could not be started. Too many instances.’ When this happens, the series that the user is trying to restart has more than one instance, this should not be the case. If this happens, it can be fixed by going to the series admin page (see Series) and find the series for which this issue occurs. Open the series and scroll all the way to the bottom. In the instances field you should see more than one instance. You can download the images by clicking ‘View on site’ next to the instance number.

Choose which instance(s) are not correct and click the ‘Delete?’ checkbox at the end of the line of that instance. Then click ‘Save’ at the bottom of the page. Now this instance is removed and the case can be restarted as usual.