numpy.ndarray.itemset

метод

ndarray.itemset(*args)

Вставка скалярного значения в массив (скаляр приводится к типу данных массива, если это возможно)

Должно быть как минимум 1 аргумент, и последний аргумент определён как значение. Тогда a.itemset(*args) эквивалентно, но быстрее, чем a[args] = item. Значение должно быть скалярным, и args должно выбрать один элемент в массиве a.

Параметры

*argsАргументы

Если один аргумент: скалярное значение, используется только в случае, если a имеет размер 1. Если два аргумента: последний аргумент — значение, которое нужно установить, и оно должно быть скалярным, первый аргумент определяет местоположение элемента массива. Это либо целое число, либо кортеж.

Примечания

По сравнению с синтаксисом индексирования, itemset обеспечивает некоторое ускорение при размещении скалярного значения в определённом месте в ndarray, если это необходимо. Однако, в целом от этого следует воздерживаться: помимо прочего, это усложняет вид кода. Кроме того, при использовании itemset (и item) в цикле следует присвоить методы локальной переменной, чтобы избежать поиска атрибута на каждой итерации цикла.

Примеры

>>> np.random.seed(123)
>>> x = np.random.randint(9, size=(3, 3))
>>> x
array([[2, 2, 6],
       [1, 3, 6],
       [1, 0, 1]])
>>> x.itemset(4, 0)
>>> x.itemset((2, 2), 9)
>>> x
array([[2, 2, 6],
       [1, 0, 6],
       [1, 0, 9]])