From e3582790155cda2db21b5dd5bbd5e6a9a3f309f9 Mon Sep 17 00:00:00 2001
From: Zeng Jinle <32832641+sneaxiy@users.noreply.github.com>
Date: Wed, 23 Oct 2019 10:55:49 +0800
Subject: [PATCH] refine_design_idea_doc, test=develop (#1533)
---
.../design_idea/fluid_design_idea.md | 82 +++++++++---------
.../design_idea/image/executor_design.png | Bin 71190 -> 114129 bytes
2 files changed, 40 insertions(+), 42 deletions(-)
diff --git a/doc/fluid/advanced_usage/design_idea/fluid_design_idea.md b/doc/fluid/advanced_usage/design_idea/fluid_design_idea.md
index bb344dbb8..fe3a9d2c2 100644
--- a/doc/fluid/advanced_usage/design_idea/fluid_design_idea.md
+++ b/doc/fluid/advanced_usage/design_idea/fluid_design_idea.md
@@ -2,53 +2,51 @@
## 简介
-本篇文档主要介绍Fluid底层的设计思想，帮助用户更好的理解框架运作过程。
+本篇文档主要介绍飞桨（PaddlePaddle，以下简称Paddle）底层的设计思想，帮助用户更好的理解框架运作过程。
阅读本文档，您将了解：
-- Fluid 内部的执行流程
+- Paddle 内部的执行流程
- Program 如何描述模型
- Executor 如何执行运算
-## 1. Fluid内部执行流程
+## 1. Paddle内部执行流程
-Fluid使用一种编译器式的执行流程，分为编译时和运行时两个部分，具体包括：编译器定义 Program ，创建Executor 运行 Program 。
+Paddle使用一种编译器式的执行流程，分为编译时和运行时两个部分，具体包括：编译器定义 Program ，创建Executor 运行 Program 。
本地训练任务执行流程图如下所示：
- 1. 编译时，用户编写一段python程序，通过调用 Fluid 提供的算子，向一段 Program 中添加变量（Tensor）以及对变量的操作（Operators 或者 Layers）。用户只需要描述核心的前向计算，不需要关心反向计算、分布式下以及异构设备下如何计算。
-
- 2. 原始的 Program 在平台内部转换为中间描述语言： `ProgramDesc`。
-
- 3. 编译期最重要的一个功能模块是 `Transpiler`。`Transpiler` 接受一段 `ProgramDesc` ，输出一段变化后的 `ProgramDesc` ，作为后端 `Executor` 最终需要执行的 Fluid Program
-
- 4. 后端 Executor 接受 Transpiler 输出的这段 Program ，依次执行其中的 Operator（可以类比为程序语言中的指令），在执行过程中会为 Operator 创建所需的输入输出并进行管理。
+ 1. 编译时，用户编写一段python程序，通过调用 Paddle 提供的算子，向一段 Program 中添加变量（Tensor）以及对变量的操作（Operators 或者 Layers）。用户只需要描述核心的前向计算，不需要关心反向计算、分布式下以及异构设备下如何计算。
+ 2. 原始的 Program 在框架内部转换为中间描述语言： `ProgramDesc`。
+ 3. `Transpiler` 接受一段 `ProgramDesc` ，输出一段变化后的 `ProgramDesc` ，作为后端 `Executor` 最终需要执行的 Program 。 `Transpiler` 并非必需步骤。
+
+ 4. 执行 `ProgramDesc` 中定义的 Operator（可以类比为程序语言中的指令），在执行过程中会为 Operator 创建所需的输入输出并进行管理。
## 2. Program设计思想
-用户完成网络定义后，一段 Fluid 程序中通常存在 2 段 Program：
+用户完成网络定义后，一段 Paddle 程序中通常存在 2 个 Program：
- 1. fluid.default_startup_program：定义了创建模型参数，输入输出，以及模型中可学习参数的初始化等各种操作
+ 1. fluid.default_startup_program：定义了模型参数初始化、优化器参数初始化、reader初始化等各种操作。
- default_startup_program 可以由框架自动生成，使用时无需显示地创建
+ default_startup_program 可以由框架自动生成，使用时无需显式地创建
如果调用修改了参数的默认初始化方式，框架会自动的将相关的修改加入default_startup_program
- 2. fluid.default_main_program ：定义了神经网络模型，前向反向计算，以及优化算法对网络中可学习参数的更新
-
- 使用Fluid的核心就是构建起 default_main_program
+ 2. fluid.default_main_program ：定义了神经网络模型，前向反向计算，以及模型参数更新、优化器参数更新等各种操作。
+ 使用Paddle的核心就是构建起 default_main_program
+
### Programs and Blocks
-Fluid 的 Program 的基本结构是一些嵌套 blocks，形式上类似一段 C++ 或 Java 程序。
+Paddle 的 Program 的基本结构是一些嵌套 blocks，形式上类似一段 C++ 或 Java 程序。
blocks中包含：
@@ -68,7 +66,7 @@ int main(){ //block 0
}
```
-类似的，在下列 Fluid 的 Program 包含3段block：
+类似的，在下列 Paddle 的 Program 包含3段block：
```python
import paddle.fluid as fluid # block 0
@@ -95,7 +93,7 @@ prob = ie()
```
### BlockDesc and ProgramDesc
-用户描述的block与program信息在Fluid中以[protobuf](https://en.wikipedia.org/wiki/Protocol_Buffers) 格式保存，所有的`protobuf`信息被定义在`framework.proto`中，在Fluid中被称为BlockDesc和ProgramDesc。ProgramDesc和BlockDesc的概念类似于一个[抽象语法树](https://en.wikipedia.org/wiki/Abstract_syntax_tree)。
+用户描述的block与program信息在Paddle中以[protobuf](https://en.wikipedia.org/wiki/Protocol_Buffers) 格式保存，所有的`protobuf`信息被定义在`framework.proto`中，在Paddle中被称为BlockDesc和ProgramDesc。ProgramDesc和BlockDesc的概念类似于一个[抽象语法树](https://en.wikipedia.org/wiki/Abstract_syntax_tree)。
`BlockDesc`中包含本地变量的定义 [vars](../../api_guides/low_level/program.html#variable)，和一系列的operator`ops`：
@@ -108,7 +106,7 @@ message BlockDesc {
}
```
-parent ID表示父块，因此block中的操作符可以引用本地定义的变量，也可以引用祖先块中定义的变量。
+parent_idx表示父块，因此block中的操作符可以引用本地定义的变量，也可以引用祖先块中定义的变量。
Program 中的每层 block 都被压平并存储在数组中。blocks ID是这个数组中块的索引。
@@ -120,7 +118,7 @@ message ProgramDesc {
### 使用Blocks的Operator
-[Programs and Blocks](#Programs and Blocks)的例子中，IfElseOp这个Operator包含了两个block——true分支和false分支。
+[Programs and Blocks](#ProgramsAndBlocks)的例子中，IfElseOp这个Operator包含了两个block——true分支和false分支。
下述OpDesc的定义过程描述了一个operator可以包含哪些属性：
@@ -152,7 +150,7 @@ message AttrDesc {
Executor 在运行时将接受一个`ProgramDesc`、一个`block_id`和一个`Scope`。`ProgramDesc`是`block`的列表，每一项包含`block`中所有参数和`operator`的`protobuf`定义；`block_id`指定入口块；`Scope`是所有变量实例的容器。
-其中 `Scope` 包含了 `name` 与 `Variable` 的映射，所有变量都被定义在 `Scope` 里。大部分API会默认使用 `global_scope` ,例如 :code:`Executor.run`,您也可以指定网络运行在某个特定的 `Scope` 中，一个网络可以在不同的 `Scope`内运行，并在该 `Scope` 内更新不同的 `Variable`。
+其中 `Scope` 包含了 `name` 与 `Variable` 的映射，所有变量都被定义在 `Scope` 里。大部分API会默认使用 `global_scope` ，例如 `Executor.run` ，您也可以指定网络运行在某个特定的 `Scope` 中，一个网络可以在不同的 `Scope`内运行，并在该 `Scope` 内更新不同的 `Variable`。
完成的编译执行的具体过程如下图所示：
@@ -160,9 +158,9 @@ Executor 在运行时将接受一个`ProgramDesc`、一个`block_id`和一个`Sc
-1. Executor 为每一个block创建一个Scope，Block是可嵌套的，因此Scope也是可嵌套的
-2. 创建所有Scope中的变量
-3. 按顺序创建并执行所有operator
+1. Executor 为每一个block创建一个Scope，Block是可嵌套的，因此Scope也是可嵌套的。
+2. 创建所有Scope中的变量。
+3. 创建并执行所有operator。
@@ -182,7 +180,7 @@ class Executor{
scope->Var(Var->Name());
}
- //创建OP并按顺序执行
+ //创建OP并执行
for (auto& op_desc : block.AllOps()){
auto op = CreateOp(*op_desc);
op->Run(*local_scope, place_);
@@ -192,7 +190,7 @@ class Executor{
**创建Executor**
-Fluid中使用fluid.Executor(place)创建Executor，place属性由用户定义，代表程序将在哪里执行。
+Paddle中使用fluid.Executor(place)创建Executor，place属性由用户定义，代表程序将在哪里执行。
下例代码表示创建一个Executor，其运行场所在CPU内：
@@ -203,7 +201,7 @@ exe = fluid.Executor(cpu)
**运行Executor**
-Fluid使用Executor.run来运行程序。定义中通过Feed映射获取数据，通过fetch\_list获取结果：
+Paddle使用Executor.run来运行程序。定义中通过Feed映射获取数据，通过fetch\_list获取结果：
```python
...
@@ -215,11 +213,11 @@ outs = exe.run(
## 代码实例
-本节通过[Fluid编程指南](../../beginners_guide/programming_guide/programming_guide.html)中简单的线性回归例子，为您介绍上述内容如何在代码中实现。
+本节通过[编程指南](../../beginners_guide/programming_guide/programming_guide.html)中简单的线性回归例子，为您介绍上述内容如何在代码中实现。
**定义Program**
-您可以随意定义自己的数据和网络结构，定义的结果都将作为一段 Program 被 Fluid 接收，Program 的基本结构是一些 blocks，本节的 Program 仅包含一个 block 0：
+您可以随意定义自己的数据和网络结构，定义的结果都将作为一段 Program 被 Paddle 接收，Program 的基本结构是一些 blocks，本节的 Program 仅包含一个 block 0：
```python
#加载函数库
@@ -230,8 +228,8 @@ import numpy
train_data=numpy.array([[1.0],[2.0],[3.0],[4.0]]).astype('float32')
y_true = numpy.array([[2.0],[4.0],[6.0],[8.0]]).astype('float32')
#定义网络
-x = fluid.layers.data(name="x",shape=[1],dtype='float32')
-y = fluid.layers.data(name="y",shape=[1],dtype='float32')
+x = fluid.data(name="x",shape=[None, 1],dtype='float32')
+y = fluid.data(name="y",shape=[None, 1],dtype='float32')
y_predict = fluid.layers.fc(input=x,size=1,act=None)
#定义损失函数
cost = fluid.layers.square_error_cost(input=y_predict,label=y)
@@ -298,9 +296,9 @@ blocks {
```
从输出结果中可以看到，整个定义过程在框架内部转化为了一段ProgramDesc，以block idx为索引。本次线性回归模型中仅有1个block，ProgramDesc中也仅有block 0一段BlockDesc。
-BlockDesc中包含定义的 vars 和一系列的 ops，以输入x为例，python代码中定义 x 是一个数据类型为"float 32"的1维数据：
+BlockDesc中包含定义的 vars 和一系列的 ops，以输入x为例，python代码中定义 x 是一个数据类型为"float32"的1维数据：
```python
-x = fluid.layers.data(name="x",shape=[1],dtype='float32')
+x = fluid.data(name="x",shape=[None, 1],dtype='float32')
```
在BlockDesc中，变量x被描述为：
```
@@ -319,15 +317,15 @@ vars {
}
persistable: false
```
-在Fluid中所有的数据类型都为LoD-Tensor，对于不存在序列信息的数据（如此处的变量X），其lod_level=0。
+在Paddle中所有的数据类型都为LoD-Tensor，对于不存在序列信息的数据（如此处的变量X），其lod_level=0。
-dims表示数据的维度，这里表示 x 的维度为[-1,1]，其中-1是batch的维度，无法确定具体数值时，Fluid 自动用 -1 占位。
+dims表示数据的维度，这里表示 x 的维度为[-1,1]，其中-1是batch的维度，无法确定具体数值时，Paddle 自动用 -1 占位。
参数`persistable`表示该变量在整个训练过程中是否为持久化变量。
**创建Executor**
-Fluid使用Executor来执行网络训练，Executor运行细节请参考[Executor设计思想](#Executor设计思想)的介绍。作为使用者，实际并不需要了解内部机制。
+Paddle使用Executor来执行网络训练，Executor运行细节请参考[Executor设计思想](#Executor设计思想)的介绍。作为使用者，实际并不需要了解内部机制。
创建Executor只需调用 fluid.Executor(place) 即可，在此之前请您依据训练场所定义place变量：
```python
@@ -338,14 +336,14 @@ Fluid使用Executor来执行网络训练，Executor运行细节请参考[Executo
```
**运行Executor**
-Fluid使用Executor.run来运行一段Program。
+Paddle使用Executor.run来运行一段Program。
-正式进行网络训练前，需先执行参数初始化。其中 defalut_startup_program 中定义了创建模型参数，输入输出，以及模型中可学习参数的初始化等各种操作。
+正式进行网络训练前，需先执行参数初始化。其中 defalut_startup_program 中定义了模型参数初始化、优化器参数初始化、reader初始化等各种操作。
```python
#参数初始化
exe.run(fluid.default_startup_program())
```
-由于传入数据与传出数据存在多列，因此 fluid 通过 feed 映射定义数据的传输数据，通过 fetch_list 取出期望结果：
+由于传入数据与传出数据存在多列，因此 Paddle 通过 feed 映射定义数据的传输数据，通过 fetch_list 取出期望结果：
```python
#开始训练
outs = exe.run(
@@ -362,5 +360,5 @@ Fluid使用Executor.run来运行一段Program。
[6.099215 ]], dtype=float32), array([1.6935859], dtype=float32)]
```
-至此您已经了解了Fluid 内部的执行流程的核心概念，更多框架使用细节请参考[使用指南](../../user_guides/index_cn.html)相关内容，[模型库](../../user_guides/models/index_cn.html
+至此您已经了解了Paddle内部的执行流程的核心概念，更多框架使用细节请参考[使用指南](../../user_guides/index_cn.html)相关内容，[模型库](../../user_guides/models/index_cn.html
)中也为您提供了丰富的模型示例以供参考。
diff --git a/doc/fluid/advanced_usage/design_idea/image/executor_design.png b/doc/fluid/advanced_usage/design_idea/image/executor_design.png
index 0b3b7ad72fd487e4193beb41db7b7df748a2844c..ae0cf2f161da7d0700ecb4f63772d2bfc4c26de0 100644
GIT binary patch
literal 114129
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�l#}dt+vBvZcML_1R(KNS1NLfLDyfA1JiT%+qv_>B-+xzn}QJfs&dPpN_
zI*u=2Ftu0;UB5nMQ;@D^eU`kBHYs!*r>gT@rh2-)$l;7cStNkX<#h#ZgR)9Cyh2UU
z&S+I~vgmK#cr==Rmg5DT{Mzu*{c-#h8tL!({i}wpci|1eU|59NPD1q58ER_5ACqUv
zVWF(T{(u;k69ZNv5I(b8E*9DmA^4py<6&gXl5V%pn~9&SkXZSebu0E_q^}u5mXcH|
zmxG}sYF8t*IjxZ3Q#h%_DOT0``$krI@UgT!*|IWdmzOUiDSzXEr=&ac`pjnIU80lx
z5F}YrOwwhyXw7Q+rsJ$fgh&#dytz}tubSr=Hm~F)%2TV~IA-;^`0VDQOA*eyvF|h9TCuqWzu&XSpjQZ%I<}oq0DNNL0cwK&a;Mow
zOlO_jzP1*>Yx*r$XRHg}A2lhV$r{z