pandas.Series.where

Series.where(cond, other=nan, inplace=False, axis=None, level=None, errors='raise', try_cast=False, raise_on_error=None) [source]

Возвращает объект той же формы, что и self, значения элементов которого взяты из self, если cond равно True, в противном случае из other.

Параметры:

cond : булево NDFrame, массив-подобный объект или вызываемая функция Если cond равно True, сохраняется исходное значение. Если False, значение заменяется соответствующим значением из other. Если cond является вызываемой функцией, она вычисляется для NDFrame и должна возвращать булево NDFrame или массив. Вызываемая функция не должна изменять входной NDFrame (хотя pandas этого не проверяет). Введено в версии 0.18.1: В качестве cond может использоваться вызываемая функция. other : скалярное значение, NDFrame или вызываемая функция Элементы, где cond равно False, заменяются соответствующим значением из other. Если other является вызываемой функцией, она вычисляется для NDFrame и должна возвращать скалярное значение или NDFrame. Вызываемая функция не должна изменять входной NDFrame (хотя pandas этого не проверяет). Введено в версии 0.18.1: В качестве other может использоваться вызываемая функция. inplace : boolean, по умолчанию False Выполнять ли операцию на данных inplace axis : ось выравнивания, если необходимо, по умолчанию None level : уровень выравнивания, если необходимо, по умолчанию None errors : str, {‘raise’, ‘ignore’}, по умолчанию ‘raise’ raise : разрешить поднятие исключений ignore : подавить исключения. В случае ошибки вернуть исходный объект Обратите внимание, что в настоящее время этот параметр не повлияет на результаты и всегда будет приводиться к подходящему типу. try_cast : boolean, по умолчанию False попытаться привести результат обратно к типу входных данных (если возможно), raise_on_error : boolean, по умолчанию True Поднимать ли исключение при недопустимых типах данных (например, при попытке where для строк) Устарело начиная с версии 0.21.0.

Возвращает:

wh : тот же тип, что и вызывающий объект

См. также

DataFrame.mask()

Примечания

Метод where — это применение выражения if-then. Для каждого элемента вызываемого DataFrame, если cond равно True, используется этот элемент; в противном случае используется соответствующий элемент из DataFrame other.

Подпись для DataFrame.where() отличается от numpy.where(). Примерно df1.where(m, df2) эквивалентно np.where(m, df1, df2).

Дополнительные сведения и примеры см. в документации where в индексировании.

Примеры

>>> s = pd.Series(range(5))
>>> s.where(s > 0)
0    NaN
1    1.0
2    2.0
3    3.0
4    4.0

>>> s.mask(s > 0)
0    0.0
1    NaN
2    NaN
3    NaN
4    NaN

>>> s.where(s > 1, 10)
0    10.0
1    10.0
2    2.0
3    3.0
4    4.0

>>> df = pd.DataFrame(np.arange(10).reshape(-1, 2), columns=['A', 'B'])
>>> m = df % 3 == 0
>>> df.where(m, -df)
   A  B
0  0 -1
1 -2  3
2 -4 -5
3  6 -7
4 -8  9
>>> df.where(m, -df) == np.where(m, df, -df)
      A     B
0  True  True
1  True  True
2  True  True
3  True  True
4  True  True
>>> df.where(m, -df) == df.mask(~m, -df)
      A     B
0  True  True
1  True  True
2  True  True
3  True  True
4  True  True