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 to the recipe 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.

Interface

The Recipe Console is in a tab of the Analysis Panel. The interface refreshes with the appropriate parameters and settings depending on the recipe chosen. 

The Recipe Console GUI can be broken down into three (3) 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 and save existing 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 (7) buttons for recipe options, which are summarized in the table below.

Name	Icon	Description
Save Recipe	Open	Saves the current recipe and settings to a file
Load Recipe	Open	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
Save Settings		Saves the recipe settings to an XML file
Load Settings		Loads recipe settings from a compatible XML file

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.

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.

The Input and Output section lets you specify the input and output locations for analysis, regions of interest (ROIs) for images that have more than one z-plane, 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.

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.

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.

Related articles