ch_PP-OCRv2_det模型-推理指导

• 概述

• 推理环境准备

• 快速上手

  • 获取源码
  • 准备数据集
  • 模型推理

• 模型推理性能

概述

ch_PP-OCRv2_det是基于PP-OCRv2的中文文本检测模型，PP-OCRv2在PP-OCR的基础上，进一步在5个方面重点优化，检测模型采用CML协同互学习知识蒸馏策略和CopyPaste数据增广策略；识别模型采用LCNet轻量级骨干网络、UDML 改进知识蒸馏策略和Enhanced CTC loss损失函数改进，进一步在推理速度和预测效果上取得明显提升。

• 参考实现：

  url=https://github.com/PaddlePaddle/PaddleOCR.git
  branch=release/2.6
  commit_id=274c216c6771a94807a34fb94377a1d7d674a69f
  model_name=ch_PP-OCRv2_det
  

输入输出数据

• 输入数据

  输入数据	数据类型	大小	数据排布格式
  input	RGB_FP32	batchsize x 3 x imgH x imgW	NCHW

• 输出数据

  输出数据	数据类型	大小	数据排布格式
  output1	FLOAT32	batchsize x 1 x imgH x imgW	NCHW

推理环境准备[所有版本]

• 该模型需要以下插件与驱动

  表 1 版本配套表

配套	版本	环境准备指导
固件与驱动	22.0.2	Pytorch框架推理环境准备
CANN	5.1.RC2	-
Python	3.7.5	-
paddlepaddle	2.3.2	仅支持x86服务器安装
说明：Atlas 300I Duo 推理卡请以CANN版本选择实际固件与驱动版本。	\	\

快速上手

获取源码

1. 获取源码。

   git clone -b release/2.6 https://github.com/PaddlePaddle/PaddleOCR.git
   cd PaddleOCR 
   git reset --hard 274c216c6771a94807a34fb94377a1d7d674a69f
   git apply ../ch_PP-OCRv2_det.patch
   cd ..
   

2. 安装依赖。

   pip3 install -r requirements.txt
   cd PaddleOCR
   python setup.py install
   cd ..
   

准备数据集

1. 获取原始数据集。

   精度测试数据集使用PaddleOCR提供的中文测试样例集，该样例集的目录为ch_PP-OCRv2_det/PaddleOCR/doc/imgs/，包括20张图片样本，由于样本model_prod_flow_ch.png图片过大，可能会超出了算子计算范围，故将其移除。在ch_PP-OCRv2_det工作目录下执行如下命令获取样例集：

    cp -r ./PaddleOCR/doc/imgs/ ./
    rm -rf ./imgs/model_prod_flow_ch.png
   

2. 数据预处理。

   数据预处理将原始数据集转换为模型输入的数据。

   在ch_PP-OCRv2_det工作目录下，执行ch_PP-OCRv2_det_preprocess.py脚本，完成预处理。

    python ch_PP-OCRv2_det_preprocess.py \
        -c PaddleOCR/configs/det/ch_PP-OCRv2/ch_PP-OCRv2_det_cml.yml \
        -o Global.infer_img=./imgs/
   

   • 参数说明：

     • -c：模型配置文件。
     • -o：可选参数列表: Global.infer_img表示图片路径。

   运行后在当前目录下的pre_data路径中保存生成的numpy数据。

模型推理

1. 模型转换。

   使用paddle2onnx将模型权重文件转换为.onnx文件，再使用ATC工具将.onnx文件转为离线推理模型文件.om文件。

   1. 获取权重文件。

训练模型（在线推理使用）链接为：

推理模型链接为：

   辅助训练模型（在线推理使用）链接为：https://paddleocr.bj.bcebos.com/dygraph_v2.0/ch/ch_ppocr_server_v2.0_det_train.tar

   在`ch_PP-OCRv2_det`工作目录下可通过以下命令获取训练模型、推理模型和辅助模型。

   ```
   wget -nc -P ./checkpoint https://paddleocr.bj.bcebos.com/PP-OCRv2/chinese/ch_PP-OCRv2_det_distill_train.tar
   cd ./checkpoint && tar xf ch_PP-OCRv2_det_distill_train.tar && cd ..

   wget -nc -P ./inference https://paddleocr.bj.bcebos.com/PP-OCRv2/chinese/ch_PP-OCRv2_det_infer.tar
   cd ./inference && tar xf ch_PP-OCRv2_det_infer.tar && cd ..


   wget -nc -P ./pretrain_models https://paddleocr.bj.bcebos.com/dygraph_v2.0/ch/ch_ppocr_server_v2.0_det_train.tar
   cd ./pretrain_models && tar xf ch_ppocr_server_v2.0_det_train.tar && cd ..
   ```

2. 导出onnx文件。

   1. 使用paddle2onnx工具导出onnx文件。

      在ch_PP-OCRv2_det工作目录下通过运行以下命令获取onnx模型。

      paddle2onnx \
          --model_dir ./inference/ch_PP-OCRv2_det_infer \
          --model_filename inference.pdmodel \
          --params_filename inference.pdiparams \
          --save_file ./ch_PP-OCRv2_det.onnx \
          --opset_version 11 \
          --enable_onnx_checker True \
          --input_shape_dict="{'x':[-1,3,-1,-1]}"
      

      参数说明请通过paddle2onnx -h命令查看。 运行后在ch_PP-OCRv2_det目录下获得ch_PP-OCRv2_det.onnx文件。

3. 使用ATC工具将ONNX模型转OM模型。

   1. 配置环境变量。

      source /usr/local/Ascend/ascend-toolkit/set_env.sh
      

      说明： 该脚本中环境变量仅供参考，请以实际安装环境配置环境变量。详细介绍请参见《CANN 开发辅助工具指南 (推理)》。

   2. 执行命令查看芯片名称（${chip_name}）。

      npu-smi info
      #该设备芯片名为Ascend310P3 （自行替换）
      回显如下：
      +-------------------+-----------------+------------------------------------------------------+
      | NPU     Name      | Health          | Power(W)     Temp(C)           Hugepages-Usage(page) |
      | Chip    Device    | Bus-Id          | AICore(%)    Memory-Usage(MB)                        |
      +===================+=================+======================================================+
      | 0       310P3     | OK              | 15.8         42                0    / 0              |
      | 0       0         | 0000:82:00.0    | 0            1074 / 21534                            |
      +===================+=================+======================================================+
      | 1       310P3     | OK              | 15.4         43                0    / 0              |
      | 0       1         | 0000:89:00.0    | 0            1070 / 21534                            |
      +===================+=================+======================================================+
      

   3. 执行ATC命令。

      atc --framework=5 \
          --model=./ch_PP-OCRv2_det.onnx \
          --output=./ch_PP-OCRv2_det_bs1 \
          --input_format=ND \
          --input_shape="x:1,3,-1,-1" \
          --soc_version=Ascend${chip_name} \
          --dynamic_dims="736,736;736,800;736,960;736,992;736,1184;736,1248;736,1280;768,928;832,1536;992,736;1088,736;1184,736"
      

      • 参数说明：

        • --model：为ONNX模型文件。
        • --framework：5代表ONNX模型。
        • --output：输出的OM模型。
        • --input_format：输入数据的格式。
        • --input_shape：输入数据的shape。
        • --log：日志级别。
        • --soc_version：处理器型号。
        • --dynamic_dims：设置输入图片的动态分辨率参数。适用于执行推理时，每次处理图片宽和高不固定的场景。

        运行成功后生成ch_PP-OCRv2_det_bs1.om模型文件。

4. 开始推理验证。

   a. 安装ais_bench推理工具。

   请访问ais_bench推理工具代码仓，根据readme文档进行工具安装。

   b. 执行推理。 在当前目录下运行以下指令

   python -m ais_bench --model=ch_PP-OCRv2_det_bs1.om --input=pre_data --output=./ --output_dirname=results_bs1 --auto_set_dymdims_mode=1 --outfmt=NPY
   

   • 参数说明：
     • --model：om模型路径。
     • --inputs：输入数据集路径。
     • --batchsize：om模型输入的batchsize。
     • --auto_set_dymdims_mode：设置自动匹配动态shape
     • --outfmt：输出数据格式 推理结果保存在当前目录的results_bs1文件夹下

   c. 精度验证。

   执行后处理脚本ch_PP-OCRv2_det_postprocess.py，参考命令如下：

   python ch_PP-OCRv2_det_postprocess.py \
       -c PaddleOCR/configs/det/ch_PP-OCRv2/ch_PP-OCRv2_det_cml.yml \
       -o Global.infer_img="./imgs/" Global.infer_results=result_bs1
   

   • 参数说明：

     • -c：模型配置文件。
     • -o：可选参数：Global.infer_img表示样本图片路径，Global.infer_results表示om推理结果路径。

   result_bs1为推理结果的保存路径，命令执行完成后，每个推理结果对应的检测图片保存在result_bs1/det_results/目录下：

   在线推理命令如下：

   python PaddleOCR/tools/infer_det.py \
       -c PaddleOCR/configs/det/ch_PP-OCRv2/ch_PP-OCRv2_det_cml.yml \
       -o Global.infer_img="./imgs/" \
       Global.pretrained_model="./checkpoint/ch_PP-OCRv2_det_distill_train/best_accuracy"
   

   执行完成后在线推理结果保存在ch_PP-OCRv2_det/output/det_db/det_results_Teacher/目录下。

   可以将om后处理得到的样例图片的推理结果，与在线推理得到的样例图片的推理结果进行对比，观察文本检测框的效果，来验证om的推理精度。

模型推理性能&精度

调用ACL接口推理计算，性能参考下列数据。

芯片型号	Batch Size	数据集	精度	性能
300I Pro	1	样例图片	见备注	232 fps

• 备注：可以将om后处理得到的样例图片的推理结果，与在线推理得到的样例图片的推理结果进行对比，观察文本检测框的效果，来验证om的推理精度。