<< 点击显示目录 >> 主页  mappVision帮助助手 > 机器视觉帮助 > mapp Vision  > 编程 > 视觉功能 > 匹配 > 匹配参数（循环写入）

信息：

本节指定的参数是硬件模块 I/O 映射的一部分，可通过 AS 软件访问。

Enable

启用/禁用视觉功能。

NumSearchMax

可查找对象的最大数量参数。

该值不应大于可查找对象的实际数量，否则将不必要地延长图像处理例程的运行时间。

信息：

该值不必与配置变量 NumResultsMax 相同，因为它只是 POWERLINK 框架的占位符。

 

信息：

理论上，也可以设置 "NumSearchMax = 0"（不单独检查），这样在执行视觉功能时会触发搜索 0 个结果。

 

信息：

如果超过 NumSearchMax 的匹配结果等级大于MinScore，则只返回 NumSearchMax 中的最佳匹配结果。如果找到的匹配数少于 NumSearchMax，则只返回等级大于MinScore 的匹配，也就是说，参数MinScore优先于NumSearchMax。如果要在图像中找到等级超过 MinScore 的所有模型实例，则 NumMatches 必须设置为 0。

Timeout

使用该参数可限制搜索对象的时间。在时间结束前获得的所有结果均可使用（参见解码数据）。

在计算时间时，请务必考虑图像采集所需的时间和其他处理时间。从触发时刻到提供结果的确切处理时间将作为FunctionProcessingTime 返回。

信息：

从 mapp Vision 5.19 开始，参数 "超时 "在设定时间过后不会在日志中生成状态条目。在 mapp Vision 5.18 之前（包括 5.18），每次都会在日志中创建一个条目。

MinScore

该参数定义了一个物体在图像中被视为匹配对象所必须达到的最低等级。该值越高，找到的匹配对象就越少，搜索速度就越快。如果 MinScore 值过低，运行时间可能会大大增加。

MinScore 会影响为匹配结果找到的候选对象。MinScore 越低，找到的候选结果就越多！

有关其他信息，请参阅 "匹配 - 对匹配等级值（分数）的影响"部分。

信息：

从 mapp Vision V5.20 开始，Minscore = 0 在内部被解释为 50.

MaxOverlap

如果模型具有对称性，则可能会在图像的相似位置发现多个旋转角度不同的物体。如果模型具有重复结构，则可能会在图像中的相似位置发现具有相同旋转的多个对象。参数 MaxOverlap 可用来确定允许两个对象重叠的最大值（用 0 和 1 之间的数字表示），以便将它们视为不同的对象并返回。如果两个对象的重叠超过 MaxOverlap，则只会返回找到的最佳结果。

信息：

MaxOverlap 会影响匹配结果的候选结果。最大重叠度越高，候选结果的数量就越多！

Alignment

信息：

易变参数：

更改该参数会导致内部参数变化，从而延长后续首次运行视觉功能时的处理时间。

在对齐（1 或 2）期间，NumResultsMax 会自动设置为 1（内部）。对齐参考数据存储在视觉功能数据中。但只有当参数 Alignment 设置为 1 至 2 时才会这样做。当然，对齐时只能教导 1 个模型（作为参考）。

有关对齐功能的更多信息，请参阅视觉功能 - 对齐。

信息：

视觉功能的特殊功能 匹配：缩放始终 = 1.0（内部永久设置）。

OffsetROIX

图像区域内感兴趣区域 (ROI) 在 X 方向上的偏移量。

OffsetROIY

图像区域内感兴趣区域 (ROI) 在 Y 方向上的偏移量。

OffsetROIOrientation

感兴趣区域 (ROI) 方向的偏移量。方向以 1/100 度的增量指定。

对于 -179.99° 至 +180.00° 的角度范围，可用值范围为 -17999 至 18000。超出此范围的值将被解释为 +180° 。

OffsetROIRotCenterX

OffsetROIRotCenterY

TestExecute

该参数执行匹配搜索，并在 mapp Vision 人机界面应用程序中显示找到的区域（找到的匹配结果的等高线区域）。

信息：

该参数在 I/O 映射中不可见。操作通过 mapp Vision HMI 应用程序进行。

---

Information:

The parameters specified in this section are part of the I/O mapping of the hardware module that can be accessed via Automation Studio.

Enable

Enables/Disables the vision function.

NumSearchMax

Parameter for the maximum number of objects to be found.

The value should not be greater than the actual number of findable objects; otherwise, the runtime of the image processing routine will be unnecessarily extended.

Information:

This value does not have to be identical to configuration variable NumResultsMax since it only serves as a placeholder for the POWERLINK frame.

 

Information:

Theoretically, "NumSearchMax = 0" can also be set (it is not checked separately), which triggers a search for 0 results when the vision function is executed.

 

Information:

If more than NumSearchMax matches reach a grade greater than MinScore, only the best number of NumSearchMax matches are returned. If less than NumSearchMax matches are found, only those matches are returned whose grade is greater than MinScore, i.e. parameter MinScore has priority over NumSearchMax. NumMatches must be set to 0 if all model instances whose grade exceeds MinScore should found in the image.

Timeout

The search for objects is limited in time using this parameter. All results obtained up to the end of the time are then available (see DecodedData).

When calculating times, be sure to account for the time required for image acquisition and other processing times. The exact processing time from the trigger moment to the provision of the result is returned as FunctionProcessingTime.

Information:

Starting with mapp Vision 5.19, parameter Timeout does not generate a status entry in the logbook when the set time has elapsed. Up to and including mapp Vision 5.18, an entry was created in the logbook each time.

MinScore

This parameter defines the minimum grade an object must have in order to be considered a match in the image. The higher the value, the fewer matches are found and the search is faster. If the MinScore value is too low, the runtime may be significantly increased.

MinScore influences the candidates found for a Matching result. The lower the MinScore, the greater the number of candidates found!

For additional information, see section Matching - Influences on the grade value (Score) of Matching.

Information:

Starting with mapp Vision V5.20, Minscore = 0 is internally interpreted as 50.

MaxOverlap

If the model has symmetries, multiple objects may be found at similar positions in the image, but with different rotations. If the model has repetitive structures, multiple objects with the same rotations may be found at similar positions in the image. Parameter MaxOverlap can be used to determine the maximum amount (expressed as a number between 0 and 1) by which two objects are permitted to overlap in order for them to be considered different and thus returned. If two objects overlap by more than MaxOverlap, only the best result found is returned.

Information:

MaxOverlap influences the candidates found for a Matching result. The higher the MaxOverlap, the greater the number of candidates!

Alignment

Information:

Volatile parameter:

Changing this parameter results in an internal parameter change, which results in longer processing time during the first subsequent run of the vision function.

NumResultsMax is automatically set to 1 (internally) during Alignment (1 or 2). Alignment reference data is stored in the vision function data. Only if parameter Alignment is set from 1 to 2, however. Of course, only 1 model (as reference) can be taught for Alignment.

For additional information about function Alignment, see Vision functions - Alignment.

Information:

Special feature of vision function Matching: Scaling is always = 1.0 (permanently set internally).

OffsetROIX

Offset of the region of interest (ROI) within the image area in the x-direction.

OffsetROIY

Offset of the region of interest (ROI) within the image area in the y-direction.

OffsetROIOrientation

Offset to the orientation of the region of interest (ROI). The orientation is specified in increments of 1/100 degrees.

For the angle range of -179.99° to +180.00°, this results in a usable range of values of -17999 to 18000. Values outside this range of values are interpreted as +180°.

OffsetROIRotCenterX

OffsetROIRotCenterY

TestExecute

The parameter performs a Matching search and displays the found regions (contour area of the found Matching results) in the mapp Vision HMI application.

Information:

This parameter is not visible in the I/O mapping. Operation takes place via the mapp Vision HMI application.