numpy.ndarray.item

ndarray.item(*args)

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

Параметры:

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

Возвращает:

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