timm/maxvit_rmlp_nano_rw_256.sw_in1k on Ascend NPU

1. 简介

本项目将 ModelScope timm/maxvit_rmlp_nano_rw_256.sw_in1k 模型适配到单卡昇腾 NPU (Ascend910) 上运行。

• 模型架构: MaxxVit (Multi-Axis Vision Transformer)，属于 timm 图像分类模型
• 输入尺寸: 1 x 3 x 256 x 256
• 输出: 1000 类 ImageNet 分类 logits
• 权重加载: ModelScope snapshot_download + 本地 safetensors 权重加载
• 预处理: timm 标准 resolve_model_data_config + create_transform

2. 验证环境

环境检查日志见 logs/env_check.log。

3. 推理运行

pip install -r requirements.txt
python inference.py

推理结果 (NPU):

=== NPU Inference ===
model: timm/maxvit_rmlp_nano_rw_256.sw_in1k
input_shape: [1, 3, 256, 256]
output_shape: [1, 1000]

NPU Top-5 Predictions:
  Top-1: class_644 (0.007382)
  Top-2: class_512 (0.006377)
  Top-3: class_600 (0.005805)
  Top-4: class_623 (0.005320)
  Top-5: class_769 (0.004877)

weights_path: /opt/atomgit/.cache/modelscope/hub/models/timm/maxvit_rmlp_nano_rw_256___sw_in1k/model.safetensors
missing_keys: 0, unexpected_keys: 0

日志保存在 logs/inference.log。

4. 精度验证

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

CPU vs NPU Top-1/Top-5 完全一致。

5. 性能参考

在 Ascend910 NPU 单卡上测得（输入 1x3x256x256，预热 2 次，正式 10 次）：

性能日志保存在 logs/benchmark.log。

6. 精度评测说明

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

7. 自验证截图

见 screenshots/self_verification.png 和 screenshots/self_verification.txt。

8. 日志文件

9. 注意事项

1. 禁止 HuggingFace 自动下载：权重通过 modelscope.snapshot_download 获取并本地加载。
2. 不提交权重：.gitignore 已排除 *.bin, *.safetensors, *.pth, *.pt, *.ckpt, *.onnx。
3. 占位测试图：由于网络限制，assets/test.jpg 为占位图（400x300 灰色图），不影响推理流程验证。
4. 首次运行会自动下载模型权重到本地缓存目录。

10. 标签

#NPU #Ascend #Ascend910 #timm #MaxViT #ImageNet