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


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



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

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

17 18 19 20 21 22 23 24 25
PaddleDetection 依赖 PaddlePaddle 版本关系:

|  PaddleDetection版本  | PaddlePaddle版本  |    备注    |
| :------------------: | :---------------: | :-------: |
|    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 已提交
26

27
## 安装说明
Q
qingqing01 已提交
28

K
Kaipeng Deng 已提交
29
### 1. 安装PaddlePaddle
30 31 32 33 34 35 36 37 38 39 40

```
# CUDA9.0
python -m pip install paddlepaddle-gpu==2.0.1.post90 -i https://mirror.baidu.com/pypi/simple

# CUDA10.1
python -m pip install paddlepaddle-gpu==2.0.1.post101 -f https://mirror.baidu.com/pypi/simple

# CPU
python -m pip install paddlepaddle -i https://mirror.baidu.com/pypi/simple
```
Q
qingqing01 已提交
41

42
更多安装方式例如conda或源码编译安装方法,请参考PaddlePaddle[安装文档](https://www.paddlepaddle.org.cn/documentation/docs/zh/install/index_cn.html)
Q
qingqing01 已提交
43

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

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

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

K
Kaipeng Deng 已提交
57 58 59 60 61 62 63 64 65 66
### 2. 安装PaddleDetection

可通过如下两种方式安装PaddleDetection

#### 2.1 通过pip安装

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

```
# pip安装paddledet
67
pip install paddledet==2.0.0 -i https://pypi.tuna.tsinghua.edu.cn/simple
K
Kaipeng Deng 已提交
68 69 70 71 72 73 74

# 下载使用源码中的配置文件和代码示例
git clone https://github.com/PaddlePaddle/PaddleDetection.git
cd PaddleDetection
```

#### 2.2 源码编译安装
Q
qingqing01 已提交
75 76

```
77
# 克隆PaddleDetection仓库
Q
qingqing01 已提交
78 79
cd <path/to/clone/PaddleDetection>
git clone https://github.com/PaddlePaddle/PaddleDetection.git
80 81 82 83 84 85 86

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

# 安装PaddleDetection
cd PaddleDetection
python setup.py install
Q
qingqing01 已提交
87 88
```

89 90 91 92 93 94 95 96 97
**注意**

1. 由于原版cocoapi不支持windows,采用第三方实现版本,该版本仅支持Python3

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


安装后确认测试通过:

Q
qingqing01 已提交
98
```
99
python ppdet/modeling/tests/test_architectures.py
Q
qingqing01 已提交
100
```
K
Kaipeng Deng 已提交
101

102
测试通过后会提示如下信息:
K
Kaipeng Deng 已提交
103 104

```
105 106 107 108
..........
----------------------------------------------------------------------
Ran 12 tests in 2.480s
OK (skipped=2)
K
Kaipeng Deng 已提交
109
```
F
Feng Ni 已提交
110

111
## 快速体验
F
Feng Ni 已提交
112

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

```
116 117 118
# 在GPU上预测一张图片
export CUDA_VISIBLE_DEVICES=0
python tools/infer.py -c configs/ppyolo/ppyolo.yml -o use_gpu=true weights=https://paddlemodels.bj.bcebos.com/object_detection/ppyolo.pdparams --infer_img=demo/000000014439.jpg
F
Feng Ni 已提交
119 120 121 122 123 124
```

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

结果如下图:

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