numpy.ma.MaskedArray.item

MaskedArray.item(*args)

Копирует элемент массива в стандартный скаляр Python и возвращает его.

Параметры:

*args : Аргументы (переменное количество и тип) пусто: в этом случае метод работает только для массивов с одним элементом (a.size == 1), который копируется в стандартный скаляр Python и возвращается. тип int: этот аргумент интерпретируется как плоский индекс в массив, указывающий, какой элемент скопировать и вернуть. кортеж из типов int: работает аналогично одиночному аргументу типа int, за исключением того, что аргумент интерпретируется как nd-индекс в массив.

Возвращает:

z : Стандартный скаляр Python Копия указанного элемента массива как подходящего скаляра Python

Примечания

Когда тип данных a является longdouble или clongdouble, item() возвращает массив скаляров, так как нет доступного скаляра Python, который бы не потерял информацию. Массивы void возвращают объект буфера для item(), если поля не определены, в противном случае возвращается кортеж.

item очень похож на a[args], за исключением того, что вместо массива скаляра возвращается стандартный скаляр Python. Это может быть полезно для ускорения доступа к элементам массива и выполнения арифметических операций над элементами массива с использованием оптимизированной математики Python.

Примеры

>>> x = np.random.randint(9, size=(3, 3))
>>> x
array([[3, 1, 7],
       [2, 8, 3],
       [8, 5, 3]])
>>> x.item(3)
2
>>> x.item(7)
5
>>> x.item((0, 1))
1
>>> x.item((2, 2))
3