fc¶

paddle.fluid.layers. fc ( input, size, num_flatten_dims=1, param_attr=None, bias_attr=None, act=None, name=None ) ¶

全连接层

该 OP 将在神经网络中构建一个全连接层。其输入可以是一个 Tensor（或 LoDTensor）或多个 Tensor（或 LoDTensor）组成的 list（详见参数说明），该 OP 会为每个输入的 Tensor 创建一个权重（weights）变量，即一个从每个输入单元到每个输出单元的全连接权重矩阵。FC 层将每个输入 Tensor 和其对应的权重(weights)相乘得到 shape 为 \([M, size]\) 输出 Tensor，其中 M 为 batch_size 大小。如果有多个输入 Tensor，则多个 shape 为 \([M, size]\) 的 Tensor 计算结果会被累加起来，作为最终输出。如果 bias_attr 非空，则会创建一个偏置变量（bias variable），并把它累加到输出结果中。如果 act 非空，将会在输出结果上应用相应的激活函数。

当输入为单个 Tensor（或 LoDTensor）：

\[\begin{split}\\Out = Act({XW + b})\\\end{split}\]

当输入为多个 Tensor（或 LoDTensor）组成的 list 时：

\[\begin{split}\\Out=Act(\sum^{N-1}_{i=0}X_iW_i+b) \\\end{split}\]

上述等式中：

\(N\)：输入的数目，如果输入是 Tensor 列表，N 等于 len(input)
\(X_i\)：第 i 个输入的 Tensor
\(W_i\)：对应第 i 个输入 Tensor 的第 i 个权重矩阵
\(b\)：该层创建的 bias 参数
\(Act\) ：activation function(激活函数)
\(Out\)：输出 Tensor

         Case 1：
    给定单个输入 Tensor data_1，且 num_flatten_dims = 2:
        data_1.data = [[[0.1, 0.2],
                       [0.3, 0.4]]]
        data_1.shape = (1, 2, 2) # 1 是 batch_size

        out = fluid.layers.fc(input=data_1, size=1， num_flatten_dims=2)

  则输出为：
        out.data = [[0.83234344], [0.34936576]]
        out.shape = (1, 2, 1)


Case 2:
    给定多个 Tensor 组成的 list:
        data_1.data = [[[0.1, 0.2],
                       [0.3, 0.4]]]
        data_1.shape = (1, 2, 2) # 1 是 batch_size

        data_2 = [[[0.1, 0.2, 0.3]]]
        data_2.shape = (1, 1, 3)

        out = fluid.layers.fc(input=[data_1, data_2], size=2)

    则输出为：
        out.data = [[0.18669507, 0.1893476]]
        out.shape = (1, 2)

        

参数¶

input (Variable|list of Variable) – 维度为 \([N_1, N_2, ..., N_k]\) 的多维 Tensor（或 LoDTensor）或由多个 Tensor（或 LoDTensor）组成的 list，输入 Tensor 的 shape 至少是 2。数据类型为 float32 或 float64。

size (int) – 全连接层输出单元的数目，即输出 Tensor（或 LoDTensor）特征维度。

num_flatten_dims (int) – 输入可以接受维度大于 2 的 Tensor。在计算时，输入首先会被扁平化（flatten）为一个二维矩阵，之后再与权重(weights)相乘。参数 num_flatten_dims 决定了输入 Tensor 的 flatten 方式：前 num_flatten_dims (包含边界，从 1 开始数) 个维度会被扁平化为二维矩阵的第一维 (即为矩阵的高)，剩下的 \(rank(X) - num\_flatten\_dims\) 维被扁平化为二维矩阵的第二维 (即矩阵的宽)。例如，假设 X 是一个五维的 Tensor，其 shape 为(2, 3, 4, 5, 6)，若 \(num\_flatten\_dims = 3\)，则扁平化的矩阵 shape 为：\((2 x 3 x 4, 5 x 6) = (24, 30)\)，最终输出 Tensor 的 shape 为 \((2, 3, 4, size)\)。默认为 1。

param_attr (ParamAttr) – 指定权重参数属性的对象。默认值为 None，表示使用默认的权重参数属性。具体用法请参见 ParamAttr 。

bias_attr (ParamAttr) – 指定偏置参数属性的对象。默认值为 None，表示使用默认的偏置参数属性。具体用法请参见 ParamAttr 。

act (str) – 应用于输出上的激活函数，如 tanh、softmax、sigmoid，relu 等，支持列表请参考激活函数，默认值为 None。

name (str，可选) - 具体用法请参见 Name，一般无需设置，默认值为 None。

返回¶

经过全连接层计算后的 Tensor，数据类型与 input 类型一致。

返回类型¶

Variable

弹出异常：ValueError - 如果输入 Tensor（或 LoDTensor）的维度小于 2

代码示例¶

COPY-FROM: paddle.fluid.layers.fc