<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.21.0/tensorflow/python/ops/confusion_matrix.py#L92-L196) |

Computes the confusion matrix from predictions and labels.

    tf.math.confusion_matrix(
        labels,
        predictions,
        num_classes=None,
        weights=None,
        dtype=https://www.tensorflow.org/api_docs/python/tf/dtypes#int32,
        name=None
    )

### Used in the notebooks

| Used in the tutorials |
|---|
| - [Video classification with a 3D convolutional neural network](https://www.tensorflow.org/tutorials/video/video_classification) - [Simple audio recognition: Recognizing keywords](https://www.tensorflow.org/tutorials/audio/simple_audio) - [Transfer learning for video classification with MoViNet](https://www.tensorflow.org/tutorials/video/transfer_learning_with_movinet) - [Fine tuning models for plant disease detection](https://www.tensorflow.org/hub/tutorials/cropnet_on_device) - [How to solve a problem on Kaggle with TF-Hub](https://www.tensorflow.org/hub/tutorials/text_classification_with_tf_hub_on_kaggle) |

The matrix columns represent the prediction labels and the rows represent the
real labels. The confusion matrix is always a 2-D array of shape `[n, n]`,
where `n` is the number of valid labels for a given classification task. Both
prediction and labels must be 1-D arrays of the same shape in order for this
function to work.

If `num_classes` is `None`, then `num_classes` will be set to one plus the
maximum value in either predictions or labels. Class labels are expected to
start at 0. For example, if `num_classes` is 3, then the possible labels
would be `[0, 1, 2]`.

If `weights` is not `None`, then each prediction contributes its
corresponding weight to the total value of the confusion matrix cell.

#### For example:

      tf.math.confusion_matrix([1, 2, 4], [2, 2, 4]) ==>
          [[0 0 0 0 0]
           [0 0 1 0 0]
           [0 0 1 0 0]
           [0 0 0 0 0]
           [0 0 0 0 1]]

Note that the possible labels are assumed to be `[0, 1, 2, 3, 4]`,
resulting in a 5x5 confusion matrix.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `labels` | 1-D `Tensor` of real labels for the classification task. |
| `predictions` | 1-D `Tensor` of predictions for a given classification. |
| `num_classes` | The possible number of labels the classification task can have. If this value is not provided, it will be calculated using both predictions and labels array. |
| `weights` | An optional `Tensor` whose shape matches `predictions`. |
| `dtype` | Data type of the confusion matrix. |
| `name` | Scope name. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A `Tensor` of type `dtype` with shape `[n, n]` representing the confusion matrix, where `n` is the number of possible labels in the classification task. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | If both predictions and labels are not 1-D vectors and have mismatched shapes, or if `weights` is not `None` and its shape doesn't match `predictions`. |

<br />