README.md 5.5 KB
Newer Older
J
Jason 已提交
1
# X2Paddle
J
Jason 已提交
2
[![License](https://img.shields.io/badge/license-Apache%202-blue.svg)](LICENSE)
J
Jason 已提交
3
[![Version](https://img.shields.io/github/release/PaddlePaddle/X2Paddle.svg)](https://github.com/PaddlePaddle/X2Paddle/releases)  
J
Jason 已提交
4 5 6
X2Paddle支持将其余深度学习框架训练得到的模型,转换至PaddlePaddle模型。  
X2Paddle is a toolkit for converting trained model to PaddlePaddle from other deep learning frameworks.

J
Jason 已提交
7
## 转换模型库
S
SunAhong1993 已提交
8
X2Paddle在多个主流的CV模型上,测试过TensorFlow/Caffe/ONNX/PyTorch模型的转换,可以在[X2Paddle-Model-Zoo](./docs/introduction/x2paddle_model_zoo.md)查看我们的模型测试列表,可以在[OP-LIST](./docs/introduction/op_list.md)中查看目前X2Paddle支持的OP列表。如果你在新的模型上进行了测试转换,也欢迎继续补充该列表;如若无法转换,可通过ISSUE反馈给我们,我们会尽快跟进。
J
Jason 已提交
9

J
Jason 已提交
10 11
## 环境依赖

Z
Zeyu Chen 已提交
12 13
- python >= 3.5  
- paddlepaddle >= 2.0.0  
J
Jason 已提交
14

J
Jason 已提交
15
**按需安装以下依赖**  
Z
Zeyu Chen 已提交
16 17 18 19 20

- tensorflow : tensorflow == 1.14.0  
- caffe : 无  
- onnx : onnx >= 1.6.0
- pytorch:torch >=1.5.0 (script方式暂不支持1.7.0)
J
Jason 已提交
21

J
Jason 已提交
22
## 安装
J
Jason 已提交
23
### 安装方式一(推荐)
J
Jason 已提交
24
```
J
Jason 已提交
25 26 27 28
git clone https://github.com/PaddlePaddle/X2Paddle.git
cd X2Paddle
git checkout develop
python setup.py install
J
Jason 已提交
29
```
J
Jason 已提交
30

J
Jason 已提交
31
### 安装方式二
J
Jason 已提交
32
我们会定期更新pip源上的x2paddle版本
J
Jason 已提交
33
```
S
SunAhong1993 已提交
34
pip install x2paddle==1.0.0rc0 --index https://pypi.Python.org/simple/
J
Jason 已提交
35
```
J
Jason 已提交
36 37 38
## 使用方法
### TensorFlow
```
S
SunAhong1993 已提交
39
x2paddle --framework=tensorflow --model=tf_model.pb --save_dir=pd_model --paddle_type dygraph
J
Jason 已提交
40 41 42
```
### Caffe
```
S
SunAhong1993 已提交
43
x2paddle --framework=caffe --prototxt=deploy.prototxt --weight=deploy.caffemodel --save_dir=pd_model --paddle_type dygraph
J
Jason 已提交
44
```
J
Jason 已提交
45
### ONNX
C
channingss 已提交
46
```
S
SunAhong1993 已提交
47
x2paddle --framework=onnx --model=onnx_model.onnx --save_dir=pd_model --paddle_type dygraph
C
channingss 已提交
48
```
S
SunAhong1993 已提交
49

S
SunAhong1993 已提交
50
### PyTorch
S
SunAhong1993 已提交
51
> PyTorch不支持命令行使用方式,详见[PyTorch2Paddle](./docs/user_guides/pytorch2paddle.md)
S
SunAhong1993 已提交
52

53
### Paddle2ONNX
S
SunAhong1993 已提交
54 55
> Paddle2ONNX功能已迁移至新的github: https://github.com/PaddlePaddle/paddle2onnx, 欢迎大家去新的代码仓库查看详细介绍以及新功能。

S
SunAhong1993 已提交
56

J
Jason 已提交
57 58 59
### 参数选项
| 参数 | |
|----------|--------------|
C
Channingss 已提交
60
|--framework | 源模型类型 (tensorflow、caffe、onnx) |
S
SunAhong1993 已提交
61
|--prototxt | 当framework为caffe时,该参数指定caffe模型的proto文件路径 |
J
Jason 已提交
62 63
|--weight | 当framework为caffe时,该参数指定caffe模型的参数文件路径 |
|--save_dir | 指定转换后的模型保存目录路径 |
J
Jason 已提交
64
|--model | 当framework为tensorflow/onnx时,该参数指定tensorflow的pb模型文件或onnx模型路径 |
J
Jason 已提交
65
|--caffe_proto | **[可选]** 由caffe.proto编译成caffe_pb2.py文件的存放路径,当存在自定义Layer时使用,默认为None |
S
SunAhong1993 已提交
66
|--define_input_shape | **[可选]** For TensorFlow, 当指定该参数时,强制用户输入每个Placeholder的shape,见[文档Q2](./docs/user_guides/FAQ.md) |
S
SunAhong1993 已提交
67
|--paddle_type | **[可选]** 该参数指定转换为动态图代码(dygraph)或者静态图代码(static),默认为dygraph|
J
Jason 已提交
68

J
Jason 已提交
69

70

J
Jason 已提交
71
## 使用转换后的模型
S
SunAhong1993 已提交
72
- 静态图:
J
Jason 已提交
73
转换后的模型包括`model_with_code``inference_model`两个目录。  
S
SunAhong1993 已提交
74
`model_with_code`中保存了模型参数,和转换后的python模型静态图代码。  
S
SunAhong1993 已提交
75
`inference_model`中保存了序列化的模型结构和参数,可直接使用paddle的接口进行加载,见[paddle.static.load_inference_model](https://www.paddlepaddle.org.cn/documentation/docs/zh/2.0-rc/api/paddle/static/load_inference_model_cn.html#load-inference-model)
S
SunAhong1993 已提交
76
- 动态图:
S
SunAhong1993 已提交
77 78 79
转换后的模型包括`model.pdparams``x2paddle_code.py`两个文件,以及`inference_model`一个目录。  
`model.pdparams`中保存了模型参数。  
`x2paddle_code.py`是转换后的python模型动态图代码。  
S
SunAhong1993 已提交
80
`inference_model`中保存了序列化的模型结构和参数,可直接使用paddle的接口进行加载,见[paddle.static.load_inference_model](https://www.paddlepaddle.org.cn/documentation/docs/zh/2.0-rc/api/paddle/static/load_inference_model_cn.html#load-inference-model)
J
Jason 已提交
81

J
Jason 已提交
82 83 84 85 86
## 小工具
X2Paddle提供了工具解决如下问题,详见[tools/README.md](tools/README.md)
1. 检测模型是否在PaddleLite中支持  
2. 合并模型参数文件

J
Jason 已提交
87
## 相关文档
S
SunAhong1993 已提交
88 89 90 91 92 93
1. [X2Paddle使用过程中常见问题](./docs/user_guides/FAQ.md)  
2. [如何导出TensorFlow的pb模型](./docs/user_guides/export_tf_model.md)
3. [X2Paddle测试模型库](./docs/introduction/x2paddle_model_zoo.md)  
4. [X2Paddle支持的op列表](./docs/introduction/op_list.md) 
5. [PyTorch模型导出为ONNX模型](./docs/user_guides/pytorch2onnx.md)
6. [X2Paddle添加内置的Caffe自定义层](./docs/user_guides/add_caffe_custom_layer.md)
S
SunAhong1993 已提交
94 95
7. [TensorFlow转换教程](./docs/demo/tensorflow2paddle.ipynb)
8. [PyTorch转换教程](./docs/demo/pytorch2paddle.ipynb)
J
jiangjiajun 已提交
96

J
Jason 已提交
97
## 更新历史
S
SunAhong1993 已提交
98 99 100 101 102 103 104 105
2020.12.09
1. 新增PyTorch2Paddle转换方式,转换得到Paddle动态图代码,并动转静获得inference_model。
方式一:trace方式,转换后的代码有模块划分,每个模块的功能与PyTorch相同。
方式二:script方式,转换后的代码按执行顺序逐行出现。
2. 新增Caffe/ONNX/Tensorflow到Paddle动态图的转换。
3. 新增TensorFlow op(14个):Neg、Greater、FloorMod、LogicalAdd、Prd、Equal、Conv3D、Ceil、AddN、DivNoNan、Where、MirrorPad、Size、TopKv2
4. 新增Optimizer模块,主要包括op融合、op消除功能,转换后的代码可读性更强,进行预测时耗时更短。

J
Jason 已提交
106

J
jiangjiajun 已提交
107 108 109 110
## Acknowledgements

X2Paddle refers to the following projects:
- [MMdnn](https://github.com/microsoft/MMdnn)