TripletMarginLoss

class torch.nn.modules.loss.TripletMarginLoss(margin=1.0, p=2.0, eps=1e-06, swap=False, size_average=None, reduce=None, reduction='mean')

创建一个标准，用于根据输入张量 $x1$, $x2$, $x3$ 和一个大于 $0$ 的 margin 来测量三元组损失。这用于测量样本之间的相对相似性。一个三元组由 a、p 和 n（即 anchor、positive examples 和 negative examples）组成。所有输入张量的形状都应为 $(N, D)$。

距离交换的详细描述请参见论文 Learning shallow convolutional feature descriptors with triplet losses（作者：V. Balntas, E. Riba 等）。

每个小批量样本的损失函数为：

$$L(a, p, n) = \max \{d(a_i, p_i) - d(a_i, n_i) + {\rm margin}, 0\}$$

其中

$$d(x_i, y_i) = \left\lVert {\bf x}_i - {\bf y}_i \right\rVert_p$$

该范数使用指定的 p 值计算，并添加了一个小的常数 $\varepsilon$ 以提高数值稳定性。

另请参阅 TripletMarginWithDistanceLoss，它使用自定义距离函数来计算输入张量的三元组边距损失。

参数

• margin (float, optional) – 默认值： $1$。

• p (int, optional) – 成对距离的范数次数。默认值： $2$。

• eps (float, optional) – 用于数值稳定的小常数。默认值： $1e-6$。

• swap (bool, optional) – 距离交换的详细描述请参见论文 Learning shallow convolutional feature descriptors with triplet losses（作者：V. Balntas, E. Riba 等）。默认值： False。

• size_average (bool, optional) – 已弃用 (参见 reduction)。默认情况下，损失值在批次中的每个损失元素上取平均值。请注意，对于某些损失，每个样本有多个元素。如果字段 size_average 设置为 False，则损失值在每个小批次中而是求和。当 reduce 为 False 时忽略。默认值：True

• reduce (bool, optional) – 已弃用 (参见 reduction)。默认情况下，损失值在每个小批次中根据 size_average 对观测值进行平均或求和。当 reduce 为 False 时，返回每个批次元素的损失值，并忽略 size_average。默认值：True

• reduction (str, optional) – 指定要应用于输出的归约方式： 'none' | 'mean' | 'sum'。 'none'：不进行归约， 'mean'：输出的总和除以输出中的元素数量， 'sum'：输出将被求和。注意： size_average 和 reduce 正在被弃用，在此期间，指定这两个参数中的任何一个都将覆盖 reduction。默认值： 'mean'

形状

• 输入： $(N, D)$ 或 $(D)$，其中 $D$ 是向量维度。

• 输出：如果 reduction 是 'none' 且输入形状为 $(N, D)$，则为形状为 $(N)$ 的张量；否则为标量。

示例

>>> triplet_loss = nn.TripletMarginLoss(margin=1.0, p=2, eps=1e-7)
>>> anchor = torch.randn(100, 128, requires_grad=True)
>>> positive = torch.randn(100, 128, requires_grad=True)
>>> negative = torch.randn(100, 128, requires_grad=True)
>>> output = triplet_loss(anchor, positive, negative)
>>> output.backward()

forward(anchor, positive, negative)

执行前向传播。

返回类型

张量