8. Device Settings – Part 2 (Code Algorithm)
Streszczenie: Ustawienia ID3000 cz. 2: algorytm odczytu – dodawanie kodów 1D/2D, obszary ROI (pojedyncze, wsadowe, szachownica), parametry algorytmów 1D i 2D, ocena jakości kodów 2D i Code Score.
EN: ID3000 settings part 2: code algorithm – adding 1D/2D codes, ROI (single, batch, chessboard), 1D and 2D algorithm parameters, 2D code quality evaluation and code score.
Dotyczy: przemysłowy czytnik kodów Hikrobot serii ID3000 (złącze M12 17-pin, Fast Ethernet, RS-232; obsługa przez klienta IDMVS)
Źródło: dokumentacja producenta (Hikrobot ID3000 Series Industrial Code Reader User Manual, V3.1.0); opisy rysunków – opracowanie Multiprojekt
8.2 Code Algorithm Settings
The code reader supports reading multiple types of 1D code and 2D code, and you can add and set code parameters via the client software.
8.2.1 Add Code
Adding code before you set code parameters via the client software. In Algorithm Settings, you can add different types of codes according to actual demands.
In Algorithm Settings, click Add Barcode, select the types of codes to be read, and set the 1D Code Number and 2D Code Number according to actual demands.
Note:
- For different models of the device, the specific parameters may differ, and the actual device you purchased shall prevail.
- Selected symbology amount and added code amount may affect the code recognition time. Selecting more symbologies or adding more codes may consume more time to recognize codes in the image.
- No matter 1D code or 2D code, up to 200 codes can be added at a time. Adding more codes may consume more time to recognize codes in the image. Therefore, the code number is recommended to be set according to the actual demands.
- The code reader may output the actual code number when there is a mismatch between the actual code number and the code number set in the client software.
Figure 8-9 Add Codes
Figure description (text version): Code selection panel. 1D Code: Code 39, Code 128, CodaBar, ITF25, Code 93, ITF14, EAN8, EAN13, UPCA, UPCE. 2D Code: QRCode, DataMatrix. In the example, Code 39, Code 128, UPCE, QRCode and DataMatrix are marked "Added".
8.2.2 Set Code Reading ROI
Algorithm ROI (Region of Interest) allows the device to execute algorithms and read codes on the specific area you selected, and thus improving code reading efficiency.
Currently, up to 4 ROIs can be configured, and the device outputs codes according to the number of ROI (e.g. Region 1, Region 2, and Region 3) in turn. The client software supports drawing single group of ROI, drawing ROI in batch, and drawing ROI via chessboard.
Note:
- If no code is recognized in the algorithm ROI, the device will output “noread”.
- Before drawing ROIs, make sure that there are images in the live view window after stopping preview.
- If no algorithm ROI is enabled, the full screen is the algorithm ROI by default.
- This function may differ by device models.
Draw Single Group of ROI
Steps
- Go to Algorithm Settings, click All Features, and find Algorithm ROI.
- Click Draw to draw ROI in the live view window.
- (Optional) Repeat the above step to draw multiple ROIs according to actual demands
Note: The client software only parses codes in the ROI you have drawn.
- (Optional) Set other ROI parameters according to actual demands.
- ROI Index: It indicates different ROIs and ranges from 0 to 149 which corresponds 1 to 150 ROIs.
- Draw ROI Width: It refers to the width in algorithm ROI.
- Draw ROI Height: It refers to the height in algorithm ROI.
- Draw ROI Offset X: It refers to the X coordinate of the upper left corner in algorithm ROI.
- Draw ROI Offset Y: It refers to the Y coordinate of the upper left corner in algorithm ROI.
Note: The result of Draw ROI Width plus Draw ROI Offset X cannot be larger than the overall horizontal resolution, and the result of Draw ROI Height plus Draw ROI Offset Y cannot be larger than the overall vertical resolution.
- (Optional) Click Execute in Restore Max. Algorithm ROI to restore the ROI to the full screen.
- (Optional) Click Execute in Clear All ROI to delete all ROIs.
- (Optional) Enable ROI Link IO Enable in Algorithm Control, and there will be prompts by the output device when codes are not read in any ROI.
Note: Make sure that the output device is connected when using this function.
Draw ROI in Batch
Steps
- Go to Algorithm Settings, click All Features, and find Algorithm ROI.
- Click Batch to set parameters according to actual demands.
- Area Offset: It sets the pixel quantity from the starting point when the ROI is in horizontal and vertical direction from the full resolution.
- Area Size: It sets the pixel quantity in the horizontal and vertical direction of the ROI.
- ROI Number: It sets the row and column quantity.
- Row Spacing: It sets the interval between rows.
- Column Spacing: It sets the interval between columns.
- Click OK after settings.
- Repeat other optional steps mentioned in drawing single group of ROI according to actual demands.
Figure 8-10 Draw ROI in Batch
Figure description (text version): Batch Create ROI dialog: Area Offset 0, 0; Area Size 2368 × 1760; ROI Number (Row × Col) 2 × 2 (maximum number 150); Row Spacing (pixel) 2 (range 0–1504); Column Spacing (pixel) 2 (range 0–2112); OK and Cancel buttons.
- (Optional) Enable ROI Link IO Enable in Algorithm Control, and there will be prompts by the output device when codes are not read in any ROI.
Note: Make sure that the output device is connected when using this function.
Draw ROI via Chessboard
Steps
- Go to Algorithm Settings, click All Features, and find Algorithm ROI.
- Click Execute in Chessboard ROI, set parameters according to actual demands, and click OK after setting.
Figure 8-11 Create Chessboard ROI
Figure description (text version): Create Chessboard ROI dialog: Rows Number 5, Columns Number 5 (maximum number 150, maximum rows 13, maximum columns 18); OK and Cancel buttons.
- Click after creating ROI, and the red frame becomes green as shown below.
Figure 8-12 Draw ROI via Chessboard
Figure description (text version): Live view in Test mode with a green grid of 25 numbered ROI cells (5 rows × 5 columns) over an image of many small codes; recognized codes are framed in colour and read results are listed in the lower left corner.
- (Optional) Click
to restore the ROI to the full screen, and click
to clean all configured ROIs. - Repeat other optional steps mentioned in drawing single group of ROI according to actual demands.
- (Optional) Enable ROI Link IO Enable in Algorithm Control, and there will be prompts by the output device when codes are not read in any ROI.
Note:
- Make sure that the output device is connected when using this function.
- The figures above are for reference only, and refer to the actual conditions.
8.2.3 Set 1D Algorithm Parameter
Click All Features on the upper-right to display all algorithm parameters. In the Algorithm Parameter page, select 1DCode as Arithmetic Type, and then you can set its corresponding parameters.
Note:
- You should have selected at least one type of 1D code.
- For different models of the device, the specific parameters may differ, and the actual device you purchased shall prevail.
Timeout Value
Timeout value refers to the maximum running time of algorithm, and its unit is ms. The code reader will stop parsing the images and return results if the time is exceeded the waiting time configured.
Code Color
It defines the readable code color. White Code On Black Wall means that the client software can recognize the white code with black background. Black Code On White Wall means that the client software can recognize the black code with white background.
Code 39 Check
Enable this parameter if Code 39 uses the parity bit.
Note: You need to select Code 39 in Add Barcode.
ITF 25 Check
Enable this parameter if ITF 25 uses the parity bit.
Note: You need to select ITF 25 in Add Barcode.
Code Score Enable
If it is enabled, the device will evaluate code quality and display overall grade and code score in history record area of the client software. The higher the score, and the better the code quality.
Accurate Timeout Enable
If it is enabled, the accuracy of algorithm timeout will improve.
8.2.4 Set 2D Algorithm Parameter
Click All Features on the upper-right to display all algorithm parameters. In the Algorithm Parameter page, select 2D Code as Arithmetic Type, and then you can set its corresponding parameters.
Note:
- You should have selected at least one type of 2D code.
- For different models of the device, the specific parameters may differ, and the actual device you purchased shall prevail.
Timeout Value
Timeout value refers to the maximum running time of algorithm, and its unit is ms. The code reader will stop parsing the images and return results if the time is exceeded the waiting time configured.
Algorithm Running Mode
It is used to be set the algorithm operating mode. It includes High Speed, High Performance, and Balance. High Speed focuses on recognition speed, and the algorithm can recognize the code rapidly, while High Performance refers to the algorithm can recognize the code that has distortion, spot or white gap, but its recognition speed is slow. Balance refers to the algorithm makes a balance between speed and performance.
2D Code Max. Size
It refers to the max. recognizable code width. The 2D code will not be recognized if its width exceeds the configured value.
Mirror Mode
It is useful when the recognized image is a mirror one, mirroring in X coordinate. 3 modes are available: Adaptive, Mirror, and Non Mirror.
Downsampling Level
It refers to the pixel sample size that the code reader takes. Increasing this parameter will improve the code reading efficiency at the expense of code recognition rate.
Note: Increasing this parameter value will improve the code reading efficiency at the cost of code recognition rate.
Code Color
It defines the readable code color. Adaptive means that the client software can recognize both the black code with white background, and the white code with black background. White Code On Black Wall means that the client software can recognize the white code with black background. Black Code On White Wall means that the client software can recognize the black code with white background.
Note
- For QR code, the code color is determined by the color of the concentric square on it. indicates that the code color is white, and indicates that the code color is black.
Figure 8-13 White QR Code and Figure 8-14 Black QR Code
Figure description (text version): Two QR code examples: a white code on a black background (Figure 8-13) and a black code on a white background (Figure 8-14); a finder pattern is highlighted in red in each.
- For DM code, the code color is determined by the color of its "L" shaped sides. White "L" shaped sides indicate that the code color is white, and black "L" shaped sides indicate that the code color is black.
Figure 8-15 White DM Code
Figure 8-16 Black DM Code
Discrete Flag
Continuous stands for the minimum units in the "L" shaped sides of the DM code are continuous, or the minimum units in the concentric square like or in the QR code are continuous. Usually the continuous code uses squares as the minimum units. Discrete stands for the minimum units in the "L" shaped sides of the DM code are discrete, or the minimum units in the concentric square like or in the QR code are discrete. Usually the discrete code uses dots as the minimum units. Adaptive stands for the device can recognize both continuous code and the discrete code.
QR Distortion Correction
If the QR code or DM code is distorted, you can enable this parameter to improve code recognition rate.
Note: If you enable this parameter, more time will be consumed to recognize the codes in the image.
Advance Param
This parameter is applicable to some special codes, and it is recommended to use the default value.
DM Code Shape
It defines the recognizable code shape. Square stands for square mode: If the 2D code is square shaped, it can be recognized by the device. Rectangle stands for rectangle mode: If the 2D code is rectangle shaped, it can be recognized by the device. Adaptive stands for compatible mode: The device can recognize 2D codes of both the abovementioned two shapes.
DM Code Type
It includes All, ECC140, and ECC200.
2D Code Quality Enable
Refer to section Set 2D Code Quality Evaluation for details.
Code Score Enable
If it is enabled, the device will evaluate code quality and display overall grade and code score in history record area of the client software. The higher the score, and the better the code quality.
Accurate Timeout Enable
If it is enabled, the accuracy of algorithm timeout will improve.
8.2.5 Set 2D Code Quality Evaluation
After 2D Code Quality Enable, you can set specific parameters according to actual demands.
Note:
- The function of code quality evaluation may differ by device models.
- In test mode, this function is enabled by default. In normal mode, you need to enable it manually.
Steps
- Set Sym Proc Type according to actual demands, and the default type is Type 1. Type 1 has a strong capacity to locate codes.
- Set Iso Edition, including Iso15415 and Iso29158
- Iso15415 is applicable to the quality evaluation for label 2-dimensional codes.
- Iso29158 is applicable to the quality evaluation for DPM format 2-dimensional codes.
- Set Verify Edition, including standard mode and HIK mode.
- Standard mode is a standard quality evaluation mode.
- HIK mode is a professional quality evaluation mode.
- Set Standard Aperture and Magnification.
- Standard aperture refers to a standard aperture, and its default value is 400.
- Magnification is 150 by default.
Note: Standard Aperture and Magnification should be configured only when Type 2 is selected as Sym Proc Type.
- Click
to start acquisition, and the client software will display the overall code quality in the history area.
Figure 8-17 2D Code Quality Evaluation
Figure description (text version): History panel with columns No., Read Time, Cost Time (ms), PPM, Barcode Type, Waybill, Barcode Content, Overall Grade and Code Score; three DataMatrix entries with overall grade F and code scores 26, 21 and 25.
Note: The overall grade includes A, B, C, D and F. A means that the code quality is the best while F means that the code quality is the worst.
- (Optional) Click specific grade in the overall grade list to view different quantity evaluation items.
8.2.6 Set Code Score
After enabling code score function, the client software can output specific score for codes it has read.
Note:
- The function of code score may differ by device models.
- In test mode, this function is enabled by default. In normal mode, you need to enable it manually.
- The code score is determined by two factors: image quality and print quality of codes. The range of code score is between 0 and 100; the higher the score, the easier the code can be read.
Steps
- Right click the device in Device Connection, and click Feature Tree.
- Go to Algorithm Control, and enable Code Score Enable.
Figure 8-18 Enable Code Score
Figure description (text version): Parameter panel with Code Score Enable switched on (highlighted), ROIRegion Num Region 4 and ROI Enable off.
- Click
to start acquisition, and the client software will display specific code score in the history area.
Figure 8-19 Code Score
Figure description (text version): History panel (same layout as Figure 8-17) showing the Code Score column with values 26, 21 and 25 for three DataMatrix reads.
- (Optional) Go to Image Settings, and adjust parameters like exposure time, gain, Gamma, light source, etc. if the code score is low.
Note: If the code score is still low after adjusting, the code may have poor printing quality.
Słowa kluczowe
Hikrobot ID3000, algorithm settings, add code, 1D code, 2D code, QR code, DataMatrix, ROI, chessboard ROI, timeout, code color, mirror mode, code quality evaluation, ISO, code score









