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=... 的支持。

wherearray_like, optional

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

**kwargs

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

返回
rndarray 或 ndarray 的元组

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

属性
identity

identity 值。

nargs

参数数量。

nin

输入数量。

nout

输出数量。

ntypes

类型数量。

signature

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

types

返回一个列表,其中类型按 输入->输出 分组。

方法

__call__(*args, **kwargs)

将自身作为函数调用。

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

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

at(a, indices[, b])

对由 'indices' 指定的元素,在操作数 'a' 上执行无缓冲的就地操作。

outer(A, B, /, **kwargs)

将 ufunc op 应用于所有对 (a, b),其中 a 在 A 中,b 在 B 中。

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

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

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

在一个轴上使用指定切片执行(局部)reduce 操作。

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

查找 NumPy 将用于该操作的数据类型。