numpy.ufunc#

class numpy.ufunc[源代码]#

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

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

关于ufuncs的详细解释可以在 通用函数 (ufunc) 的文档中找到.

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

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

广播规则是:

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

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

参数:
*xarray_like

输入数组.

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

备用数组对象,用于放置结果;如果提供,它必须具有与输入广播匹配的形状.一个数组元组(只能作为关键字参数)的长度必须等于输出数量;使用 None 表示未初始化的输出,将由 ufunc 分配.

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])

对操作数 'a' 中由 'indices' 指定的元素执行无缓冲的就地操作.

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])

在单个轴上使用指定的切片执行(本地)归约.

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

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