numpy.ufunc#

class numpy.ufunc[source]#

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

要查看特定 ufunc 的文档,请使用 info。例如,np.info(np.sin)。因为 ufunc 是用 C(为了速度)编写的,并通过 NumPy 的 ufunc 功能链接到 Python,所以无论何时在 ufunc 上调用 help(),Python 的 help() 函数都会找到此页面。

可以在 通用函数 (ufunc) 的文档中找到对 ufunc 的详细解释。

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

对参数 *x 逐元素应用 op,广播参数。

广播规则是

  • 长度为 1 的维度可以前置到任一数组。

  • 数组可以在长度为 1 的维度上重复。

参数:
*xarray_like

输入数组。

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

用于放置结果的备用数组对象;如果提供,它必须具有输入广播到的形状。数组元组(仅作为关键字参数可能)的长度必须等于输出的数量;对于要由 ufunc 分配的未初始化输出,请使用 None。

wherearray_like,可选

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

**kwargs**

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

返回值:
rndarray 或 ndarray 元组

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

属性:
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 中的所有 a 和 B 中的所有 b 的所有对 (a, b)。

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

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

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

使用指定切片在单个轴上执行(局部)归约。

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

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