numpy.ma.MaskedArray.nonzero

метод

MaskedArray.nonzero(self) [source]

Возвращает индексы элементов, не являющихся масками и отличных от нуля.

Возвращает кортеж массивов, по одному для каждой размерности, содержащих индексы элементов, отличных от нуля в этой размерности. Соответствующие значения, отличные от нуля, можно получить с помощью:

a[a.nonzero()]

Чтобы сгруппировать индексы по элементу, а не по размерности, используйте:

np.transpose(a.nonzero())

Результат всегда является 2D-массивом, с одной строкой для каждого элемента, отличного от нуля.

Параметры:	None
Возвращает:	tuple_of_arrays : tuple Индексы элементов, отличных от нуля.

См. также

numpy.nonzero

Функция, работающая с nd-массивами.

flatnonzero

Возвращает индексы, отличные от нуля, в уплощенной версии входного массива.

ndarray.nonzero

Эквивалентный метод ndarray.

count_nonzero

Подсчитывает количество элементов, отличных от нуля, во входном массиве.

Примеры

>>> import numpy.ma as ma
>>> x = ma.array(np.eye(3))
>>> x
masked_array(
  data=[[1., 0., 0.],
        [0., 1., 0.],
        [0., 0., 1.]],
  mask=False,
  fill_value=1e+20)
>>> x.nonzero()
(array([0, 1, 2]), array([0, 1, 2]))

Элементы маски игнорируются.

>>> x[1, 1] = ma.masked
>>> x
masked_array(
  data=[[1.0, 0.0, 0.0],
        [0.0, --, 0.0],
        [0.0, 0.0, 1.0]],
  mask=[[False, False, False],
        [False,  True, False],
        [False, False, False]],
  fill_value=1e+20)
>>> x.nonzero()
(array([0, 2]), array([0, 2]))

Индексы также можно сгруппировать по элементу.

>>> np.transpose(x.nonzero())
array([[0, 0],
       [2, 2]])

Распространенное применение nonzero — нахождение индексов массива, где условие является истинным. Учитывая массив a, условие a > 3 является булевым массивом, и так как False интерпретируется как 0, ma.nonzero(a > 3) возвращает индексы a, где условие истинно.

>>> a = ma.array([[1,2,3],[4,5,6],[7,8,9]])
>>> a > 3
masked_array(
  data=[[False, False, False],
        [ True,  True,  True],
        [ True,  True,  True]],
  mask=False,
  fill_value=True)
>>> ma.nonzero(a > 3)
(array([1, 1, 1, 2, 2, 2]), array([0, 1, 2, 0, 1, 2]))

Также может быть вызван метод nonzero массива условия.

>>> (a > 3).nonzero()
(array([1, 1, 1, 2, 2, 2]), array([0, 1, 2, 0, 1, 2]))