timm/maxvit_tiny_rw_224.sw_in1k 在昇腾 NPU 上的部署

1. 简介

将 timm 图像分类模型 maxvit_tiny_rw_224.sw_in1k 适配到单卡昇腾 NPU (Ascend910)。通过 ModelScope 的 snapshot_download 功能下载权重，使用 timm.create_model(pretrained=False) 加载本地权重，无需直接连接 HuggingFace。

2. 验证环境

• NPU: Ascend910 (npu-smi: 正常)
• torch.npu.is_available(): True
• 设备: Ascend910_9362
• PyTorch + torch_npu

3. 推理运行

pip install -r requirements.txt
python inference.py

推理结果 (NPU Top-5):

• Top-1: class_979 (0.3240)
• Top-2: class_980 (0.1970)
• Top-3: class_970 (0.0317)
• Top-4: class_525 (0.0184)
• Top-5: class_867 (0.0144)

4. 精度验证

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

• CPU Top-1: class_979
• NPU Top-1: class_979
• CPU Top-5: class_979, class_980, class_970, class_525, class_867
• NPU Top-5: class_979, class_980, class_970, class_525, class_867
• Top-1 match: True
• Top-5 match: True

5. 性能参考

6. 精度评测说明

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

7. 自验证截图

见 screenshots/self_verification.png

8. 日志文件

• logs/env_check.log - 环境检查
• logs/inference.log - 推理结果
• logs/accuracy.log - 精度验证
• logs/benchmark.log - 性能基准

9. 注意事项

• 使用 ModelScope snapshot_download 下载权重，不使用 HuggingFace 直连
• 使用 timm.create_model(pretrained=False) + 本地权重加载
• 不提交任何权重文件（*.bin, *.safetensors, *.pth, *.pt, *.ckpt, *.onnx）
• 单图 smoke 验证，非完整 ImageNet 评测

10. 标签

#NPU #Ascend #timm #image-classification #Ascend910