numpy.ma.MaskedArray.item

метод

ma.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.

Примеры

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

Для массива с объектным типом dtype элементы возвращаются как есть.

>>> a = np.array([np.int64(1)], dtype=object)
>>> a.item() #return np.int64
np.int64(1)