numpy.put

numpy.put(a, ind, v, mode='raise') [source]

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

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

a.flat[ind] = v

Parameters

andarray

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

indarray_like

Индексы цели, интерпретируются как целые числа.

varray_like

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

mode{‘raise’, ‘wrap’, ‘clip’}, optional

Указывает, как будут обрабатываться индексы за пределами границ.

• ‘raise’ – генерируется ошибка (по умолчанию)
• ‘wrap’ – перенос вокруг
• ‘clip’ – обрезка до диапазона

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

См. также

putmask, place

put_along_axis

Помещение элементов по соответствию массива и массивов индексов

Примеры

>>> 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])