Keras 3 API 文档 / 层 API / 核心层 / 嵌入层

嵌入层

[来源]

Embedding

keras.layers.Embedding(
    input_dim,
    output_dim,
    embeddings_initializer="uniform",
    embeddings_regularizer=None,
    embeddings_constraint=None,
    mask_zero=False,
    weights=None,
    lora_rank=None,
    **kwargs
)

将非负整数(索引)转换为固定大小的密集向量。

例如 [[4], [20]] -> [[0.25, 0.1], [0.6, -0.2]]

此层只能用于固定范围内的非负整数输入。

示例

>>> model = keras.Sequential()
>>> model.add(keras.layers.Embedding(1000, 64))
>>> # The model will take as input an integer matrix of size (batch,
>>> # input_length), and the largest integer (i.e. word index) in the input
>>> # should be no larger than 999 (vocabulary size).
>>> # Now model.output_shape is (None, 10, 64), where `None` is the batch
>>> # dimension.
>>> input_array = np.random.randint(1000, size=(32, 10))
>>> model.compile('rmsprop', 'mse')
>>> output_array = model.predict(input_array)
>>> print(output_array.shape)
(32, 10, 64)

参数

  • input_dim: 整数。词汇量的大小,即最大整数索引 + 1。
  • output_dim: 整数。密集嵌入的维度。
  • embeddings_initializer: embeddings 矩阵的初始化器(参见 keras.initializers)。
  • embeddings_regularizer: 应用于 embeddings 矩阵的正则化函数(参见 keras.regularizers)。
  • embeddings_constraint: 应用于 embeddings 矩阵的约束函数(参见 keras.constraints)。
  • mask_zero: 布尔值,指示输入值 0 是否是应该被屏蔽的特殊“填充”值。这在使用可能接受可变长度输入的循环层时很有用。如果为 True,则模型中的所有后续层都需要支持屏蔽,否则将引发异常。如果 mask_zero 设置为 True,则作为结果,索引 0 不能在词汇表中使用(input_dim 应等于词汇表大小 + 1)。
  • weights: 大小为 (input_dim, output_dim) 的可选浮点数矩阵。要使用的初始嵌入值。
  • lora_rank: 可选整数。如果设置,层的正向传播将实现 LoRA(低秩自适应)并使用提供的秩。LoRA 将层的嵌入矩阵设置为不可训练,并用一个通过乘以两个低秩可训练矩阵获得的原始矩阵的增量替换它。这对于降低微调大型嵌入层的计算成本很有用。您还可以通过调用 layer.enable_lora(rank) 在现有 Embedding 层上启用 LoRA。

输入形状

形状为 (batch_size, input_length) 的 2D 张量。

输出形状

形状为 (batch_size, input_length, output_dim) 的 3D 张量。