dask.array.frexp

dask.array.frexp

dask.array.frexp(x, [out1, out2, ]/, [out=(None, None), ]*, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature])[源代码]

此文档字符串是从 numpy.frexp 复制的。

Dask 版本可能存在一些不一致性。

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

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

参数
xarray_like

要分解的数字数组。

out1ndarray,可选

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

out2ndarray,可选

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

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

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

哪里类似数组, 可选

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

**kwargs

对于其他仅关键字参数,请参阅 ufunc 文档

返回
尾数ndarray

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

指数ndarray

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])
>>> y1 * 2**y2  
array([ 0.,  1.,  2.,  3.,  4.,  5.,  6.,  7.,  8.])