Aivia Software

Recipe Console

The Recipe Console is the primary module for performing image analysis in Aivia. You can select a recipe to run and modify detection parameters to optimize the analysis outcome. You can save the analysis parameters and reuse them for future analyses.

Deep learning models and python recipes can be applied through the Recipe Console if your license permits these options.


The interface refreshes with the appropriate parameters and settings depending on the recipe chosen. 

The Recipe Console GUI can be broken down into three main sections: Console Controls, Recipe Settings, and Apply Controls.

  • The Console Controls section contains the recipe selection menu as well as file options.

  • The Recipe Settings section contains the analysis parameters and previewing options.

  • The Apply Controls section has options for running the recipe


Console Controls Section

The Console Controls section allows you to select recipes, load recipes, and load and save recipe settings. All recipes that come with your installation of Aivia can be found in the Recipe dropdown menu.

There are seven buttons for recipe options, which are summarized in the table below.




Load Settings

Loads recipe settings from a compatible XML file

Save Settings

Saves the recipe settings to an XML file

Load Recipe

Loads a recipe from a file

Delete Recipe

Removes the current recipe from the recipe list and the Recipe Console; this does not delete the recipe from its file

Reload Recipe

Reloads the current recipe to its initial configuration

Restore Standard Recipes

Exercise caution when using this function

Restores the standard recipes that come with your installation of Aivia and removes all other recipes from the Recipe Console; this does not delete recipes from their files

Toggle Measurement Calculation

Toggles whether the default measurements are calculated with the recipe or not

Combine ROI output into one set.



Combines the output into a single object set when applying to multiple regions of interest at a time.





Recipe Settings Section

When you select a new recipe, the Recipe Settings section refreshes to show the settings that are available for the selected recipe. This section is further broken down into three sections: Recipe Header, Input and Output, and Preset Groups.


Recipe Header

The Recipe Header displays the recipe name and controls for expanding/collapsing the recipe interface. For some recipes, the question mark icon is active and can be used to open a description of the recipe. Also for only some recipes, the Automatic Parameter Selection button can be used to automatically determine a set of reasonable parameters for the current image and specified input and output options for the recipe.



Automatic Parameter Selection button


Input and Output

The Input and Output section lets you specify the input and output locations for analysis, regions of interest (ROIs), and deep learning models to use for pre-processing. When a deep learning model is specified in the Input and Output section, the model is applied to the specified input channel(s), and then the output image(s) from the deep learning model is/are fed into the selected recipe.

Several deep learning models can be downloaded from our Deep Learning Model Library. You can also train your own models with Aivia Cloud.


Preset Groups

The Preset Groups section allows you to manipulate the analysis parameters and preview results.

To expand any of the sub-sections in the Recipe Settings, click on the rightward or downward pointing caret next to the name of the sub-section. You can also toggle the display of all recipe preset groups to show the analysis parameters by clicking on the Show Advanced Options button on the right side of the Recipe Header.



Show Advanced Options button



Apply Controls Section

The three (3) buttons located at the bottom-right corner of the Recipe Console allow you to apply the current recipe to the displayed image. The apply options are as follows:

  • Start/Restart applies the recipe from the first frame of the image.

  • Pause/Continue allows you to temporarily stop recipe processing and then resume processing.

  • Step applies the recipe one time frame forward.


Using the Recipe Console

The typical workflow for using the recipe console is as follows:

  1. Load an image to use with the analysis recipe.

  2. Select a recipe to apply or load a recipe from a file.

  3. Adjust the recipe settings using the recipe presets or by adjusting individual parameters.

  4. Preview the output while adjusting the recipe settings.

  5. Apply the recipe to the image once you are satisfied with the preview.

Detailed information on how to use the Recipe Console can be found on the How to use the Recipe Console page as well as in the Tutorial sections of the individual recipe pages.