numpy.ufunc#

class numpy.ufunc[原始碼]#

在整個陣列上逐元素運算的函數。

若要查看特定 ufunc 的文件,請使用 info。例如,np.info(np.sin)。由於 ufunc 是以 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 或 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)

將 self 作為函數呼叫。

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

對單一軸上的指定切片執行(局部)reduce 運算。

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

找出 NumPy 將用於運算的 dtype。