# tf.contrib.losses.cosine_distance

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v1.15.0/tensorflow/contrib/losses/python/losses/loss_ops.py#L607-L652) |

Adds a cosine-distance loss to the training procedure. (deprecated arguments) (deprecated)

    tf.contrib.losses.cosine_distance(
        predictions, labels=None, axis=None, weights=1.0, scope=None, dim=None
    )

> [!WARNING]
> **Warning:** THIS FUNCTION IS DEPRECATED. It will be removed after 2016-12-30. Instructions for updating: Use tf.losses.cosine_distance instead.

> [!WARNING]
> **Warning:** SOME ARGUMENTS ARE DEPRECATED: `(dim)`. They will be removed in a future version. Instructions for updating: dim is deprecated, use axis instead

Note that the function assumes that `predictions` and `labels` are already
unit-normalized.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `predictions` | An arbitrary matrix. |
| `labels` | A `Tensor` whose shape matches 'predictions' |
| `axis` | The dimension along which the cosine distance is computed. |
| `weights` | Coefficients for the loss a scalar, a tensor of shape \[batch_size\] or a tensor whose shape matches `predictions`. |
| `scope` | The scope for the operations performed in computing the loss. |
| `dim` | The old (deprecated) name for `axis`. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A scalar `Tensor` representing the loss value. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | If `predictions` shape doesn't match `labels` shape, or `weights` is `None`. |

<br />