numpy.remainder

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

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

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

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

Это следует отличать от:

• Функции Python 3.7 math.remainder и C, которая вычисляет остаток IEEE, являющийся дополнением к round(x1 / x2).
• Функции MATLAB rem и/или оператора C %, который является дополнением к int(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.

Возвращаемое значение

yndarray

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

См. также

floor_divide

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

divmod

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

fmod

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

divide, floor

Примечания

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

Примеры

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

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

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