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