pandas.DataFrame.where

DataFrame.where(cond, other=_NoDefault.no_default, inplace=False, axis=None, level=None, errors='raise', try_cast=_NoDefault.no_default)[source]

Замена значений, где условие ложно.

Параметры

cond:bool Series/DataFrame, массив-подобный объект или вызываемый объект

Если cond истинно, сохраняется исходное значение. Если ложно, заменяется соответствующим значением из other. Если cond является вызываемым объектом, он вычисляется для Series/DataFrame и должен возвращать булеву Series/DataFrame или массив. Вызываемый объект не должен изменять входные Series/DataFrame (хотя pandas этого не проверяет).

other:скаляр, Series/DataFrame или вызываемый объект

Элементы, где cond ложно, заменяются соответствующим значением из other. Если other — вызываемый объект, он вычисляется для Series/DataFrame и должен возвращать скаляр или Series/DataFrame. Вызываемый объект не должен изменять входные Series/DataFrame (хотя pandas этого не проверяет).

inplace:bool, по умолчанию False

Выполнять ли операцию на месте с данными.

axis:int, по умолчанию None

Ось выравнивания, если необходимо. Для Series этот параметр игнорируется и по умолчанию равен 0.

level:int, по умолчанию None

Уровень выравнивания, если необходимо.

errors:str, {‘raise’, ‘ignore’}, по умолчанию ‘raise’

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

• ‘raise’ : разрешить исключения.

• ‘ignore’ : подавить исключения. В случае ошибки возвращается исходный объект.

Устарело начиная с версии 1.5.0: Этот аргумент не имел эффекта.

try_cast:bool, по умолчанию None

Попробовать привести результат обратно к типу входных данных (если возможно).

Устарело начиная с версии 1.3.0: Привести к исходному типу вручную, если необходимо.

Возвращает

Тип, соответствующий вызывающему объекту, или None, если inplace=True.

См. также

DataFrame.mask()

Возвращает объект той же формы, что и self.

Примечания

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

Подпись для 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
dtype: float64
>>> s.mask(s > 0)
0    0.0
1    NaN
2    NaN
3    NaN
4    NaN
dtype: float64

>>> s = pd.Series(range(5))
>>> t = pd.Series([True, False])
>>> s.where(t, 99)
0     0
1    99
2    99
3    99
4    99
dtype: int64
>>> s.mask(t, 99)
0    99
1     1
2    99
3    99
4    99
dtype: int64

>>> s.where(s > 1, 10)
0    10
1    10
2    2
3    3
4    4
dtype: int64
>>> s.mask(s > 1, 10)
0     0
1     1
2    10
3    10
4    10
dtype: int64

>>> df = pd.DataFrame(np.arange(10).reshape(-1, 2), columns=['A', 'B'])
>>> df
   A  B
0  0  1
1  2  3
2  4  5
3  6  7
4  8  9
>>> 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