jax.numpy.triu

jax.numpy.triu(m, k=0)

返回数组的上三角部分。

JAX 对 numpy.triu() 的实现

参数:

• m (ArrayLike) – 输入数组。必须具有 m.ndim >= 2。

• k (int) – 可选，整型，默认为 0。指定了其下方元素被设置为零的次对角线。`k=0` 指主对角线，`k<0` 指主对角线下方的次对角线，`k>0` 指主对角线上方的次对角线。

返回:

一个形状与输入数组相同的数组，包含给定数组的上三角部分，其中由 k 指定的次对角线以下的元素被设置为零。

返回类型:

Array

另请参阅

• jax.numpy.tril(): 返回数组的下三角部分。

• jax.numpy.tri(): 返回一个在对角线及以下为 1，其他地方为 0 的数组。

示例

>>> x = jnp.array([[1, 2, 3],
...                [4, 5, 6],
...                [7, 8, 9],
...                [10, 11, 12]])
>>> jnp.triu(x)
Array([[1, 2, 3],
       [0, 5, 6],
       [0, 0, 9],
       [0, 0, 0]], dtype=int32)
>>> jnp.triu(x, k=1)
Array([[0, 2, 3],
       [0, 0, 6],
       [0, 0, 0],
       [0, 0, 0]], dtype=int32)
>>> jnp.triu(x, k=-1)
Array([[ 1,  2,  3],
       [ 4,  5,  6],
       [ 0,  8,  9],
       [ 0,  0, 12]], dtype=int32)

当 m.ndim > 2 时，jnp.triu 会在尾随轴上批量运行。

>>> x1 = jnp.array([[[1, 2],
...                  [3, 4]],
...                 [[5, 6],
...                  [7, 8]]])
>>> jnp.triu(x1)
Array([[[1, 2],
        [0, 4]],

       [[5, 6],
        [0, 8]]], dtype=int32)