numpy.any

numpy.any(a, axis=None, out=None, keepdims=<no value>, *, where=<no value>)[source]

Проверка, истинно ли хотя бы одно из значений массива вдоль заданной оси.

Возвращает одно булево значение, если axis является None.

Параметры:

aarray_like

Вводной массив или объект, который можно преобразовать в массив.

axisNone или int или кортеж из целых чисел, необязательно

Ось или оси, по которым выполняется логическое ИЛИ. По умолчанию (axis=None) выполняется логическое ИЛИ по всем измерениям входного массива. axis может быть отрицательным, в этом случае он считает от последней до первой оси.

Добавлена в версии 1.7.0.

Если это кортеж из целых чисел, выполняется сводка по нескольким осям, а не по одной оси или всем осям, как раньше.

outndarray, необязательно

Альтернативный массив вывода, в который помещается результат. Он должен иметь ту же форму, что и ожидаемый результат, и его тип сохраняется (например, если он имеет тип float, то он останется таким, возвращая 1.0 для True и 0.0 для False, независимо от типа a). Подробнее см. Определение типа результата.

keepdimsbool, необязательно

Если это True, оси, которые уменьшены, сохраняются в результате в виде измерений с размером один. С этим параметром результат будет корректно транслироваться относительно входного массива.

Если передано значение по умолчанию, то keepdims не будет передаваться методу any подклассов ndarray, однако любое значение, отличное от значения по умолчанию, будет. Если метод подкласса не реализует keepdims , будут подняты исключения.

wherearray_like из bool, необязательно

Элементы, которые нужно учитывать при проверке на наличие True значений. Подробности см. в reduce.

Добавлена в версии 1.20.0.

Возвращает:

anybool или ndarray

Возвращается новый булевый или ndarray массив, если не указано out, в противном случае возвращается ссылка на out.

См. также

ndarray.any

эквивалентный метод

all

Проверка, истинны ли все элементы вдоль заданной оси.

Примечания

Не число (NaN), положительная и отрицательная бесконечность оцениваются как True, поскольку они не равны нулю.

Изменено в версии 2.0: Перед NumPy 2.0, any не возвращало булевы значения для входных массивов с типом object. Это поведение все еще доступно через np.logical_or.reduce.

Примеры

>>> np.any([[True, False], [True, True]])
True

>>> np.any([[True, False], [False, False]], axis=0)
array([ True, False])

>>> np.any([-1, 0, 5])
True

>>> np.any([[np.nan], [np.inf]], axis=1, keepdims=True)
array([[ True],
       [ True]])

>>> np.any([[True, False], [False, False]], where=[[False], [True]])
False

>>> a = np.array([[1, 0, 0],
...               [0, 0, 1],
...               [0, 0, 0]])
>>> np.any(a, axis=0)
array([ True, False,  True])
>>> np.any(a, axis=1)
array([ True,  True, False])

>>> o=np.array(False)
>>> z=np.any([-1, 4, 5], out=o)
>>> z, o
(array(True), array(True))
>>> # Check now that z is a reference to o
>>> z is o
True
>>> id(z), id(o) # identity of z and o              
(191614240, 191614240)