numpy.put

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

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

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

a.flat[ind] = v

Параметры:

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