jax.numpy.diagflat

jax.numpy.diagflat(v, k=0)

返回一个二维数组，其中展平的输入数组放置在对角线上。

JAX 实现的 numpy.diagflat()。

对于某些标量值 v，这与 np.diagflat 不同。JAX 始终返回一个二维数组，而 NumPy 可能根据 v 的类型返回一个标量。

参数:

• v (ArrayLike) – 输入数组。可以是 N 维的，但会展平为 1 维。

• k (int) – 可选，默认值=0。对角线偏移量。正值将对角线放置在主对角线上方，负值将其放置在主对角线下方。

返回值:

一个二维数组，输入元素沿着指定偏移量 (k) 的对角线放置。其余条目填充为零。

返回类型:

数组

另请参阅

• jax.numpy.diag()

• jax.numpy.diagonal()

示例

>>> jnp.diagflat(jnp.array([1, 2, 3]))
Array([[1, 0, 0],
       [0, 2, 0],
       [0, 0, 3]], dtype=int32)
>>> jnp.diagflat(jnp.array([1, 2, 3]), k=1)
Array([[0, 1, 0, 0],
       [0, 0, 2, 0],
       [0, 0, 0, 3],
       [0, 0, 0, 0]], dtype=int32)
>>> a = jnp.array([[1, 2],
...                [3, 4]])
>>> jnp.diagflat(a)
Array([[1, 0, 0, 0],
       [0, 2, 0, 0],
       [0, 0, 3, 0],
       [0, 0, 0, 4]], dtype=int32)