高度测量
功能介绍
模块位置：测量-高度测量
使用区域输入，根据不同的方法获取区域高度值，常见输入为含有阶梯高度3D数据如：FPC/PCB焊点，台阶。
方法
通过不同方法计算高度值。
点到平面
对一个区域中所有的3D点计算点到基准平面的距离，然后对这些值进行排序，过滤部分数据后输出高度值。
该方法需要先定义区域和平面输入，其中基准平面需要其他模块的输出，如直接使用平面模块定义一个基准平面，得到基准平面后，高度测量模块选择点到平面方法，绘制区域并选择基准平面作为输入，执行模块即可获取区域高度值。
区域高度值：在指定比例范围筛选后得到的最低/最高/平均点到平面距离。
绝对高度Z
直接读取所有3D点的高度值，然后对这些值进行排序，过滤部分数据后输出高度值。
该方法无需平面输入，高度测量模块选择绝对高度Z方法，绘制区域，执行模块即可获取区域高度值。
注意：区域绘制如果高度差较大，会对结果造成影响，导致高度值出现偏差。
批处理使能
- 默认开启，无需设置：按区域输出高度列表（每个区域一个高度，包括最小/最大/平均值）。
具体使用方法查看批处理使能
使用场景
用于3D几何测量。和点面测量3D有区别，点面测量是先通过区域计算3D点，然后只算单个3D点到平面的距离，高度测量则是计算区域内所有3D点到平面的距离再过滤，因此，高度测量更适合区域高度，也更精确。
示例说明
以下示例为点到平面方法。第一步获取基准平面，第二步绘制区域点。参数设置比例范围设为[0.05,0.95],是否绝对值勾选：
 |  |  |
|---|---|---|
| 基准平面 | 区域点 | 点到平面高度测量 |
以下示例为对同一数据两种绘制方式造成区域点偏差的结果（高度差）：
 |  |  |  |
|---|---|---|---|
| 无高度差绘制 | 绝对高度值刚好在平面上 | 带有高度差绘制 | 绝对高度值计算在平面下方 |
方法：点到平面
输入
| 输入 | 类型 | 说明 |
|---|---|---|
| 图像源 | 图像 | 输入图像 |
| 2D区域 | / | 通过绘制或继承得到一个输入区域：区域类型、区域列表、启用坐标系、坐标系。 |
| 基准平面 | 平面 | 输入的平面 |
参数说明
比例范围
范围[0,1],用于计算完高度值并排序后，排除极端离群点，常用于去除毛刺或孔洞异常值。常见取值如[0.05,0.95] 排掉前后5%异常。
是否绝对值
- 勾选：输出高度始终为正值，仅表示点到平面的距离大小。
- 不勾选：输出带符号距离，正负代表点位于平面两侧的相对位置。
方法：绝对高度Z
输入
| 输入 | 类型 | 说明 |
|---|---|---|
| 图像源 | 图像 | 输入图像 |
| 2D区域 | / | 通过绘制或继承得到一个输入区域：区域类型、区域列表、启用坐标系、坐标系。 |
参数说明
比例范围
范围[0,1],用于计算完高度值并排序后，排除极端离群点，常用于去除毛刺或孔洞异常值。常见取值如[0.05,0.95] 排掉前后5%异常。
输出
| 输出 | 类型 | 默认启用 | 额外启用条件 | 说明 |
|---|---|---|---|---|
| 区域列表 | 区域集 | 否 | / | 传递给下游模块的输入区域集合，保留用户在界面上框选的所有区域 |
| 区域中心列表 | 2D点集 | 否 | / | 每个输入区域计算所得二维几何中心 |
| 最小值列表 | 实数列表 | 是 | / | 区域最低高度值列表；与区域列表一一对应 |
| 最大值列表 | 实数列表 | 是 | / | 区域最高高度值列表；与区域列表一一对应 |
| 平均值列表 | 实数列表 | 是 | / | 区域平均高度值列表；与区域列表一一对应 |
| 3D点集 | 3D点集 | 是 | / | 对每个区域，在筛选后的点集上求得的平均三维坐标 |
| 垂点集 | 3D点集 | 是 | 点到平面方法下生效 | 将上述平均3D点按当前模式投影到基准平面得到的垂足坐标 |