Spec-Zone.ru › NumPy 2.0

numpy.nonzero

numpy.nonzero(a)[source]

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

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

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

Примечание

При вызове на нульмерном массиве или скаляре, nonzero(a) обрабатывается как nonzero(atleast_1d(a)).

Устарело начиная с версии 1.17.0: Используйте atleast_1d явно, если это поведение является намеренным.

Параметры:
aarray_like

Входной массив.

Возвращает:
tuple_of_arraystuple

Индексы элементов, не равных нулю.

См. также

flatnonzero

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

ndarray.nonzero

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

count_nonzero

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

Примечания

Хотя ненулевые значения можно получить с помощью a[nonzero(a)], рекомендуется использовать x[x.astype(bool)] или x[x != 0] вместо этого, что правильно обработает нульмерные массивы.

Примеры

>>> x = np.array([[3, 0, 0], [0, 4, 0], [5, 6, 0]])
>>> x
array([[3, 0, 0],
       [0, 4, 0],
       [5, 6, 0]])
>>> np.nonzero(x)
(array([0, 1, 2, 2]), array([0, 1, 0, 1]))
>>> x[np.nonzero(x)]
array([3, 4, 5, 6])
>>> np.transpose(np.nonzero(x))
array([[0, 0],
       [1, 1],
       [2, 0],
       [2, 1]])

Общее применение nonzero - это поиск индексов массива, где условие истинно. Учитывая массив a, условие a > 3 - это булевый массив, и так как False интерпретируется как 0, np.nonzero(a > 3) возвращает индексы a, где условие истинно.

>>> a = np.array([[1, 2, 3], [4, 5, 6], [7, 8, 9]])
>>> a > 3
array([[False, False, False],
       [ True,  True,  True],
       [ True,  True,  True]])
>>> np.nonzero(a > 3)
(array([1, 1, 1, 2, 2, 2]), array([0, 1, 2, 0, 1, 2]))

Использование этого результата для индексации a эквивалентно прямому использованию маски:

>>> a[np.nonzero(a > 3)]
array([4, 5, 6, 7, 8, 9])
>>> a[a > 3]  # prefer this spelling
array([4, 5, 6, 7, 8, 9])

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

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

© 2005–2024 NumPy Developers
Licensed under the 3-clause BSD License.
https://numpy.org/doc/2.0/reference/generated/numpy.nonzero.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API