numpy.ndarray.item

метод

ndarray.item(*args)

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

Параметры:

*args : Arguments (variable number and type) none: в этом случае метод работает только для массивов с одним элементом (a.size == 1), который копируется в стандартный Python-скалярный объект и возвращается. int_type: этот аргумент интерпретируется как плоский индекс в массиве, определяющий элемент для копирования и возврата. кортеж из int_types: функционирует аналогично одиночному аргументу int_type, за исключением того, что аргумент интерпретируется как индекс nd в массиве.

Возвращаемое значение:

z : Standard Python scalar object Копия указанного элемента массива в виде подходящего 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