timm/cait_xxs36_384.fb_dist_in1k on Ascend NPU

1. 简介

本项目将 timm/cait_xxs36_384.fb_dist_in1k 图像分类模型适配到单卡昇腾 NPU（Ascend910）上运行。模型基于 CAIT（Class-Attention in Image Transformers）XXS/36 架构，输入分辨率 384x384，在 ImageNet-1k 上通过蒸馏训练，输出 1000 维分类 logits。

2. 验证环境

• NPU: Ascend910_9362
• CANN: 8.5.1
• Python: 3.11.14
• PyTorch: 2.9.0+cpu
• torch-npu: 可用

3. 推理运行

pip install -r requirements.txt
python inference.py

推理结果 (NPU Top-5):

• Top-1: class_111 (0.204013)
• Top-2: class_549 (0.040004)
• Top-3: class_977 (0.034831)
• Top-4: class_473 (0.015247)
• Top-5: class_644 (0.008289)

日志保存在 logs/inference.log。

4. 精度验证

对单张测试输入进行 CPU 与 NPU 一致性验证：

• CPU Top-1: class_111
• NPU Top-1: class_111
• CPU Top-5: class_111, class_549, class_977, class_473, class_644
• NPU Top-5: class_111, class_549, class_977, class_473, class_644
• Top-1 match: True
• Top-5 match: True

5. 性能参考

测试条件：单卡 Ascend910，输入尺寸 [1, 3, 384, 384]，预热 2 次 + 正式 10 次。

6. 精度评测说明

本项目包含单输入 smoke consistency 验证，非官方 ImageNet 完整验证集评测。详细指标见第 4 节。

7. 自验证截图

见 screenshots/self_verification.png。

8. 日志文件

9. 注意事项

1. 模型权重通过 ModelScope snapshot_download 下载，严禁使用 HuggingFace 自动下载。
2. 推理时 pretrained=False，通过本地 model.safetensors 加载权重。
3. 输入尺寸由 timm.data.resolve_model_data_config 自动解析为 384x384。
4. 测试图片为占位图（网络下载失败），实际部署时可替换为真实图片。

10. 标签

#NPU