timm/convnext_base.fb_in22k on Ascend NPU

1. 简介

本项目将 timm/convnext_base.fb_in22k 模型适配到昇腾 NPU (Ascend910) 上运行。

• 原始模型: timm/convnext_base.fb_in22k
• 模型架构: ConvNeXt Base
• 预训练数据集: ImageNet-22k
• 分类数: 21841
• 输入尺寸: 224x224

适配方式：使用 ModelScope snapshot_download 下载权重，通过 timm.create_model(..., pretrained=False) 创建模型并加载本地权重，确保不触发 HuggingFace 自动下载。

2. 验证环境

3. 推理运行

pip install -r requirements.txt
python inference.py

推理结果 (NPU Top-5):

• Top-1: class_9534 (0.001166)
• Top-2: class_7585 (0.001120)
• Top-3: class_5363 (0.001037)
• Top-4: class_9051 (0.000966)
• Top-5: class_9245 (0.000952)

日志保存在 logs/inference.log。

4. 精度验证

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

• CPU Top-1: class_9534
• NPU Top-1: class_9534
• CPU Top-5: class_9534, class_7585, class_5363, class_9051, class_9245
• NPU Top-5: class_9534, class_7585, class_5363, class_9051, class_9245
• Top-1 match: True
• Top-5 match: True

5. 性能参考

测试配置：batch_size=1, input=[1, 3, 224, 224], warmup=2, iterations=10

6. 精度评测说明

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

7. 自验证截图

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

8. 日志文件

• logs/inference.log — 推理结果
• logs/accuracy.log — CPU-NPU 精度一致性
• logs/benchmark.log — 性能基准测试
• logs/env_check.log — 环境检查

9. 注意事项

• 权重通过 ModelScope 下载，严禁使用 timm.create_model(..., pretrained=True) 触发 HuggingFace 自动下载
• 推理时需确保 NPU 设备可用
• 本模型使用 ImageNet-22k 预训练权重，输出 21841 个类别，无官方 id2label 映射文件

10. 标签

#NPU #Ascend #Ascend910 #ConvNeXt #ImageNet-22k