numpy.divmod

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

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

Новое в версии 1.13.0.

np.divmod(x, y) эквивалентно (x // y, x % y), но быстрее, так как избегает избыточных вычислений. Используется для реализации встроенной в Python функции divmod для массивов NumPy.

Параметры:

x1 : array_like Массив делимого. x2 : array_like Массив делителя. Если x1.shape != x2.shape, они должны быть совместимы для трансляции к общему размеру (который становится размером выходного массива). out : ndarray, None, or tuple of ndarray and None, optional Расположение, в котором хранится результат. Если указано, оно должно иметь размер, к которому входные данные транслируются. Если не указано или None, возвращается новый выделенный массив. Кортеж (возможен только как ключевой параметр) должен иметь длину, равную количеству результатов. where : array_like, optional Это условие транслируется по входу. В позициях, где условие истинно, массив out будет установлен в результат ufunc. В противном случае массив out сохранит свое исходное значение. Обратите внимание, что если массив out создается по умолчанию через out=None, позиции в нем, где условие ложно, останутся неинициализированными. **kwargs Для других ключевых аргументов см. документацию по ufunc.

Возвращает:

out1 : ndarray Элемент-поэлементное частное, полученное при делении по модулю. Это скаляр, если и x1, и x2 являются скалярами. out2 : ndarray Элемент-поэлементный остаток от деления по модулю. Это скаляр, если и x1, и x2 являются скалярами.

См. также

floor_divide

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

remainder

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

modf

Эквивалентно divmod(x, 1) для положительного x с переставленными возвращаемыми значениями.

Примеры

>>> np.divmod(np.arange(5), 3)
(array([0, 0, 0, 1, 1]), array([0, 1, 2, 0, 1]))