无人机遥感影像匀色处理

一、模块要解决什么问题

正射、镶嵌之后的影像序列，往往在辐射域上仍不协调：相邻图幅亮度/色度跳变、接缝条带、云与无效区干扰统计。ColorBalancing 面向的是多景一致性与观感增强：

• 全局匀色：在景与景有重叠的前提下，用重叠区统计或参考关系，为每景估计整体调整，先消除“一块亮、一块暗”的大面差异。
• 局部匀色：在接边附近做多分辨率融合，削弱窄条色差，同时尽量保留纹理细节。
• 单景增强：去雾、USM 锐化等单进单出能力，可插在流水线前后由产品定义顺序。

底层依赖栅格引擎（如 GDAL）做分块读写；算法侧组合统计、线性/直方图/参考驱动与金字塔融合等策略。

---

二、核心类关系（概念类图）

对外以 C 风格导出函数 + 参数结构体 为主（如全局/局部/组合匀色、去雾、锐化）。内部用 抽象基类统一“预处理—主处理—清理”，多种全局策略通过平行实现类接入，局部大块数据走专门的分块调度类。

读图要点：

• IColorBalancing 把“多景任务”的共同部分（路径列表、输出格式、掩膜与有效范围 shapefile、亮度对比度等）收拢，子类专注各自算法。
• 全局与局部在工程上既可单独调用，也可 Global_Local 一类入口固定顺序串联（先全局、后局部），避免接口组合爆炸。

---

三、典型执行流程

3.1 全局匀色（时间线）

1. 一致性门禁：空间参考、波段数、数据类型等需可一起参与运算；不满足则预处理阶段失败，避免算到一半才暴露。
2. 缩小影像 / 临时文件：对大图先做分辨率降级或分块可读副本，用于加速重叠分析与统计（控制内存与 I/O）。
3. 重叠与邻接：求景间相交几何；按最小相交像元等阈值剪弱边，减少噪声邻接对全局解的影响。
4. 重叠区统计：在掩膜、有效范围约束下估计景间差异；可分支为线性拉伸、直方图、参考影像权重迭代、模板驱动等。
5. 全局参数求解与回写：得到每景每波段（或亮度/色彩空间分量）的调整参数，写出结果或仅返回参数供外部二次应用。
6. 进度：常用 GDAL 风格分段进度（如预处理、求解、写盘各占比例），便于 UI 展示。

3.2 局部匀色（时间线）

1. 镶嵌范围与模板：shapefile 指明参与镶嵌的有效区域及与文件名关联字段；可选初始模板、云掩膜、黑边处理。
2. 分块调度：按最大行列块控制单次内存占用；可选跳过已存在临时文件、任务结束后清理临时文件——直接影响断点续跑与磁盘占用。
3. 多分辨率融合：金字塔层数控制“低频对齐接缝、高频保留细节”的平衡。
4. 写出：与全局类似，带进度回调。

3.3 组合流程（产品常用）

全局 → 局部 的顺序是刻意设计的：全局先拉齐辐射基准，局部再在接缝处做精细融合；若颠倒，接缝算法要在“大偏色”上硬拉，易糊或假。

3.4 单景去雾 / 锐化

路径最短：读 → 单景算子 → 写。与多景匀色解耦，便于在 DOM 流水线中按项目选择“先物理去雾再匀色”或“先匀色再观感锐化”。

---

四、设计原因（为何这样拆）

设计点	原因
基类 + 多实现	全局策略多（线性/直方图/参考/模板），继承或平行类比单一巨型函数更易维护与单测。
PreProcess / Process 两阶段	先失败快速返回，避免长时间计算后才发现数据不可用；进度分段更清晰。
shapefile 掩膜与有效范围	遥感生产里云、水域、境外无效区必须用矢量约束统计样本，否则整体被拉灰或拉偏。
重叠剪枝	弱重叠边对解算贡献噪声，剪枝提高稳定性。
局部单独分块类	数据量可达 GB～TB 级，必须将“算法正确性”与“工程可跑完”绑定在同一套调度里。

---

五、注意事项（集成与运维）

1. 数据一致性：源列表、参考、模板、掩膜的坐标系与分辨率逻辑要由上游保证；否则错误集中在 PreProcess。
2. 重叠不足：相交像元低于阈值时，全局匀色可能无有效约束，需业务侧扩容邻接或改参考策略。
3. 云掩膜与有效范围：字段名默认与 shapefile 属性一致，生产库换字段时要同步改参数，否则“ silently 用错列”。
4. 临时文件：局部匀色的跳过/清理开关影响调试（想复现中间结果要关清理）与磁盘空间。
5. 进度回调：长任务务必接上，否则用户误以为死机；失败路径要区分 PreProcess 与 Process。
6. 与镶嵌线工序：几何接缝与辐射接缝应对齐；镶嵌线未定就匀色，后续改线可能需重跑局部阶段。

---

六、踩坑记录

• 只跑全局、接缝仍在：优先检查是否应启用局部；或镶嵌/接边几何与匀色输入是否同一版数据。
• 整体发灰、发花：多为直方图/参考权重与云掩膜同时不当时，统计样本被极端像元主导；可缩小有效范围或换参考。
• 16 位与 8 位去雾：两条路径参数含义接近但动态范围不同，混用默认参数易出现裁切或噪声；产品层应对数据位深分支。
• 大工程中断：局部临时文件策略与“跳过已存在”组合不当，可能导致续跑读到陈旧临时图，结果不可复现。
• 多线程：若在外层并行调多组匀色，注意 GDAL 缓存、临时目录锁与 shapefile 占用。

---

七、心得体会

1. 匀色是“几何之后的第二道关”：客户抱怨往往表现为“颜色”，根因常在重叠质量、掩膜与参考影像选择；只调算法参数不查数据，容易陷入无效迭代。
2. 先全局后局部是认知模型：培训时把这条时间线讲清楚，比罗列参数名更能帮助读者建立直觉。
3. 进度与阶段日志是交付物的一部分：生产环境排障依赖“卡在哪一段”，与算法同等重要。
4. 策略多 ≠ 一次全打开：参考影像迭代、直方图映射、模板同时开，可能过拟合或极慢；产品侧宜提供“推荐组合”而非全开。

---