Skip to content

摩尔纹分析 V1 ​

当前发布边界 ​

此算法为 Experimental,默认不展示或执行;门禁和错误码见统一平台发布清单。

适用范围 ​

保留的摩尔纹分析实现使用稳定 ID colorvision.frequency.moire-analysis,复用 FFT / 频域分析 的亮度、窗函数、二维 DFT、带符号频率坐标、实数共轭规范化和峰值检测规则,在此基础上加入窄带周期证据评分、同半径背景解释、共轭 notch 建议、可选对称 notch 滤波和频域证据热力图。源码包含 Catalog、Invocation、Runner、Result、ImageView、Batch 与本地 Flow 适配,但默认产品发布门禁尚未解除。

score 表示周期频谱证据,不能确定显示、传感器、采样或光学成因。RemoveMoire/M_RemoveMoire 是独立的 Gaussian blur、pyrDown/pyrUp 和锐化处理路径,不提供频谱测量;本算法不依赖 ONNX/AI 模型运行时。

输入、参数和数值契约 ​

输入采用频域分析的九种 canonical format:Gray8/16/32F、Bgr24/48/96F、Bgra32/64/128F。彩色亮度固定为 0.114B + 0.587G + 0.299R,alpha 忽略;整数映射为标称 0..255 DN,float 必须是有限 [0,1] 编码样本后再映射到同一标称范围。越界或非有限 float 返回 moire_float_out_of_nominal_range,其他非有限亮度返回 moire_nonfinite_input。算法不修改输入。

检测参数明确以下边界:

  • Rectangular/Hann/Hamming/Blackman 窗和可选均值移除与频域分析完全同义;
  • Minimum/MaximumFrequencyCyclesPerPixel 约束候选频带;
  • RelativePowerThreshold 相对当前频带最大功率做第一层筛选;
  • MinimumProminenceRatio 要求 peak power / same-radius-bin mean power 达到阈值,不把所有高频峰都解释为摩尔纹;
  • PeakNeighborhoodRadius 使用频域分析的环绕频率栅格非极大抑制;
  • MaximumSuggestions 限制结构化建议和后续滤波工作量;
  • MaximumPixels 在创建 OpenCV 工作区前拒绝超限输入。

V1 是全图频域分析,不接受 ROI。ROI 摩尔纹分析若未来加入,必须先定义裁剪边界、窗泄漏和 ROI 坐标回写规则,不能在当前 provider 内隐式裁图。

候选、评分和方向 ​

频域分析先返回实数输入共轭对的规范半平面代表。摩尔纹分析再按同一半径频谱箱的 mean power 计算 prominence,仅保留达到阈值的峰。每条建议同时返回 (fx, fy) 与 (-fx, -fy);频率单位是 cycles/pixel,周期是 1/frequency,频率方向归一到 [0,180),空间条纹方向与频率方向正交。

评分固定为:

100 * sqrt(clamp(2 * sum(candidatePower) / totalPower, 0, 1) * (1 - 1 / maximumProminence))

系数 2 补回结构化结果中省略的实数共轭半平面能量。没有候选时 score 为 0、候选表为空,并返回 moire_no_periodic_candidate;有候选时返回 moire_score_is_evidence,提醒调用者不得把数值当作因果结论。分类只用于 UI 阅读:低 <20、中 <50、高 <75、很高 >=75,自动化应使用原始 score、power fraction 和 prominence。

对称 notch 滤波 ​

EnableNotchFilter=false 是默认值,此时算法只分析和建议。启用后,provider 对未加窗、已移除均值的标称亮度执行第二次复数 DFT。每个规范候选同时应用中心在正负频率的 Gaussian notch:

response = product(1 - attenuation * exp(-wrappedDistance² / (2 * sigma²)))

频率距离在周期 DFT 环面上计算,避免 Nyquist 边界处的单边截断;正负 notch 共同保持实值逆变换的共轭对称。逆 DFT 使用 RealOutput | Scale,恢复原亮度均值,裁剪到 [0,255] 后输出归一化 Gray32Float [0,1]。这张图是明确的单通道亮度结果,不冒充原彩色格式;是否替换原图由宿主决定。moire.filtered_candidate_power_retention 是建议频点处滤波响应平方的估计,不代替对输出重新测量。

Result artifact ​

Artifact内容
moire-magnitude-spectrumGray8 对数归一化、中心化幅度显示;不是定量 magnitude
moire-frequency-heatmapGray8 候选 prominence Gaussian 显示;坐标为中心化频率栅格
moire-filtered-luminance仅启用滤波时存在;Gray32Float 归一化亮度,均值已恢复
moire-analysis-summaryscore、候选数、候选功率占比、最大 prominence、估计保留功率及主周期/方向
moire-notch-suggestions排名、正/负共轭频率、周期/方向、功率、径向背景、prominence、sigma/attenuation 和解释
moire-analysisschema=colorvision.frequency.moire-analysis/v1;输入、检测、评分定义、滤波规则、参数 schema 和完整候选

频谱和热力图只承担显示;可复现的数值保留在 Measurement、Table 与 StructuredData。摩尔纹分析不产生 WPF Visual 或核心层 overlay。

保留的宿主、所有权与导出(默认禁用) ​

本节描述保留实现及测试场景;默认菜单与 Runner 不开放摩尔纹分析,不能与条件启用的旧 RemoveMoire 混淆。

  • ImageView:“算法 → 摩尔纹分析...”打开事务参数窗口,经统一 analysis session 执行;Clear、切图、revision 变化或同 revision 更新 Invocation 会淘汰旧结果。结果窗口显示频谱、热力图、可选滤波亮度和建议表,可保存滤波 TIFF 或导出 CSV/JSON;关闭窗口释放 Result。
  • Batch:BatchAlgorithmAnalysisProcessor 执行同一 Invocation/Runner 并导出结构化证据;算法没有 Batch 图像格式转换策略。
  • Flow:LocalFlowImageAlgorithmAdapter.ExecuteRawAsync 可对本地像素帧运行同一 provider;旧 MQTT/device AlgorithmNode 和 STN 保持在远端 execution plane。
  • Copilot:摩尔纹分析不在显式白名单中。alias、Catalog 投影和 provider 注册都不会令它自动成为 Copilot 工具。

Runner 继续拥有解析、参数验证、provider 选择、调度、取消、诊断和 Transferred 输入释放。Result 拥有两张 Gray8 图以及可选 Gray32Float 图;失败、异常或取消不会泄漏已创建 artifact。OpenCV DFT 调用内部不可抢占,取消在扫描、加窗、DFT 前后、聚合、热力图、notch 栅格和逆变换输出循环的检查点生效。

测试和性能门禁 ​

结果上限按两张 Gray8 加一张 Gray32Float 计算,为 6 bytes/pixel。启用滤波还会创建第二组执行期 DFT 与重建工作区。大图验收须分别量测结果占用、托管分配、原生工作集和延迟。

摩尔纹分析不做自动因果判定、时序视频摩尔纹跟踪、彩色通道分别滤波、盲反卷积、非均匀 FFT、GPU provider 或自动提交滤波图。每项若加入都需要独立数值、色彩和所有权契约。

基于 MIT License 发布。