jax.numpy.ravel

jax.numpy.ravel(a, order='C')

将数组展平为 1 维形状。

numpy.ravel() 的 JAX 实现，使用 jax.lax.reshape() 实现。

ravel(arr, order=order) 等价于 reshape(arr, -1, order=order)。

参数:

• a (ArrayLike) – 要展平的数组。

• order (str) – 'F' 或 'C'，指定 reshape 应该应用列优先（Fortran 风格，"F"）还是行优先（C 风格，"C"）顺序；默认为 "C"。JAX 不支持 order=”A” 或 order=”K”。

返回:

输入数组的展平副本。

返回类型:

Array

注释

与 numpy.ravel() 不同，jax.numpy.ravel() 将返回输入数组的副本，而不是视图。但是，在 JIT 下，编译器会在可能的情况下优化掉这些副本，因此这在实践中不会影响性能。

另请参阅

• jax.Array.ravel()：通过数组方法实现的等效功能。

• jax.numpy.reshape()：通用的数组 reshape。

示例

>>> x = jnp.array([[1, 2, 3],
...                [4, 5, 6]])

默认情况下，ravel 使用 C 风格的行优先顺序

>>> jnp.ravel(x)
Array([1, 2, 3, 4, 5, 6], dtype=int32)

可选地，使用 Fortran 风格的列优先顺序进行 ravel

>>> jnp.ravel(x, order='F')
Array([1, 4, 2, 5, 3, 6], dtype=int32)

为了方便起见，相同的功能可以通过 jax.Array.ravel() 方法获得

>>> x.ravel()
Array([1, 2, 3, 4, 5, 6], dtype=int32)