Tutorials References Exercises Videos Menu
Website Get Certified Pro NEW

Pandas DataFrame where() Method

❮ DataFrame Reference


Example

Set to NaN, all values where the age if not over 30:

import pandas as pd

data = {
  "age": [50, 40, 30, 40, 20, 10, 30],
  "qualified": [True, False, False, False, False, True, True]
}
df = pd.DataFrame(data)

newdf = df.where(df["age"] > 30)
Try it Yourself »

Definition and Usage

The where() method replaces the values of the rows where the condition evaluates to False.

The where() method is the opposite of the The mask() method.


Syntax

dataframe.where(cond, other, inplace, axis, level, errors, try_cast)

Parameters

The otherinplace, axis, level, errors, try_cast parameters are keyword arguments.

Parameter Value Description
cond   Required. An expression or function that evacuates to either True or False
other String
Number
Series
DataFrame
Optional. A set of values to replace the rows that evaluates to False with
inplace True
False
Optional, default False. Specifies whether to perform the operation on the original DataFrame or not, if not, which is default, this method returns a new DataFrame
axis Number
None
Optional, default None. Specifies the alignment axis
level Number
None
Optional, default None. Specifies the alignment level
errors 'raise'
'ignore'
Optional, default 'raise'. Specifies what to do with exceptions
try_cast True
False
Optional, default False. Specifies whether to try to cast the result back to the input type or not

Return Value

A DataFrame with the result, or None if the inplace parameter is set to True.


❮ DataFrame Reference