jax.numpy.roots

jax.numpy.roots(p, *, strip_zeros=True)

返回给定系数 p 的多项式的根。

numpy.roots() 的 JAX 实现。

参数:

• p (ArrayLike) – 多项式系数数组，秩为 1。

• strip_zeros (bool) – bool，默认值=True。如果为 True，则会剥离系数中的前导零，类似于 numpy.roots()。如果设置为 False，则不会剥离前导零，并且未定义的根将由函数输出中的 NaN 值表示。strip_zeros 必须设置为 False，以便该函数与 jax.jit() 和其他 JAX 转换兼容。

返回:

包含多项式根的数组。

返回类型:

数组 (Array)

注意

与此函数的 np.roots 不同，jnp.roots 返回复数数组中的根，而与根的值无关。

另请参阅

• jax.numpy.poly(): 查找给定根序列的多项式系数。

• jax.numpy.polyfit(): 数据的最小二乘多项式拟合。

• jax.numpy.polyval(): 在特定值处评估多项式。

示例

>>> coeffs = jnp.array([0, 1, 2])

默认行为与 numpy 匹配并剥离前导零

>>> jnp.roots(coeffs)
Array([-2.+0.j], dtype=complex64)

使用 strip_zeros=False，额外的根设置为 NaN

>>> jnp.roots(coeffs, strip_zeros=False)
Array([-2. +0.j, nan+nanj], dtype=complex64)