init
This commit is contained in:
@@ -0,0 +1,112 @@
|
||||
[English](README_CN.md) | 简体中文
|
||||
# PP-OCRv3 RKNPU2 Python部署示例
|
||||
本目录下提供`infer.py`, 供用户完成PP-OCRv3在RKNPU2的部署.
|
||||
|
||||
|
||||
## 1. 部署环境准备
|
||||
在部署前,需确认以下两个步骤
|
||||
- 1. 在部署前,需自行编译基于RKNPU2的Python预测库,参考文档[RKNPU2部署环境编译](https://github.com/PaddlePaddle/FastDeploy/blob/develop/docs/cn/build_and_install#自行编译安装)
|
||||
- 2. 同时请用户参考[FastDeploy RKNPU2资源导航](https://github.com/PaddlePaddle/FastDeploy/blob/develop/docs/cn/build_and_install/rknpu2.md)
|
||||
|
||||
## 2.部署模型准备
|
||||
在部署前, 请准备好您所需要运行的推理模型, 您可以在[FastDeploy支持的PaddleOCR模型列表](../README.md)中下载所需模型.
|
||||
同时, 在RKNPU2上部署PP-OCR系列模型时,我们需要把Paddle的推理模型转为RKNN模型.
|
||||
由于rknn_toolkit2工具暂不支持直接从Paddle直接转换为RKNN模型,因此我们需要先将Paddle推理模型转为ONNX模型, 最后转为RKNN模型, 示例如下.
|
||||
|
||||
```bash
|
||||
# 下载PP-OCRv3文字检测模型
|
||||
wget https://paddleocr.bj.bcebos.com/PP-OCRv3/chinese/ch_PP-OCRv3_det_infer.tar
|
||||
tar -xvf ch_PP-OCRv3_det_infer.tar
|
||||
# 下载文字方向分类器模型
|
||||
wget https://paddleocr.bj.bcebos.com/dygraph_v2.0/ch/ch_ppocr_mobile_v2.0_cls_infer.tar
|
||||
tar -xvf ch_ppocr_mobile_v2.0_cls_infer.tar
|
||||
# 下载PP-OCRv3文字识别模型
|
||||
wget https://paddleocr.bj.bcebos.com/PP-OCRv3/chinese/ch_PP-OCRv3_rec_infer.tar
|
||||
tar -xvf ch_PP-OCRv3_rec_infer.tar
|
||||
|
||||
# 请用户自行安装最新发布版本的paddle2onnx, 转换模型到ONNX格式的模型
|
||||
paddle2onnx --model_dir ch_PP-OCRv3_det_infer \
|
||||
--model_filename inference.pdmodel \
|
||||
--params_filename inference.pdiparams \
|
||||
--save_file ch_PP-OCRv3_det_infer/ch_PP-OCRv3_det_infer.onnx \
|
||||
--enable_dev_version True
|
||||
paddle2onnx --model_dir ch_ppocr_mobile_v2.0_cls_infer \
|
||||
--model_filename inference.pdmodel \
|
||||
--params_filename inference.pdiparams \
|
||||
--save_file ch_ppocr_mobile_v2.0_cls_infer/ch_ppocr_mobile_v2.0_cls_infer.onnx \
|
||||
--enable_dev_version True
|
||||
paddle2onnx --model_dir ch_PP-OCRv3_rec_infer \
|
||||
--model_filename inference.pdmodel \
|
||||
--params_filename inference.pdiparams \
|
||||
--save_file ch_PP-OCRv3_rec_infer/ch_PP-OCRv3_rec_infer.onnx \
|
||||
--enable_dev_version True
|
||||
|
||||
# 固定模型的输入shape
|
||||
python -m paddle2onnx.optimize --input_model ch_PP-OCRv3_det_infer/ch_PP-OCRv3_det_infer.onnx \
|
||||
--output_model ch_PP-OCRv3_det_infer/ch_PP-OCRv3_det_infer.onnx \
|
||||
--input_shape_dict "{'x':[1,3,960,960]}"
|
||||
python -m paddle2onnx.optimize --input_model ch_ppocr_mobile_v2.0_cls_infer/ch_ppocr_mobile_v2.0_cls_infer.onnx \
|
||||
--output_model ch_ppocr_mobile_v2.0_cls_infer/ch_ppocr_mobile_v2.0_cls_infer.onnx \
|
||||
--input_shape_dict "{'x':[1,3,48,192]}"
|
||||
python -m paddle2onnx.optimize --input_model ch_PP-OCRv3_rec_infer/ch_PP-OCRv3_rec_infer.onnx \
|
||||
--output_model ch_PP-OCRv3_rec_infer/ch_PP-OCRv3_rec_infer.onnx \
|
||||
--input_shape_dict "{'x':[1,3,48,320]}"
|
||||
|
||||
# 在rockchip/rknpu2_tools/目录下, 我们为用户提供了转换ONNX模型到RKNN模型的工具
|
||||
python rockchip/rknpu2_tools/export.py --config_path tools/rknpu2/config/ppocrv3_det.yaml \
|
||||
--target_platform rk3588
|
||||
python rockchip/rknpu2_tools/export.py --config_path tools/rknpu2/config/ppocrv3_rec.yaml \
|
||||
--target_platform rk3588
|
||||
python rockchip/rknpu2_tools/export.py --config_path tools/rknpu2/config/ppocrv3_cls.yaml \
|
||||
--target_platform rk3588
|
||||
```
|
||||
|
||||
|
||||
## 3.运行部署示例
|
||||
在本目录执行如下命令即可完成编译测试,支持此模型需保证FastDeploy版本1.0.3以上(x.x.x>1.0.3), RKNN版本在1.4.1b22以上。
|
||||
|
||||
```
|
||||
# 下载图片和字典文件
|
||||
wget https://gitee.com/paddlepaddle/PaddleOCR/raw/release/2.6/doc/imgs/12.jpg
|
||||
wget https://gitee.com/paddlepaddle/PaddleOCR/raw/release/2.6/ppocr/utils/ppocr_keys_v1.txt
|
||||
|
||||
# 下载部署示例代码
|
||||
# 下载部署示例代码
|
||||
git clone https://github.com/PaddlePaddle/FastDeploy.git
|
||||
cd FastDeploy/examples/vision/ocr/PP-OCR/rockchip/python
|
||||
|
||||
# 如果您希望从PaddleOCR下载示例代码,请运行
|
||||
git clone https://github.com/PaddlePaddle/PaddleOCR.git
|
||||
# 注意:如果当前分支找不到下面的fastdeploy测试代码,请切换到dygraph分支
|
||||
git checkout dygraph
|
||||
cd PaddleOCR/deploy/fastdeploy/rockchip/python
|
||||
|
||||
|
||||
# CPU推理
|
||||
python3 infer.py \
|
||||
--det_model ./ch_PP-OCRv3_det_infer/ch_PP-OCRv3_det_infer.onnx \
|
||||
--cls_model ./ch_ppocr_mobile_v2.0_cls_infer/ch_ppocr_mobile_v2.0_cls_infer.onnx \
|
||||
--rec_model ./ch_PP-OCRv3_rec_infer/ch_PP-OCRv3_rec_infer.onnx \
|
||||
--rec_label_file ./ppocr_keys_v1.txt \
|
||||
--image 12.jpg \
|
||||
--device cpu
|
||||
|
||||
# NPU推理
|
||||
python3 infer.py \
|
||||
--det_model ./ch_PP-OCRv3_det_infer/ch_PP-OCRv3_det_infer_rk3588_unquantized.rknn \
|
||||
--cls_model ./ch_ppocr_mobile_v2.0_cls_infer/ch_ppocr_mobile_v20_cls_infer_rk3588_unquantized.rknn \
|
||||
--rec_model ./ch_PP-OCRv3_rec_infer/ch_PP-OCRv3_rec_infer_rk3588_unquantized.rknn \
|
||||
--rec_label_file ppocr_keys_v1.txt \
|
||||
--image 12.jpg \
|
||||
--device npu
|
||||
```
|
||||
|
||||
运行完成可视化结果如下图所示
|
||||
<img width="640" src="https://user-images.githubusercontent.com/109218879/185826024-f7593a0c-1bd2-4a60-b76c-15588484fa08.jpg">
|
||||
|
||||
## 4. 更多指南
|
||||
- [PP-OCR系列 Python API查阅](https://www.paddlepaddle.org.cn/fastdeploy-api-doc/python/html/ocr.html)
|
||||
- [FastDeploy部署PaddleOCR模型概览](../../)
|
||||
- [PP-OCRv3 C++部署](../cpp)
|
||||
- [FastDeploy RKNPU2资源导航](https://github.com/PaddlePaddle/FastDeploy/blob/develop/docs/cn/build_and_install/rknpu2.md)
|
||||
- 如果用户想要调整前后处理超参数、单独使用文字检测识别模型、使用其他模型等,更多详细文档与说明请参考[PP-OCR系列在CPU/GPU上的部署](../../cpu-gpu/python/README.md)
|
||||
@@ -0,0 +1,144 @@
|
||||
# Copyright (c) 2022 PaddlePaddle Authors. All Rights Reserved.
|
||||
#
|
||||
# Licensed under the Apache License, Version 2.0 (the "License");
|
||||
# you may not use this file except in compliance with the License.
|
||||
# You may obtain a copy of the License at
|
||||
#
|
||||
# http://www.apache.org/licenses/LICENSE-2.0
|
||||
#
|
||||
# Unless required by applicable law or agreed to in writing, software
|
||||
# distributed under the License is distributed on an "AS IS" BASIS,
|
||||
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
# See the License for the specific language governing permissions and
|
||||
# limitations under the License.
|
||||
|
||||
import fastdeploy as fd
|
||||
import cv2
|
||||
import os
|
||||
|
||||
|
||||
def parse_arguments():
|
||||
import argparse
|
||||
import ast
|
||||
parser = argparse.ArgumentParser()
|
||||
parser.add_argument(
|
||||
"--det_model", required=True, help="Path of Detection model of PPOCR.")
|
||||
parser.add_argument(
|
||||
"--cls_model",
|
||||
required=True,
|
||||
help="Path of Classification model of PPOCR.")
|
||||
parser.add_argument(
|
||||
"--rec_model",
|
||||
required=True,
|
||||
help="Path of Recognization model of PPOCR.")
|
||||
parser.add_argument(
|
||||
"--rec_label_file",
|
||||
required=True,
|
||||
help="Path of Recognization model of PPOCR.")
|
||||
parser.add_argument(
|
||||
"--image", type=str, required=True, help="Path of test image file.")
|
||||
parser.add_argument(
|
||||
"--device",
|
||||
type=str,
|
||||
default='cpu',
|
||||
help="Type of inference device, support 'cpu', 'kunlunxin' or 'gpu'.")
|
||||
parser.add_argument(
|
||||
"--cpu_thread_num",
|
||||
type=int,
|
||||
default=9,
|
||||
help="Number of threads while inference on CPU.")
|
||||
return parser.parse_args()
|
||||
|
||||
|
||||
def build_option(args):
|
||||
|
||||
det_option = fd.RuntimeOption()
|
||||
cls_option = fd.RuntimeOption()
|
||||
rec_option = fd.RuntimeOption()
|
||||
if args.device == "npu":
|
||||
det_option.use_rknpu2()
|
||||
cls_option.use_rknpu2()
|
||||
rec_option.use_rknpu2()
|
||||
|
||||
return det_option, cls_option, rec_option
|
||||
|
||||
|
||||
def build_format(args):
|
||||
det_format = fd.ModelFormat.ONNX
|
||||
cls_format = fd.ModelFormat.ONNX
|
||||
rec_format = fd.ModelFormat.ONNX
|
||||
if args.device == "npu":
|
||||
det_format = fd.ModelFormat.RKNN
|
||||
cls_format = fd.ModelFormat.RKNN
|
||||
rec_format = fd.ModelFormat.RKNN
|
||||
|
||||
return det_format, cls_format, rec_format
|
||||
|
||||
|
||||
args = parse_arguments()
|
||||
|
||||
# Detection模型, 检测文字框
|
||||
det_model_file = args.det_model
|
||||
det_params_file = ""
|
||||
# Classification模型,方向分类,可选
|
||||
cls_model_file = args.cls_model
|
||||
cls_params_file = ""
|
||||
# Recognition模型,文字识别模型
|
||||
rec_model_file = args.rec_model
|
||||
rec_params_file = ""
|
||||
rec_label_file = args.rec_label_file
|
||||
|
||||
det_option, cls_option, rec_option = build_option(args)
|
||||
det_format, cls_format, rec_format = build_format(args)
|
||||
|
||||
det_model = fd.vision.ocr.DBDetector(
|
||||
det_model_file,
|
||||
det_params_file,
|
||||
runtime_option=det_option,
|
||||
model_format=det_format)
|
||||
|
||||
cls_model = fd.vision.ocr.Classifier(
|
||||
cls_model_file,
|
||||
cls_params_file,
|
||||
runtime_option=cls_option,
|
||||
model_format=cls_format)
|
||||
|
||||
rec_model = fd.vision.ocr.Recognizer(
|
||||
rec_model_file,
|
||||
rec_params_file,
|
||||
rec_label_file,
|
||||
runtime_option=rec_option,
|
||||
model_format=rec_format)
|
||||
|
||||
# Det,Rec模型启用静态shape推理
|
||||
det_model.preprocessor.static_shape_infer = True
|
||||
rec_model.preprocessor.static_shape_infer = True
|
||||
|
||||
if args.device == "npu":
|
||||
det_model.preprocessor.disable_normalize()
|
||||
det_model.preprocessor.disable_permute()
|
||||
cls_model.preprocessor.disable_normalize()
|
||||
cls_model.preprocessor.disable_permute()
|
||||
rec_model.preprocessor.disable_normalize()
|
||||
rec_model.preprocessor.disable_permute()
|
||||
|
||||
# 创建PP-OCR,串联3个模型,其中cls_model可选,如无需求,可设置为None
|
||||
ppocr_v3 = fd.vision.ocr.PPOCRv3(
|
||||
det_model=det_model, cls_model=cls_model, rec_model=rec_model)
|
||||
|
||||
# Cls模型和Rec模型的batch size 必须设置为1, 开启静态shape推理
|
||||
ppocr_v3.cls_batch_size = 1
|
||||
ppocr_v3.rec_batch_size = 1
|
||||
|
||||
# 预测图片准备
|
||||
im = cv2.imread(args.image)
|
||||
|
||||
#预测并打印结果
|
||||
result = ppocr_v3.predict(im)
|
||||
|
||||
print(result)
|
||||
|
||||
# 可视化结果
|
||||
vis_im = fd.vision.vis_ppocr(im, result)
|
||||
cv2.imwrite("visualized_result.jpg", vis_im)
|
||||
print("Visualized result save in ./visualized_result.jpg")
|
||||
Reference in New Issue
Block a user