You're reading an pre-release version of this documentation.
For the latest stable release version, please have a look at master.

Caffe 模型转换示例

概述

本文档以 lenet_caffe 为例,演示如何使用 Netrans 对 Caffe 模型进行转换。Netrans 支持所有的 Caffe 模型。

快速开始

1. 环境准备

确保已安装 Netrans,如未安装请参考 安装指南

2. 进入示例目录

1cd /home/xj/work/nudt/netrans/examples/caffe
2mamba activate netrans  # 激活 netrans 环境

3. 数据准备

本示例包含以下文件:

lenet_caffe/
├── 0.jpg                   # 校准图像
├── dataset.txt             # 数据集路径配置
├── lenet_caffe.caffemodel  # Caffe模型权重
└── lenet_caffe.prototxt    # Caffe模型结构定义

4. 一体化转换(推荐)

1# CLI 方式 - 一体化流程(推荐)
2netrans load lenet_caffe --mean 128 --scale 1
3netrans quantize lenet_caffe asymu8 --pre --post
4netrans export lenet_caffe asymu8

分步详细流程

 1# 1. 模型导入
 2netrans load lenet_caffe --mean 128 --scale 1
 3
 4# 2. 模型量化
 5netrans quantize lenet_caffe asymu8
 6
 7# 3. 前后处理集成
 8netrans add_pre_post lenet_caffe asymu8 --preprocess --postprocess
 9
10# 4. 模型导出
11netrans export lenet_caffe asymu8

Python API 示例

基础转换

from netrans import Netrans

# 初始化
netrans = Netrans()

# 加载模型
netrans.load('lenet_caffe', mean=[128], scale=[1])

# 量化并集成前后处理
netrans.quantize('asymu8', pre=True, post=True)

# 导出NBG格式
netrans.export('asymu8')

分步API使用

from netrans import Netrans

netrans = Netrans()

# 分步执行
netrans.load('lenet_caffe', mean=[128], scale=[1])  # lenet 输入为灰度图像,仅有一个通道
netrans.quantize('asymu8')
netrans.add_pre_post('asymu8', pre=True, post=True)
netrans.export('asymu8')

输出说明

环境准备完成后,执行转换流程会生成:

lenet_caffe/
├── 0.jpg
├── dataset.txt
├── lenet_caffe.caffemodel
├── lenet_caffe.prototxt
├── lenet_caffe.data                    # 模型权重数据(生成)
├── lenet_caffe.json                    # 模型结构描述(生成)
├── lenet_caffe_asymu8.quantize         # 量化配置(生成)
├── lenet_caffe_inputmeta.yml           # 输入元数据(生成)
├── lenet_caffe_postprocess_file.yml    # 后处理配置(生成)
└── wksp/                               # 工作空间(生成)
    ├── lenet_caffe_asymu8/              # 量化模型工程
    └── lenet_caffe_asymu8_nbg_unify/    # 最终NBG输出
        ├── network_binary.nb        # NBG模型文件(核心输出)
        ├── nbg_meta.json            # NBG元数据
        ├── main.c                   # 测试程序
        └── ...                      # 其他部署文件

核心输出文件:

  • network_binary.nb - 最终NBG模型文件,可直接部署到PNNA芯片

  • nbg_meta.json - 模型元数据,包含输入输出信息

  • main.c - 示例应用程序,展示如何加载和运行模型

相关文档


版本: 6.42.4+
更新日期: 2025-12-22
测试模型: lenet_caffe (Caffe格式)