本节是对前两节内容的实践。我们以10.1节（词嵌入word2vec）中的跳字模型和10.2节（近似训练）中的负采样为例，介绍在语料库上训练词嵌入模型的实现。我们还会介绍一些实现中的技巧，如二次采样（subsampling）。

首先导入实验所需的包或模块。

  1. import collections
  2. import math
  3. import random
  4. import sys
  5. import time
  6. import os
  7. import numpy as np
  8. import torch
  9. from torch import nn
  10. import torch.utils.data as Data
  12. sys.path.append("..") 
  13. import d2lzh_pytorch as d2l
  14. print(torch.__version__)

10.3.1 处理数据集

PTB（Penn Tree Bank）是一个常用的小型语料库 [1]。它采样自《华尔街日报》的文章，包括训练集、验证集和测试集。我们将在PTB训练集上训练词嵌入模型。该数据集的每一行作为一个句子。句子中的每个词由空格隔开。

确保ptb.train.txt已经放在了文件夹../../data/ptb下。

  1. assert 'ptb.train.txt' in os.listdir("../../data/ptb")
  3. with open('../../data/ptb/ptb.train.txt', 'r') as f:
  4.     lines = f.readlines()
  5.     # st是sentence的缩写
  6.     raw_dataset = [st.split() for st in lines]
  8. '# sentences: %d' % len(raw_dataset) # 输出 '# sentences: 42068'

对于数据集的前3个句子，打印每个句子的词数和前5个词。这个数据集中句尾符为”“，生僻词全用”“表示，数字则被替换成了”N”。

  1. for st in raw_dataset[:3]:
  2.     print('# tokens:', len(st), st[:5])

输出：

  1. # tokens: 24 ['aer', 'banknote', 'berlitz', 'calloway', 'centrust']
  2. # tokens: 15 ['pierre', '<unk>', 'N', 'years', 'old']
  3. # tokens: 11 ['mr.', '<unk>', 'is', 'chairman', 'of']

10.3.1.1 建立词语索引

为了计算简单，我们只保留在数据集中至少出现5次的词。

  1. # tk是token的缩写
  2. counter = collections.Counter([tk for st in raw_dataset for tk in st])
  3. counter = dict(filter(lambda x: x[1] >= 5, counter.items()))

然后将词映射到整数索引。

  1. idx_to_token = [tk for tk, _ in counter.items()]
  2. token_to_idx = {tk: idx for idx, tk in enumerate(idx_to_token)}
  3. dataset = [[token_to_idx[tk] for tk in st if tk in token_to_idx]
  4.            for st in raw_dataset]
  5. num_tokens = sum([len(st) for st in dataset])
  6. '# tokens: %d' % num_tokens # 输出 '# tokens: 887100'

10.3.1.2 二次采样

文本数据中一般会出现一些高频词，如英文中的“the”“a”和“in”。通常来说，在一个背景窗口中，一个词（如“chip”）和较低频词（如“microprocessor”）同时出现比和较高频词（如“the”）同时出现对训练词嵌入模型更有益。因此，训练词嵌入模型时可以对词进行二次采样 [2]。
具体来说，数据集中每个被索引词10.3 word2vec的实现 - 图1将有一定概率被丢弃，该丢弃概率为

10.3 word2vec的实现 - 图2%20%3D%20%5Cmax%5Cleft(1%20-%20%5Csqrt%7B%5Cfrac%7Bt%7D%7Bf(w_i)%7D%7D%2C%200%5Cright)%2C%0A#card=math&code=P%28w_i%29%20%3D%20%5Cmax%5Cleft%281%20-%20%5Csqrt%7B%5Cfrac%7Bt%7D%7Bf%28w_i%29%7D%7D%2C%200%5Cright%29%2C%0A)

其中 10.3 word2vec的实现 - 图3#card=math&code=f%28w_i%29) 是数据集中词10.3 word2vec的实现 - 图4的个数与总词数之比，常数10.3 word2vec的实现 - 图5是一个超参数（实验中设为10.3 word2vec的实现 - 图6）。可见，只有当10.3 word2vec的实现 - 图7%20%3E%20t#card=math&code=f%28w_i%29%20%3E%20t)时，我们才有可能在二次采样中丢弃词10.3 word2vec的实现 - 图8，并且越高频的词被丢弃的概率越大。

  1. def discard(idx):
  2.     return random.uniform(0, 1) < 1 - math.sqrt(
  3.         1e-4 / counter[idx_to_token[idx]] * num_tokens)
  5. subsampled_dataset = [[tk for tk in st if not discard(tk)] for st in dataset]
  6. '# tokens: %d' % sum([len(st) for st in subsampled_dataset]) # '# tokens: 375875'

可以看到，二次采样后我们去掉了一半左右的词。下面比较一个词在二次采样前后出现在数据集中的次数。可见高频词“the”的采样率不足1/20。

  1. def compare_counts(token):
  2.     return '# %s: before=%d, after=%d' % (token, sum(
  3.         [st.count(token_to_idx[token]) for st in dataset]), sum(
  4.         [st.count(token_to_idx[token]) for st in subsampled_dataset]))
  6. compare_counts('the') # '# the: before=50770, after=2013'

但低频词“join”则完整地保留了下来。

  1. compare_counts('join') # '# join: before=45, after=45'

10.3.1.3 提取中心词和背景词

我们将与中心词距离不超过背景窗口大小的词作为它的背景词。下面定义函数提取出所有中心词和它们的背景词。它每次在整数1和max_window_size（最大背景窗口）之间随机均匀采样一个整数作为背景窗口大小。

  1. def get_centers_and_contexts(dataset, max_window_size):
  2.     centers, contexts = [], []
  3.     for st in dataset:
  4.         if len(st) < 2:  # 每个句子至少要有2个词才可能组成一对“中心词-背景词”
  5.             continue
  6.         centers += st
  7.         for center_i in range(len(st)):
  8.             window_size = random.randint(1, max_window_size)
  9.             indices = list(range(max(0, center_i - window_size),
  10.                                  min(len(st), center_i + 1 + window_size)))
  11.             indices.remove(center_i)  # 将中心词排除在背景词之外
  12.             contexts.append([st[idx] for idx in indices])
  13.     return centers, contexts

下面我们创建一个人工数据集，其中含有词数分别为7和3的两个句子。设最大背景窗口为2，打印所有中心词和它们的背景词。

  1. tiny_dataset = [list(range(7)), list(range(7, 10))]
  2. print('dataset', tiny_dataset)
  3. for center, context in zip(*get_centers_and_contexts(tiny_dataset, 2)):
  4.     print('center', center, 'has contexts', context)

输出：

  1. dataset [[0, 1, 2, 3, 4, 5, 6], [7, 8, 9]]
  2. center 0 has contexts [1, 2]
  3. center 1 has contexts [0, 2, 3]
  4. center 2 has contexts [1, 3]
  5. center 3 has contexts [2, 4]
  6. center 4 has contexts [3, 5]
  7. center 5 has contexts [3, 4, 6]
  8. center 6 has contexts [4, 5]
  9. center 7 has contexts [8]
  10. center 8 has contexts [7, 9]
  11. center 9 has contexts [7, 8]

实验中，我们设最大背景窗口大小为5。下面提取数据集中所有的中心词及其背景词。

  1. all_centers, all_contexts = get_centers_and_contexts(subsampled_dataset, 5)

10.3.2 负采样

我们使用负采样来进行近似训练。对于一对中心词和背景词，我们随机采样10.3 word2vec的实现 - 图9个噪声词（实验中设10.3 word2vec的实现 - 图10）。根据word2vec论文的建议，噪声词采样概率10.3 word2vec的实现 - 图11#card=math&code=P%28w%29)设为10.3 word2vec的实现 - 图12词频与总词频之比的0.75次方 [2]。

  1. def get_negatives(all_contexts, sampling_weights, K):
  2.     all_negatives, neg_candidates, i = [], [], 0
  3.     population = list(range(len(sampling_weights)))
  4.     for contexts in all_contexts:
  5.         negatives = []
  6.         while len(negatives) < len(contexts) * K:
  7.             if i == len(neg_candidates):
  8.                 # 根据每个词的权重（sampling_weights）随机生成k个词的索引作为噪声词。
  9.                 # 为了高效计算，可以将k设得稍大一点
  10.                 i, neg_candidates = 0, random.choices(
  11.                     population, sampling_weights, k=int(1e5))
  12.             neg, i = neg_candidates[i], i + 1
  13.             # 噪声词不能是背景词
  14.             if neg not in set(contexts):
  15.                 negatives.append(neg)
  16.         all_negatives.append(negatives)
  17.     return all_negatives
  19. sampling_weights = [counter[w]**0.75 for w in idx_to_token]
  20. all_negatives = get_negatives(all_contexts, sampling_weights, 5)

10.3.3 读取数据

我们从数据集中提取所有中心词all_centers，以及每个中心词对应的背景词all_contexts和噪声词all_negatives。我们先定义一个Dataset类。

  1. class MyDataset(torch.utils.data.Dataset):
  2.     def __init__(self, centers, contexts, negatives):
  3.         assert len(centers) == len(contexts) == len(negatives)
  4.         self.centers = centers
  5.         self.contexts = contexts
  6.         self.negatives = negatives
  8.     def __getitem__(self, index):
  9.         return (self.centers[index], self.contexts[index], self.negatives[index])
  11.     def __len__(self):
  12.         return len(self.centers)

我们将通过随机小批量来读取它们。在一个小批量数据中，第10.3 word2vec的实现 - 图13个样本包括一个中心词以及它所对应的10.3 word2vec的实现 - 图14个背景词和10.3 word2vec的实现 - 图15个噪声词。由于每个样本的背景窗口大小可能不一样，其中背景词与噪声词个数之和10.3 word2vec的实现 - 图16也会不同。在构造小批量时，我们将每个样本的背景词和噪声词连结在一起，并添加填充项0直至连结后的长度相同，即长度均为10.3 word2vec的实现 - 图17（max_len变量）。为了避免填充项对损失函数计算的影响，我们构造了掩码变量masks，其每一个元素分别与连结后的背景词和噪声词contexts_negatives中的元素一一对应。当contexts_negatives变量中的某个元素为填充项时，相同位置的掩码变量masks中的元素取0，否则取1。为了区分正类和负类，我们还需要将contexts_negatives变量中的背景词和噪声词区分开来。依据掩码变量的构造思路，我们只需创建与contexts_negatives变量形状相同的标签变量labels，并将与背景词（正类）对应的元素设1，其余清0。

下面我们实现这个小批量读取函数batchify。它的小批量输入data是一个长度为批量大小的列表，其中每个元素分别包含中心词center、背景词context和噪声词negative。该函数返回的小批量数据符合我们需要的格式，例如，包含了掩码变量。

  1. def batchify(data):
  2.     """用作DataLoader的参数collate_fn: 输入是个长为batchsize的list, 
  3.     list中的每个元素都是Dataset类调用__getitem__得到的结果
  4.     """
  5.     max_len = max(len(c) + len(n) for _, c, n in data)
  6.     centers, contexts_negatives, masks, labels = [], [], [], []
  7.     for center, context, negative in data:
  8.         cur_len = len(context) + len(negative)
  9.         centers += [center]
  10.         contexts_negatives += [context + negative + [0] * (max_len - cur_len)]
  11.         masks += [[1] * cur_len + [0] * (max_len - cur_len)]
  12.         labels += [[1] * len(context) + [0] * (max_len - len(context))]
  13.     return (torch.tensor(centers).view(-1, 1), torch.tensor(contexts_negatives),
  14.             torch.tensor(masks), torch.tensor(labels))

我们用刚刚定义的batchify函数指定DataLoader实例中小批量的读取方式，然后打印读取的第一个批量中各个变量的形状。

  1. batch_size = 512
  2. num_workers = 0 if sys.platform.startswith('win32') else 4
  4. dataset = MyDataset(all_centers, 
  5.                     all_contexts, 
  6.                     all_negatives)
  7. data_iter = Data.DataLoader(dataset, batch_size, shuffle=True,
  8.                             collate_fn=batchify, 
  9.                             num_workers=num_workers)
  10. for batch in data_iter:
  11.     for name, data in zip(['centers', 'contexts_negatives', 'masks',
  12.                            'labels'], batch):
  13.         print(name, 'shape:', data.shape)
  14.     break

输出：

  1. centers shape: torch.Size([512, 1])
  2. contexts_negatives shape: torch.Size([512, 60])
  3. masks shape: torch.Size([512, 60])
  4. labels shape: torch.Size([512, 60])

10.3.4 跳字模型

我们将通过使用嵌入层和小批量乘法来实现跳字模型。它们也常常用于实现其他自然语言处理的应用。

10.3.4.1 嵌入层

获取词嵌入的层称为嵌入层，在PyTorch中可以通过创建nn.Embedding实例得到。嵌入层的权重是一个矩阵，其行数为词典大小（num_embeddings），列数为每个词向量的维度（embedding_dim）。我们设词典大小为20，词向量的维度为4。

  1. embed = nn.Embedding(num_embeddings=20, embedding_dim=4)
  2. embed.weight

输出：

  1. Parameter containing:
  2. tensor([[-0.4689,  0.2420,  0.9826, -1.3280],
  3.         [-0.6690,  1.2385, -1.7482,  0.2986],
  4.         [ 0.1193,  0.1554,  0.5038, -0.3619],
  5.         [-0.0347, -0.2806,  0.3854, -0.8600],
  6.         [-0.6479, -1.1424, -1.1920,  0.3922],
  7.         [ 0.6334, -0.0703,  0.0830, -0.4782],
  8.         [ 0.1712,  0.8098, -1.2208,  0.4169],
  9.         [-0.9925,  0.9383, -0.3808, -0.1242],
  10.         [-0.3762,  1.9276,  0.6279, -0.6391],
  11.         [-0.8518,  2.0105,  1.8484, -0.5646],
  12.         [-1.0699, -1.0822, -0.6945, -0.7321],
  13.         [ 0.4806, -0.5945,  1.0795,  0.1062],
  14.         [-1.5377,  1.0420,  0.4325,  0.1098],
  15.         [-0.8438, -1.4104, -0.9700, -0.4889],
  16.         [-1.9745, -0.3092,  0.6398, -0.4368],
  17.         [ 0.0484, -0.8516, -0.4955, -0.1363],
  18.         [-2.6301, -0.7091,  2.2116, -0.1363],
  19.         [-0.2025,  0.8037,  0.4906,  1.5929],
  20.         [-0.6745, -0.8791, -0.9220, -0.8125],
  21.         [ 0.2450,  1.9456,  0.1257, -0.3728]], requires_grad=True)

嵌入层的输入为词的索引。输入一个词的索引10.3 word2vec的实现 - 图18，嵌入层返回权重矩阵的第10.3 word2vec的实现 - 图19行作为它的词向量。下面我们将形状为(2, 3)的索引输入进嵌入层，由于词向量的维度为4，我们得到形状为(2, 3, 4)的词向量。

  1. x = torch.tensor([[1, 2, 3], [4, 5, 6]], dtype=torch.long)
  2. embed(x)

输出：

  1. tensor([[[-0.6690,  1.2385, -1.7482,  0.2986],
  2.          [ 0.1193,  0.1554,  0.5038, -0.3619],
  3.          [-0.0347, -0.2806,  0.3854, -0.8600]],
  5.         [[-0.6479, -1.1424, -1.1920,  0.3922],
  6.          [ 0.6334, -0.0703,  0.0830, -0.4782],
  7.          [ 0.1712,  0.8098, -1.2208,  0.4169]]], grad_fn=<EmbeddingBackward>)

10.3.4.2 小批量乘法

我们可以使用小批量乘法运算bmm对两个小批量中的矩阵一一做乘法。假设第一个小批量中包含10.3 word2vec的实现 - 图20个形状为10.3 word2vec的实现 - 图21的矩阵10.3 word2vec的实现 - 图22，第二个小批量中包含10.3 word2vec的实现 - 图23个形状为10.3 word2vec的实现 - 图24的矩阵10.3 word2vec的实现 - 图25。这两个小批量的矩阵乘法输出为10.3 word2vec的实现 - 图26个形状为10.3 word2vec的实现 - 图27的矩阵10.3 word2vec的实现 - 图28。因此，给定两个形状分别为(10.3 word2vec的实现 - 图29, 10.3 word2vec的实现 - 图30, 10.3 word2vec的实现 - 图31)和(10.3 word2vec的实现 - 图32, 10.3 word2vec的实现 - 图33, 10.3 word2vec的实现 - 图34)的Tensor，小批量乘法输出的形状为(10.3 word2vec的实现 - 图35, 10.3 word2vec的实现 - 图36, 10.3 word2vec的实现 - 图37)。

  1. X = torch.ones((2, 1, 4))
  2. Y = torch.ones((2, 4, 6))
  3. torch.bmm(X, Y).shape

输出：

  1. torch.Size([2, 1, 6])

10.3.4.3 跳字模型前向计算

在前向计算中，跳字模型的输入包含中心词索引center以及连结的背景词与噪声词索引contexts_and_negatives。其中center变量的形状为(批量大小, 1)，而contexts_and_negatives变量的形状为(批量大小, max_len)。这两个变量先通过词嵌入层分别由词索引变换为词向量，再通过小批量乘法得到形状为(批量大小, 1, max_len)的输出。输出中的每个元素是中心词向量与背景词向量或噪声词向量的内积。

  1. def skip_gram(center, contexts_and_negatives, embed_v, embed_u):
  2.     v = embed_v(center)
  3.     u = embed_u(contexts_and_negatives)
  4.     pred = torch.bmm(v, u.permute(0, 2, 1))
  5.     return pred

10.3.5 训练模型

在训练词嵌入模型之前，我们需要定义模型的损失函数。

10.3.5.1 二元交叉熵损失函数

根据负采样中损失函数的定义，我们可以使用二元交叉熵损失函数,下面定义SigmoidBinaryCrossEntropyLoss。

  1. class SigmoidBinaryCrossEntropyLoss(nn.Module):
  2.     def __init__(self): # none mean sum
  3.         super(SigmoidBinaryCrossEntropyLoss, self).__init__()
  4.     def forward(self, inputs, targets, mask=None):
  5.         """
  6.         input – Tensor shape: (batch_size, len)
  7.         target – Tensor of the same shape as input
  8.         """
  9.         inputs, targets, mask = inputs.float(), targets.float(), mask.float()
  10.         res = nn.functional.binary_cross_entropy_with_logits(inputs, targets, reduction="none", weight=mask)
  11.         return res.mean(dim=1)
  13. loss = SigmoidBinaryCrossEntropyLoss()

值得一提的是，我们可以通过掩码变量指定小批量中参与损失函数计算的部分预测值和标签：当掩码为1时，相应位置的预测值和标签将参与损失函数的计算；当掩码为0时，相应位置的预测值和标签则不参与损失函数的计算。我们之前提到，掩码变量可用于避免填充项对损失函数计算的影响。

  1. pred = torch.tensor([[1.5, 0.3, -1, 2], [1.1, -0.6, 2.2, 0.4]])
  2. # 标签变量label中的1和0分别代表背景词和噪声词
  3. label = torch.tensor([[1, 0, 0, 0], [1, 1, 0, 0]])
  4. mask = torch.tensor([[1, 1, 1, 1], [1, 1, 1, 0]])  # 掩码变量
  5. loss(pred, label, mask) * mask.shape[1] / mask.float().sum(dim=1)

输出：

  1. tensor([0.8740, 1.2100])

作为比较，下面将从零开始实现二元交叉熵损失函数的计算，并根据掩码变量mask计算掩码为1的预测值和标签的损失。

  1. def sigmd(x):
  2.     return - math.log(1 / (1 + math.exp(-x)))
  4. print('%.4f' % ((sigmd(1.5) + sigmd(-0.3) + sigmd(1) + sigmd(-2)) / 4)) # 注意1-sigmoid(x) = sigmoid(-x)
  5. print('%.4f' % ((sigmd(1.1) + sigmd(-0.6) + sigmd(-2.2)) / 3))

输出：

  1. 0.8740
  2. 1.2100

10.3.5.2 初始化模型参数

我们分别构造中心词和背景词的嵌入层，并将超参数词向量维度embed_size设置成100。

  1. embed_size = 100
  2. net = nn.Sequential(
  3.     nn.Embedding(num_embeddings=len(idx_to_token), embedding_dim=embed_size),
  4.     nn.Embedding(num_embeddings=len(idx_to_token), embedding_dim=embed_size)
  5. )

10.3.5.3 定义训练函数

下面定义训练函数。由于填充项的存在，与之前的训练函数相比，损失函数的计算稍有不同。

  1. def train(net, lr, num_epochs):
  2.     device = torch.device('cuda' if torch.cuda.is_available() else 'cpu')
  3.     print("train on", device)
  4.     net = net.to(device)
  5.     optimizer = torch.optim.Adam(net.parameters(), lr=lr)
  6.     for epoch in range(num_epochs):
  7.         start, l_sum, n = time.time(), 0.0, 0
  8.         for batch in data_iter:
  9.             center, context_negative, mask, label = [d.to(device) for d in batch]
  11.             pred = skip_gram(center, context_negative, net[0], net[1])
  13.             # 使用掩码变量mask来避免填充项对损失函数计算的影响
  14.             l = (loss(pred.view(label.shape), label, mask) *
  15.                  mask.shape[1] / mask.float().sum(dim=1)).mean() # 一个batch的平均loss
  16.             optimizer.zero_grad()
  17.             l.backward()
  18.             optimizer.step()
  19.             l_sum += l.cpu().item()
  20.             n += 1
  21.         print('epoch %d, loss %.2f, time %.2fs'
  22.               % (epoch + 1, l_sum / n, time.time() - start))

现在我们就可以使用负采样训练跳字模型了。

  1. train(net, 0.01, 10)

输出：

  1. train on cpu
  2. epoch 1, loss 1.97, time 74.53s
  3. epoch 2, loss 0.62, time 81.85s
  4. epoch 3, loss 0.45, time 74.49s
  5. epoch 4, loss 0.39, time 72.04s
  6. epoch 5, loss 0.37, time 72.21s
  7. epoch 6, loss 0.35, time 71.81s
  8. epoch 7, loss 0.34, time 72.00s
  9. epoch 8, loss 0.33, time 74.45s
  10. epoch 9, loss 0.32, time 72.08s
  11. epoch 10, loss 0.32, time 72.05s

10.3.6 应用词嵌入模型

训练好词嵌入模型之后，我们可以根据两个词向量的余弦相似度表示词与词之间在语义上的相似度。可以看到，使用训练得到的词嵌入模型时，与词“chip”语义最接近的词大多与芯片有关。

  1. def get_similar_tokens(query_token, k, embed):
  2.     W = embed.weight.data
  3.     x = W[token_to_idx[query_token]]
  4.     # 添加的1e-9是为了数值稳定性
  5.     cos = torch.matmul(W, x) / (torch.sum(W * W, dim=1) * torch.sum(x * x) + 1e-9).sqrt()
  6.     _, topk = torch.topk(cos, k=k+1)
  7.     topk = topk.cpu().numpy()
  8.     for i in topk[1:]:  # 除去输入词
  9.         print('cosine sim=%.3f: %s' % (cos[i], (idx_to_token[i])))
  11. get_similar_tokens('chip', 3, net[0])

输出：

  1. cosine sim=0.478: hard-disk
  2. cosine sim=0.446: intel
  3. cosine sim=0.440: drives

小结

  • 可以使用PyTorch通过负采样训练跳字模型。
  • 二次采样试图尽可能减轻高频词对训练词嵌入模型的影响。
  • 可以将长度不同的样本填充至长度相同的小批量，并通过掩码变量区分非填充和填充，然后只令非填充参与损失函数的计算。

参考文献

[1] Penn Tree Bank. https://catalog.ldc.upenn.edu/LDC99T42

[2] Mikolov, T., Sutskever, I., Chen, K., Corrado, G. S., & Dean, J. (2013). Distributed representations of words and phrases and their compositionality. In Advances in neural information processing systems (pp. 3111-3119).

注：本节除代码外与原书基本相同，原书传送门