embedding

    嵌入层(Embedding Layer)

    该OP根据input中的id信息从embedding矩阵中查询对应embedding信息,并会根据输入的size (vocab_size, emb_size)和dtype自动构造一个二维embedding矩阵。

    输出的Tensor的shape是将输入Tensor shape的会在输出的embedding最后追加一维emb_size。

    注:input中的id必须满足 0 =< id < size[0],否则程序会抛异常退出。

    • input (Variable) - 存储id信息的Tensor,数据类型必须为:int64,输入的shape最后一维须为1。input中的id必须满足 0 =< id < size[0]

    • size (tuple|list) - embedding矩阵的维度。必须包含两个元素,第一个元素为vocab_size(词表大小), 第二个为emb_size(embedding层维度)。

    • is_sparse (bool) - 是否使用稀疏的更新方式,这个参数只会影响反向的梯度更新的性能,sparse更新速度更快,推荐使用稀疏更新的方式。但某些optimizer不支持sparse更新,比如 、 Adamax,此时is_sparse必须为False。默认为False。

    • is_distributed (bool) - 是否使用分布式的方式存储embedding矩阵,仅在多机分布式cpu训练中使用。默认为False。

    • param_attr (ParamAttr) - 指定权重参数属性的对象。默认值为None,表示使用默认的权重参数属性。具体用法请参见 cn_api_paddle_ParamAttr 。此外,可以通过 param_attr 参数加载用户自定义或预训练的词向量。只需将本地词向量转为numpy数据格式,且保证本地词向量的shape和embedding的 size 参数一致,然后使用 进行初始化,即可实现加载自定义或预训练的词向量。

    • dtype (str|core.VarDesc.VarType) - 输出Tensor的数据类型,数据类型必须为:float32 或 float64,默认为 float32。

    返回:input映射后得到的Embedding Tensor或LoDTensor,数据类型和dtype定义的类型一致。

    返回类型:Variable

    1. import paddle
    2. paddle.enable_static()
    3. data = paddle.static.data(name='sequence', shape=[1], dtype='int64')
    4. # 示例 1
    5. # 示例 2: 加载用户自定义或预训练的词向量
    6. weight_data = np.random.random(size=(128, 100)) # numpy格式的词向量数据
    7. w_param_attrs = paddle.ParamAttr(
    8. name="emb_weight",
    9. learning_rate=0.5,
    10. initializer=paddle.nn.initializer.Assign(weight_data),