numpy.ufunc#

class numpy.ufunc[源代码]#

对整个数组按元素进行操作的函数.

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

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

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

将 op 按元素应用于参数 *x ,并广播参数.

广播规则为:

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

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

参数:
xarray_like

输入数组.

outndarray, None, …, or tuple of ndarray and None, optional

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

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

wherearray_like, optional

此条件在输入上进行广播.在条件为 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

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

方法

__call__ (args, \kwargs)

将 self 作为函数调用.

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

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

at (a, indices[, b])

对由“索引”指定的元素执行操作数“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.
当前页面