简介本资源是一套基于Vision TransformerViT的图像去雾算法完整实现方案面向计算机视觉方向的研究者、深度学习开发者及高校高年级本科生解决雾霾天气下图像对比度低、细节模糊等实际成像问题。压缩包共340个文件包含204个Python源码文件含模型定义、训练/测试主逻辑、数据预处理模块、39张效果对比图与可视化结果png/gif、16个配置文件yaml、12个实验指标CSV记录、9个Jupyter Notebook演示案例及9个说明文档txt/md整体大小为156.38MB结构清晰支持开箱即用与二次训练。已有1442人学习下载提供完整的项目介绍与使用说明文档、预训练权重加载路径配置My_best_model目录、option.py参数详解如--train_ps补丁尺寸设置并附带多组CIFAR-10/100上的ViT与ResNet损失曲面分析数据便于理解模型优化行为与泛化特性。1. Vision Transformer 不是只能做分类——它正在改写图像去雾的底层逻辑很多人第一次听说 Vision TransformerViT时脑海里浮现的是 ImageNet 分类排行榜上的 SOTA 数字或是 ViT-B/16 在下游任务微调时那几行from transformers import ViTModel。但如果你正被雾霾图像困扰——监控摄像头拍出灰蒙蒙的车牌、无人机航拍因大气散射丢失纹理细节、医疗内窥镜图像因介质浑浊导致边界模糊——那么 ViT 的价值远不止于“换掉 ResNet”。它用全局注意力机制建模长程依赖天然适配去雾任务中「雾浓度空间非均匀、透射率与场景深度强耦合」这一核心难点。本项目不是简单套用 ViT 主干提取特征而是将 ViT 的 patch embedding、自注意力权重、cls token 动态响应全部纳入物理模型约束框架把大气散射方程 $ I(x) J(x)t(x) A(1-t(x)) $ 中的透射率 $ t(x) $ 和全局大气光 $ A $分别由 ViT 的多层注意力图与 cls token 回归联合预测。适合已有 Python 基础、熟悉 PyTorch 图像处理流程、且需要在真实监控/遥感/车载场景中部署轻量级去雾模块的工程师。2. 为什么必须用 Vision Transformer 而非 CNN 做去雾主干2.1 CNN 在去雾任务中的结构性瓶颈传统基于 CNN 的去雾方法如 AOD-Net、GFN、DehazeNet普遍采用 U-Net 或编解码结构其卷积核感受野受限于固定尺寸如 3×3、5×5即使堆叠多层也难以建模跨区域的雾浓度关联。例如在一张含远山与近树的图像中山顶雾浓而山脚雾淡CNN 需要数十层才能让山顶特征影响山脚的透射率估计导致梯度弥散和伪影。更关键的是CNN 的局部归纳偏置local inductive bias与雾的物理分布矛盾雾是全局光学现象其散射强度由整幅图像的大气条件决定而非像素邻域统计。提示实测对比显示在 RESIDE-SOTS 测试集上ResNet-50 主干的 DehazeNet 在远距离物体 PSNR 下降达 4.2 dB而同等参数量的 ViT-Tiny 主干模型保持稳定——这印证了全局建模的必要性。2.2 ViT 如何从物理层面重构去雾流程Vision Transformer 的核心突破在于将图像切分为不重叠 patch如 16×16每个 patch 经线性投影后成为 token 序列。自注意力机制使每个 token 可以直接加权聚合所有其他 token 的信息天然支持「远距离雾浓度一致性约束」。本项目具体实现中Patch Embedding 层输入图像 $ I \in \mathbb{R}^{H \times W \times 3} $ 被划分为 $ N (H/16) \times (W/16) $ 个 patch每个 patch 线性映射为 768 维向量ViT-Base 配置形成 $ X \in \mathbb{R}^{N \times 768} $Position Embedding 注入添加可学习的位置编码 $ E_{pos} \in \mathbb{R}^{N \times 768} $保留空间先验避免纯注意力丢失结构CLS Token 动态回归在序列前端插入 [CLS] token其最终输出经两层 MLP 直接回归全局大气光 $ A $维度为 3RGB# vision_transformer_dehaze.py 片段CLS token 大气光回归 class CLSAtrousRegressor(nn.Module): def __init__(self, embed_dim768, hidden_dim512): super().__init__() self.mlp nn.Sequential( nn.Linear(embed_dim, hidden_dim), nn.GELU(), nn.Dropout(0.1), nn.Linear(hidden_dim, 3) # 输出 R/G/B 三通道大气光值 ) def forward(self, x_cls): # x_cls: [B, 1, 768] return torch.sigmoid(self.mlp(x_cls)) * 1.0 # 限制 A ∈ [0, 1]该代码中torch.sigmoid确保输出在 [0,1] 区间符合归一化图像的物理范围* 1.0是显式类型对齐避免混合精度训练时的梯度异常。2.3 注意力图作为透射率先验的可行性验证ViT 每层的注意力权重矩阵 $ \text{Attention}(Q,K,V) \in \mathbb{R}^{N \times N} $其第 $ i $ 行表示第 $ i $ 个 patch 对所有 patch 的关注强度。实验发现在深层如第 10 层高雾区域 patch 的注意力分布更集中于自身自注意力权重 0.7而低雾区域则呈现广泛分散模式。这与透射率 $ t(x) $ 的物理定义高度吻合——$ t(x) $ 越小雾越浓光线衰减越强局部信息越主导。因此本项目将第 10 层注意力图的熵值 $ H_i -\sum_j \alpha_{ij} \log \alpha_{ij} $ 作为空间变化透射率的初始先验输入后续轻量 CNN 解码头进行精细化校正。3. 从零复现Python 环境搭建、数据加载与模型训练全流程3.1 Python 环境配置与依赖安装兼容 Windows/Linux/macOS本项目严格限定 Python 3.9因 PyTorch 2.0 对torch.compile的支持需此版本。避免使用conda install pytorch默认渠道可能拉取 CPU-only 版本必须指定 CUDA 构建版本# 创建隔离环境推荐 python -m venv vit_dehaze_env source vit_dehaze_env/bin/activate # Linux/macOS # vit_dehaze_env\Scripts\activate.bat # Windows # 安装 PyTorch以 CUDA 11.8 为例根据 nvidia-smi 输出选择 pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118 # 安装核心依赖注意 cv2 必须从 conda-forge 安装以避免 ABI 冲突 pip install numpy1.23.5 # 避免 1.24 与旧版 PIL 兼容问题 pip install opencv-python-headless4.8.1.78 # headless 版本避免 GUI 依赖 pip install timm0.9.2 # 提供 ViT 预训练权重与灵活 backbone 接口 pip install albumentations1.3.1 # 高性能图像增强支持多进程注意若执行import cv2报错libglib-2.0.so.0: cannot open shared object fileLinux需运行sudo apt-get install libglib2.0-0Windows 用户若遇cv2DLL 加载失败请卸载所有opencv-python相关包后重装opencv-python-headless。3.2 数据集组织与 RESIDE 格式兼容加载器本项目默认使用 RESIDE 数据集Realistic Single Image Dehazing其 SOTSSynthetic Objective Testing Set子集提供成对清晰/有雾图像。目录结构必须严格如下data/ ├── train/ │ ├── haze/ # 训练雾图命名如 1_haze.png, 2_haze.png │ └── clear/ # 对应清晰图命名如 1_clear.png, 2_clear.png ├── test_sots/ │ ├── haze/ │ └── clear/加载器采用内存映射优化避免训练时 IO 瓶颈# data_loader.py import torch from torch.utils.data import Dataset, DataLoader from PIL import Image import numpy as np import os class RESIDEDataset(Dataset): def __init__(self, root_dir, modetrain, transformNone): self.root_dir root_dir self.mode mode self.transform transform # 自动匹配 haze/clear 文件名忽略后缀差异 self.haze_files sorted([f for f in os.listdir(f{root_dir}/{mode}/haze) if f.endswith((.png, .jpg))]) self.clear_files [f.replace(_haze, _clear).replace(haze, clear) for f in self.haze_files] def __len__(self): return len(self.haze_files) def __getitem__(self, idx): haze_path os.path.join(self.root_dir, self.mode, haze, self.haze_files[idx]) clear_path os.path.join(self.root_dir, self.mode, clear, self.clear_files[idx]) haze_img np.array(Image.open(haze_path).convert(RGB)) / 255.0 clear_img np.array(Image.open(clear_path).convert(RGB)) / 255.0 if self.transform: augmented self.transform(imagehaze_img, image0clear_img) # image0 为清晰图别名 haze_img, clear_img augmented[image], augmented[image0] # 转为 tensor 并调整维度 [C, H, W] haze_tensor torch.from_numpy(haze_img).permute(2, 0, 1).float() clear_tensor torch.from_numpy(clear_img).permute(2, 0, 1).float() return haze_tensor, clear_tensor # 实例化训练集含增强 train_dataset RESIDEDataset( root_dirdata, modetrain, transformalbumentations.Compose([ albumentations.RandomCrop(height256, width256, p0.8), albumentations.HorizontalFlip(p0.5), albumentations.RandomBrightnessContrast(p0.2), albumentations.Normalize(mean[0.485, 0.456, 0.406], std[0.229, 0.224, 0.225]) # ImageNet 标准化 ]) )关键点说明albumentations.Normalize使用 ImageNet 均值标准差确保 ViT 预训练权重迁移有效RandomCrop尺寸设为 256×256因 ViT-Base 的 patch size16故输入需为 16 的整数倍256/1616保证 patch 划分无余数。3.3 模型训练命令与超参数配置表训练脚本train.py支持单卡/多卡 DDP核心启动命令如下# 单卡训练最常用 python train.py \ --data_dir data \ --model_name vit_base_patch16_224 \ --batch_size 8 \ --lr 1e-4 \ --epochs 100 \ --save_freq 10 \ --log_dir logs/vit_dehaze_base # 多卡训练需 NCCL 后端 python -m torch.distributed.launch --nproc_per_node2 train.py \ --data_dir data \ --model_name vit_small_patch16_224 \ --batch_size 16 \ --lr 2e-4 \ --epochs 80下表为不同 ViT 变体在 RTX 4090 上的实测超参建议基于 RESIDE-SOTS 验证集 PSNR 收敛性ViT 变体Batch Size初始学习率权重衰减Dropout Rate验证 PSNRdB显存占用GBViT-Tiny323e-40.050.124.88.2ViT-Small162e-40.050.126.312.5ViT-Base81e-40.050.127.118.7提示若显存不足可将--batch_size减半并用--gradient_accumulation_steps 2补偿等效 batch size避免梯度更新不稳定。4. 关键模块解析透射率解码头设计与物理损失函数组合4.1 透射率解码头从注意力熵到精细化 $ t(x) $ViT 主干输出的注意力熵仅提供粗粒度先验需轻量 CNN 解码头进行空间细化。本项目采用三阶段结构熵图上采样将第 10 层注意力图熵值 $ H \in \mathbb{R}^{16 \times 16} $ 双线性插值至 $ 256 \times 256 $多尺度特征融合ViT 最后一层 patch embedding $ X_{last} \in \mathbb{R}^{256 \times 768} $ 重塑为 $ 16 \times 16 \times 768 $经 1×1 卷积压缩通道至 64再上采样至 256×256残差精修将熵图与上采样特征拼接输入 3 层卷积kernel3, padding1每层后接 LeakyReLU最后一层输出单通道 $ \hat{t}(x) $。# decoder.py class TransmissionDecoder(nn.Module): def __init__(self, embed_dim768, upsample_scale16): super().__init__() self.entropy_proj nn.Conv2d(1, 64, 1) # 熵图通道扩展 self.feature_proj nn.Conv2d(embed_dim, 64, 1) # ViT 特征压缩 self.refine_net nn.Sequential( nn.Conv2d(128, 64, 3, padding1), nn.LeakyReLU(0.2), nn.Conv2d(64, 32, 3, padding1), nn.LeakyReLU(0.2), nn.Conv2d(32, 1, 3, padding1), # 输出单通道 t(x) nn.Sigmoid() # 保证 t ∈ [0,1] ) def forward(self, attn_entropy, vit_features): # attn_entropy: [B, 1, 16, 16] - [B, 1, 256, 256] entropy_up F.interpolate(attn_entropy, scale_factor16, modebilinear) entropy_feat self.entropy_proj(entropy_up) # [B, 64, 256, 256] # vit_features: [B, 256, 768] - [B, 768, 16, 16] - [B, 64, 256, 256] B, N, C vit_features.shape feat_2d vit_features.transpose(1, 2).view(B, C, 16, 16) feat_up F.interpolate(feat_2d, scale_factor16, modebilinear) feat_proj self.feature_proj(feat_up) fused torch.cat([entropy_feat, feat_proj], dim1) # [B, 128, 256, 256] return self.refine_net(fused) # [B, 1, 256, 256]F.interpolate使用bilinear模式而非nearest因双线性插值能保留熵图的空间渐变特性避免块状伪影。4.2 物理驱动的复合损失函数设计单纯 L1/L2 损失易导致去雾后图像过饱和或色彩失真。本项目采用四重损失组合损失项公式权重作用重建损失$ \mathcal{L}_{rec} $$ | \hat{J}(x) - J(x) |_1 $1.0保证去雾结果与真值清晰图一致物理一致性损失$ \mathcal{L}_{phys} $$ | I(x) - (\hat{J}(x)\hat{t}(x) \hat{A}(1-\hat{t}(x))) |_1 $0.8强制输出满足大气散射方程透射率平滑损失$ \mathcal{L}_{tv} $$ \sum_{x} | \nabla \hat{t}(x) |_2 $0.01抑制 $ t(x) $ 的噪声振荡大气光约束损失$ \mathcal{L}_{A} $$ | \hat{A} - \text{mean}(I(x)[\hat{t}(x)0.1]) |_2 $0.5利用雾最浓区域估计 $ A $# loss.py def physical_loss(haze, pred_j, pred_t, pred_a): # haze: [B,3,H,W], pred_j/t: [B,3,H,W]/[B,1,H,W], pred_a: [B,3] pred_a_exp pred_a.unsqueeze(-1).unsqueeze(-1) # [B,3,1,1] recon pred_j * pred_t pred_a_exp * (1 - pred_t) # [B,3,H,W] return F.l1_loss(recon, haze) def tv_loss(pred_t): # pred_t: [B,1,H,W] h_tv torch.pow(pred_t[:, :, 1:, :] - pred_t[:, :, :-1, :], 2).mean() w_tv torch.pow(pred_t[:, :, :, 1:] - pred_t[:, :, :, :-1], 2).mean() return h_tv w_tv # 训练循环中调用 loss_rec F.l1_loss(pred_j, clear) loss_phys physical_loss(haze, pred_j, pred_t, pred_a) loss_tv tv_loss(pred_t) loss_a F.mse_loss(pred_a, haze.mean(dim[2,3])) # 粗略初始化 A total_loss loss_rec 0.8 * loss_phys 0.01 * loss_tv 0.5 * loss_ahaze.mean(dim[2,3])作为 $ A $ 的粗略估计用于监督 $ \mathcal{L}_A $比单纯随机初始化收敛更快。5. 部署与推理单张图像去雾、批量处理及性能调优技巧5.1 单张图像快速去雾脚本支持 JPG/PNGinfer.py提供开箱即用的推理接口自动处理任意尺寸图像通过 padding 适配 ViT 输入要求python infer.py \ --model_path logs/vit_dehaze_base/best_model.pth \ --input_image data/test_sots/haze/1_haze.png \ --output_image results/1_dehazed.png \ --device cuda:0核心逻辑在于动态 paddingViT 要求输入为 16 的整数倍故对原始尺寸 $ H \times W $计算 $ H \lceil H/16 \rceil \times 16 $$ W \lceil W/16 \rceil \times 16 $用 reflection padding 避免边缘黑边# infer.py 片段 def pad_to_vit_size(img_tensor): # img_tensor: [C, H, W] _, h, w img_tensor.shape new_h ((h - 1) // 16 1) * 16 new_w ((w - 1) // 16 1) * 16 pad_h new_h - h pad_w new_w - w # reflection padding镜像填充比 zero-padding 更自然 return F.pad(img_tensor, (0, pad_w, 0, pad_h), modereflect) # 推理时 orig_h, orig_w haze_pil.size[::-1] # PIL size is (W,H) haze_tensor transforms.ToTensor()(haze_pil).unsqueeze(0) # [1,C,H,W] haze_padded pad_to_vit_size(haze_tensor[0]).unsqueeze(0) # [1,C,H,W] with torch.no_grad(): pred_j model(haze_padded.to(device)) # 去除 padding pred_j_cropped pred_j[:, :, :orig_h, :orig_w]F.pad(..., modereflect)是关键reflection padding 将图像边缘像素对称复制避免 zero-padding 引入的虚假暗角实测 PSNR 提升 0.9 dB。5.2 批量处理与 FPS 优化技巧对监控视频流或大批量图像需启用torch.compilePyTorch 2.0和 FP16 推理# infer_batch.py model torch.compile(model) # 图形级优化首次运行稍慢后续加速 1.8x model model.half().to(device) # FP16 推理 haze_batch haze_batch.half().to(device) with torch.no_grad(), torch.autocast(device_typecuda): pred_batch model(haze_batch)在 RTX 4090 上ViT-Small 批处理batch_size16, 512×512实测吞吐达42 FPS较未编译版本提升 83%。若需进一步提速可关闭torch.compile的dynamicTrue默认开启改用静态 shape 编译# 针对固定尺寸如 512×512的极致优化 model torch.compile(model, dynamicFalse, fullgraphTrue)此时编译后首次推理耗时增加约 200ms但后续帧稳定在 18ms/帧55 FPS。5.3 模型轻量化知识蒸馏压缩 ViT-Base 至 ViT-Tiny生产环境常需在 Jetson Orin 或树莓派上部署此时 ViT-Base 过重。本项目提供蒸馏脚本distill.py用 ViT-Base 作为教师模型指导 ViT-Tiny 训练python distill.py \ --teacher_path logs/vit_dehaze_base/best_model.pth \ --student_arch vit_tiny_patch16_224 \ --distill_weight 0.7 \ --temperature 4.0蒸馏损失包含两部分特征蒸馏学生 ViT-Tiny 最后一层 patch embedding 与教师对应层的 MSE 损失权重 0.3输出蒸馏学生去雾图 $ \hat{J}_s $ 与教师 $ \hat{J}_t $ 的 KL 散度温度缩放后权重 0.7温度 $ T4.0 $ 使软标签分布更平滑提升小模型学习效率。蒸馏后 ViT-Tiny 在 SOTS 上 PSNR 仅下降 0.6 dB24.2 → 23.6但参数量从 86M 降至 5.7M推理速度提升 4.2 倍。提示若蒸馏过程出现 NaN 损失立即降低--temperature至 2.0并检查教师模型是否在 eval 模式下运行model.eval()。本文还有配套的精品资源点击获取