课程资料
学习指南 · 代码示例 · 阶段作业 · 上机练习
快速开始
从教师发放的课程项目根目录运行:
git submodule update --init --recursive
cmake -S demos/mingcv -B build/mingcv
cmake --build build/mingcv --parallel
ctest --test-dir build/mingcv --output-on-failure
先运行 baseline,再修改一个参数或一个算法步骤。每次实验保留输入、命令、参数和输出,确保结果能够复现。
跟着课程开发库
每章结束形成一个可回退的 mingcv 版本:补接口、补测试、跑示例、打 Git 标签。课件末尾的代码工作坊提供可修改的 C++ 片段和概念图;按 C 可打开 Slidev 粉笔工具,在页面上标注推导和输出。
| 检查点 | 版本 | 主线 |
|---|---|---|
| 第1章 | course-v0.1.0 |
Image 与读写 |
| 第2章 | course-v0.2.0 |
采样与内插 |
| 第3章 | course-v0.3.0 |
空间滤波 |
| 第4至12章 | course-v0.4.0 至 course-v0.12.0 |
变换、复原、颜色、分割、特征和分类 |
课件中的编辑框不会在浏览器编译 C++;学生仍需在本地运行 CMake/CTest,提交测试结果和生成图像。
章节示例
按章分目录,每个 example 各有自己的 .cpp、main() 和可执行文件。
当前是基础示例骨架,不是教材例题完整复现。现有 51 个程序,第 2 章 13 个、第 3 章 20 个;源码位于 third_party/mingcv/examples/chap-XX/<example>.cpp,
课程目标名为 dip_chapXX_<example>。均值、高斯、中值滤波也分别运行。
| 章节 | 示例内容 |
|---|---|
| 01 | 图像表示、通道、灰度与量化 |
| 02 | 分辨率、内插、浮点算术、逻辑掩模、邻接距离、仿射变换 |
| 03 | 灰度变换、直方图匹配、局部增强、有符号卷积、可分离滤波 |
| 04 | DFT 对数频谱与伪彩色显示 |
| 05 | 噪声模型与中值复原 |
| 06 | RGB 与灰度补色 |
| 07 | 一层 Haar 的四个子带 |
| 08 | 图像熵与位平面 |
| 09 | 形态学、连通分量与区域框 |
| 10 | Sobel 梯度与 Otsu 分割 |
| 11 | 区域统计、标签与包围盒 |
| 12 | 特征向量与最近原型分类 |
cmake --build build/mingcv --target dip_chap03_ex01_gamma --parallel
./build/mingcv/dip_chap03_ex01_gamma
./build/mingcv/dip_chap03_gaussian_filter
每个程序已经由 CMake 注入默认教材图像路径,直接运行即可。覆盖输入时使用:
./build/mingcv/dip_chap03_ex01_gamma \
--input path/to/image.png \
--output outputs/my-gamma
旧示例使用 third_party/mingcv/data/lena.png。第 2、3 章新增实验使用构建时自动生成的斜坡、几何图、冲激、暗部细节和照明场,位于 build/mingcv/data/teaching/。默认输入绝对路径由 CMake 写入程序。每个例子单独输出到
outputs/chap-XX/<example>/,相对于运行时工作目录,包含结果图、
README.txt、联系表和 Markdown 报告。运行
./build/mingcv/dip_chap03_ex01_gamma --help 可查看默认路径。
数值实验另存 CSV,保留负值和高动态范围;PNG 只是显示结果。新增实验为教材小节对应的原理演示,不冒充教材编号例题复现。后续依次补第 4 章可逆变换与频域滤波、第 5 章退化与复原,再推进其余章节。
阶段性作业
作业 1:从 RGB 到灰度
- 比较加权灰度化与简单平均灰度化;
- 选择三张内容不同的图像,保存灰度和三个通道结果;
- 解释不同颜色通道中结构可见性的差异。
作业 2:量化与灰度变换
- 比较 2、4、8、32、256 灰度级;
- 比较二值化、Gamma 变换和对数变换;
- 设计一个单调灰度映射,说明收益与代价。
作业 3:可复用算法接口
- 将一个算法整理为独立函数;
- 为非法参数和空图像增加测试;
- 画出输入与输出的映射曲线,并让
ctest通过。
作业 4:教材算法与现代方法
- 保留教材算法作为 baseline;
- 使用相同输入比较一个现代实现或论文方法;
- 同时讨论效果、速度和失败案例。
提交规范
每次提交包含源代码、完整运行命令、关键结果图和不超过 300 字的观察记录。
| 评分维度 | 分值 |
|---|---|
| 可复现构建与运行 | 25 |
| 算法实现正确性 | 30 |
| 结果图与对比实验 | 25 |
| 原理解释与边界分析 | 20 |
不要提交 build/、.git/、系统缓存或大型临时文件。
上机练习
Exam 01 覆盖加权灰度化、8 级均匀量化、结果保存和简短原理说明。公开 starter 与检查器位于课程项目的 exam/mingcv/;正式考试的隐藏测试不在网站公开。