Aivia Software

How to batch apply recipes

As of Aivia 11, most batch processing in Aivia is done through the Workflow Processor. The Workflow Processor has options for saving processed images, Excel-readable measurement files, channels, and object masks. While you can create a workflow with multiple analysis steps, including pixel classification, image enhancement, object classification, and more in the Workflow Processor, the step-by-step guide on this page only covers a basic recipe workflow.

Step-by-step guide

This tutorial uses automatic workflow creation from an object group, but workflows can also be manually defined or created from recent actions. Please see the Workflow Processor page for more details.

Before beginning the tutorial, please download the Nuclei Count Demo Images ( This tutorial uses the Nuclei Count recipe. Please refer to the documentation on the Nuclei Count recipe for more information about the recipe.

1. Unzip the demo file. There should be five images total.

2. Load one of the images into Aivia.

3. In the Recipe Console, click on the Recipe selection dropdown menu and select the Nuclei Count recipe.

4. Set the recipe parameters as shown below.

Nuclei Count tutorial parameters

5. Click the Start button or press the F4 key on your keyboard to apply the recipe.

6. In the Object Set Settings panel, right-click on the created object group and choose the Create Workflow option. This creates a workflow with the analysis steps that were taken to create the object group, which in this case was applying the Nuclei Count recipe with the parameters specified in Step 4. This also launches the Workflow Processor.

Create a workflow from an object group

7. In the Workflow Processor window, click the Add File(s) button, navigate to the folder containing the unzipped demo images in the dialog that opens, select the five demo images, and then click Open.

The exclamation point and yellow border around the workflow tile indicate that the workflow has not been saved to a file. To save the workflow for future use, go to the Editor tab and click the Save icon in the upper-right corner of the workflow’s tile. You can also make other modifications to the workflow in the Editor tab, such as renaming the workflow, adding additional processing steps, or changing the recipe or recipe parameters. See the Workflow Processor page for more details.

8. Click on the Browse button to the right of the Save Folder text field, navigate to the desired output location, and then click Select Folder.

9. In the Additional Save Options section, check the boxes for the types of output files you would like to save. With the Save Field option, the processed images with their generated objects and measurements are saved as Aivia TIFF files.

10. Click Run Job(s) to start the workflow processing. The Queue tab of the Workflow Processor is automatically shown, displaying the job currently being processed as well as the queue of jobs waiting to be processed. Once the queue is empty, all jobs have been completed.

11. After processing is done, there is a folder within the specified save folder with the data, time, and workflow name in the title, and within that folder there is a folder for each of the input images titled “Job [#]” by default. Each “Job [#]” folder contains all outputs for one of the input images.

12. You can open the processed images (if the Save Field output option was used) in Aivia to view the analysis results. You may click on the Explore Results Active Tile (accessed from the search bar) to adjust the Aivia layout to one conducive to exploring analysis results.