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 的元素分解为尾数和以 2 为底的指数。

返回 (mantissa, exponent),其中 x = mantissa * 2**exponent。尾数位于开区间(-1, 1)内,而以 2 为底的指数是一个有符号整数。

参数:
xarray_like

要分解的数字数组。

out1ndarray, optional

用于存放尾数的输出数组。必须与 x 具有相同的形状。

out2ndarray, optional

用于存放指数的输出数组。必须与 x 具有相同的形状。

outndarray, None 或 ndarray 和 None 的元组,可选

结果存储的位置。如果提供,其形状必须是输入广播后的形状。如果未提供或为 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 的逆运算。

注意

不支持复数数据类型,它们将引发 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.])