Skip to content

本地点阵畸变 V2 ​

V2 用一次点阵定位得到完整点位,再由 GridDistortionAnalysis.Calculate 同时计算 TV 的两种口径、九点的两种口径、四角几何和居中投影径向模型的光学估计。ImageView 主指标表展示 TV、对边均值九点、四角几何和相对光学估计;旧 P9 三跨度保留在全部分析 JSON。Flow 的兼容结果字段固定采用标准 TV 和对边均值九点。

输入是完整的规则圆点阵,行列分别为 3~15 的奇数,可以是 3×3、5×7、7×7 或其他非正方形奇数阵列。多点图卡的九点指标取首行、中行、末行与首列、中列、末列的交点。缺点时拒绝计算,不用拟合点冒充实测点;当前不计算左右眼 DIFF_H/DIFF_V,这还需要配对输入和明确差值定义。

使用入口 ​

ImageView ​

打开图像,在图像右键 分析测量 → 视场与畸变 → 点阵畸变测量... 设置行列数等参数并计算;矩形区域右键直接选择同名命令。菜单通过 IIEditorToolContextMenu 发现,无需在 ImageView.xaml 硬编码。结果窗口包含多口径指标、光学估计及 JSON,可复制分析结果;图上显示点位及代表九点。图像被替换或较新任务启动后,过期计算不能覆盖当前叠图。

图像分析和流程节点均提供 亮点模式:默认勾选,检测暗背景上的亮点,适用于发光屏幕;取消勾选,检测亮背景上的暗点,适用于暗点反射图卡。BrightTarget 只改变背景残差与圆心提取的亮暗方向,有序圆心之后共用相同几何计算。模式随配置和运行参数保存;未包含该字段的旧节点配置仍按亮点运行。光晕、漏光、印刷反射与照明不均会影响圆心提取,暗点照片通过不能替代发光屏幕的实拍验证。

九点畸变测量 位于同组。它的原生 M_CalDistortionP9 优先使用既有阈值分割和尺寸筛选;自动阈值和默认候选点筛选未找齐 3×3 时,使用 V2 的完整点阵定位补充,成功后仍按九点旧公式计算。显式阈值或自定义候选点筛选保持原有语义。补充定位点没有旧分割器的外接矩形,结果中的 boundingRect 为 null;candidateCount 与警告沿用 V2 的候选统计,candidatePoints 为空,不伪造额外候选坐标。直接将旧配置改为 7×7 不能获得有效的 49 点畸变指标。

Flow 和 ARVR ​

使用 本地点阵畸变(V2) 节点,输入、结果目录和搜索区域沿用 Engine 本地节点约定。优先使用上游内存帧,没有内存帧时读取 IN 图像结果对应的文件;本地图片通过“加载图片”节点输入。彩色帧按 BGR 灰度化,CIE 取 Y 平面,输入只读。借用帧必须满足已有方向标记,节点不重复翻转。ROI 输出坐标还原到整图。

在节点右侧的 说明 中点击 查看算法原理,打开随软件提供的离线图文帮助,包含公式、指标判读和点阵交互示意。帮助主题 ID 为 algorithms.grid-distortion,与本页共用内容;窗口支持打开对应网站页面、复制链接和打印或保存 PDF。

离线正文由本页 algorithm-help 标记段及共享示意组件生成到 UI/ColorVision.UI.Desktop/Assets/Help。修改正文或共享组件后运行 npm run docs:help 生成帮助包,npm run docs:help:check 检查内容是否同步;这两个命令仅处理本地帮助文件,不上传网站。普通 dotnet build 只复制已生成的帮助资源,不要求安装 Node。

“搜索区域关注点”可选择寻找发光区写入的 POI 模板,每次执行读取数据库最新内容,优先于固定“搜索区域”;两者属于同一配置组,选中关注点后隐藏手动区域,清空后恢复显示且保留原矩形值。结果目录支持文件夹选择器。支持单个中心矩形 Rect、左上角矩形 LTRect、按 LT/RT/RB/LB 保存的四角点外接矩形(宽高包含两端像素),不做透视裁正。模板不存在、形状无效或区域越界时停止,不回退全图。结果参数记录模板名和有效搜索矩形。模板没有帧身份,需让前序定位成功后串行执行,并行流程使用独立模板。

TV_distortion 和 LocalGridDistortionMetrics.TV 使用标准 TV,Point9_distortion 和 LocalGridDistortionMetrics.Point9 使用对边均值九点。完整分析保留全部口径。

流程执行需要有效批次和数据库连接。成功记录的类型为 Distortion(9)、版本为 2.0,DetailCommon 指向结果 JSON。Distortion2View 与 ProjectARVRPro 读取 TV_distortion、Point9_distortion、Optic_Distortion,数值单位为百分数。ImageView 单次分析不要求数据库。

主程序历史结果标注 P 编号和原图坐标,完整有序点阵显示行列连线及四角参考框;较大点阵需保存的行列元数据,不猜测旧结果布局。侧栏先列主要指标,再保留完整原始 JSON;仅对明确声明百分数的结果标 %,不改变历史数值。等待原图加载后才画叠图,切换结果时丢弃迟到绘制;非法或越界点不画标记,也不拼接残缺网格。

Optic_Distortion 是未标定的相对光学估计。残差校验不通过时写 null,CSV 留空。旧配置中的光学输出开关和 TvFormula/Point9Formula 不参与计算,重新保存时省略。客户配方和判定由 ProjectARVRPro 维护。

算法结构化拒绝和分析几何退化可保存失败主记录,不生成成功明细,也不替换上游有效主记录引用;事务提交后才更新当前结果引用。提交后的消息发布失败不撤销已保存结果。帧加载、方向/ROI 等前置错误及未包装的意外异常不保证产生失败主记录。TotalTime 记录定位调用耗时,不含派生分析、文件、数据库和通知。

点阵畸变测量原理 ​

本说明对应本地点阵畸变 V2,公式版本为 point-grid-metrics/2。同一次圆心定位产生 TV、九点四边、梯形、四角几何和相对径向估计。Flow 的兼容结果固定使用标准 TV 和对边均值九点,完整分析同时保留半值 TV 和旧本地 P9 三跨度口径。

N×M 怎样取代表九点 ​

N 是行数,M 是列数,当前各自支持 3~15 的奇数。先定位完整点阵,再取首、中、末行与首、中、末列的九个交点。例如 5×7 取第 1、3、5 行和第 1、4、7 列:

text
A 左上 ─── B 上中 ─── C 右上
│           │           │
D 左中 ─── E 中心 ─── F 右中
│           │           │
G 左下 ─── H 下中 ─── I 右下

九点指标按这些实测点计算,不把所有 3×3 小格的结果平均;缺点时拒绝计算,不用拟合点冒充实测点。中心 E 不直接进入 TV、四边弯曲和梯形公式,它是径向模型的参考中心。点阵中其他点仍参与完整性、定位质量和全点模型检查。

观察几何变化 ​

切换点阵规格或成像形状,观察代表点与指标变化。示意使用合成圆心坐标,只演示几何量,不执行图像定位或光学模型拟合。

六条参考跨度 ​

跨度使用两端圆心的欧氏距离,单位为 px。定义上、中、下宽度和左、中、右高度:

Wt=‖A−C‖,Wm=‖D−F‖,Wb=‖G−I‖Hl=‖A−G‖,Hc=‖B−H‖,Hr=‖C−I‖

对边均值为:

W¯=Wt+Wb2,H¯=Hl+Hr2

结果中的 TopWidth、MiddleWidth、BottomWidth、LeftHeight、CenterHeight、RightHeight 分别对应这六条跨度。

TV 比较边缘和中间跨度 ​

指标数值计算公式含义
标准水平 TV100×(W¯−Wm)/Wm上下宽度均值相对中间宽度的变化
标准垂直 TV100×(H¯−Hc)/Hc左右高度均值相对中间高度的变化
半值水平 TV标准水平 TV 除以 2同一次定位的另一种输出口径
半值垂直 TV标准垂直 TV 除以 2同上

单位均为 %。正值表示边缘平均跨度大于中间跨度,负值表示小于。TV 描述整体跨度变化;透视和其他成像几何也可能影响它,不能仅由 TV 换算独立标定的径向畸变。

四边畸变测量中点偏离 ​

四个边中点到对应角点连线的有符号垂距分别为 dt、db、dl、dr。向图卡内部弯曲为正,向外为负。

指标所用垂距数值计算公式
上边畸变 TopPercentB 到直线 AC 的垂距 dt100dt/H¯
下边畸变 BottomPercentH 到直线 GI 的垂距 db100db/H¯
左边畸变 LeftPercentD 到直线 AG 的垂距 dl100dl/W¯
右边畸变 RightPercentF 到直线 CI 的垂距 dr100dr/W¯

单位为 %。例如左右平均高度为 1000 px,上中点向内偏离上边角点连线 10 px,上边畸变即为 +1%。每条边只取对应的中点测量偏离,未在整条边上搜索最大弯曲点。

梯形比较两条对边长度 ​

指标数值计算公式正值表示
KeystoneHorizontalPercent100(Hl−Hr)/H¯左边高度大于右边高度
KeystoneVerticalPercent100(Wt−Wb)/W¯上边宽度大于下边宽度

单位为 %。当前对边均值口径中,Horizontal 比较左右高度,Vertical 比较上下宽度。四边均为直线的梯形,四边弯曲值可以为零,梯形指标仍可不为零。

四边倾斜角与最大倾斜角 ​

上下边相对图像水平线的倾斜角为:

θt,b=atan2(|Δy|,|Δx|)×180π

左右边相对图像垂直线的倾斜角为:

θl,r=atan2(|Δx|,|Δy|)×180π

这里的坐标差来自该边两端实测角点。TopTiltDegrees、BottomTiltDegrees、LeftTiltDegrees、RightTiltDegrees 保存四边角度,范围均为 0~90°;MaximumTiltDegrees 取四者最大值。

基准为原图水平、垂直方向,因此包含图卡整体旋转。例如规则矩形整体旋转 5°,最大倾斜角也为 5°。它描述图像上的边线方向,不能直接解释为器件实际的空间倾角。

最大边长差比例 ​

MaximumEdgeLengthDifferencePercent 将两组对边长度差取绝对值,再取较大值:

Dmax=100max(|Hl−Hr|H¯,|Wt−Wb|W¯)

它也等于对边均值口径下两个梯形比例绝对值的最大值,单位 %,始终使用两对边平均长度。例如上边 1000 px、下边 1200 px,左右高度相等,结果为 100×200/1100≈18.18%。

该值只使用四个角点。整体等比例缩放或旋转不改变它;中间点弯曲而四角不变时,它仍可为零。两项四角汇总不能替代中间点、四边弯曲和径向畸变分析,也不自动设置客户判定限。

四角几何整体保存在 Analysis.Geometry,ImageView 显示并可复制这些指标。全部分析 JSON、Flow 结果文件和主记录参数保存同一计算结果;Flow 同时提供 LocalGridDistortionGeometry、LocalGridDistortionMaximumTiltDegrees、LocalGridDistortionMaximumEdgeLengthDifferencePercent,并在 LocalGridDistortionMetrics.Geometry 中保留整体对象。原有百分比字段及 ARVR 默认口径不变,角度字段由 Degrees 明示单位。

旧本地 P9 三跨度口径 ​

旧口径把中间跨度也计入分母:

W3=Wt+Wm+Wb3,H3=Hl+Hc+Hr3

上下边弯曲量改为除以 H3,左右边弯曲量改为除以 W3,均乘 100。旧梯形还保留了不同的轴命名:

旧本地字段数值计算公式比较对象
旧 KeystoneHorizontalPercent100(Wt−Wb)/W3上下宽度
旧 KeystoneVerticalPercent100(Hl−Hr)/H3左右高度

不能只改分母后沿用字段解释。旧口径兼容本仓库 distortion_p9.cpp 的数学约定;使用 V2 定位器后,点位和最终数值不保证与旧定位器逐位一致,也不宣称等同于不可见的供应商服务实现。对比历史结果时需确认分母和轴定义。

相对光学估计使用全部点 ​

方法 CenteredProjectiveBrownK1/v2 假设图卡为等间距平面点阵,光学中心位于实测中心点 E。使用完整点阵联合拟合无径向畸变投影参考 p0=H(u,v) 与一阶 Brown 径向模型:

pa=p0(1+k1‖p0‖2)

二者均以中心点为原点,径向模型作用于投影后的图像坐标。中心相邻点只提供优化初值,最终节距来自拟合投影的局部导数,避免把已经畸变的中心节距直接当作理想放大率。

每个非中心点按实测半径 ra 与参考半径 r0 计算:

Di=100ra,i−r0,ir0,i
光学结果含义
ActualRadiusPixels实测点到中心 E 的距离,对应 AD,单位 px
ReferenceRadiusPixels对应投影参考点到中心 E 的距离,对应 PD,单位 px
ReferencePosition对应投影参考点的原图坐标
RadialPercent该点的径向偏差百分比,正值为枕形方向,负值为桶形方向
OpticRatioPercent选取绝对百分比最大的点,并保留该点正负号
MaxAbsoluteRatioPercent最大绝对径向偏差百分比,始终非负
MaxErrorPointId上述最大偏差点的 ID

最大点按绝对百分比选择,不按最大的像素位移选择。中心点参考半径为零,不生成逐点径向百分比;5×7 点阵对应 34 个非中心点样本。不能仅凭 TV 或四边畸变换算本模型的径向结果。

模型参数及诊断含义
Origin实测中心 E 的原图坐标,单位 px
ColumnPitch、RowPitch中心处无径向畸变参考的列、行节距向量,单位 px
RadialCoefficientPerPixelSquared一阶径向系数 k1,单位 px−2
FitRmsPixels全部点的二维拟合残差均方根,单位 px
MaxResidualPixels最大单点拟合残差,单位 px
FitResidualFraction拟合 RMS 除以最小实测相邻点距,是无量纲比例
FitIterations数值拟合迭代次数
IsAvailable是否通过收敛、可辨识性、几何和残差检查
IsCalibrated当前固定为 false,表示未经独立标定

逐点参考位置包含投影,不能仅用行、列节距向量线性外推全图。径向偏差描述变形量,拟合残差描述模型预测位置与实测位置的差;低残差不能证明光学中心等假设成立。

优化未收敛、参数不可辨识、投影退化、径向映射非单调,或 RMS 超过最小实测相邻点距的 1%、单点残差超过 3% 时,IsAvailable = false,数值为空并给出原因。残差门限衡量模型符合程度,不是计量精度承诺;失效不阻断 TV、九点结果,Flow 只自动发布有效的光学项。结果窗口显示像素残差与迭代次数,分析 JSON 保存诊断。

参考由单张图估计,结果只覆盖实测点阵范围。模型可在居中一阶径向假设成立时恢复已知畸变并分离透视,但不估计光轴偏心、切向和高阶畸变;九点约束有限,不能据此当作独立标定或整幅图边缘畸变。独立标定及图卡、光轴信息仍用于验证实拍图的物理准确性。

单位与定位质量读数 ​

上述 Percent 及兼容 JSON 中的比例数值已乘 100,例如 1.5 表示 1.5%。Fraction 字段为比例,例如 0.01 表示 1%。光学项不可用或旧结果缺少新字段时应保留为空,不能当作有效零。

诊断含义
候选点数、选中点数定位候选数量和最终组成完整点阵的数量
Quality.Score启发式定位质量分数,不是正确率概率
MinimumContrast最小归一化点对比度
GridResidualFraction定位几何残差相对网格间距的比例
ProcessingScale粗定位所用的处理缩放比例
各阶段耗时预处理、候选检测、排序、原图精修、原生指标计算和原生检测合计,单位 ms

单张图没有左右眼配对信息,当前不生成 DIFF_H、DIFF_V。最终合格判定使用项目约定的指标口径和限值。

公式参考 Edmund Optics 的径向与 TV 畸变说明;规则点阵检测参考 OpenCV findCirclesGrid,畸变参考网格与标定方法可参阅 Discorpy 方法文档。本实现未移植 Discorpy 的完整标定模型,附件中的公式也不作为行业标准认证依据。

定位、质量与接口 ​

V2 先缩小图像作粗定位,通过局部背景扣除与局部对比归一化减轻漏光及高亮反光影响,生成圆点候选;结合行列拓扑和拟合残差选择完整点阵,再在原图局部窗口细化点中心。全局亮度阈值和固定像素面积不再是唯一选点条件,仍保留明确的对比度和几何质量门限。过强非投影变形、遮挡或缺点仍可能拒绝,质量分数不是正确率概率。

候选提取保留外框、圆环内部的独立前景点,排除孔洞轮廓,避免框住整张图时漏掉内部圆点。聚类排序失败时,使用 OpenCV 基于邻接图的排序假设,两者都必须通过相同的完整点数、几何残差和原图精修校验。额外点只有在竞争已占用格点,或紧邻行列至少三个不同格点形成扩展时才判为歧义;孤立远点偶然落在无限延伸的整数网格上,不足以否定当前点阵。该检查不保证识别相距较远的多套图卡,多个完整图卡同框时应通过搜索区域明确目标。

Core 参数默认值范围
ExpectedRows / ExpectedCols3 / 33~15 的奇数
BrightTargettrue“亮点模式”勾选为亮点,取消为暗点
MaxProcessingSize1600256~4096 px
MinimumContrast0.020~1
MaximumGridResidualFraction0.3大于 0 且不超过 1,相对网格间距

Flow 当前直接开放行列数、亮点模式、搜索区域和最小对比度,其他检测参数使用 Core 默认值。原生导出 M_CalDistortionGridV2 接收 HImage、RoiRect 和 UTF-8 JSON,返回 JSON 缓冲区并由 FreeResult 释放。原有 P9 ABI 保持独立;调用 V2 需要同时交付具有新导出的 opencv_helper.dll。包装层校验结果完整性和有限值,DLL、入口、解析及释放错误返回失败,不能作为有效的零畸变。

验证和复现 ​

现场复核应固定原图、ROI、DLL 版本和计算口径,对照完整的行列对应、点位误差、有效跨度及畸变指标。保留输入与 DLL 哈希,输出写独立目录。若比较耗时,分别记录原生调用与整条流程。OpenCV 公开点阵可作定位对照,客户验收仍需独立实测样本及计量基准。

基于 MIT License 发布。