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