numpy.put#

numpy.put(a, ind, v, mode='raise')[источник]#

Заменяет указанные элементы массива заданными значениями.

Индексирование работает на сглаженном целевом массиве. put примерно эквивалентно:

a.flat[ind] = v

Параметры:

andarray

Целевой массив.

indarray_like

Целевые индексы, интерпретируемые как целые числа.

varray_like

Значения для размещения в a по целевым индексам. Если v может быть установлено в конкретное ind он будет повторяться по мере необходимости.

mode{‘raise’, ‘wrap’, ‘clip’}, опционально

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

'raise' – вызвать ошибку (по умолчанию)
‘wrap’ – циклический перенос
‘clip’ – обрезать до диапазона

Режим ‘clip’ означает, что все индексы, превышающие допустимые, заменяются на индекс последнего элемента по данной оси. Обратите внимание, что это отключает индексацию с отрицательными числами. В режиме ‘raise’, если возникает исключение, целевой массив всё равно может быть изменён.

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

putmask, place
put_along_axis: Разместить элементы, сопоставляя массив и массивы индексов

Примеры

>>> import numpy as np
>>> a = np.arange(5)
>>> np.put(a, [0, 2], [-44, -55])
>>> a
array([-44,   1, -55,   3,   4])

>>> a = np.arange(5)
>>> np.put(a, 22, -5, mode='clip')
>>> a
array([ 0,  1,  2,  3, -5])