numpy.ufunc#

class numpy.ufunc[源代码]#

在整个数组上逐元素操作的函数.

要查看特定 ufunc 的文档,请使用 info .例如, np.info(np.sin) .由于 ufunc 是用 C 编写的(为了提高速度)并使用 NumPy 的 ufunc 工具链接到 Python 中,因此每当在 ufunc 上调用 help() 时,Python 的 help() 函数都会找到此页面.

有关 ufunc 的详细说明,请参见 通用函数 ( ufunc ) 的文档.

调用 ufunc: op(x[, out], where=True, kwargs)

op 逐元素应用于参数 *x ,并广播这些参数.

广播规则是:

  • 长度为 1 的维度可以添加到任一数组.

  • 数组可以沿长度为 1 的维度重复.

参数:
xarray_like

输入数组.

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

存储结果的位置.如果未提供或为 None,则 ufunc 会创建新数组.如果作为关键字参数传递,则可以是省略号 ( out=... ) 以确保即使结果是 0 维数组也会返回数组,或者是一个长度等于输出数量的元组(其中 None 可用于 ufunc 的分配).

在 2.3 版本加入: 添加了对 out=... 的支持.

其中类数组,可选

此条件会在输入上进行广播.在条件为True的位置, out 数组将被设置为ufunc结果.否则, out 数组将保留其原始值.请注意,如果通过默认的 out=None 创建一个未初始化的 out 数组,则其中条件为False的位置将保持未初始化.

\kwargs

对于其他仅限关键字的参数,请参见 ufunc docs .

返回:
rndarray 或 ndarray 元组

r 将具有 x 中数组广播到的形状;如果提供了 out ,则将返回它.否则,将分配 r 并且可能包含未初始化的值.如果函数有多个输出,则结果将是一个数组元组.

属性:
identity

标识值.

nargs

参数的数量.

nin

输入的数量.

nout

输出的数量.

ntypes

类型的数量.

signature

广义 ufunc 操作的核心元素的定义.

types

返回一个列表,其中类型分组为 input->output.

方法

__call__ (args, \kwargs)

将 self 作为函数调用.

accumulate (array[, axis, dtype, out])

累积将运算符应用于所有元素的结果.

at (a, indices[, b])

对 'indices' 指定的元素,在操作数 'a' 上执行非缓冲的原地操作.

outer (A, B, /, \kwargs)

将 ufunc op 应用于 A 中的 a 和 B 中的 b 的所有对 (a, b).

reduce (array[, axis, dtype, out, keepdims, ...])

通过沿一个轴应用 ufunc,将 array 的维度减少一维.

reduceat (array, indices[, axis, dtype, out])

在单个轴上使用指定切片执行(局部)reduce.

resolve_dtypes (dtypes, \[, signature, ...])

查找 NumPy 将用于操作的 dtypes.