Spec-Zone.ru › pandas 0.25

pandas.DataFrame.any

DataFrame.any(self, axis=0, bool_only=None, skipna=True, level=None, **kwargs) [source]

Возвращает True, если хотя бы один элемент является True, потенциально по оси.

Возвращает False, если нет хотя бы одного элемента в серии или вдоль оси Dataframe, который является True или эквивалентен (например, не ноль или не пустой).

Параметры:
axis : {0 or ‘index’, 1 or ‘columns’, None}, default 0

Указывает, какие оси или оси следует уменьшить.

  • 0 / ‘index’ : уменьшить индекс, вернуть Series, индекс которой — исходные метки столбцов.
  • 1 / ‘columns’ : уменьшить столбцы, вернуть Series, индекс которой — исходный индекс.
  • None : уменьшить все оси, вернуть скаляр.
bool_only : bool, default None

Включать только булевы столбцы. Если None, попытается использовать все, затем использовать только булевы данные. Не реализовано для Series.

skipna : bool, default True

Исключать значения NA/null. Если вся строка/столбец — NA, а skipna — True, результат будет False, как и для пустой строки/столбца. Если skipna — False, то NA обрабатываются как True, потому что они не равны нулю.

level : int or level name, default None

Если ось — MultiIndex (иерархический), считать по определённому уровню, сводя в Series.

**kwargs : any, default None

Дополнительные ключевые слова не влияют, но могут приниматься для совместимости с NumPy.

Возвращает:
Series или DataFrame

Если указан уровень, возвращается DataFrame; в противном случае возвращается Series.

См. также

numpy.any
Версия NumPy этого метода.
Series.any
Возвращает True, если хотя бы один элемент — True.
Series.all
Возвращает True, если все элементы — True.
DataFrame.any
Возвращает True, если хотя бы один элемент — True по заданной оси.
DataFrame.all
Возвращает True, если все элементы — True по заданной оси.

Примеры

Series

Для входных данных Series, выход — скаляр, указывающий, есть ли хотя бы один элемент, равный True.

>>> pd.Series([False, False]).any()
False
>>> pd.Series([True, False]).any()
True
>>> pd.Series([]).any()
False
>>> pd.Series([np.nan]).any()
False
>>> pd.Series([np.nan]).any(skipna=False)
True

DataFrame

Содержит ли каждый столбец хотя бы один элемент True (по умолчанию).

>>> df = pd.DataFrame({"A": [1, 2], "B": [0, 2], "C": [0, 0]})
>>> df
   A  B  C
0  1  0  0
1  2  2  0
>>> df.any()
A     True
B     True
C    False
dtype: bool

Агрегирование по столбцам.

>>> df = pd.DataFrame({"A": [True, False], "B": [1, 2]})
>>> df
       A  B
0   True  1
1  False  2
>>> df.any(axis='columns')
0    True
1    True
dtype: bool
>>> df = pd.DataFrame({"A": [True, False], "B": [1, 0]})
>>> df
       A  B
0   True  1
1  False  0
>>> df.any(axis='columns')
0    True
1    False
dtype: bool

Агрегирование по всему DataFrame с axis=None.

>>> df.any(axis=None)
True

any для пустого DataFrame — пустая Series.

>>> pd.DataFrame([]).any()
Series([], dtype: bool)

© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.25.0/reference/api/pandas.DataFrame.any.html

Spec-Zone.ru

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