多区域对位

## 多区域对位
对位在机械手的物理坐标系下，利用机械坐标下的点进行对位。
此模块输入为多相机提取到的点数组。
同时增加了权重功能，可以设置每个点在对位时的计算占比。权重越高的的点对结果影响越大。

## 使用场景
机器视觉对位是指利用机器视觉系统（相机、镜头、光源、图像处理软件）来精确识别、测量目标物体（工件）的位置和角度（姿态），并将其引导、调整或对齐到预设的期望位置和角度的过程。其核心目标是消除位置和角度偏差，实现高精度的定位和装配。
简单来说，就是视觉系统告诉控制系统：目标现在在这里（坐标X, Y, 角度θ），和它应该在的位置（目标坐标X0, Y0, 角度θ）差了（ΔX, ΔY, Δθ），请移动这么多来对准。
对位一般在对齐两个平面上的物体上使用，常用在贴膜贴标。需要两个相机拍到的信息相互转换的情况。

![](/media/202601/2026-01-16_103750_4119460.3507559082787539.png)

## 模块原理
在之前的模块，不论纠偏还是对位模块，输入的都是图像点，同时输入标定和映射，最后输出机械的补偿。而机械点对位模块，输入和输出都是机械点，不进行标定转换，直接进行对位计算。这样就可以应对于更复杂的机械模型，同时要求用户在流程上自行进行图像点和机械点的转换，方便查找错误。
多模块对位与机械点对位相同，即对输入数据直接进行对位，不进行标定转换。这就要求输入数据在同一坐标系下。
![](/media/202601/2026-01-16_145933_2558250.16599257650176014.png)
机械模型分为带角度的XYR,XR,YR和不带角度的XY类型。两种对位的计算方式是不同的，结果也会不同。
顺时针坐标系：
![](/media/202601/2026-01-16_113933_0972430.8700678454763793.png)
逆时针坐标系：

![](/media/202601/2026-01-16_113959_6188830.08372255033215326.png)

机械坐标系的类型为当前机械的坐标类型，当类型带有角度R时会影响计算结果和角度方向。
对位方式分为三种，点对，点加角度和点加直线。其中点对用的是SVD分解的算法。点加角度和点加直线用的是同一种算法，直线输入会将直线的角度提出带入点加角度的算法去计算结果。                      
### 补偿量
补偿量在带角度R的机械模型时，补偿的R会影响XY的值。（即，只补偿R的情况下，机械手抓取工件的位置XY不会变，但机械实际坐标XY会为了补偿旋转，计算少量变化。）
补偿量会在最后一次对位结束，加到结果中。如果此次对位没有结束，需要继续对位，则结果输出不会添加补偿。补偿量不会影响纠偏的对位完成精度的判断。
因为输入的都是机械点，不需要拍照数据，只能对位一次结束。

### 高级参数
出发姿态：出发点对应的机械坐标位置，即，旋转中心的位置。一般是下相机的拍照位置。当机械类型带有角度R时，拍照姿态对结果有很大影响。
对位精度为机械精度，当对位输出小于对位精度时，对位成功。否者如果对位次数小于既定次数，则会输出错误代码1，并继续进行对位。
机械范围为机械的可运动范围，它只规范实际姿态，并不限制偏移姿态。当输出的实际坐标超出范围时，会输出错误代码5。

![](/media/202601/2026-01-16_120047_2400260.4576382066205451.png)

### 权重参数

![](/media/202601/2026-01-16_115729_3472490.8188645567092419.png)
记录每个点的权重，默认为1。输入值大于0即可，计算时会自行归一化。

## 使用方法

### 前后序模块
相机采图，直线提取，来获取用于对位的点数组。
当输入为图像点组时，输入的拍照位要求是图像的像素点，此时输出也为像素值。
当输入为机械点组时，即需要将提取到的图像点数据都转换为机械点数据。此时输出为实际物理偏移。

![](/media/202601/2026-01-16_144411_8416800.003281676519748644.png)
## 参数配置说明
【机械类型】依据现场机械手坐标系类型选择对应机械模型。
【标定组】选择当前设备所在的坐标系组。其中坐标系组须在全局数据管理中的坐标系标定中设置。
【设备选择】在选择的坐标系组中选择用于机械对位的机械设备。（用来获取机械的旋转方向和坐标系）
【点对数目】输入的区域数量，会改变需要输入的区域个数。
【补偿量】机械坐标，在机械坐标系中进行补偿。点击订阅时，可通过端口引入补偿量。
【参考图像】在处理过程中用作参照的图像。
#### 高级参数
【拍照示教姿态】示教过程中相机能拍到物料时的机械末端坐标。
【对位精度】机械坐标，对位需要达到精度范围。
【纠偏次数】进行对位允许的最大次数。若对位结果未达到对位精度且仍在机械行程范围内，则继续对位，直至纠偏次数。
【机械行程】机械手允许的行程范围。

## 输出说明
![](/media/202601/2026-01-16_145739_3208340.40791172627811667.png)
当输入都为机械点时，输出为机械偏移。
当输入都为图像点时，输出为像素值。
输出有抓取姿态和偏移姿态两组。抓取姿态为机械手的实际抓取姿态，也是【机械行程】的判断范围。偏移姿态为机械手相对与示教位置的偏移，不判断机械行程。
| 特征   | 抓取姿态       | 偏移姿态              |
|------|------------|-------------------|
| 坐标类型 | 绝对坐标(GPS式) | 相对坐标(参照物式)        |
| 安全检测 | 全面检查机械行程   | 不检查范围             |
| 主要作用 | 最终执行位置     | 位置微调              |
| 类比   | 详细收货地址     | "在你左前方"           |
| 依赖关系 | 绝对坐标(GPS式) | 包含示教坐标+偏移量仅基于示教坐标 |
## 注意事项
**机械坐标系**的类型为当前机械的坐标类型，当类型带有角度R时会影响计算结果和角度方向。
## 问题查找
1. 当对位不准确时，关注特征匹配模块是否获取准确图像。
2. 如果还无法稳定纠偏，需要测试标定和映射的准确度。
（标定映射问题测试方式：
改变取料拍照位置2mm，观察结果输出是否偏移2mm。此情况下结果不对说明是标定错误。
改变贴合拍照位置2mm，观察结果输出是否偏移2mm。此情况下结果不对说明是映射错误。）
3. 如果存在偏移角度变大，会导致xy不准情况，可能时标定旋转中心计算错误导致，尝试重新标定，修改标定方式，提高旋转中心的计算（添加标定校验或使用长半径标定模块）。
4. 如果在视野中心纠偏准确视野四周会有xy偏差情况，考虑图像畸变（使用图像畸变矫正模块），或者标定比例尺计算错误（使用标定校准模块）。

点击此处跳转到对应的中文说明书文章页:&nbsp;[Multi-Region Alignment](/doc/595)