INSTALL_cn.md 3.9 KB
Newer Older
1
[English](INSTALL.md) | 简体中文
Q
qingqing01 已提交
2 3


4
# 安装文档
Q
qingqing01 已提交
5 6 7



8
## 环境要求
Q
qingqing01 已提交
9

G
Guanghua Yu 已提交
10
- PaddlePaddle 2.2
Q
qingqing01 已提交
11
- OS 64位操作系统
G
Guanghua Yu 已提交
12
- Python 3(3.5.1+/3.6/3.7/3.8/3.9),64位版本
F
Feng Ni 已提交
13
- pip/pip3(9.0.1+),64位版本
G
Guanghua Yu 已提交
14
- CUDA >= 10.1
Q
qingqing01 已提交
15 16
- cuDNN >= 7.6

17 18 19 20
PaddleDetection 依赖 PaddlePaddle 版本关系:

|  PaddleDetection版本  | PaddlePaddle版本  |    备注    |
| :------------------: | :---------------: | :-------: |
K
Kaipeng Deng 已提交
21 22 23
|    develop           |       >= 2.2.2    |     默认使用动态图模式    |
|    release/2.4       |       >= 2.2.2    |     默认使用动态图模式    |
|    release/2.3       |       >= 2.2.0rc  |     默认使用动态图模式    |
24
|    release/2.2       |       >= 2.1.2    |     默认使用动态图模式    |
G
Guanghua Yu 已提交
25
|    release/2.1       |       >= 2.1.0    |     默认使用动态图模式    |
26 27 28 29 30
|    release/2.0       |       >= 2.0.1    |     默认使用动态图模式    |
|    release/2.0-rc    |       >= 2.0.1    |     --    |
|    release/0.5       |       >= 1.8.4    |  大部分模型>=1.8.4即可运行,Cascade R-CNN系列模型与SOLOv2依赖2.0.0.rc版本 |
|    release/0.4       |       >= 1.8.4    |  PP-YOLO依赖1.8.4 |
|    release/0.3       |        >=1.7      |     --    |
Q
qingqing01 已提交
31

32
## 安装说明
Q
qingqing01 已提交
33

K
Kaipeng Deng 已提交
34
### 1. 安装PaddlePaddle
35 36 37

```
# CUDA10.1
G
Guanghua Yu 已提交
38
python -m pip install paddlepaddle-gpu==2.2.0.post101 -f https://www.paddlepaddle.org.cn/whl/linux/mkl/avx/stable.html
39 40 41 42

# CPU
python -m pip install paddlepaddle -i https://mirror.baidu.com/pypi/simple
```
G
Guanghua Yu 已提交
43 44
- 更多CUDA版本或环境快速安装,请参考[PaddlePaddle快速安装文档](https://www.paddlepaddle.org.cn/install/quick)
- 更多安装方式例如conda或源码编译安装方法,请参考[PaddlePaddle安装文档](https://www.paddlepaddle.org.cn/documentation/docs/zh/install/index_cn.html)
Q
qingqing01 已提交
45

46
请确保您的PaddlePaddle安装成功并且版本不低于需求版本。使用以下命令进行验证。
Q
qingqing01 已提交
47

48 49 50 51 52 53 54 55 56 57
```
# 在您的Python解释器中确认PaddlePaddle安装成功
>>> import paddle
>>> paddle.utils.run_check()

# 确认PaddlePaddle版本
python -c "import paddle; print(paddle.__version__)"
```
**注意**
1. 如果您希望在多卡环境下使用PaddleDetection,请首先安装NCCL
Q
qingqing01 已提交
58

K
Kaipeng Deng 已提交
59 60 61
### 2. 安装PaddleDetection


Y
yzl19940819 已提交
62

K
Kaipeng Deng 已提交
63 64 65 66

**注意:** pip安装方式只支持Python3


Q
qingqing01 已提交
67 68

```
69
# 克隆PaddleDetection仓库
Q
qingqing01 已提交
70 71
cd <path/to/clone/PaddleDetection>
git clone https://github.com/PaddlePaddle/PaddleDetection.git
72

73
# 安装其他依赖
74
cd PaddleDetection
75 76
pip install -r requirements.txt

K
Kaipeng Deng 已提交
77 78
# 编译安装paddledet
python setup.py install
Q
qingqing01 已提交
79 80
```

81
**注意**
Y
yzl19940819 已提交
82
1. 如果github下载代码较慢,可尝试使用[gitee](https://gitee.com/PaddlePaddle/PaddleDetection.git)或者[代理加速](https://doc.fastgit.org/zh-cn/guide.html)
83

K
Kaipeng Deng 已提交
84
1. 若您使用的是Windows系统,由于原版cocoapi不支持Windows,`pycocotools`依赖可能安装失败,可采用第三方实现版本,该版本仅支持Python3
85 86 87

    ```pip install git+https://github.com/philferriere/cocoapi.git#subdirectory=PythonAPI```

88 89
2. 若您使用的是Python <= 3.6的版本安装`pycocotools`可能会报错`distutils.errors.DistutilsError: Could not find suitable distribution for Requirement.parse('cython>=0.27.3')`, 您可通过先安装`cython`如`pip install cython`解决该问题

90 91 92

安装后确认测试通过:

Q
qingqing01 已提交
93
```
94
python ppdet/modeling/tests/test_architectures.py
Q
qingqing01 已提交
95
```
K
Kaipeng Deng 已提交
96

97
测试通过后会提示如下信息:
K
Kaipeng Deng 已提交
98 99

```
100
.......
101
----------------------------------------------------------------------
102
Ran 7 tests in 12.816s
K
Kaipeng Deng 已提交
103
OK
K
Kaipeng Deng 已提交
104
```
F
Feng Ni 已提交
105

106
## 快速体验
F
Feng Ni 已提交
107

W
wangguanzhong 已提交
108
**恭喜!** 您已经成功安装了PaddleDetection,接下来快速体验目标检测效果
F
Feng Ni 已提交
109 110

```
111 112
# 在GPU上预测一张图片
export CUDA_VISIBLE_DEVICES=0
113
python tools/infer.py -c configs/ppyolo/ppyolo_r50vd_dcn_1x_coco.yml -o use_gpu=true weights=https://paddledet.bj.bcebos.com/models/ppyolo_r50vd_dcn_1x_coco.pdparams --infer_img=demo/000000014439.jpg
F
Feng Ni 已提交
114 115 116 117 118 119
```

会在`output`文件夹下生成一个画有预测结果的同名图像。

结果如下图:

120
![](../images/000000014439.jpg)