numpy.ma.MaskedArray.item

метод

MaskedArray.item(*args)

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

Параметры

*argsArguments (variable number and type)

• none: в этом случае метод работает только для массивов с одним элементом (a.size == 1), который копируется в стандартный скалярный объект Python и возвращается.
• int_type: этот аргумент интерпретируется как плоский индекс в массиве, определяющий, какой элемент скопировать и вернуть.
• кортеж из int_types: работает аналогично аргументу int_type, за исключением того, что аргумент интерпретируется как индекс nd в массиве.

Возвращает

zStandard Python scalar object

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