numpy.fmod

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

Возвращает остаток от деления по элементам.

Это реализация NumPy функции C-библиотеки fmod, остаток имеет тот же знак, что и делимое x1. Она эквивалентна функции Matlab(TM) rem и не следует путать с оператором взятия остатка Python x1 % x2.

Параметры

x1array_like

Делимое.

x2array_like

Делитель. Если x1.shape != x2.shape, они должны быть совместимы для трансляции в общую форму (которая станет формой выходных данных).

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

Место назначения, куда будет помещён результат. Если предоставлено, оно должно иметь форму, на которую транслируются входные данные. Если не предоставлено или равно None, возвращается только что выделенный массив. Кортеж (только как ключевой параметр) должен иметь длину, равную числу выходов.

wherearray_like, optional

Это условие транслируется по входным данным. В местах, где условие истинно, массив out будет задан результатом ufunc. В противном случае массив out сохранит своё первоначальное значение. Обратите внимание, что если массив out создаётся через значение по умолчанию out=None, места в нём, где условие ложно, останутся неинициализированными.

**kwargs

Для других ключевых аргументов см. документацию ufunc.

Возвращает

yarray_like

Остаток от деления x1 на x2. Это скаляр, если x1 и x2 оба скаляры.

См. также

remainder

Эквивалентно оператору Python %.

divide

Примечания

Результат операции взятия остатка для отрицательного делимого и делителя ограничен соглашениями. Для 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]])