README_ch.md 7.4 KB
Newer Older
G
grasswolfs 已提交
1
[English](README.md) | 简体中文
W
WenmuZhou 已提交
2

G
grasswolfs 已提交
3
# PP-Structure
W
WenmuZhou 已提交
4

G
grasswolfs 已提交
5 6 7 8 9 10 11
PP-Structure是一个可用于复杂文档结构分析和处理的OCR工具包,主要特性如下:
- 支持对图片形式的文档进行版面分析,可以划分**文字、标题、表格、图片以及列表**5类区域(与Layout-Parser联合使用)
- 支持文字、标题、图片以及列表区域提取为文字字段(与PP-OCR联合使用)
- 支持表格区域进行结构化分析,最终结果输出Excel文件
- 支持python whl包和命令行两种方式,简单易用
- 支持版面分析和表格结构化两类任务自定义训练
- 总模型大小仅有18.6M(持续优化)
W
WenmuZhou 已提交
12

G
grasswolfs 已提交
13
## 1. 效果展示
W
WenmuZhou 已提交
14

G
grasswolfs 已提交
15
<img src="../doc/table/ppstructure.GIF" width="100%"/>
16 17 18



G
grasswolfs 已提交
19
## 2. 安装
20

G
grasswolfs 已提交
21
### 2.1 安装依赖
22

G
grasswolfs 已提交
23
- **(1) 安装PaddlePaddle**
24 25

```bash
G
grasswolfs 已提交
26
pip3 install --upgrade pip
27

G
grasswolfs 已提交
28 29
# GPU安装
python3 -m pip install paddlepaddle-gpu==2.1.2 -i https://mirror.baidu.com/pypi/simple
30

G
grasswolfs 已提交
31 32
# CPU安装
 python3 -m pip install paddlepaddle==2.1.2 -i https://mirror.baidu.com/pypi/simple
33

G
grasswolfs 已提交
34
# 更多需求,请参照[安装文档](https://www.paddlepaddle.org.cn/install/quick)中的说明进行操作。
35 36
```

G
grasswolfs 已提交
37
- **(2) 安装 Layout-Parser**
W
WenmuZhou 已提交
38

39
```bash
G
grasswolfs 已提交
40
pip3 install -U premailer paddleocr https://paddleocr.bj.bcebos.com/whl/layoutparser-0.0.0-py3-none-any.whl
41 42
```

G
grasswolfs 已提交
43 44 45 46
### 2.2 安装PaddleOCR(包含PP-OCR和PP-Structure)

- **(1) PIP快速安装PaddleOCR whl包(仅预测)**

47
```bash
G
grasswolfs 已提交
48
pip install "paddleocr>=2.0.6" # 推荐使用2.0.1+版本
49
```
W
WenmuZhou 已提交
50

G
grasswolfs 已提交
51 52 53 54 55 56 57 58 59
- **(2) 完整克隆PaddleOCR源码(预测+训练)**

```bash
【推荐】git clone https://github.com/PaddlePaddle/PaddleOCR

#如果因为网络问题无法pull成功,也可选择使用码云上的托管:
git clone https://gitee.com/paddlepaddle/PaddleOCR

#注:码云托管代码可能无法实时同步本github项目更新,存在3~5天延时,请优先使用推荐方式。
W
opt doc  
WenmuZhou 已提交
60
```
W
WenmuZhou 已提交
61 62


G
grasswolfs 已提交
63 64 65
## 3 PP-Structure 快速开始

### 3.1 命令行使用(默认参数,极简)
W
WenmuZhou 已提交
66

W
opt doc  
WenmuZhou 已提交
67
```bash
W
WenmuZhou 已提交
68
paddleocr --image_dir=../doc/table/1.png --type=structure
W
opt doc  
WenmuZhou 已提交
69 70
```

G
grasswolfs 已提交
71
### 3.2 Python脚本使用(自定义参数,灵活)
W
WenmuZhou 已提交
72 73

```python
W
WenmuZhou 已提交
74
import os
W
WenmuZhou 已提交
75
import cv2
W
WenmuZhou 已提交
76
from paddleocr import PPStructure,draw_structure_result,save_structure_res
W
WenmuZhou 已提交
77

W
WenmuZhou 已提交
78
table_engine = PPStructure(show_log=True)
W
WenmuZhou 已提交
79

W
WenmuZhou 已提交
80
save_folder = './output/table'
W
WenmuZhou 已提交
81 82 83
img_path = '../doc/table/1.png'
img = cv2.imread(img_path)
result = table_engine(img)
W
WenmuZhou 已提交
84
save_structure_res(result, save_folder,os.path.basename(img_path).split('.')[0])
W
WenmuZhou 已提交
85

W
WenmuZhou 已提交
86
for line in result:
W
WenmuZhou 已提交
87
    line.pop('img')
W
WenmuZhou 已提交
88 89 90 91
    print(line)

from PIL import Image

W
opt doc  
WenmuZhou 已提交
92
font_path = '../doc/fonts/simfang.ttf' # PaddleOCR下提供字体包
W
WenmuZhou 已提交
93
image = Image.open(img_path).convert('RGB')
W
WenmuZhou 已提交
94
im_show = draw_structure_result(image, result,font_path=font_path)
W
WenmuZhou 已提交
95 96 97 98
im_show = Image.fromarray(im_show)
im_show.save('result.jpg')
```

G
grasswolfs 已提交
99
### 3.3 返回结果说明
W
WenmuZhou 已提交
100 101 102 103
PaddleStructure 的返回结果为一个dict组成的list,示例如下

```shell
[
G
grasswolfs 已提交
104 105 106
  {   'type': 'Text',
      'bbox': [34, 432, 345, 462],
      'res': ([[36.0, 437.0, 341.0, 437.0, 341.0, 446.0, 36.0, 447.0], [41.0, 454.0, 125.0, 453.0, 125.0, 459.0, 41.0, 460.0]],
W
WenmuZhou 已提交
107 108 109 110 111 112
                [('Tigure-6. The performance of CNN and IPT models using difforen', 0.90060663), ('Tent  ', 0.465441)])
  }
]
```
dict 里各个字段说明如下

G
grasswolfs 已提交
113
| 字段            | 说明           |
W
WenmuZhou 已提交
114 115 116 117 118
| --------------- | -------------|
|type|图片区域的类型|
|bbox|图片区域的在原图的坐标,分别[左上角x,左上角y,右下角x,右下角y]|
|res|图片区域的OCR或表格识别结果。<br> 表格: 表格的HTML字符串; <br> OCR: 一个包含各个单行文字的检测坐标和识别结果的元组|

W
WenmuZhou 已提交
119

G
grasswolfs 已提交
120
### 3.4 参数说明
W
opt doc  
WenmuZhou 已提交
121 122 123 124 125 126 127 128

| 字段            | 说明                                     | 默认值                                      |
| --------------- | ---------------------------------------- | ------------------------------------------- |
| output          | excel和识别结果保存的地址                | ./output/table                              |
| table_max_len   | 表格结构模型预测时,图像的长边resize尺度 | 488                                         |
| table_model_dir | 表格结构模型 inference 模型地址          | None                                        |
| table_char_type | 表格结构模型所用字典地址                 | ../ppocr/utils/dict/table_structure_dict.tx |

W
WenmuZhou 已提交
129 130
大部分参数和paddleocr whl包保持一致,见 [whl包文档](../doc/doc_ch/whl.md)

W
WenmuZhou 已提交
131
运行完成后,每张图片会在`output`字段指定的目录下有一个同名目录,图片里的每个表格会存储为一个excel,图片区域会被裁剪之后保存下来,excel文件和图片名名为表格在图片里的坐标。
W
opt doc  
WenmuZhou 已提交
132 133


G
grasswolfs 已提交
134
## 4. PP-Structure Pipeline介绍
W
opt doc  
WenmuZhou 已提交
135 136 137

![pipeline](../doc/table/pipeline.jpg)

G
grasswolfs 已提交
138
在PP-Structure中,图片会先经由Layout-Parser进行版面分析,在版面分析中,会对图片里的区域进行分类,包括**文字、标题、图片、列表和表格**5类。对于前4类区域,直接使用PP-OCR完成对应区域文字检测与识别。对于表格类区域,经过表格结构化处理后,表格图片转换为相同表格样式的Excel文件。
W
opt doc  
WenmuZhou 已提交
139

G
grasswolfs 已提交
140
### 4.1 版面分析
W
opt doc  
WenmuZhou 已提交
141

G
grasswolfs 已提交
142
版面分析对文档数据进行区域分类,其中包括版面分析工具的Python脚本使用、提取指定类别检测框、性能指标以及自定义训练版面分析模型,详细内容可以参考[文档](layout/README_ch.md)
W
opt doc  
WenmuZhou 已提交
143

G
grasswolfs 已提交
144
### 4.2 表格结构化
W
opt doc  
WenmuZhou 已提交
145

G
grasswolfs 已提交
146
表格结构化将表格图片转换为excel文档,其中包含对于表格文本的检测和识别以及对于表格结构和单元格坐标的预测,详细说明参考[文档](table/README_ch.md)
W
opt doc  
WenmuZhou 已提交
147

G
grasswolfs 已提交
148
## 5. 预测引擎推理(与whl包效果相同)
W
opt doc  
WenmuZhou 已提交
149 150 151 152

使用如下命令即可完成预测引擎的推理

```python
153
cd ppstructure
W
WenmuZhou 已提交
154 155 156 157 158 159 160 161 162 163 164 165

# 下载模型
mkdir inference && cd inference
# 下载超轻量级中文OCR模型的检测模型并解压
wget https://paddleocr.bj.bcebos.com/dygraph_v2.0/ch/ch_ppocr_mobile_v2.0_det_infer.tar && tar xf ch_ppocr_mobile_v2.0_det_infer.tar
# 下载超轻量级中文OCR模型的识别模型并解压
wget https://paddleocr.bj.bcebos.com/dygraph_v2.0/ch/ch_ppocr_mobile_v2.0_rec_infer.tar && tar xf ch_ppocr_mobile_v2.0_rec_infer.tar
# 下载超轻量级英文表格英寸模型并解压
wget https://paddleocr.bj.bcebos.com/dygraph_v2.0/table/en_ppocr_mobile_v2.0_table_structure_infer.tar && tar xf en_ppocr_mobile_v2.0_table_structure_infer.tar
cd ..

python3 table/predict_system.py --det_model_dir=inference/ch_ppocr_mobile_v2.0_det_infer --rec_model_dir=inference/ch_ppocr_mobile_v2.0_rec_infer --table_model_dir=inference/en_ppocr_mobile_v2.0_table_structure_infer --image_dir=../doc/table/1.png --rec_char_dict_path=../ppocr/utils/ppocr_keys_v1.txt --table_char_dict_path=../ppocr/utils/dict/table_structure_dict.txt --rec_char_type=ch --det_limit_side_len=736 --det_limit_type=min --output=../output/table --vis_font_path=../doc/fonts/simfang.ttf
W
opt doc  
WenmuZhou 已提交
166
```
W
WenmuZhou 已提交
167
运行完成后,每张图片会在`output`字段指定的目录下有一个同名目录,图片里的每个表格会存储为一个excel,图片区域会被裁剪之后保存下来,excel文件和图片名名为表格在图片里的坐标。
W
opt doc  
WenmuZhou 已提交
168

W
WenmuZhou 已提交
169
**Model List**
W
WenmuZhou 已提交
170

W
opt doc  
WenmuZhou 已提交
171 172
|模型名称|模型简介|配置文件|推理模型大小|下载地址|
| --- | --- | --- | --- | --- |
G
grasswolfs 已提交
173
|en_ppocr_mobile_v2.0_table_structure|英文表格场景的表格结构预测|[table_mv3.yml](../configs/table/table_mv3.yml)|18.6M|[推理模型](https://paddleocr.bj.bcebos.com/dygraph_v2.0/table/en_ppocr_mobile_v2.0_table_structure_infer.tar) |