Single Target Template Matching

>i **Template Description**
>
> 1. [xxx] Needs to be replaced
> 2. After document editing is completed, please delete the template description

## [Single Target Template Matching]

Find similar graphic regions based on the contour feature information of the template image. The algorithm of this module is different from feature matching.

## Module Principle
Find similar graphic regions based on the contour feature information of the template image.

## Usage Scenarios
Need to find objects with certain contour features

## Usage Method

### Predecessor/Successor Modules
Generally used in conjunction with the Camera Image Acquisition module

### Usage Example
[Record operation video]

## Feature Template
[Some matching modules need to save feature templates in advance, which need to be introduced in detail in this section]

## Parameter Configuration Description

### Basic Parameters
【Matching Score】The similarity between the template and the target in the search image. The detected target will only be found when the similarity is greater than the set value. The default is 0.7.
【Search Angle】Input the minimum and maximum search angles. Only targets within this angle range can be matched. The range is from -180 to 180.
【Display Settings】Display settings such as ROI region, graphic results, mask display, etc., including whether to display, color selection, font size, etc.
【Position Adjustment】Adjust the position and size of ROI.
【Model Edit】Edit the model for detection use, parameter introduction see the detailed introduction of template edit below

【Scaling Level】Usually set to 3~7. Too few (like 1) cannot cope with size changes; too many (like 10) will significantly slow down the speed. The target to be matched may present different sizes due to shooting distance and lens focal length. The ‌Scaling Level‌ parameter controls the range of the matching algorithm searching for targets in space.
【Enable Sub-pixel】Matching is more accurate after enabling, but the required detection time is also longer. Sub-pixel accuracy continuously models the image gray distribution through interpolation algorithms, thereby improving the positioning accuracy of feature points to ‌0.1 pixel or even higher.

【ROI Type】The default ROI type for the detection area is Rotated Rectangle.
【ROI Source】Manual ROI: Can manually drag the position and size of ROI in the window; Reference ROI: Can connect external ROI at the port.
【Position Correction】After selecting pose correction, you can connect the coordinate system to make the ROI region move with the coordinate system.

### Template Edit

【Model Generation Method】Extract on image, generate specific model based on selected roi region

【Update Image】After clicking, the image input port of this module will be read to the interface. After clicking Generate Model, the template image will be switched to the current image. This button needs to be clicked when switching model images.
【Generate】After clicking, generate a new model based on the current image and parameters

【Move ROI】Same as position adjustment popup interface, specify adjusting model roi position, used for finer roi adjustment

Model Parameters
【Min Rotation Angle】Model search angle range, minimum angle
【Max Rotation Angle】Model search angle range, maximum angle
【Angle Step】Angle's.
【Pyramid Level】.
【Matching Polarity】

Reference Position
【Modify Reference Point】Add, delete, clear reference points
【Reference Position Move】Move reference points more precisely

## Output Description

【Running Result】Output True if target is matched, otherwise False
【Matching Score】Matching score value corresponding to matching result
【Position Offset】Position offset of matching result relative to template
【Detection Angle】Angle of matching result
【Detection Position】Detection position corresponding to matching result
【Mask Output】Mask region edited by this module
【Rotated Rectangle ROI】Mask region edited by this module
【Output Coordinate System】Rectangular border drawn by the roi of this module

## Other Supplements

## Precautions

---

Click here to jump to the corresponding Chinese manual page: [Single Target Template Matching](/doc/79)