Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

PCB AOI 黄金样本工具

基于 PySide6 + OpenCV + NumPy 的 PCB AOI 桌面应用,覆盖从项目建立、图像预处理、标注、ROI 提取、黄金样本生成到在线验证的完整流程。


1. 项目定位

本仓库提供两类使用方式:

  1. 统一应用(推荐):通过工作流串联全部模块,适合实际业务使用。
  2. 独立模块工具:单独打开某个 GUI,适合调参、排查和算法验证。

入口文件:main.py


2. 功能总览

模块 主要职责 关键文件
统一应用壳 工作流编排、步骤导航、项目上下文、进度恢复 modules/unified_app/main_application.py
PCB 提取 从原始整图提取有效板区,产出图 A modules/pcb_extractor/pcb_extractor_gui.py
标注编辑 标注 Fiducial / ROI / Exclusion,并保存 annotation.json modules/pcb_annotator/pcb_annotator_gui.py
ROI 提取 在图 B 中定位 ROI(局部查找 / 基准点仿射),保存 ROI 图块 modules/roi_extractor/roi_extractor_gui.py
黄金样本生成 对多张 B 图 ROI 对齐融合,生成 ROI 黄金样本 modules/golden_sample/golden_sample_gui.py
黄金样本验证 图 B ROI 对齐 + 缺陷评分与结果可视化 modules/golden_sample_verifier/golden_sample_verifier_gui.py

3. 工作流(统一应用)

3.1 创建黄金样本流程(7 步)

工作流定义在 modules/unified_app/core/workflow_manager.py:

  1. 选择项目目录
  2. 图像导入(单张原始整图)
  3. PCB 提取
  4. 标注编辑
  5. ROI 提取
  6. 黄金样本生成
  7. 完成确认

3.2 使用黄金样本流程(4 步)

  1. 打开项目
  2. 导入待检测图片(图 B)
  3. 特征提取与检测(验证)
  4. 输出缺陷信息

3.3 进度保存与恢复

  • 工作流进度文件:<project_path>/.workflow_progress.json
  • 相关实现:modules/unified_app/module_pages.py
  • 项目上下文(路径/状态)对象:modules/unified_app/core/project_context.py

4. 算法与处理能力

4.1 对齐分层(粗 / 局部 / 精)

统一常量定义:modules/alignment_constants.py

  • 粗对齐:orb/sift/brisk/kaze/akaze/fiducial
  • 局部查找:
    • template_matching
    • rotated_template_matching
    • edge_template_matching
    • local_feature_matching
    • phase_correlation_matching
  • 精对齐:ecc_translation/ecc_euclidean/ecc_affine/shitomasi_lk

4.2 黄金样本融合算法

modules/golden_sample/core/golden_sample_core.py 中包含:

  • 平均融合
  • 中值融合
  • 最大值融合
  • 最小值融合
  • 加权融合
  • 金字塔融合

4.3 验证算法

modules/golden_sample_verifier/core/verifier_core.py:

  • 绝对差值
  • 结构化相似度(SSIM)
  • 峰值信噪比(PSNR)
  • 平均绝对误差(MAE)
  • 均方误差(MSE)

5. 多线程现状(当前代码)

当前已接入 Qt 原生线程池(QThreadPool + QRunnable),用于避免 GUI 卡顿:

  • 通用任务执行器:modules/unified_app/core/task_runner.py
  • ROI 提取 GUI:后台任务 + 取消 + 进度提示
    • modules/roi_extractor/roi_extractor_gui.py
  • 验证 GUI:后台任务 + 取消 + 进度提示
    • modules/golden_sample_verifier/golden_sample_verifier_gui.py
  • ROI 匹配器支持多 ROI 并行与取消令牌
    • modules/roi_extractor/core/roi_matcher.py

说明:当前取消属于协作式取消,正在执行的底层单次 OpenCV 调用会在返回后结束。


6. 安装与环境

推荐 Python 3.10+(Windows 中文路径已在项目中做过兼容处理)。

6.1 安装依赖

pip install -r requirements.txt

requirements.txt 当前内容:

  • opencv-python
  • numpy
  • matplotlib
  • pyyaml
  • PySide6
  • Pillow

6.2 可选依赖(启用 SSIM 验证)

verifier_core.py 的 SSIM 路径使用 skimage:

pip install scikit-image

7. 运行方式

7.1 统一应用(推荐)

python main.py

7.2 独立运行各 GUI 模块

# ROI 提取
python -c "from modules.roi_extractor.roi_extractor_gui import main; main()"

# 黄金样本验证
python -c "from modules.golden_sample_verifier.golden_sample_verifier_gui import main; main()"

# 黄金样本生成
python -c "from modules.golden_sample.golden_sample_gui import main; main()"

# PCB 标注
python -c "from modules.pcb_annotator.pcb_annotator_gui import main; main()"

# PCB 提取
python -c "from modules.pcb_extractor.pcb_extractor_gui import main; main()"

7.3 独立实验/辅助工具

# 粗对齐算法可视化验证
python tools/coarse_align_verifier_gui.py

# 基准点 ROI 提取实验工具
python tools/roi_extractor_fiducial_experiment.py

8. 测试

测试框架:unittest

8.1 运行全部测试

python tests/run_tests.py

8.2 模式过滤

python tests/run_tests.py -k "workflow_manager"
python tests/run_tests.py -k "project_context"
python tests/run_tests.py -k "module_pages"

8.3 单条测试(推荐排查方式)

python -m unittest tests.test_unified_app.test_workflow_manager.TestWorkflowManager.test_reset

8.4 与多线程相关的新增测试

python -m unittest tests.test_unified_app.test_task_runner.TestTaskRunner.test_cancel_token

若本地未安装 PySide6,部分 GUI/任务相关测试会被跳过或导入失败。


9. 关键数据与输出约定

9.1 项目核心文件

  • annotation.json:标注数据(fiducials / rois / exclusion_regions)
  • original_image_*.png:原图(统一壳和 ROI 提取模块会按规则查找)
  • .workflow_progress.json:工作流恢复文件

9.2 重要目录(创建流程校验会用到)

  • images/fiducials/<fid_id>/<fid_id>.png
  • images/rois/<roi_id>/<roi_id>.png
  • images/rois/<roi_id>/<roi_id>_golden_sample.png

相关严格门禁实现:modules/unified_app/module_pages.py。

9.3 bbox 兼容格式

项目中常见两种格式,核心代码均有兼容:

  • [[x1, y1], [x2, y2]]
  • [x1, y1, x2, y2]

10. 代码结构

.
├── main.py
├── modules/
│   ├── unified_app/
│   │   ├── main_application.py
│   │   ├── module_pages.py
│   │   ├── navigation_panel.py
│   │   ├── step_navigator.py
│   │   ├── core/
│   │   │   ├── workflow_manager.py
│   │   │   ├── project_context.py
│   │   │   └── task_runner.py
│   │   └── utils/
│   │       ├── logger.py
│   │       └── file_lock.py
│   ├── pcb_extractor/
│   ├── pcb_annotator/
│   ├── roi_extractor/
│   ├── golden_sample/
│   ├── golden_sample_verifier/
│   ├── alignment_constants.py
│   ├── template_matcher.py
│   └── matchment_algorithms.py
├── tools/
├── tests/
└── doc/

11. 常见开发入口

  • 工作流与步骤状态:modules/unified_app/core/workflow_manager.py
  • 页面编排与产物门禁:modules/unified_app/module_pages.py
  • ROI 定位主流程:modules/roi_extractor/roi_extractor_gui.py
  • ROI 匹配核心:modules/roi_extractor/core/roi_matcher.py
  • 验证主流程:modules/golden_sample_verifier/golden_sample_verifier_gui.py
  • 验证核心算法:modules/golden_sample_verifier/core/verifier_core.py

12. 文档

doc/ 目录包含架构、改造和测试清单文档,例如:

  • doc/GoldenSample_System_Architecture.md
  • doc/Fiducial_Based_ROI_Integration_Plan.md
  • doc/Unified_App_Manual_Test_Checklist.md
  • doc/多线程改造方案.md
  • doc/多线程与CUDA改造影响分析.md

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages