Adjust Parameters

This topic introduces the actions related to parameters, including the general workflow of adjusting parameters, managing parameter groups, changing parameter visibility, and checking parameter descriptions.

General Workflow of Adjusting Parameters

When adjusting the parameters, you usually need to acquire the data again to check the result of parameter adjustment. The general workflow of adjusting parameters is as follows:

  1. At the top of the parameter panel, create a parameter group, or select a parameter group for saving the parameter values.

  2. Click single cap to acquire data and check the data quality.

    • 2D image: not too bright or too dark; the surface features of the target object are clearly visible.

      Too dark Good Too bright

      exposure time 30

      exposure time 120

      overexposure

    • Depth map and point cloud: the needed data is complete. In the following example, the needed data is the rim of the bin and the rotors inside the bin.

      Determine which part of the data is needed according to your actual needs. For example, if you need to pick metal bowls with opening facing up by the rim, usually you only need to make sure that the data of the bowl rims is complete.
      Needed data incomplete Needed data complete

      exposure time 3d 1

      exposure time 3d 4

  3. If the data quality is not good, adjust the corresponding parameters in the parameter panel on the right.

    • If the quality of the 2D image is not good, adjust the parameters in the 2D Parameters category.

    • If the quality of the depth map is not good, adjust the parameters in the 3D Parameters, Depth Range, and ROI categories.

    • If the quality of the point cloud is not good, adjust the parameters in the 3D Parameters, Point Cloud Processing, Depth Range, and ROI categories.

  4. Repeat steps 2 and 3 until the data quality meets your requirements.

    • Adjustment of the parameters in the Point Cloud Processing, Depth Range, and ROI categories takes effect immediately. You do not need to acquire the data again.

    • If the data quality is still not good, you can change the visibility and adjust the newly displayed parameters.

Manage Parameter Groups

Parameter groups are used to save parameter values for different applications, projects, workpieces, and so on. When the application, project, workpiece, etc., changes, switching the parameter group in use can quickly apply the corresponding parameter values.

In Mech-Eye Viewer, you can create a new parameter group, save parameter values to a parameter group, delete a parameter group, rename a parameter group, and import and export parameter groups.

Create Parameter Group

Follow these steps to create a new parameter group:

  1. On the right of the Parameter Group section, click icon plus.

  2. In the pop-up window, enter the name for the parameter group, and click OK.

  3. After the parameter group is created, it will be displayed in the drop-down menu in the Parameter Group section.

Save Parameters to Parameter Group

Follow these steps to save parameters to a parameter group:

  1. Click the drop-down menu in the Parameter Group section, and select the parameter group used for saving parameter values.

  2. Adjust parameters.

  3. In the Parameter Group section, click Save or use the shortcut Ctrl + S to save the adjusted parameter values to the currently selected parameter group.

An asterisk (*) next to a parameter name indicates that the value of this parameter has not been saved to the parameter group.

Delete Parameter Group

To delete a no longer needed parameter group, follow these steps:

  1. Click the drop-down menu in the Parameter Group section, and select the parameter group to be deleted.

  2. Click icon reduce, and then click Yes in the pop-up window to delete the parameter group.

The default and calib parameter groups cannot be deleted.

Rename Parameter Group

Follow these steps to rename a parameter group:

  1. Click the drop-down menu in the Parameter Group section, and select the parameter group to be renamed.

  2. Click icon rename, enter the new name in the pop-up window, and then click OK.

  3. After the change, the new name will be displayed in the drop-down menu of the Parameter Group section.

The default and calib parameter groups cannot be renamed.

Export Parameter Groups

You can export all the parameter groups saved in the current camera to a JSON file. Follow these steps to export parameter groups:

  1. In the Parameter Group section, click Export, select the file path, and then click Save.

  2. The Successfully Saved window will pop-up. Click OK in the window to close this window.

Import Parameter Groups

You can import parameter groups from a JSON file to replace all the parameter groups saved in the current camera. Follow these steps to import parameter groups:

  1. In the Parameter Group section, click Import, find the JSON file that stores all the parameter group information, and click Open.

  2. The Successfully Imported window will pop-up. Click OK in the window to close this window.

Reset Parameter Group

To reset the parameter values saved in a parameter group to default values, follow these steps:

  1. Click the drop-down menu in the Parameter Group section, and select the parameter group to be reset.

  2. Click Reset, and then click Yes in the pop-up window to reset the parameter values to those stored in the default parameter group.

Change Visibility

The visibility of parameters in Mech-Eye Viewer includes three levels: Beginner, Expert, and Guru. Select from the drop-down menu of Visibility to change the visibility.

  • The Beginner level includes the most frequently used basic parameters.

  • The Expert level includes all parameters in the Beginner level and provides more parameters.

  • The Guru level includes all parameters in the Expert level and provides more parameters.

Usually, adjusting parameters in the Beginner level is enough to meet your needs. If the data quality is still not satisfactory, you can adjust the parameters in the Expert level. In rare cases, the parameters in the Guru level need to be adjusted to meet special needs.

The Guru level is available in the Administrator account. If needed, please contact Technical Support.

Check Parameter Description

After you select a parameter in the parameter list, the bottom of the parameter panel displays more information about this parameter, include parameter explanation, API parameter name, value range, default value, visibility and data type. When you adjust parameters, you can use the information here as a reference.

  • If the Parameter Description section blocks the parameter list, click × at the upper right of this section to close it.

  • To display the Parameter Description section again, check the Parameter Description option in the View menu.