INSTALL_cn.md 3.8 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.1
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版本  |    备注    |
| :------------------: | :---------------: | :-------: |
21 22
|    develop           |       >= 2.2.0rc |     Dygraph mode is set as default    |
|    release/2.3       |       >= 2.2.0rc |     Dygraph mode is set as default    |
23
|    release/2.2       |       >= 2.1.2    |     默认使用动态图模式    |
G
Guanghua Yu 已提交
24
|    release/2.1       |       >= 2.1.0    |     默认使用动态图模式    |
25 26 27 28 29
|    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 已提交
30

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

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

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

# CPU
python -m pip install paddlepaddle -i https://mirror.baidu.com/pypi/simple
```
G
Guanghua Yu 已提交
42 43
- 更多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 已提交
44

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

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

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

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


Y
yzl19940819 已提交
61

K
Kaipeng Deng 已提交
62 63 64 65

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


Q
qingqing01 已提交
66 67

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

72 73 74
# 安装其他依赖
pip install -r requirements.txt

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

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

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

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

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

89 90 91

安装后确认测试通过:

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

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

```
K
Kaipeng Deng 已提交
99
.....
100
----------------------------------------------------------------------
K
Kaipeng Deng 已提交
101 102
Ran 5 tests in 4.280s
OK
K
Kaipeng Deng 已提交
103
```
F
Feng Ni 已提交
104

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

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

```
110 111
# 在GPU上预测一张图片
export CUDA_VISIBLE_DEVICES=0
112
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 已提交
113 114 115 116 117 118
```

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

结果如下图:

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