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 将被分配并可能包含未初始化的值。如果函数有多个输出,则结果将是一个数组元组。
- 属性:
方法
__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 将用于该操作的数据类型。