Parameter Recipe
This section introduces the application and configuration of parameter recipes.
Introduction
Parameter recipes are sets of parameter settings that need to be adjusted according to different situations for the same project. With parameter recipes, you do not need to build multiple projects with the same logic and configure their parameters differently to meet different on-site requirements. Instead, you will only need to switch between parameter recipes in one project to make it applicable to various scenarios and therefore the productivity can be increased.
Mech-Vision provides a tool to configure Parameter recipes.
Application Scenarios
Parameter recipes are applicable to scenarios where the parameters need to be set according to different situations. The typical application scenarios are summarized as follows:
-
Use the same Mech-Vision project to process different target objects. In this scenario, you can configure different parameter recipes and switch parameter settings for different target objects.
-
Use the same Mech-Vision project to process target objects in different bins. In this scenario, you can configure different parameter recipes and switch parameter settings for different bins.
-
Under different light conditions (e.g., in the daytime or in the evening), the Mech-Vision project should use different camera configuration parameter groups and other parameter settings. In this scenario, you can configure different parameter recipes and switch camera configuration parameter groups for different light conditions.
-
In Eye In Hand mode, the Mech-Vision project should capture images in different areas. In this scenario, you can configure different parameter recipes and switch camera configuration parameter groups for different image capturing areas.
When master-control communication is used, you should switch the corresponding parameter recipe in a Mech-Vision project manually. When Standard Interfaces or Adapter is used for communication, you should run a recipe-switching command on the robot side, and Mech-Vision will switch the parameter recipe automatically according to the command it received.
Configure Parameter Recipes
Add a Parameter Recipe
Follow these steps to add a parameter recipe:
-
Open a project, click the Project Assistant tab, and click
to open the Parameter Recipe panel.
-
Click
in the Parameter Recipe panel. -
Click the Add recipe button in the pop-up Parameter Recipe Editor window, and enter the recipe name in the text box.
-
Select the newly added recipe and click the Add Parameter button. Then a Select Step Parameters dialog box will pop up.
-
In the Select Step Parameters dialog box, select the Step you want to add in the left panel, and then select the parameters of the Step on the right. After selecting all the parameters of Steps you need, click OK.
-
Double-click the parameters one by one to modify their settings in the parameter recipe list.
After the parameters are added, you can customize the parameter names according to actual requirements. Click the Customize parameter name button to modify the names.
Please pay attention to the order to set parameters in the recipe. You may not be able to set a parameter successfully because of the setting order.
-
Click Save in the Parameter Recipe Editor dialog box. A Saved successfully message will appear in the lower left corner of the dialog box.
If you need multiple parameter recipes in the project, just follow the above instructions to add multiple recipes. The parameter settings of the newly added parameter recipe will be the same as those in the current project by default.
Copy Parameter Recipe
When a parameter recipe already exists in the Parameter Recipe Editor, you can copy the existing parameter recipe by using the “Copy recipe” feature.
-
Select any available parameter recipe in the Parameter Recipe Editor, and then click the Copy recipe button.
-
After the parameter recipe is copied, a parameter recipe copy will appear in the Parameter Recipe Editor. Double-click the recipe name to modify the recipe name.
Apply or Switch the Parameter Recipe
|
When Standard Interfaces or Adapter is used for communication, you should run a command on the robot side to switch the parameter recipe successfully. |
Follow these steps to apply or switch the parameter recipe manually:
-
Click the Project Assistant tab, and click
to open the Parameter Recipe panel.
-
In the Parameter Recipe panel, select the parameter recipe corresponding to the target object in the drop-down list. The selected parameter recipe will take effect when the project runs.
|
After running the project with the selected parameter recipe, if you want to modify the parameter settings in the recipe, please refer to Modify Specific Parameter Setting in the Parameter Recipe. If you modify the parameter settings in the project directly, the parameter recipe will be switched to Customized when you run the project again. |
View the Parameter Recipe ID
When Standard Interfaces or Adapter is used for communication, you should specify the parameter recipe ID instead of the recipe name in the command sent from the robot end.
Follow these steps to view the ID of the parameter recipe:
-
Open a project, click the Project Assistant tab, and click
to open the Parameter Recipe panel.
-
Click
in the Parameter Recipe panel. -
Check the ID of the recipe you need in the leftmost column of the table.
Add Parameters to the Parameter Recipe
Follow these steps to add parameters to the recipe:
-
Select the recipe you want to modify in the Parameter Recipe Editor dialog box, and click the Add Parameter button.
-
Select new Steps and parameters in the Select Step Parameters dialog box, and click OK to confirm.
-
Double-click the new parameter settings in the parameter recipe list to modify.
-
Click Save in the Parameter Recipe Editor dialog box.
Delete Parameters from the Parameter Recipe
Follow these steps to delete parameters in the recipe:
-
Select the parameter you want to delete in the Parameter Recipe Editor dialog box, and click the Delete Parameter button.
Once the parameter is deleted, it will be removed from all parameter recipes.
-
Click Save in the Parameter Recipe Editor dialog box.
Modify Specific Parameter Setting in the Parameter Recipe
Follow these steps to modify the settings of a specific parameters in the recipe:
-
Double-click the parameter settings you want to adjust in the parameter recipe entry to modify.
-
Click Save in the Parameter Recipe Editor dialog box.
Update Parameter Settings according to the Current Project Configuration
You can update the settings of specific parameters or all parameters in a recipe according to the configuration of the current project.
Follow these steps to update the settings of specific parameters in a recipe according to the configuration of the current project:
-
Select the parameter(s) of a specific recipe you want to update in the Parameter Recipe Editor dialog box.
Press the Ctrl key to select multiple parameter settings.
-
Click the Update Parameter button on the toolbar.
Follow these steps to update the settings of all parameters in a recipe according to the configuration of the current project:
-
Click the recipe ID in the Parameter Recipe Editor dialog box to select the entire recipe item.
-
Click the Update Parameter button on the toolbar.
Synchronize Parameter Settings Between Two Parameter Recipes
You can synchronize settings of all parameters between two recipes.
-
Click the recipe number in the Parameter Recipe Editor dialog box to select the entire recipe item.
-
Right-click the recipe name and select Copy values to recipe “xx” in the context menu.
Synchronize Parameter Settings Between Two Parameters
You can synchronize settings between two parameters.
-
Click the parameter name in the Parameter Recipe Editor dialog box to select the settings of this specific parameter in all recipes.
-
Right-click in the selected area and then select Copy values to column “XX”.
