temporal_shift

paddle.fluid.layers.temporal_shift(x, seg_num, shift_ratio=0.25, name=None)[源代码]

该OP用于对输入X做时序通道T上的位移操作，为TSM(Temporal Shift Module)中使用的操作。

输入（X）的形状应为[N*T, C, H, W]，N是批大小，T是 seg_num 指定的时间段号，C是通道号，H和W是特征的高度和宽度。

时间偏移计算如下：

步骤1：将输入（X）reshape为[N, T, C, H, W]。

步骤2：填充0到第二个(T)尺寸的变形结果，填充宽度每边为1，填充结果的形状为[N，T+2，C，H，W]。

步骤3：假设 shift_ratio 为1/4，切片填充结果如下：

temporal_shift - 图1

步骤4：沿第3(C)维连接三个切片，并将结果重塑为[N*T, C, H, W]。

有关时序移动的详细信息，请参阅文件： Temporal Shift Module

参数

  • x (Variable) – 时移算符的输入张量。维度为

    temporal_shift - 图2

    的4-D Tensor。N为批量大小，T为时间段数，C为信道数，H为特征高度，W为特征宽度，数据类型为float32或float64。

  • seg_num (int) – 时间段编号，这应该是一个正整数。
  • shift_ratio (float) – 通道的移位比、通道的第一个 shift_ratio 部分沿时间维度移动-1，通道的第二个 shift_ratio 部分沿时间维度移动1，范围须在[0, 0.5]内。默认值0.25
  • name (str，可选) – 具体用法请参见 Name ，一般无需设置。默认值：None。

返回

Variable(Tensor) 时序位移后的输出张量，维度与输入 x 一致。

返回类型

变量(Variable)，数据类型与输入 x 一致。

抛出异常

TypeError – seg_num 必须是int类型

代码示例

  1. import paddle.fluid as fluid
  2. input = fluid.data(name='input', shape=[None,4,2,2], dtype='float32')
  3. out = fluid.layers.temporal_shift(x=input, seg_num=2, shift_ratio=0.2)