diff --git a/doc_cn/algorithm/rnn/glossary_rnn.dot b/doc_cn/algorithm/rnn/glossary_rnn.dot
new file mode 100644
index 0000000000000000000000000000000000000000..2cd0fb1820c44b0e8e0b869f9d39fcad27efa758
--- /dev/null
+++ b/doc_cn/algorithm/rnn/glossary_rnn.dot
@@ -0,0 +1,42 @@
+digraph G{
+ subgraph cluster_timestep0 {
+ label="recurrent timestep i-1"
+ bgcolor=lightgray
+ node [style=filled,color=white]
+ fc0_0 [label="fc 0"]
+ fc0_1 [label="fc 1"]
+ fc0_2 [label="fc 2"]
+
+ fc0_0 -> fc0_1
+ fc0_1 -> fc0_2
+ }
+
+ subgraph cluster_timestep1 {
+ label="recurrent timestep i"
+ node [style=filled];
+ fc1_0 [label="fc 0"]
+ fc1_1 [label="fc 1"]
+ fc1_2 [label="fc 2"]
+ color=blue
+
+ fc1_0 -> fc1_1
+ fc1_1 -> fc1_2
+ }
+
+ subgraph cluster_timestep2 {
+ label="recurrent timestep i+1"
+ bgcolor=lightgray
+ node [style=filled,color=white]
+ fc2_0 [label="fc 0"]
+ fc2_1 [label="fc 1"]
+ fc2_2 [label="fc 2"]
+
+ fc2_0 -> fc2_1
+ fc2_1 -> fc2_2
+ }
+
+
+ fc0_1 -> fc1_1 [style="dotted" constraint=false]
+ fc1_1 -> fc2_1 [style="dotted" constraint=false]
+
+}
\ No newline at end of file
diff --git a/doc_cn/algorithm/rnn/glossary_rnn_with_memory.dot b/doc_cn/algorithm/rnn/glossary_rnn_with_memory.dot
new file mode 100644
index 0000000000000000000000000000000000000000..0f101ec2d8f15aec76c57f328046b6b55cf0c7eb
--- /dev/null
+++ b/doc_cn/algorithm/rnn/glossary_rnn_with_memory.dot
@@ -0,0 +1,48 @@
+digraph G{
+ subgraph cluster_timestep0 {
+ label="recurrent timestep i-1"
+ bgcolor=lightgray
+ node [style=filled,color=white]
+ fc0_0 [label="fc 0"]
+ fc0_1 [label="fc 1"]
+ fc0_2 [label="fc 2"]
+ m0 [label="memory"]
+ fc0_0 -> fc0_1
+ fc0_1 -> fc0_2
+ fc0_1 -> m0
+ m0 -> fc0_1
+ }
+
+ subgraph cluster_timestep1 {
+ label="recurrent timestep i"
+ node [style=filled];
+ fc1_0 [label="fc 0"]
+ fc1_1 [label="fc 1"]
+ fc1_2 [label="fc 2"]
+ m1 [label="memory"]
+ color=blue
+ fc1_0 -> fc1_1
+ fc1_1 -> fc1_2
+ fc1_1 -> m1
+ m1 -> fc1_1
+ }
+
+ subgraph cluster_timestep2 {
+ label="recurrent timestep i+1"
+ bgcolor=lightgray
+ node [style=filled,color=white]
+ fc2_0 [label="fc 0"]
+ fc2_1 [label="fc 1"]
+ fc2_2 [label="fc 2"]
+ m2 [label="memory"]
+ fc2_0 -> fc2_1
+ fc2_1 -> fc2_2
+ fc2_1 -> m2
+ m2 -> fc2_1
+ }
+
+
+ m0 -> m1 [style="dotted" constraint=false]
+ m1 -> m2 [style="dotted" constraint=false]
+
+}
\ No newline at end of file
diff --git a/doc_cn/algorithm/rnn/hierarchical-rnn.md b/doc_cn/algorithm/rnn/hierarchical-rnn.md
deleted file mode 100644
index c184a34e85a571e98e88c14ef653356fdd555a19..0000000000000000000000000000000000000000
--- a/doc_cn/algorithm/rnn/hierarchical-rnn.md
+++ /dev/null
@@ -1,403 +0,0 @@
-# 双层RNN配置与示例
-
-我们在`paddle/gserver/tests/test_RecurrentGradientMachine`单测中，通过多组语义相同的单双层RNN配置，讲解如何使用双层RNN。
-
-## 示例1：双进双出，subseq间无memory
-
-配置：单层RNN（`sequence_layer_group`）和双层RNN（`sequence_nest_layer_group`），语义完全相同。
-
-### 读取双层序列的方法
-
-首先，我们看一下单双层序列的不同数据组织形式（您也可以采用别的组织形式）：
-
-- 单层序列的数据（`Sequence/tour_train_wdseg`）如下，一共有10个样本。每个样本由两部分组成，一个label（此处都为2）和一个已经分词后的句子。
-
-```text
-2 酒店 有 很 舒适 的 床垫 子 ， 床上用品 也 应该 是 一人 一 换 ， 感觉 很 利落 对 卫生 很 放心 呀 。
-2 很 温馨 ， 也 挺 干净 的 * 地段 不错 ， 出来 就 有 全家 ， 离 地铁站 也 近 ， 交通 很方便 * 就是 都 不 给 刷牙 的 杯子 啊 ， 就 第一天 给 了 一次性杯子 *
-2 位置 方便 ， 强烈推荐 ， 十一 出去玩 的 时候 选 的 ， 对面 就是 华润万家 ， 周围 吃饭 的 也 不少 。
-2 交通便利 ， 吃 很 便利 ， 乾 浄 、 安静 ， 商务 房 有 电脑 、 上网 快 ， 价格 可以 ， 就 早餐 不 好吃 。 整体 是 不错 的 。 適 合 出差 來 住 。
-2 本来 准备 住 两 晚 ， 第 2 天 一早 居然 停电 ， 且 无 通知 ， 只有 口头 道歉 。 总体来说 性价比 尚可 ， 房间 较 新 ， 还是 推荐 .
-2 这个 酒店 去过 很多 次 了 ， 选择 的 主要原因 是 离 客户 最 便宜 相对 又 近 的 酒店
-2 挺好 的 汉庭 ， 前台 服务 很 热情 ， 卫生 很 整洁 ， 房间 安静 ， 水温 适中 ， 挺好 ！
-2 HowardJohnson 的 品质 ， 服务 相当 好 的 一 家 五星级 。 房间 不错 、 泳池 不错 、 楼层 安排 很 合理 。 还有 就是 地理位置 ， 简直 一 流 。 就 在 天一阁 、 月湖 旁边 ， 离 天一广场 也 不远 。 下次 来 宁波 还会 住 。
-2 酒店 很干净 ， 很安静 ， 很 温馨 ， 服务员 服务 好 ， 各方面 都 不错 *
-2 挺好 的 ， 就是 没 窗户 ， 不过 对 得 起 这 价格
-```
-
-- 双层序列的数据（`Sequence/tour_train_wdseg.nest`）如下，一共有4个样本。样本间用空行分开，代表不同的双层序列，序列数据和上面的完全一样。每个样本的子句数分别为2,3,2,3。
-
-```text
-2 酒店 有 很 舒适 的 床垫 子 ， 床上用品 也 应该 是 一人 一 换 ， 感觉 很 利落 对 卫生 很 放心 呀 。
-2 很 温馨 ， 也 挺 干净 的 * 地段 不错 ， 出来 就 有 全家 ， 离 地铁站 也 近 ， 交通 很方便 * 就是 都 不 给 刷牙 的 杯子 啊 ， 就 第一天 给 了 一次性杯子 *
-
-2 位置 方便 ， 强烈推荐 ， 十一 出去玩 的 时候 选 的 ， 对面 就是 华润万家 ， 周围 吃饭 的 也 不少 。
-2 交通便利 ， 吃 很 便利 ， 乾 浄 、 安静 ， 商务 房 有 电脑 、 上网 快 ， 价格 可以 ， 就 早餐 不 好吃 。 整体 是 不错 的 。 適 合 出差 來 住 。
-2 本来 准备 住 两 晚 ， 第 2 天 一早 居然 停电 ， 且 无 通知 ， 只有 口头 道歉 。 总体来说 性价比 尚可 ， 房间 较 新 ， 还是 推荐 .
-
-2 这个 酒店 去过 很多 次 了 ， 选择 的 主要原因 是 离 客户 最 便宜 相对 又 近 的 酒店
-2 挺好 的 汉庭 ， 前台 服务 很 热情 ， 卫生 很 整洁 ， 房间 安静 ， 水温 适中 ， 挺好 ！
-
-2 HowardJohnson 的 品质 ， 服务 相当 好 的 一 家 五星级 。 房间 不错 、 泳池 不错 、 楼层 安排 很 合理 。 还有 就是 地理位置 ， 简直 一 流 。 就 在 天一阁 、 月湖 旁边 ， 离 天一广场 也 不远 。 下次 来 宁波 还会 住 。
-2 酒店 很干净 ， 很安静 ， 很 温馨 ， 服务员 服务 好 ， 各方面 都 不错 *
-2 挺好 的 ， 就是 没 窗户 ， 不过 对 得 起 这 价格
-```
-
-其次，我们看一下单双层序列的不同dataprovider（见`sequenceGen.py`）：
-
-- 单层序列的dataprovider如下：
- - word_slot是integer_value_sequence类型，代表单层序列。
- - label是integer_value类型，代表一个向量。
-
-```python
-def hook(settings, dict_file, **kwargs):
- settings.word_dict = dict_file
- settings.input_types = [integer_value_sequence(len(settings.word_dict)),
- integer_value(3)]
-
-@provider(init_hook=hook)
-def process(settings, file_name):
- with open(file_name, 'r') as fdata:
- for line in fdata:
- label, comment = line.strip().split('\t')
- label = int(''.join(label.split()))
- words = comment.split()
- word_slot = [settings.word_dict[w] for w in words if w in settings.word_dict]
- yield word_slot, label
-```
-
-- 双层序列的dataprovider如下：
- - word_slot是integer_value_sub_sequence类型，代表双层序列。
- - label是integer_value_sequence类型，代表单层序列，即一个子句一个label。注意：也可以为integer_value类型，代表一个向量，即一个句子一个label。通常根据任务需求进行不同设置。
- - 关于dataprovider中input_types的详细用法，参见PyDataProvider2。
-
-```python
-def hook2(settings, dict_file, **kwargs):
- settings.word_dict = dict_file
- settings.input_types = [integer_value_sub_sequence(len(settings.word_dict)),
- integer_value_sequence(3)]
-
-@provider(init_hook=hook2)
-def process2(settings, file_name):
- with open(file_name) as fdata:
- label_list = []
- word_slot_list = []
- for line in fdata:
- if (len(line)) > 1:
- label,comment = line.strip().split('\t')
- label = int(''.join(label.split()))
- words = comment.split()
- word_slot = [settings.word_dict[w] for w in words if w in settings.word_dict]
- label_list.append(label)
- word_slot_list.append(word_slot)
- else:
- yield word_slot_list, label_list
- label_list = []
- word_slot_list = []
-```
-
-### 模型中的配置
-
-首先，我们看一下单层序列的配置（见`sequence_layer_group.conf`）。注意：batchsize=5表示一次过5句单层序列，因此2个batch就可以完成1个pass。
-
-```python
-settings(batch_size=5)
-
-data = data_layer(name="word", size=dict_dim)
-
-emb = embedding_layer(input=data, size=word_dim)
-
-# (lstm_input + lstm) is equal to lstmemory
-with mixed_layer(size=hidden_dim*4) as lstm_input:
- lstm_input += full_matrix_projection(input=emb)
-
-lstm = lstmemory_group(input=lstm_input,
- size=hidden_dim,
- act=TanhActivation(),
- gate_act=SigmoidActivation(),
- state_act=TanhActivation(),
- lstm_layer_attr=ExtraLayerAttribute(error_clipping_threshold=50))
-
-lstm_last = last_seq(input=lstm)
-
-with mixed_layer(size=label_dim,
- act=SoftmaxActivation(),
- bias_attr=True) as output:
- output += full_matrix_projection(input=lstm_last)
-
-outputs(classification_cost(input=output, label=data_layer(name="label", size=1)))
-
-```
-其次，我们看一下语义相同的双层序列配置（见`sequence_nest_layer_group.conf`），并对其详细分析：
-
-- batchsize=2表示一次过2句双层序列。但从上面的数据格式可知，2句双层序列和5句单层序列的数据完全一样。
-- data_layer和embedding_layer不关心数据是否是序列格式，因此两个配置在这两层上的输出是一样的。
-- lstmemory:
- - 单层序列过了一个mixed_layer和lstmemory_group。
- - 双层序列在同样的mixed_layer和lstmemory_group外，直接加了一层group。由于这个外层group里面没有memory，表示subseq间不存在联系，即起到的作用仅仅是把双层seq拆成单层，因此双层序列过完lstmemory的输出和单层的一样。
-- last_seq：
- - 单层序列直接取了最后一个元素
- - 双层序列首先（last_seq层）取了每个subseq的最后一个元素，将其拼接成一个新的单层序列；接着（expand_layer层）将其扩展成一个新的双层序列，其中第i个subseq中的所有向量均为输入的单层序列中的第i个向量；最后（average_layer层）取了每个subseq的平均值。
- - 分析得出：第一个last_seq后，每个subseq的最后一个元素就等于单层序列的最后一个元素，而expand_layer和average_layer后，依然保持每个subseq最后一个元素的值不变（这两层仅是为了展示它们的用法，实际中并不需要）。因此单双层序列的输出是一样旳。
-
-```python
-settings(batch_size=2)
-
-data = data_layer(name="word", size=dict_dim)
-
-emb_group = embedding_layer(input=data, size=word_dim)
-
-# (lstm_input + lstm) is equal to lstmemory
-def lstm_group(lstm_group_input):
- with mixed_layer(size=hidden_dim*4) as group_input:
- group_input += full_matrix_projection(input=lstm_group_input)
-
- lstm_output = lstmemory_group(input=group_input,
- name="lstm_group",
- size=hidden_dim,
- act=TanhActivation(),
- gate_act=SigmoidActivation(),
- state_act=TanhActivation(),
- lstm_layer_attr=ExtraLayerAttribute(error_clipping_threshold=50))
- return lstm_output
-
-lstm_nest_group = recurrent_group(input=SubsequenceInput(emb_group),
- step=lstm_group,
- name="lstm_nest_group")
-# hasSubseq ->(seqlastins) seq
-lstm_last = last_seq(input=lstm_nest_group, agg_level=AggregateLevel.EACH_SEQUENCE)
-
-# seq ->(expand) hasSubseq
-lstm_expand = expand_layer(input=lstm_last, expand_as=emb_group, expand_level=ExpandLevel.FROM_SEQUENCE)
-
-# hasSubseq ->(average) seq
-lstm_average = pooling_layer(input=lstm_expand,
- pooling_type=AvgPooling(),
- agg_level=AggregateLevel.EACH_SEQUENCE)
-
-with mixed_layer(size=label_dim,
- act=SoftmaxActivation(),
- bias_attr=True) as output:
- output += full_matrix_projection(input=lstm_average)
-
-outputs(classification_cost(input=output, label=data_layer(name="label", size=1)))
-```
-## 示例2：双进双出，subseq间有memory
-
-配置：单层RNN（`sequence_rnn.conf`），双层RNN（`sequence_nest_rnn.conf`和`sequence_nest_rnn_readonly_memory.conf`），语义完全相同。
-
-### 读取双层序列的方法
-
-我们看一下单双层序列的不同数据组织形式和dataprovider（见`rnn_data_provider.py`）
-```python
-data = [
- [[[1, 3, 2], [4, 5, 2]], 0],
- [[[0, 2], [2, 5], [0, 1, 2]], 1],
-]
-
-@provider(input_types=[integer_value_sub_sequence(10),
- integer_value(3)])
-def process_subseq(settings, file_name):
- for d in data:
- yield d
-
-@provider(input_types=[integer_value_sequence(10),
- integer_value(3)])
-def process_seq(settings, file_name):
- for d in data:
- seq = []
-```
-- 单层序列：有两句，分别为[1,3,2,4,5,2]和[0,2,2,5,0,1,2]。
-- 双层序列：有两句，分别为[[1,3,2],[4,5,2]]（2个子句）和[[0,2],[2,5],[0,1,2]]（3个子句）。
-- 单双层序列的label都分别是0和1
-
-### 模型中的配置
-
-我们选取单双层序列配置中的不同部分，来对比分析两者语义相同的原因。
-
-- 单层序列：过了一个很简单的recurrent_group。每一个时间步，当前的输入y和上一个时间步的输出rnn_state做了一个全链接。
-
-```python
-def step(y):
- mem = memory(name="rnn_state", size=hidden_dim)
- return fc_layer(input=[y, mem],
- size=hidden_dim,
- act=TanhActivation(),
- bias_attr=True,
- name="rnn_state")
-
-out = recurrent_group(step=step, input=emb)
-```
-- 双层序列，外层memory是一个元素：
- - 内层inner_step的recurrent_group和单层序列的几乎一样。除了boot_layer=outer_mem，表示将外层的outer_mem作为内层memory的初始状态。外层outer_step中，outer_mem是一个子句的最后一个向量，即整个双层group是将前一个子句的最后一个向量，作为下一个子句memory的初始状态。
- - 从输入数据上看，单双层序列的句子是一样的，只是双层序列将其又做了子序列划分。因此双层序列的配置中，必须将前一个子句的最后一个元素，作为boot_layer传给下一个子句的memory，才能保证和单层序列的配置中“每一个时间步都用了上一个时间步的输出结果”一致。
-
-```python
-def outer_step(x):
- outer_mem = memory(name="outer_rnn_state", size=hidden_dim)
- def inner_step(y):
- inner_mem = memory(name="inner_rnn_state",
- size=hidden_dim,
- boot_layer=outer_mem)
- return fc_layer(input=[y, inner_mem],
- size=hidden_dim,
- act=TanhActivation(),
- bias_attr=True,
- name="inner_rnn_state")
-
- inner_rnn_output = recurrent_group(
- step=inner_step,
- input=x)
- last = last_seq(input=inner_rnn_output, name="outer_rnn_state")
-
- return inner_rnn_output
-
-out = recurrent_group(step=outer_step, input=SubsequenceInput(emb))
-```
-- 双层序列，外层memory是单层序列：
- - 由于外层每个时间步返回的是一个子句，这些子句的长度往往不等长。因此当外层有is_seq=True的memory时，内层是**无法直接使用**它的，即内层memory的boot_layer不能链接外层的这个memory。
- - 如果内层memory想**间接使用**这个外层memory，只能通过`pooling_layer`、`last_seq`或`first_seq`这三个layer将它先变成一个元素。但这种情况下，外层memory必须有boot_layer，否则在第0个时间步时，由于外层memory没有任何seq信息，因此上述三个layer的前向会报出“**Check failed: input.sequenceStartPositions**”的错误。
-
-## 示例3：双进双出，输入不等长
-
-**输入不等长**是指recurrent_group的多个输入在各时刻的长度可以不相等, 但需要指定一个和输出长度一致的input，用targetInlink表示。参考配置：单层RNN（`sequence_rnn_multi_unequalength_inputs.conf`），双层RNN（`sequence_nest_rnn_multi_unequalength_inputs.conf`）
-
-### 读取双层序列的方法
-
-我们看一下单双层序列的数据组织形式和dataprovider（见`rnn_data_provider.py`）
-```python
-data2 = [
- [[[1, 2], [4, 5, 2]], [[5, 4, 1], [3, 1]] ,0],
- [[[0, 2], [2, 5], [0, 1, 2]],[[1, 5], [4], [2, 3, 6, 1]], 1],
-]
-
-@provider(input_types=[integer_value_sub_sequence(10),
- integer_value_sub_sequence(10),
- integer_value(2)],
- should_shuffle=False)
-def process_unequalength_subseq(settings, file_name): #双层RNN的dataprovider
- for d in data2:
- yield d
-
-
-@provider(input_types=[integer_value_sequence(10),
- integer_value_sequence(10),
- integer_value(2)],
- should_shuffle=False)
-def process_unequalength_seq(settings, file_name): #单层RNN的dataprovider
- for d in data2:
- words1=reduce(lambda x,y: x+y, d[0])
- words2=reduce(lambda x,y: x+y, d[1])
- yield words1, words2, d[2]
-```
-
-data2 中有两个样本，每个样本有两个特征, 记fea1, fea2。
-
-- 单层序列：两个样本分别为[[1, 2, 4, 5, 2], [5, 4, 1, 3, 1]] 和 [[0, 2, 2, 5, 0, 1, 2], [1, 5, 4, 2, 3, 6, 1]]
-- 双层序列：两个样本分别为
- - **样本1**：[[[1, 2], [4, 5, 2]], [[5, 4, 1], [3, 1]]]。fea1和fea2都分别有2个子句，fea1=[[1, 2], [4, 5, 2]], fea2=[[5, 4, 1], [3, 1]]
- - **样本2**：[[[0, 2], [2, 5], [0, 1, 2]],[[1, 5], [4], [2, 3, 6, 1]]]。fea1和fea2都分别有3个子句， fea1=[[0, 2], [2, 5], [0, 1, 2]], fea2=[[1, 5], [4], [2, 3, 6, 1]]。
- - **注意**：每个样本中，各特征的子句数目需要相等。这里说的“双进双出，输入不等长”是指fea1在i时刻的输入的长度可以不等于fea2在i时刻的输入的长度。如对于第1个样本，时刻i=2, fea1[2]=[4, 5, 2]，fea2[2]=[3, 1]，3≠2。
-- 单双层序列中，两个样本的label都分别是0和1
-
-### 模型中的配置
-
-单层RNN（`sequence_rnn_multi_unequalength_inputs.conf`）和双层RNN（`sequence_nest_rnn_multi_unequalength_inputs.conf`）两个模型配置达到的效果完全一样，区别只在于输入为单层还是双层序列，现在我们来看它们内部分别是如何实现的。
-
-- 单层序列：
- - 过了一个简单的recurrent_group。每一个时间步，当前的输入y和上一个时间步的输出rnn_state做了一个全连接，功能与示例2中`sequence_rnn.conf`的`step`函数完全相同。这里，两个输入x1,x2分别通过calrnn返回最后时刻的状态。结果得到的encoder1_rep和encoder2_rep分别是单层序列，最后取encoder1_rep的最后一个时刻和encoder2_rep的所有时刻分别相加得到context。
- - 注意到这里recurrent_group输入的每个样本中，fea1和fea2的长度都分别相等，这并非偶然，而是因为recurrent_group要求输入为单层序列时，所有输入的长度都必须相等。
-
-```python
-def step(x1, x2):
- def calrnn(y):
- mem = memory(name = 'rnn_state_' + y.name, size = hidden_dim)
- out = fc_layer(input = [y, mem],
- size = hidden_dim,
- act = TanhActivation(),
- bias_attr = True,
- name = 'rnn_state_' + y.name)
- return out
-
- encoder1 = calrnn(x1)
- encoder2 = calrnn(x2)
- return [encoder1, encoder2]
-
-encoder1_rep, encoder2_rep = recurrent_group(
- name="stepout",
- step=step,
- input=[emb1, emb2])
-
-encoder1_last = last_seq(input = encoder1_rep)
-encoder1_expandlast = expand_layer(input = encoder1_last,
- expand_as = encoder2_rep)
-context = mixed_layer(input = [identity_projection(encoder1_expandlast),
- identity_projection(encoder2_rep)],
- size = hidden_dim)
-```
-- 双层序列：
- - 双层RNN中，对输入的两个特征分别求时序上的连续全连接(`inner_step1`和`inner_step2`分别处理fea1和fea2)，其功能与示例2中`sequence_nest_rnn.conf`的`outer_step`函数完全相同。不同之处是，此时输入`[SubsequenceInput(emb1), SubsequenceInput(emb2)]`在各时刻并不等长。
- - 函数`outer_step`中可以分别处理这两个特征，但我们需要用targetInlink指定recurrent_group的输出的格式（各子句长度）只能和其中一个保持一致，如这里选择了和emb2的长度一致。
- - 最后，依然是取encoder1_rep的最后一个时刻和encoder2_rep的所有时刻分别相加得到context。
-
-```python
-def outer_step(x1, x2):
- outer_mem1 = memory(name = "outer_rnn_state1", size = hidden_dim)
- outer_mem2 = memory(name = "outer_rnn_state2", size = hidden_dim)
- def inner_step1(y):
- inner_mem = memory(name = 'inner_rnn_state_' + y.name,
- size = hidden_dim,
- boot_layer = outer_mem1)
- out = fc_layer(input = [y, inner_mem],
- size = hidden_dim,
- act = TanhActivation(),
- bias_attr = True,
- name = 'inner_rnn_state_' + y.name)
- return out
-
- def inner_step2(y):
- inner_mem = memory(name = 'inner_rnn_state_' + y.name,
- size = hidden_dim,
- boot_layer = outer_mem2)
- out = fc_layer(input = [y, inner_mem],
- size = hidden_dim,
- act = TanhActivation(),
- bias_attr = True,
- name = 'inner_rnn_state_' + y.name)
- return out
-
- encoder1 = recurrent_group(
- step = inner_step1,
- name = 'inner1',
- input = x1)
-
- encoder2 = recurrent_group(
- step = inner_step2,
- name = 'inner2',
- input = x2)
-
- sentence_last_state1 = last_seq(input = encoder1, name = 'outer_rnn_state1')
- sentence_last_state2_ = last_seq(input = encoder2, name = 'outer_rnn_state2')
-
- encoder1_expand = expand_layer(input = sentence_last_state1,
- expand_as = encoder2)
-
- return [encoder1_expand, encoder2]
-
-encoder1_rep, encoder2_rep = recurrent_group(
- name="outer",
- step=outer_step,
- input=[SubsequenceInput(emb1), SubsequenceInput(emb2)],
- targetInlink=emb2)
-
-encoder1_last = last_seq(input = encoder1_rep)
-encoder1_expandlast = expand_layer(input = encoder1_last,
- expand_as = encoder2_rep)
-context = mixed_layer(input = [identity_projection(encoder1_expandlast),
- identity_projection(encoder2_rep)],
- size = hidden_dim)
-```
-
-## 示例4：beam_search的生成
-
-TBD
diff --git a/doc_cn/algorithm/rnn/hrnn_demo.rst b/doc_cn/algorithm/rnn/hrnn_demo.rst
new file mode 100644
index 0000000000000000000000000000000000000000..96396ff105d134920396ded9ad8f00494357a37c
--- /dev/null
+++ b/doc_cn/algorithm/rnn/hrnn_demo.rst
@@ -0,0 +1,7 @@
+.. _algo_hrnn_demo:
+
+#################
+双层RNN的使用示例
+#################
+
+TBD
\ No newline at end of file
diff --git a/doc_cn/algorithm/rnn/hrnn_rnn_api_compare.rst b/doc_cn/algorithm/rnn/hrnn_rnn_api_compare.rst
new file mode 100644
index 0000000000000000000000000000000000000000..9baa0b578041ab82331a94c2a9e4d081697a5fda
--- /dev/null
+++ b/doc_cn/algorithm/rnn/hrnn_rnn_api_compare.rst
@@ -0,0 +1,230 @@
+.. _algo_hrnn_rnn_api_compare:
+
+#####################
+单双层RNN API对比介绍
+#####################
+
+本文以PaddlePaddle的双层RNN单元测试为示例，用多对效果完全相同的、分别使用单双层RNN作为网络配置的模型，来讲解如何使用双层RNN。本文中所有的例子，都只是介绍双层RNN的API接口，并不是使用双层RNN解决实际的问题。如果想要了解双层RNN在具体问题中的使用，请参考\ :ref:`algo_hrnn_demo`\ 。本文中示例所使用的单元测试文件是\ `test_RecurrentGradientMachine.cpp `_\ 。
+
+示例1：双层RNN，子序列间无Memory
+================================
+
+在双层RNN中的经典情况是将内层的每一个时间序列数据，分别进行序列操作；并且内层的序列操作之间独立无依赖，即不需要使用Memory\ 。
+
+在本示例中，单层RNN和双层RNN的网络配置，都是将每一句分好词后的句子，使用LSTM作为encoder，压缩成一个向量。区别是RNN使用两层序列模型，将多句话看成一个整体同时使用encoder压缩。二者语意上完全一致。这组语义相同的示例配置如下：
+
+* 单层RNN\: `sequence_layer_group.conf `_
+* 双层RNN\: `sequence_nest_layer_group.conf `_
+
+
+读取双层序列数据
+----------------
+
+首先，本示例中使用的原始数据如下\:
+
+- 本例中的原始数据一共有10个样本。每个样本由两部分组成，一个label（此处都为2）和一个已经分词后的句子。这个数据也被单层RNN网络直接使用。
+
+.. literalinclude:: ../../../paddle/gserver/tests/Sequence/tour_train_wdseg
+ :language: text
+
+
+- 双层序列数据一共有4个样本。 每个样本间用空行分开，整体数据和原始数据完全一样。但于双层序列的LSTM来说，第一个样本同时encode两条数据成两个向量。这四条数据同时处理的句子数量为\ :code:`[2, 3, 2, 3]`\ 。
+
+.. literalinclude:: ../../../paddle/gserver/tests/Sequence/tour_train_wdseg.nest
+ :language: text
+
+其次，对于两种不同的输入数据类型，不同DataProvider对比如下(`sequenceGen.py `_)\：
+
+.. literalinclude:: ../../../paddle/gserver/tests/sequenceGen.py
+ :language: python
+ :lines: 21-39
+ :linenos:
+
+- 这是普通的单层时间序列的DataProvider代码，其说明如下：
+
+ * DataProvider共返回两个数据，分别是words和label。即上述代码中的第19行。
+ - words是原始数据中的每一句话，所对应的词表index数组。它是integer_value_sequence类型的，即整数数组。words即为这个数据中的单层时间序列。
+ - label是原始数据中对于每一句话的分类标签，它是integer_value类型的。
+
+.. literalinclude:: ../../../paddle/gserver/tests/sequenceGen.py
+ :language: python
+ :lines: 42-71
+ :linenos:
+
+- 对于同样的数据，双层时间序列的DataProvider的代码。其说明如下：
+
+ - DataProvider共返回两组数据，分别是sentences和labels。即在双层序列的原始数据中，每一组内的所有句子和labels
+ - sentences是双层时间序列的数据。由于它内部包含了每组数据中的所有句子，且每个句子表示为对应的词表索引数组，因此它是integer_value_sub_sequence 类型的，即双层时间序列。
+ - labels是每组内每个句子的标签，故而是一个单层时间序列。
+
+
+模型配置的模型配置
+------------------------------------------
+
+首先，我们看一下单层RNN的配置。代码中9-15行(高亮部分)即为单层RNN序列的使用代码。这里使用了PaddlePaddle预定义好的RNN处理函数。在这个函数中，RNN对于每一个时间步通过了一个LSTM网络。
+
+.. literalinclude:: ../../../paddle/gserver/tests/sequence_layer_group.conf
+ :language: python
+ :lines: 38-63
+ :linenos:
+ :emphasize-lines: 9-15
+
+
+其次，我们看一下语义相同的双层RNN的网络配置\:
+
+* PaddlePaddle中的许多layer并不在意输入是否是时间序列，例如\ :code:`embedding_layer`\ 。在这些layer中，所有的操作都是针对每一个时间步来进行的。
+
+* 在该配置的7-26行(高亮部分)，将双层时间序列数据先变换成单层时间序列数据，再对每一个单层时间序列进行处理。
+
+ * 使用\ :code:`recurrent_group`\ 这个函数进行变换，在变换时需要将输入序列传入。由于我们想要的变换是双层时间序列=> 单层时间序列，所以我们需要将输入数据标记成\ :code:`SubsequenceInput`\ 。
+
+ * 在本例中，我们将原始数据的每一组，通过\ :code:`recurrent_group`\ 进行拆解，拆解成的每一句话再通过一个LSTM网络。这和单层RNN的配置是等价的。
+
+* 与单层RNN的配置类似，我们只需要使用LSTM encode成的最后一个向量。所以对\ :code:`recurrent_group`\ 进行了\ :code:`last_seq`\ 操作。但和单层RNN不同，我们是对每一个子序列取最后一个元素，因此\ :code:`agg_level=AggregateLevel.EACH_SEQUENCE`\ 。
+
+* 至此，\ :code:`lstm_last`\ 便和单层RNN配置中的\ :code:`lstm_last`\ 具有相同的结果了。
+
+.. literalinclude:: ../../../paddle/gserver/tests/sequence_nest_layer_group.conf
+ :language: python
+ :lines: 38-64
+ :linenos:
+ :emphasize-lines: 7-26
+
+示例2：双层RNN，子序列间有Memory
+================================
+
+本示例意图使用单层RNN和双层RNN实现两个完全等价的全连接RNN。
+
+* 对于单层RNN，输入数据为一个完整的时间序列，例如\ :code:`[4, 5, 2, 0, 9, 8, 1, 4]`\ 。
+
+* 对于双层RNN，输入数据为在单层RNN数据里面，任意将一些数据组合成双层时间序列，例如\ :code:`[ [4, 5, 2], [0, 9], [8, 1, 4]]`。
+
+模型配置的模型配置
+------------------
+
+我们选取单双层序列配置中的不同部分，来对比分析两者语义相同的原因。
+
+- 单层RNN：过了一个很简单的recurrent_group。每一个时间步，当前的输入y和上一个时间步的输出rnn_state做了一个全链接。
+
+.. literalinclude:: ../../../paddle/gserver/tests/sequence_rnn.conf
+ :language: python
+ :lines: 36-48
+
+- 双层RNN，外层memory是一个元素：
+
+ - 内层inner_step的recurrent_group和单层序列的几乎一样。除了boot_layer=outer_mem，表示将外层的outer_mem作为内层memory的初始状态。外层outer_step中，outer_mem是一个子句的最后一个向量，即整个双层group是将前一个子句的最后一个向量，作为下一个子句memory的初始状态。
+ - 从输入数据上看，单双层序列的句子是一样的，只是双层序列将其又做了子序列划分。因此双层序列的配置中，必须将前一个子句的最后一个元素，作为boot_layer传给下一个子句的memory，才能保证和单层序列的配置中“每个时间步都用了上一个时间步的输出结果”一致。
+
+.. literalinclude:: ../../../paddle/gserver/tests/sequence_nest_rnn.conf
+ :language: python
+ :lines: 39-66
+
+.. warning::
+ PaddlePaddle目前只支持在每个时间步中，Memory的时间序列长度一致的情况。
+
+示例3：双层RNN，输入不等长
+==========================
+
+.. role:: red
+
+.. raw:: html
+
+
+
+**输入不等长** 是指recurrent_group的多个输入序列，在每个时间步的子序列长度可以不相等。但序列输出时，需要指定与某一个输入的序列信息是一致的。使用\ :red:`targetInlink`\ 可以指定哪一个输入和输出序列信息一致，默认指定第一个输入。
+
+示例3的配置分别为\ `单层不等长RNN `_\ 和\ `双层不等长RNN `_\ 。
+
+示例3对于单层RNN和双层RNN数据完全相同。
+
+* 对于单层RNN的数据一共有两个样本，他们分别是\ :code:`[1, 2, 4, 5, 2], [5, 4, 1, 3, 1]`\ 和\ :code:`[0, 2, 2, 5, 0, 1, 2], [1, 5, 4, 2, 3, 6, 1]`\ 。对于每一个单层RNN的数据，均有两组特征。
+
+* 在单层数据的基础上，双层RNN数据随意加了一些隔断，例如将第一条数据转化为\ :code:`[[0, 2], [2, 5], [0, 1, 2]],[[1, 5], [4], [2, 3, 6, 1]]`\ 。
+
+* 需要注意的是PaddlePaddle目前只支持子序列数目一样的多输入双层RNN。例如本例中的两个特征，均有三个子序列。每个子序列长度可以不一致，但是子序列的数目必须一样。
+
+
+模型配置
+--------
+
+和示例2中的配置类似，示例3的配置使用了单层RNN和双层RNN，实现两个完全等价的全连接RNN。
+
+* 单层RNN\:
+
+.. literalinclude:: ../../../paddle/gserver/tests/sequence_rnn_multi_unequalength_inputs.py
+ :language: python
+ :lines: 42-59
+ :linenos:
+
+* 双层RNN\ \:
+
+.. literalinclude:: ../../../paddle/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py
+ :language: python
+ :lines: 41-80
+ :linenos:
+
+在上面代码中，单层和双层序列的使用和示例2中的示例类似，区别是同时处理了两个输入。而对于双层序列，两个输入的子序列长度也并不相同。但是，我们使用了\ :code:`targetInlink`\ 参数设置了外层\ :code:`recurrent_group`\ 的输出格式。所以外层输出的序列形状，和\ :code:`emb2`\ 的序列形状一致。
+
+示例4：beam_search的生成
+========================
+
+TBD
+
+
+词汇表
+======
+
+.. _glossary_memory:
+
+Memory
+------
+
+Memory是PaddlePaddle实现RNN时候使用的一个概念。RNN即时间递归神经网络，通常要求时间步之间具有一些依赖性，即当前时间步下的神经网络依赖前一个时间步神经网络中某一个神经元输出。如下图所示。
+
+.. graphviz:: glossary_rnn.dot
+
+上图中虚线的连接，即是跨越时间步的网络连接。PaddlePaddle在实现RNN的时候，将这种跨越时间步的连接用一个特殊的神经网络单元实现。这个神经网络单元就叫Memory。Memory可以缓存上一个时刻某一个神经元的输出，然后在下一个时间步输入给另一个神经元。使用Memory的RNN实现便如下图所示。
+
+.. graphviz:: glossary_rnn_with_memory.dot
+
+使用这种方式，PaddlePaddle可以比较简单的判断哪些输出是应该跨越时间步的，哪些不是。
+
+.. _glossary_timestep:
+
+时间步
+------
+
+参考时间序列。
+
+
+.. _glossary_sequence:
+
+时间序列
+--------
+
+时间序列(time series)是指一系列的特征数据。这些特征数据之间的顺序是有意义的。即特征的数组，而不是特征的集合。而这每一个数组元素，或者每一个系列里的特征数据，即为一个时间步(time step)。值得注意的是，时间序列、时间步的概念，并不真正的和『时间』有关。只要一系列特征数据中的『顺序』是有意义的，即为时间序列的输入。
+
+举例说明，例如文本分类中，我们通常将一句话理解成一个时间序列。比如一句话中的每一个单词，会变成词表中的位置。而这一句话就可以表示成这些位置的数组。例如 :code:`[9, 2, 3, 5, 3]` 。
+
+关于时间序列(time series)的更详细准确的定义，可以参考 `维基百科页面 Time series `_ 或者 `维基百科中文页面 时间序列 `_ 。
+
+另外，Paddle中经常会将时间序列成为 :code:`Sequence` 。他们在Paddle的文档和API中是一个概念。
+
+.. _glossary_RNN:
+
+RNN
+---
+
+RNN 在PaddlePaddle的文档中，一般表示 :code:`Recurrent neural network`，即时间递归神经网络。详细介绍可以参考 `维基百科页面 Recurrent neural network `_ 或者 `中文维基百科页面 `_ 中关于时间递归神经网络的介绍。
+
+RNN 一般在PaddlePaddle中，指对于一个时间序列输入数据，每一个时间步之间的神经网络具有一定的相关性。例如，某一个神经元的一个输入为上一个时间步网络中某一个神经元的输出。或者，从每一个时间步来看，神经网络的网络结构中具有有向环结构。
+
+.. _glossary_双层RNN:
+
+双层RNN
+-------
+
+双层RNN顾名思义，即RNN之间有一次嵌套关系。输入数据整体上是一个时间序列，而对于每一个内层特征数据而言，也是一个时间序列。即二维数组，或者数组的数组这个概念。 而双层RNN是可以处理这种输入数据的网络结构。
+
+例如，对于段落的文本分类，即将一段话进行分类。我们将一段话看成句子的数组，每个句子又是单词的数组。这便是一种双层RNN的输入数据。而将这个段落的每一句话用lstm编码成一个向量，再对每一句话的编码向量用lstm编码成一个段落的向量。再对这个段落向量进行分类，即为这个双层RNN的网络结构。
+
diff --git a/doc_cn/algorithm/rnn/simple_full_hierarchical_recurrent.dot b/doc_cn/algorithm/rnn/simple_full_hierarchical_recurrent.dot
new file mode 100644
index 0000000000000000000000000000000000000000..ff278a0323bb2c3ef07bf6f016a3a8df05783581
--- /dev/null
+++ b/doc_cn/algorithm/rnn/simple_full_hierarchical_recurrent.dot
@@ -0,0 +1,30 @@
+digraph G {
+ rankdir=LR;
+
+ subgraph cluster_t0 {
+ a [label="4"]
+ b [label="5"]
+ c [label="2"]
+ }
+
+ subgraph cluster_t1 {
+ d [label="0"]
+ e [label="9"]
+ }
+
+ subgraph cluster_t2 {
+ f [label="8"]
+ g [label="1"]
+ h [label="4"]
+ }
+
+ a -> b;
+ b -> c;
+ c -> d [constraint=false];
+
+ d -> e;
+ e -> f [constraint=false];
+
+ f -> g;
+ g -> h;
+}
\ No newline at end of file
diff --git a/doc_cn/algorithm/rnn/simple_full_recurrent.dot b/doc_cn/algorithm/rnn/simple_full_recurrent.dot
new file mode 100644
index 0000000000000000000000000000000000000000..cee281fbac993afbd0cc3416570f95965cdf0a59
--- /dev/null
+++ b/doc_cn/algorithm/rnn/simple_full_recurrent.dot
@@ -0,0 +1,19 @@
+digraph G {
+ rankdir=LR;
+ a [label="4"]
+ b [label="5"]
+ c [label="2"]
+ d [label="0"]
+ e [label="9"]
+ f [label="8"]
+ g [label="1"]
+ h [label="4"]
+
+ a -> b;
+ b -> c;
+ c -> d;
+ d -> e;
+ e -> f;
+ f -> g;
+ g -> h;
+}
\ No newline at end of file
diff --git a/doc_cn/concepts/use_concepts.rst b/doc_cn/concepts/use_concepts.rst
index 67e98edabc0c2a4ecdf8d7993f8dd66b9365a05d..73fa78455f5287101e7e6855f08ecfb2764b8b4b 100644
--- a/doc_cn/concepts/use_concepts.rst
+++ b/doc_cn/concepts/use_concepts.rst
@@ -32,6 +32,7 @@ PaddlePaddle进程内嵌了一个 :code:`python` 解释器。 这个 :code:`pyth
所以，PaddlePaddle单机训练进程，:code:`paddle train` , 对于用户的主要接口语言为 python。 主要需要用户配置的两个文件为 :code:`DataProvider` 和训练文件 :code:`TrainerConfig` 。
+.. _glossary_DataProvider:
DataProvider
============
@@ -42,6 +43,7 @@ DataProvider是 :code:`paddle train` 的数据提供器。 它负责将用户的
为了方便用户使用自己的数据格式， PaddlePaddle 提供了 `PyDataProvider`_ 来处理数据。 并且在这个Provider中，PaddlePaddle的 C++ 部分接管了如何shuffle，处理 batch，GPU/CPU通信，双缓冲，异步读取等问题。 用户可以参考 `PyDataProvider`_ 的相关文档，继续深入了解 DataProvider 的使用。
+.. _glossary_trainer_config:
训练文件
========
diff --git a/doc_cn/conf.py.in b/doc_cn/conf.py.in
index 421e0c298d4430082b5ba7ef317408fc5c32cda7..4f3afb814f1e779a711e3535da1f8853aa0d97c6 100644
--- a/doc_cn/conf.py.in
+++ b/doc_cn/conf.py.in
@@ -69,7 +69,7 @@ master_doc = 'index'
#
# This is also used if you do content translation via gettext catalogs.
# Usually you set "language" from the command line for these cases.
-language = None
+language = 'zh_CN'
# There are two options for replacing |today|: either, you set today to some
# non-false value, then it is used:
diff --git a/doc_cn/index.rst b/doc_cn/index.rst
index c9f2126c3e36a019a1dbff2cfafd109eb58b77aa..88a9f79fd23c97785a054af2aa9ee53f8578ef63 100644
--- a/doc_cn/index.rst
+++ b/doc_cn/index.rst
@@ -23,7 +23,7 @@ PaddlePaddle文档
* `Recurrent Group教程 `_
* `单层RNN示例 <../doc/algorithm/rnn/rnn.html>`_
-* `双层RNN示例 `_
+* :ref:`algo_hrnn_rnn_api_compare`
* `支持双层序列作为输入的Layer `_
常见问题
diff --git a/paddle/gserver/tests/sequenceGen.py b/paddle/gserver/tests/sequenceGen.py
index fab876fd30da0a80774d06028ae2321e12354d59..99440ada535da3c0f9fe6027171b08fec742023a 100644
--- a/paddle/gserver/tests/sequenceGen.py
+++ b/paddle/gserver/tests/sequenceGen.py
@@ -33,10 +33,10 @@ def process(settings, file_name):
label, comment = line.strip().split('\t')
label = int(''.join(label.split()))
words = comment.split()
- word_slot = [
+ words = [
settings.word_dict[w] for w in words if w in settings.word_dict
]
- yield word_slot, label
+ yield words, label
## for hierarchical sequence network
@@ -52,20 +52,20 @@ def hook2(settings, dict_file, **kwargs):
@provider(init_hook=hook2, should_shuffle=False)
def process2(settings, file_name):
with open(file_name) as fdata:
- label_list = []
- word_slot_list = []
+ labels = []
+ sentences = []
for line in fdata:
if (len(line)) > 1:
label, comment = line.strip().split('\t')
label = int(''.join(label.split()))
words = comment.split()
- word_slot = [
+ words = [
settings.word_dict[w] for w in words
if w in settings.word_dict
]
- label_list.append(label)
- word_slot_list.append(word_slot)
+ labels.append(label)
+ sentences.append(words)
else:
- yield word_slot_list, label_list
- label_list = []
- word_slot_list = []
+ yield sentences, labels
+ labels = []
+ sentences = []
diff --git a/paddle/gserver/tests/sequence_nest_rnn.conf b/paddle/gserver/tests/sequence_nest_rnn.conf
index 93b08eb2f8746d514e35b49e5261e4fa9fa681e6..524760be765943cdc4bf90315d63013d93b764bb 100644
--- a/paddle/gserver/tests/sequence_nest_rnn.conf
+++ b/paddle/gserver/tests/sequence_nest_rnn.conf
@@ -55,9 +55,8 @@ def outer_step(x):
input=x)
last = last_seq(input=inner_rnn_output, name="outer_rnn_state")
- # "return last" should also work. But currently RecurrentGradientMachine
- # does not handle it, and will report error: In hierachical RNN, all out
- # links should be from sequences now.
+ # "return last" won't work, because recurrent_group only support the input
+ # sequence type is same as return sequence type.
return inner_rnn_output
out = recurrent_group(
diff --git a/paddle/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.conf b/paddle/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.conf
deleted file mode 100644
index d0b9450f4b9f9659fdd606503b6bc1ea45338c76..0000000000000000000000000000000000000000
--- a/paddle/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.conf
+++ /dev/null
@@ -1,106 +0,0 @@
-#edit-mode: -*- python -*-
-# Copyright (c) 2016 Baidu, Inc. All Rights Reserved
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-from paddle.trainer_config_helpers import *
-
-######################## data source ################################
-define_py_data_sources2(train_list='gserver/tests/Sequence/dummy.list',
- test_list=None,
- module='rnn_data_provider',
- obj='process_unequalength_subseq')
-
-
-settings(batch_size=2, learning_rate=0.01)
-######################## network configure ################################
-dict_dim = 10
-word_dim = 8
-hidden_dim = 8
-label_dim = 2
-
-speaker1 = data_layer(name="word1", size=dict_dim)
-speaker2 = data_layer(name="word2", size=dict_dim)
-
-emb1 = embedding_layer(input=speaker1, size=word_dim)
-emb2 = embedding_layer(input=speaker2, size=word_dim)
-
-# This hierachical RNN is designed to be equivalent to the simple RNN in
-# sequence_rnn_multi_unequalength_inputs.conf
-
-def outer_step(x1, x2):
- outer_mem1 = memory(name = "outer_rnn_state1", size = hidden_dim)
- outer_mem2 = memory(name = "outer_rnn_state2", size = hidden_dim)
- def inner_step1(y):
- inner_mem = memory(name = 'inner_rnn_state_' + y.name,
- size = hidden_dim,
- boot_layer = outer_mem1)
- out = fc_layer(input = [y, inner_mem],
- size = hidden_dim,
- act = TanhActivation(),
- bias_attr = True,
- name = 'inner_rnn_state_' + y.name)
- return out
-
- def inner_step2(y):
- inner_mem = memory(name = 'inner_rnn_state_' + y.name,
- size = hidden_dim,
- boot_layer = outer_mem2)
- out = fc_layer(input = [y, inner_mem],
- size = hidden_dim,
- act = TanhActivation(),
- bias_attr = True,
- name = 'inner_rnn_state_' + y.name)
- return out
-
- encoder1 = recurrent_group(
- step = inner_step1,
- name = 'inner1',
- input = x1)
-
- encoder2 = recurrent_group(
- step = inner_step2,
- name = 'inner2',
- input = x2)
-
- sentence_last_state1 = last_seq(input = encoder1, name = 'outer_rnn_state1')
- sentence_last_state2_ = last_seq(input = encoder2, name = 'outer_rnn_state2')
-
- encoder1_expand = expand_layer(input = sentence_last_state1,
- expand_as = encoder2)
-
- return [encoder1_expand, encoder2]
-
-
-encoder1_rep, encoder2_rep = recurrent_group(
- name="outer",
- step=outer_step,
- input=[SubsequenceInput(emb1), SubsequenceInput(emb2)],
- targetInlink=emb2)
-
-encoder1_last = last_seq(input = encoder1_rep)
-encoder1_expandlast = expand_layer(input = encoder1_last,
- expand_as = encoder2_rep)
-context = mixed_layer(input = [identity_projection(encoder1_expandlast),
- identity_projection(encoder2_rep)],
- size = hidden_dim)
-
-rep = last_seq(input=context)
-prob = fc_layer(size=label_dim,
- input=rep,
- act=SoftmaxActivation(),
- bias_attr=True)
-
-outputs(classification_cost(input=prob,
- label=data_layer(name="label", size=label_dim)))
-
diff --git a/paddle/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py b/paddle/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py
new file mode 100644
index 0000000000000000000000000000000000000000..163fce956e917f4d3fe6e17bfc4592abd9edddb4
--- /dev/null
+++ b/paddle/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py
@@ -0,0 +1,98 @@
+# edit-mode: -*- python -*-
+# Copyright (c) 2016 Baidu, Inc. All Rights Reserved
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from paddle.trainer_config_helpers import *
+
+######################## data source ################################
+define_py_data_sources2(
+ train_list='gserver/tests/Sequence/dummy.list',
+ test_list=None,
+ module='rnn_data_provider',
+ obj='process_unequalength_subseq')
+
+settings(batch_size=2, learning_rate=0.01)
+######################## network configure ################################
+dict_dim = 10
+word_dim = 8
+hidden_dim = 8
+label_dim = 2
+
+speaker1 = data_layer(name="word1", size=dict_dim)
+speaker2 = data_layer(name="word2", size=dict_dim)
+
+emb1 = embedding_layer(input=speaker1, size=word_dim)
+emb2 = embedding_layer(input=speaker2, size=word_dim)
+
+
+# This hierarchical RNN is designed to be equivalent to the simple RNN in
+# sequence_rnn_multi_unequalength_inputs.conf
+def outer_step(x1, x2):
+ index = [0]
+
+ def inner_step(ipt):
+ index[0] += 1
+ i = index[0]
+ outer_mem = memory(name="outer_rnn_state_%d" % i, size=hidden_dim)
+
+ def inner_step_impl(y):
+ inner_mem = memory(
+ name="inner_rnn_state_" + y.name,
+ size=hidden_dim,
+ boot_layer=outer_mem)
+ out = fc_layer(
+ input=[y, inner_mem],
+ size=hidden_dim,
+ act=TanhActivation(),
+ bias_attr=True,
+ name='inner_rnn_state_' + y.name)
+ return out
+
+ encoder = recurrent_group(
+ step=inner_step_impl, name='inner_%d' % i, input=ipt)
+ last = last_seq(name="outer_rnn_state_%d" % i, input=encoder)
+ return encoder, last
+
+ encoder1, sentence_last_state1 = inner_step(ipt=x1)
+ encoder2, sentence_last_state2 = inner_step(ipt=x2)
+
+ encoder1_expand = expand_layer(
+ input=sentence_last_state1, expand_as=encoder2)
+
+ return [encoder1_expand, encoder2]
+
+
+encoder1_rep, encoder2_rep = recurrent_group(
+ name="outer",
+ step=outer_step,
+ input=[SubsequenceInput(emb1), SubsequenceInput(emb2)],
+ targetInlink=emb2)
+
+encoder1_last = last_seq(input=encoder1_rep)
+encoder1_expandlast = expand_layer(input=encoder1_last, expand_as=encoder2_rep)
+context = mixed_layer(
+ input=[
+ identity_projection(encoder1_expandlast),
+ identity_projection(encoder2_rep)
+ ],
+ size=hidden_dim)
+
+rep = last_seq(input=context)
+prob = fc_layer(
+ size=label_dim, input=rep, act=SoftmaxActivation(), bias_attr=True)
+
+outputs(
+ classification_cost(
+ input=prob, label=data_layer(
+ name="label", size=label_dim)))
diff --git a/paddle/gserver/tests/sequence_rnn_multi_unequalength_inputs.conf b/paddle/gserver/tests/sequence_rnn_multi_unequalength_inputs.py
similarity index 52%
rename from paddle/gserver/tests/sequence_rnn_multi_unequalength_inputs.conf
rename to paddle/gserver/tests/sequence_rnn_multi_unequalength_inputs.py
index 28b1cb98cf132fb74b08d440be44d68c6cf3ffae..4cf7035477c4aa6b0d49bf2558e81738b86a1752 100644
--- a/paddle/gserver/tests/sequence_rnn_multi_unequalength_inputs.conf
+++ b/paddle/gserver/tests/sequence_rnn_multi_unequalength_inputs.py
@@ -16,11 +16,11 @@
from paddle.trainer_config_helpers import *
######################## data source ################################
-define_py_data_sources2(train_list='gserver/tests/Sequence/dummy.list',
- test_list=None,
- module='rnn_data_provider',
- obj='process_unequalength_seq')
-
+define_py_data_sources2(
+ train_list='gserver/tests/Sequence/dummy.list',
+ test_list=None,
+ module='rnn_data_provider',
+ obj='process_unequalength_seq')
settings(batch_size=2, learning_rate=0.01)
######################## network configure ################################
@@ -38,38 +38,40 @@ emb2 = embedding_layer(input=speaker2, size=word_dim)
# This hierachical RNN is designed to be equivalent to the RNN in
# sequence_nest_rnn_multi_unequalength_inputs.conf
+
def step(x1, x2):
- def calrnn(y):
- mem = memory(name = 'rnn_state_' + y.name, size = hidden_dim)
- out = fc_layer(input = [y, mem],
- size = hidden_dim,
- act = TanhActivation(),
- bias_attr = True,
- name = 'rnn_state_' + y.name)
- return out
-
- encoder1 = calrnn(x1)
- encoder2 = calrnn(x2)
- return [encoder1, encoder2]
+ def calrnn(y):
+ mem = memory(name='rnn_state_' + y.name, size=hidden_dim)
+ out = fc_layer(
+ input=[y, mem],
+ size=hidden_dim,
+ act=TanhActivation(),
+ bias_attr=True,
+ name='rnn_state_' + y.name)
+ return out
+
+ encoder1 = calrnn(x1)
+ encoder2 = calrnn(x2)
+ return [encoder1, encoder2]
+
encoder1_rep, encoder2_rep = recurrent_group(
- name="stepout",
- step=step,
- input=[emb1, emb2])
+ name="stepout", step=step, input=[emb1, emb2])
-encoder1_last = last_seq(input = encoder1_rep)
-encoder1_expandlast = expand_layer(input = encoder1_last,
- expand_as = encoder2_rep)
-context = mixed_layer(input = [identity_projection(encoder1_expandlast),
- identity_projection(encoder2_rep)],
- size = hidden_dim)
+encoder1_last = last_seq(input=encoder1_rep)
+encoder1_expandlast = expand_layer(input=encoder1_last, expand_as=encoder2_rep)
+context = mixed_layer(
+ input=[
+ identity_projection(encoder1_expandlast),
+ identity_projection(encoder2_rep)
+ ],
+ size=hidden_dim)
rep = last_seq(input=context)
-prob = fc_layer(size=label_dim,
- input=rep,
- act=SoftmaxActivation(),
- bias_attr=True)
-
-outputs(classification_cost(input=prob,
- label=data_layer(name="label", size=label_dim)))
+prob = fc_layer(
+ size=label_dim, input=rep, act=SoftmaxActivation(), bias_attr=True)
+outputs(
+ classification_cost(
+ input=prob, label=data_layer(
+ name="label", size=label_dim)))
diff --git a/paddle/gserver/tests/test_RecurrentGradientMachine.cpp b/paddle/gserver/tests/test_RecurrentGradientMachine.cpp
index 80d713dac03a42b370d50ebb17d089e9be2f17ff..9d86067fb5a96f8b292d00344cefaed4d6b39950 100644
--- a/paddle/gserver/tests/test_RecurrentGradientMachine.cpp
+++ b/paddle/gserver/tests/test_RecurrentGradientMachine.cpp
@@ -13,12 +13,12 @@ See the License for the specific language governing permissions and
limitations under the License. */
#include
-#include
-#include
-#include
+#include
#include
#include
-#include
+#include
+#include
+#include
P_DECLARE_int32(seed);
@@ -45,10 +45,9 @@ public:
auto p = const_cast(this);
auto& params = p->getGradientMachine()->getParameters();
return std::accumulate(
- params.begin(),
- params.end(),
- 0UL,
- [](size_t a, const ParameterPtr& p) { return a + p->getSize(); });
+ params.begin(), params.end(), 0UL, [](size_t a, const ParameterPtr& p) {
+ return a + p->getSize();
+ });
}
};
@@ -148,8 +147,8 @@ TEST(RecurrentGradientMachine, rnn_multi_input) {
TEST(RecurrentGradientMachine, rnn_multi_unequalength_input) {
for (bool useGpu : {false, true}) {
- test("gserver/tests/sequence_rnn_multi_unequalength_inputs.conf",
- "gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.conf",
+ test("gserver/tests/sequence_rnn_multi_unequalength_inputs.py",
+ "gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py",
1e-6,
useGpu);
}