numpy.frexp#

numpy.frexp(x, [out1, out2, ]/, [out=(None, None), ]*, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature]) = <ufunc 'frexp'>#

将 x 的元素分解为尾数和二的幂指数。

返回 (mantissa, exponent),其中 x = mantissa * 2**exponent。尾数(mantissa)位于开区间(-1, 1) 内,而二的幂指数(exponent)是带符号的整数。

参数:
xarray_like

要分解的数字数组。

out1ndarray, optional

尾数(mantissa)的输出数组。必须与 x 具有相同的形状。

out2ndarray, optional

指数(exponent)的输出数组。必须与 x 具有相同的形状。

outndarray, None, or tuple of ndarray and None, optional

结果存储的位置。如果提供了,它必须具有输入广播到的形状。如果未提供或为 None,则返回一个新分配的数组。元组(仅可能作为关键字参数)的长度必须等于输出的数量。

wherearray_like, optional

此条件将广播到输入。在条件为 True 的位置,out 数组将设置为 ufunc 结果。在其他地方,out 数组将保留其原始值。请注意,如果通过默认的 out=None 创建了一个未初始化的 out 数组,那么其中条件为 False 的位置将保持未初始化状态。

**kwargs

有关其他关键字参数,请参阅 ufunc 文档

返回:
mantissandarray

在 -1 和 1 之间的浮点值。如果 x 是标量,则这也是一个标量。

exponentndarray

2 的整数指数。如果 x 是标量,则这也是一个标量。

另请参阅

ldexp

计算 y = x1 * 2**x2,这是 frexp 的逆运算。

备注

不支持复数 dtype,会引发 TypeError。

示例

>>> import numpy as np
>>> x = np.arange(9)
>>> y1, y2 = np.frexp(x)
>>> y1
array([ 0.   ,  0.5  ,  0.5  ,  0.75 ,  0.5  ,  0.625,  0.75 ,  0.875,
        0.5  ])
>>> y2
array([0, 1, 2, 2, 3, 3, 3, 3, 4], dtype=int32)
>>> y1 * 2**y2
array([ 0.,  1.,  2.,  3.,  4.,  5.,  6.,  7.,  8.])