tf.contrib.losses.metric_learning.npairs_loss

View source on GitHub

Computes the npairs loss.

Npairs loss expects paired data where a pair is composed of samples from the same labels and each pairs in the minibatch have different labels. The loss has two components. The first component is the L2 regularizer on the embedding vectors. The second component is the sum of cross entropy loss which takes each row of the pair-wise similarity matrix as logits and the remapped one-hot labels as labels.

See: http://www.nec-labs.com/uploads/images/Department-Images/MediaAnalytics/papers/nips16_npairmetriclearning.pdf

labels 1-D tf.int32 Tensor of shape [batch_size/2].
embeddings_anchor 2-D Tensor of shape [batch_size/2, embedding_dim] for the embedding vectors for the anchor images. Embeddings should not be l2 normalized.
embeddings_positive 2-D Tensor of shape [batch_size/2, embedding_dim] for the embedding vectors for the positive images. Embeddings should not be l2 normalized.
reg_lambda Float. L2 regularization term on the embedding vectors.
print_losses Boolean. Option to print the xent and l2loss.

npairs_loss tf.float32 scalar.