Python numpy fmod用法及代碼示例

本文簡要介紹 python 語言中 numpy.fmod 的用法。

用法:

numpy.fmod(x1, x2, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True [, signature, extobj ]) = <ufunc 'fmod'>

返回除法的元素餘數。

這是C庫函數fmod的NumPy實現，餘數與被除數同號x1.它相當於 Matlab(TM)rem函數，不應與 Python 模運算符混淆x1 % x2.

參數：

x1： array_like

股利。

x2： array_like

除數。如果 x1.shape != x2.shape ，它們必須可以廣播到一個公共形狀(成為輸出的形狀)。

out： ndarray，None，或 ndarray 和 None 的元組，可選

存儲結果的位置。如果提供，它必須具有輸入廣播到的形狀。如果未提供或 None，則返回一個新分配的數組。元組(隻能作為關鍵字參數)的長度必須等於輸出的數量。

where： 數組，可選

此條件通過輸入廣播。在條件為真的位置，out數組將設置為 ufunc 結果。在其他地方，out數組將保留其原始值。請注意，如果未初始化out數組是通過默認創建的out=None，其中條件為 False 的位置將保持未初始化狀態。

**kwargs：

對於其他僅關鍵字參數，請參閱 ufunc 文檔。

返回：

y： array_like

x1 除以 x2 的餘數。如果 x1 和 x2 都是標量，則這是一個標量。

注意：

負被除數和除數的模運算結果受慣例約束。對於fmod，結果的符號是被除數的符號，而對於 remainder ，結果的符號是除數的符號。 fmod 函數相當於 Matlab(TM) rem 函數。

例子：

>>> np.fmod([-3, -2, -1, 1, 2, 3], 2)
array([-1,  0, -1,  1,  0,  1])
>>> np.remainder([-3, -2, -1, 1, 2, 3], 2)
array([1, 0, 1, 1, 0, 1])

>>> np.fmod([5, 3], [2, 2.])
array([ 1.,  1.])
>>> a = np.arange(-3, 3).reshape(3, 2)
>>> a
array([[-3, -2],
       [-1,  0],
       [ 1,  2]])
>>> np.fmod(a, [2,2])
array([[-1,  0],
       [-1,  0],
       [ 1,  0]])