numpy.mod#

numpy.mod(x1, x2, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, сигнатура]) = 'remainder'>#

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

Вычисляет остаток, дополнительный к floor_divide функция. Она эквивалентна оператору модуля Python x1 % x2 numpy.polysub x2. Эквивалентная функция MATLAB np.remainder является mod.

Предупреждение

Это не следует путать с:

  • Python’s math.remainder и C remainder, которые вычисляют остаток IEEE, являющийся дополнением к round(x1 / x2).

  • MATLAB rem функция и/или C % оператор, который является дополнением к int(x1 / x2).

Параметры:
x1array_like

Массив дивидендов.

x2array_like

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

выходndarray, None или кортеж из ndarray и None, опционально

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

гдеarray_like, необязательный

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

**kwargs

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

Возвращает:
yndarray

Поэлементный остаток от деления floor_divide(x1, x2). Это скаляр, если оба x1 и x2 являются скалярами.

Смотрите также

floor_divide

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

divmod

Одновременное целочисленное деление и остаток.

fmod

Эквивалент MATLAB rem функция.

divide, floor

Примечания

Возвращает 0, когда x2 равно 0 и оба x1 и x2 являются (массивами) целых чисел. mod является псевдонимом remainder.

Примеры

>>> import numpy as np
>>> np.remainder([4, 7], [2, 3])
array([0, 1])
>>> np.remainder(np.arange(7), 5)
array([0, 1, 2, 3, 4, 0, 1])

The % оператор может использоваться как сокращение для np.remainder на ndarrays.

>>> x1 = np.arange(7)
>>> x1 % 5
array([0, 1, 2, 3, 4, 0, 1])