<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/keras-team/keras/tree/v3.15.1/keras/src/ops/numpy.py#L2602-L2638) |

Extract a diagonal or construct a diagonal array.

#### View aliases


**Main aliases**

[`tf.keras.ops.numpy.diag`](https://www.tensorflow.org/api_docs/python/tf/keras/ops/diag)

<br />

    tf.keras.ops.diag(
        x, k=0
    )

<br />

<br />

<br />

| ## Args ||
|---|---|
| `x` | Input tensor. If `x` is 2-D, returns the k-th diagonal of `x`. If `x` is 1-D, return a 2-D tensor with `x` on the k-th diagonal. |
| `k` | The diagonal to consider. Defaults to `0`. Use `k > 0` for diagonals above the main diagonal, and `k < 0` for diagonals below the main diagonal. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| The extracted diagonal or constructed diagonal tensor. ||

<br />

#### Examples:

    from keras.src import ops
    x = ops.arange(9).reshape((3, 3))
    x
    array([[0, 1, 2],
           [3, 4, 5],
           [6, 7, 8]])

    ops.diag(x)
    array([0, 4, 8])
    ops.diag(x, k=1)
    array([1, 5])
    ops.diag(x, k=-1)
    array([3, 7])

    ops.diag(ops.diag(x)))
    array([[0, 0, 0],
           [0, 4, 0],
           [0, 0, 8]])