Parameter Recipe

You are currently viewing the documentation for the latest version (2.1.2). To access a different version, click the "Switch version" button located in the upper-right corner of the page.

■ If you are not sure which version of the product you are currently using, please feel free to contact Mech-Mind Technical Support.

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:

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

    project assist
  2. Click setting icon in the Parameter Recipe panel.

  3. Click the Add recipe button in the pop-up Parameter Recipe Editor window, and enter the recipe name in the text box.

    add and input recipe
  4. Select the newly added recipe and click the Add Parameter button. Then a Select Step Parameters dialog box will pop up.

    add parameter
  5. 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.

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

    modify parameter

    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.

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

    save recipe

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.

  1. Select any available parameter recipe in the Parameter Recipe Editor, and then click the Copy recipe button.

    select recipe to copy
  2. 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.

    copy recipe

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:

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

    project assist
  2. 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.

    switch recipe

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 open icon to open the Parameter Recipe panel.

    project assist
  2. Click setting icon in the Parameter Recipe panel.

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

    view recipe id

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.

    edit parameter
  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.

    modify new parameter
  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.

    Once the parameter is deleted, it will be removed from all parameter recipes.

    delete parameter
  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.

    modify specify parameter
  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.

    Press the Ctrl key to select multiple parameter settings.

  2. Click the Update Parameter button on the toolbar.

    select parameter to update

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

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

  2. 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.

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

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

    select recipe to sync

Synchronize Parameter Settings Between Two Parameters

You can synchronize settings between two parameters.

  1. Click the parameter name in the Parameter Recipe Editor dialog box to select the settings of this specific parameter in all recipes.

    select column
  2. Right-click in the selected area and then select Copy values to column “XX”.

    select param to sync

Is this page helpful?

You can give a feedback in any of the following ways:

We Value Your Privacy

We use cookies to provide you with the best possible experience on our website. By continuing to use the site, you acknowledge that you agree to the use of cookies. If you decline, a single cookie will be used to ensure you're not tracked or remembered when you visit this website.