numpy.recarray.item

метод

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

Для массива с типом данных object элементы возвращаются как есть.

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