无人机遥感影像匀色处理
无人机遥感影像匀色处理
一、模块要解决什么问题
正射、镶嵌之后的影像序列，往往在辐射域上仍不协调：相邻图幅亮度/色度跳变、接缝条带、云与无效区干扰统计。ColorBalancing 面向的是多景一致性与观感增强：
- 全局匀色：在景与景有重叠的前提下，用重叠区统计或参考关系，为每景估计整体调整，先消除“一块亮、一块暗”的大面差异。
- 局部匀色：在接边附近做多分辨率融合，削弱窄条色差，同时尽量保留纹理细节。
- 单景增强：去雾、USM 锐化等单进单出能力，可插在流水线前后由产品定义顺序。
底层依赖栅格引擎（如 GDAL）做分块读写；算法侧组合统计、线性/直方图/参考驱动与金字塔融合等策略。
二、核心类关系（概念类图）
对外以C 风格导出函数 + 参数结构体为主（如全局/局部/组合匀色、去雾、锐化）。内部用抽象基类统一“预处理—主处理—清理”，多种全局策略通过平行实现类接入，局部大块数据走专门的分块调度类。
读图要点：
- IColorBalancing把“多景任务”的共同部分（路径列表、输出格式、掩膜与有效范围 shapefile、亮度对比度等）收拢，子类专注各自算法。
- 全局与局部在工程上既可单独调用，也可Global_Local一类入口固定顺序串联（先全局、后局部），避免接口组合爆炸。
三、典型执行流程
3.1 全局匀色（时间线）
- 一致性门禁：空间参考、波段数、数据类型等需可一起参与运算；不满足则预处理阶段失败，避免算到一半才暴露。
- 缩小影像 / 临时文件：对大图先做分辨率降级或分块可读副本，用于加速重叠分析与统计（控制内存与 I/O）。
- 重叠与邻接：求景间相交几何；按最小相交像元等阈值剪弱边，减少噪声邻接对全局解的影响。
- 重叠区统计：在掩膜、有效范围约束下估计景间差异；可分支为线性拉伸、直方图、参考影像权重迭代、模板驱动等。
- 全局参数求解与回写：得到每景每波段（或亮度/色彩空间分量）的调整参数，写出结果或仅返回参数供外部二次应用。
- 进度：常用 GDAL 风格分段进度（如预处理、求解、写盘各占比例），便于 UI 展示。
3.2 局部匀色（时间线）
- 镶嵌范围与模板：shapefile 指明参与镶嵌的有效区域及与文件名关联字段；可选初始模板、云掩膜、黑边处理。
- 分块调度：按最大行列块控制单次内存占用；可选跳过已存在临时文件、任务结束后清理临时文件——直接影响断点续跑与磁盘占用。
- 多分辨率融合：金字塔层数控制“低频对齐接缝、高频保留细节”的平衡。
- 写出：与全局类似，带进度回调。
3.3 组合流程（产品常用）
全局 → 局部的顺序是刻意设计的：全局先拉齐辐射基准，局部再在接缝处做精细融合；若颠倒，接缝算法要在“大偏色”上硬拉，易糊或假。
3.4 单景去雾 / 锐化
路径最短：读 → 单景算子 → 写。与多景匀色解耦，便于在 DOM 流水线中按项目选择“先物理去雾再匀色”或“先匀色再观感锐化”。
四、设计原因（为何这样拆）
| 设计点 | 原因 |
|---|---|
| 基类 + 多实现 | 全局策略多（线性/直方图/参考/模板），继承或平行类比单一巨型函数更易维护与单测。 |
| PreProcess / Process 两阶段 | 先失败快速返回，避免长时间计算后才发现数据不可用；进度分段更清晰。 |
| shapefile 掩膜与有效范围 | 遥感生产里云、水域、境外无效区必须用矢量约束统计样本，否则整体被拉灰或拉偏。 |
| 重叠剪枝 | 弱重叠边对解算贡献噪声，剪枝提高稳定性。 |
| 局部单独分块类 | 数据量可达 GB～TB 级，必须将“算法正确性”与“工程可跑完”绑定在同一套调度里。 |
五、注意事项（集成与运维）
- 数据一致性：源列表、参考、模板、掩膜的坐标系与分辨率逻辑要由上游保证；否则错误集中在 PreProcess。
- 重叠不足：相交像元低于阈值时，全局匀色可能无有效约束，需业务侧扩容邻接或改参考策略。
- 云掩膜与有效范围：字段名默认与 shapefile 属性一致，生产库换字段时要同步改参数，否则“ silently 用错列”。
- 临时文件：局部匀色的跳过/清理开关影响调试（想复现中间结果要关清理）与磁盘空间。
- 进度回调：长任务务必接上，否则用户误以为死机；失败路径要区分 PreProcess 与 Process。
- 与镶嵌线工序：几何接缝与辐射接缝应对齐；镶嵌线未定就匀色，后续改线可能需重跑局部阶段。
六、踩坑记录
- 只跑全局、接缝仍在：优先检查是否应启用局部；或镶嵌/接边几何与匀色输入是否同一版数据。
- 整体发灰、发花：多为直方图/参考权重与云掩膜同时不当时，统计样本被极端像元主导；可缩小有效范围或换参考。
- 16 位与 8 位去雾：两条路径参数含义接近但动态范围不同，混用默认参数易出现裁切或噪声；产品层应对数据位深分支。
- 大工程中断：局部临时文件策略与“跳过已存在”组合不当，可能导致续跑读到陈旧临时图，结果不可复现。
- 多线程：若在外层并行调多组匀色，注意 GDAL 缓存、临时目录锁与 shapefile 占用。
七、心得体会
- 匀色是“几何之后的第二道关”：客户抱怨往往表现为“颜色”，根因常在重叠质量、掩膜与参考影像选择；只调算法参数不查数据，容易陷入无效迭代。
- 先全局后局部是认知模型：培训时把这条时间线讲清楚，比罗列参数名更能帮助读者建立直觉。
- 进度与阶段日志是交付物的一部分：生产环境排障依赖“卡在哪一段”，与算法同等重要。
- 策略多 ≠ 一次全打开：参考影像迭代、直方图映射、模板同时开，可能过拟合或极慢；产品侧宜提供“推荐组合”而非全开。