Skip to content
This repository was archived by the owner on Jan 24, 2024. It is now read-only.

Comments

Add the Chinese version README of iOS demo.#57

Merged
Xreki merged 2 commits intoPaddlePaddle:developfrom
Xreki:update_readme_ios_demo
Dec 14, 2017
Merged

Add the Chinese version README of iOS demo.#57
Xreki merged 2 commits intoPaddlePaddle:developfrom
Xreki:update_readme_ios_demo

Conversation

@Xreki
Copy link
Collaborator

@Xreki Xreki commented Dec 13, 2017

Fix #58


这是一个使用PaddlePaddle库进行离线目标检测的iOS Demo。该Demo调用PaddlePaddle C-API接口,使用预训练好的PaddlePaddle模型,可以检测到通过摄像头捕获到的目标的类别,并将其标记出来,展示给用户。

更多关于SSD模型架构特征,以及如何使用PaddlePaddle训练得到一个好的SSD模型,可以参考[这里](https://github.com/PaddlePaddle/models/tree/develop/ssd)。我们也提供了一个[Linux Demo](https://github.com/PaddlePaddle/Mobile/tree/develop/Demo/linux),可以在Linux系统上快速地验证模型.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

17行末尾的句号应该改成中文句号。

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

| ------------------------ |:----------:| --------:|------:|
| [pascal\_mobilenet\_300\_66](http://cloud.dlnel.org/filepub/?uuid=39c325d9-b468-4940-ba47-d50c8ec5fd5b) | 300 x 300 | 66% | 23.2MB |
| [vgg\_ssd\_net](http://cloud.dlnel.org/filepub/?uuid=1116a5f3-7762-44b5-82bb-9954159cb5d4) | 300 x 300 | 71% | 104.3MB |
| [face\_mobilenet\_160\_91](http://cloud.dlnel.org/filepub/?uuid=038c1dbf-08b3-42a9-b2dc-efccd63859fb) | 160 x 160 | 91% | 18.4MB |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

需要加:点击表中对应的模型可以直接下载么?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done. 加了一句说明。

<img src="assets/demo_pascal.jpg" width = "25%" />
<img src="assets/demo_face.jpeg" width = "25%" />

图-1 App设置主界面,20类通用目标检测效果,人脸检测效果
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image
图和下面的文字并没有对齐。要改成图1-1,图1-2,图1-3么

Copy link
Collaborator Author

@Xreki Xreki Dec 13, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

我改了一下,但是没有改成图1-1,图1-2,图1-3这种样式,看起来感觉有点奇怪。。。另外,我想把3个图显示在同一行,对齐没法控制啊。。。。。

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

有两种办法:

  • 通过打空格,使文字和图对应
  • 分成三行打:
    • 图-1 左:APP设置主界面
    • 图-1 中:20类通用目标检测效果
    • 图-1 右: 人脸检测效果

另外,READEME中所有的图可以居中显示么?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

加了些空格调整了下,还是做不到每一条都居中对齐。分成三行打的方式不太好。

READEME中所有的图可以居中显示么?

Done.


### 演示效果

App模型需要开启摄像头权限。启动App后,点击屏幕,将会出现设置主界面,其中
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

设置主界面(如图1-1所示)?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

图下面的标题改了一下。这里也对应改了。

- 模型选择层:可以选择`Pascal MobileNet 300`或`Face MobileNet 160`,进行20类通用目标检测或者人脸检测。注意:默认情况下`Pascal VGG 300`功能是关闭的。每一次改变设置,App将需要重新启动。
- 摄像头选择层:可选择`Front/Back Camera`,即`前置/后置摄像头`来捕获图像,进行检测。
- 精度阈值控制层:控制识别结果的准确度。取值越高,检测到目标的准确性也越高,但检测到目标的数量可能会降低。
- 刷新时间间隔控制层:控制摄像头捕获图像的频率。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

APP界面看着都是英文,所以这里的精度阈值控制层等,后面要括号下对应的英文么?用户会不会找不到?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done. 加上了英文。


### 准备模型

Github上面只维护了该Demo相关的源码文件和项目配置。用户可下载[face\_mobilenet\_160\_91.paddle](http://cloud.dlnel.org/filepub/?uuid=038c1dbf-08b3-42a9-b2dc-efccd63859fb)和[pascal\_mobilenet\_300\_66.paddle](http://cloud.dlnel.org/filepub/?uuid=39c325d9-b468-4940-ba47-d50c8ec5fd5b),加入项目根目录下面的`models`子目录下面。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

表格里面的模型名称,后面没有带paddle,两者是否要统一?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done. 前面表格里加上了.paddle后缀。


用户可按照[iOS平台编译指南](https://github.com/PaddlePaddle/Paddle/blob/develop/doc/mobile/cross_compiling_for_ios_cn.md),拉取[Paddle](https://github.com/PaddlePaddle/Paddle)最新的源码,编译适用于iOS平台的PaddlePaddle库。在执行`make install`之后,PaddlePaddle库将会安装在`CMAKE_INSTALL_PREFIX`所指定的目录下。该目录包含如下子目录:

- `include`,其中包含使用PaddlePaddle所需要引入的头文件,通常代码中加入#include <paddle/capi.h>即可。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#include <paddle/capi.h>

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.


用户也可从[wiki](https://github.com/PaddlePaddle/Mobile/wiki)页面下载预编译好的版本。

准备好PaddlePaddle库之后,用户需要将PaddlePaddle库目录重命名为`paddle-ios`,并拷贝到`AICamera`项目的根目录下。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PDCamera or AICamera? 要统一名字?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这个涉及到改源码的目录名。后面再来统一吧。


```
.
├── AICamera
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AICamera是上一级目录?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

加了当前目录。

└── third_party
```

然后,你就可以构建和运行该Demo了。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

你-》您,全文同。

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

还是统一用吧。

@Xreki Xreki force-pushed the update_readme_ios_demo branch 18 times, most recently from 7c6ef9f to ed19e6b Compare December 14, 2017 02:29
@Xreki Xreki force-pushed the update_readme_ios_demo branch from ed19e6b to 9317cf0 Compare December 14, 2017 02:38
Copy link
Contributor

@luotao1 luotao1 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@Xreki Xreki merged commit 925c440 into PaddlePaddle:develop Dec 14, 2017
@Xreki Xreki deleted the update_readme_ios_demo branch December 14, 2017 08:49
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants