row_conv

paddle.static.nn. row_conv ( input, future_context_size, param_attr=None, act=None ) [源代码]
api_attr

声明式编程模式(静态图)

该接口为行卷积(Row-convolution operator)或称之为超前卷积(lookahead convolution),最早介绍于DeepSpeech2论文中,论文链接:

双向的RNN在深度语音模型中很有用,它通过对整个序列执行正向和反向传递来学习序列的表示。然而,与单向RNNs不同的是,在线部署和低延迟设置中,双向RNNs具有难度。超前卷积将来自未来子序列的信息以一种高效的方式进行计算,以改进单向递归神经网络。 row convolution operator 与一维序列卷积不同,计算方法如下:

给定输入序列长度为 \(t\) 的输入序列 \(X\) 和输入维度 \(D\) ,以及一个大小为 \(context * D\) 的滤波器 \(W\) ,输出序列卷积为:

\[out_i = \sum_{j=i}^{i+context-1} X_{j} · W_{j-i}\]
公式中:
  • \(out_i\) : 第i行输出变量形为[1, D].

  • \(context\) : 下文(future context)大小

  • \(X_j\) : 第j行输出变量,形为[1,D]

  • \(W_{j-i}\) : 第(j-i)行参数,其形状为[1,D]。

详细请参考 设计文档

参数:
  • input (Tensor) -- 支持输入为LodTensor和Tensor,输入类型可以是[float32, float64],它支持可变时间长度的输入序列。当输入input为LodTensor时,其内部张量是一个具有形状(T x N)的矩阵,其中T是这个mini batch中的总的timestep,N是输入数据维数。当输入input为Tensor时,其形状为(B x T x N)的三维矩阵,B为mini batch大小,T为每个batch输入中的最大timestep,N是输入数据维数。当输入input为LoDTensor,形状为[9, N],LoD信息为[2, 3, 4],等价于输入input为形状是[3, 4, N]的Tensor。

  • future_context_size (int) -- 下文大小。请注意,卷积核的shape是[future_context_size + 1, N],N和输入input的数据维度N保持一致。

  • param_attr (ParamAttr) -- 参数的属性,包括名称、初始化器等。

  • act (str) -- 非线性激活函数。

返回:表示row_conv计算结果的Tensor,数据类型、维度和输入input相同。

代码示例

import paddle
paddle.enable_static()

# LoDTensor input
x = paddle.static.data(name='x', shape=[9, 16],
                      dtype='float32', lod_level=3)
out_x = paddle.static.nn.row_conv(input=x, future_context_size=2)

# Tensor input
y = paddle.static.data(name='y', shape=[9, 4, 16],
                      dtype='float32')
out_y = paddle.static.nn.row_conv(input=y, future_context_size=2)