<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#L3222-L3308) |

Evaluates the Einstein summation convention on the operands.

#### View aliases


**Main aliases**

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

<br />

    tf.keras.ops.einsum(
        subscripts, *operands, **kwargs
    )

<br />

<br />

<br />

| ## Args ||
|---|---|
| `subscripts` | Specifies the subscripts for summation as comma separated list of subscript labels. An implicit (classical Einstein summation) calculation is performed unless the explicit indicator `->` is included as well as subscript labels of the precise output form. |
| `operands` | The operands to compute the Einstein sum of. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| The calculation based on the Einstein summation convention. ||

<br />

#### Example:

    from keras.src import ops
    a = ops.arange(25).reshape(5, 5)
    b = ops.arange(5)
    c = ops.arange(6).reshape(2, 3)

#### Trace of a matrix:

    ops.einsum("ii", a)
    60
    ops.einsum(a, [0, 0])
    60
    ops.trace(a)
    60

#### Extract the diagonal:

    ops.einsum("ii -> i", a)
    array([ 0,  6, 12, 18, 24])
    ops.einsum(a, [0, 0], [0])
    array([ 0,  6, 12, 18, 24])
    ops.diag(a)
    array([ 0,  6, 12, 18, 24])

#### Sum over an axis:

    ops.einsum("ij -> i", a)
    array([ 10,  35,  60,  85, 110])
    ops.einsum(a, [0, 1], [0])
    array([ 10,  35,  60,  85, 110])
    ops.sum(a, axis=1)
    array([ 10,  35,  60,  85, 110])

For higher dimensional tensors summing a single axis can be done
with ellipsis:

    ops.einsum("...j -> ...", a)
    array([ 10,  35,  60,  85, 110])
    np.einsum(a, [..., 1], [...])
    array([ 10,  35,  60,  85, 110])

Compute a matrix transpose or reorder any number of axes:

    ops.einsum("ji", c)
    array([[0, 3],
           [1, 4],
           [2, 5]])
    ops.einsum("ij -> ji", c)
    array([[0, 3],
           [1, 4],
           [2, 5]])
    ops.einsum(c, [1, 0])
    array([[0, 3],
           [1, 4],
           [2, 5]])
    ops.transpose(c)
    array([[0, 3],
           [1, 4],
           [2, 5]])

Matrix vector multiplication:

    ops.einsum("ij, j", a, b)
    array([ 30,  80, 130, 180, 230])
    ops.einsum(a, [0, 1], b, [1])
    array([ 30,  80, 130, 180, 230])
    ops.einsum("...j, j", a, b)
    array([ 30,  80, 130, 180, 230])