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