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.

You can use the Parameter Recipe tool in Project Assistant to configure different 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 workpieces or objects.

    In this scenario, you can configure different parameter recipes and switch parameter settings dynamically for different workpieces or objects.

  • Use the same Mech-Vision project to process workpieces in different bins.

    In this scenario, you can configure different parameter recipes and switch parameter settings dynamically 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 parameter settings dynamically 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 parameter settings dynamically 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.

  1. Open a project, click the Project Assistant tab, and click recipe_icon to open the Parameter Recipe panel.

    ../../../_images/project_assistant.png
  2. Click setting_icon in the Parameter Recipe panel.

  3. Click the Add Recipe button in the pop-up Parameter Recipe Editor window.

    ../../../_images/recipe_editor.png
  4. Double-click the newly added item and enter the recipe name.

    ../../../_images/add_recipe.png
  5. Select the newly added recipe and then click the Add Parameter button, and a Select Step Parameters dialog box will pop up.

    ../../../_images/add_parameter.png
  6. 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.

    ../../../_images/add_parameter_settings.png
  7. Add all the parameters of Steps you need, and then click OK.

  8. Double-click the parameters one by one to modify their settings in the parameter recipe list.

    ../../../_images/modify_parameter_settings.png

    Warning

    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.

  9. Click Save in the Parameter Recipe Editor dialog box. A Saved successfully message will appear in the lower left corner of the dialog box.

    ../../../_images/save_recipe.png

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.

Apply or Switch the Parameter Recipe

Note

When Standard Interfaces or Adapter is used for communication, you should run a command on the robot side, and Mech-Vision will switch the parameter recipe automatically according to the command it received.

Follow these steps to apply or switch the parameter recipe manually.

  1. Click the Project Assistant tab, and click recipe_icon to open the Parameter Recipe panel.

    ../../../_images/project_assistant.png
  2. Select the parameter recipe you need in the drop-down list, and the selected parameter recipe will take effect when you run the project.

    ../../../_images/switch_recipe.png

Note

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.

  1. Open a project, click the Project Assistant tab, and click recipe_icon to open the Parameter Recipe panel.

    ../../../_images/project_assistant.png
  2. Click setting_icon in the panel.

  3. Check the ID of the recipe you need in the leftmost column of the table.

    ../../../_images/view_recipe_id.png

Add Parameters to the Parameter Recipe

Follow these steps to add parameters to the recipe.

  1. Select the recipe you want to modify in the Parameter Recipe Editor dialog box, and click the Add Parameter button.

    ../../../_images/edit_parameter.png
  2. Select new Steps and parameters in the Select Step Parameters dialog box, and click OK to confirm.

  3. Double-click the new parameter settings in the parameter recipe list to modify.

    ../../../_images/modify_parameter_settings.png
  4. Click Save in the Parameter Recipe Editor dialog box.

Delete Parameters from the Parameter Recipe

Follow these steps to delete parameters in the recipe.

  1. Select the parameter you want to delete in the Parameter Recipe Editor dialog box, and click the Delete Parameter button.

    ../../../_images/delete_parameter_setting.png
  2. 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.

  1. Double-click the parameter settings you want to adjust in the parameter recipe entry to modify.

    ../../../_images/modify_parameter_settings.png
  2. 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:

  1. Select the parameter(s) of a specific recipe you want to update in the Parameter Recipe Editor dialog box.

    Note

    Press the Ctrl key to select multiple parameter settings.

  2. Click the Update Parameter button on the toolbar.

    ../../../_images/select_parameter_to_update.png

Follow these steps to update the settings of all parameters in a recipe according to the configuration of the current project:

  1. Click the ID of the recipe you want to update in the Parameter Recipe Editor dialog box.

  2. Click the Update Parameter button on the toolbar.

Synchronize Parameter Settings Between Two Parameter Recipes

You can synchronize settings of specific parameters or all parameters between two recipes.

Follow these steps to synchronize specific parameter settings between two recipes.

  1. Select the parameters of the recipe you want to synchronize in the Parameter Recipe Editor dialog box.

    Note

    Press the Ctrl key to select multiple parameter settings.

  2. Right-click and select Copy values to recipe “xx” in the context menu.

    ../../../_images/select_parameter_to_sync.png

Follow these steps to synchronize all parameter settings between two recipes.

  1. Click the recipe ID in the Parameter Recipe Editor dialog box to select the entire recipe item.

  2. Right-click and select Copy values to recipe “xx” in the context menu.

    ../../../_images/select_recipe_to_sync.png