Menu
×
   ❮     
HTML CSS JAVASCRIPT SQL PYTHON JAVA PHP HOW TO W3.CSS C C++ C# BOOTSTRAP REACT MYSQL JQUERY EXCEL XML DJANGO NUMPY PANDAS NODEJS R TYPESCRIPT ANGULAR GIT POSTGRESQL MONGODB ASP AI GO KOTLIN SASS VUE DSA GEN AI SCIPY AWS CYBERSECURITY DATA SCIENCE
     ❯   

Pandas DataFrame mask() Method

❮ DataFrame Reference


Example

Set to NaN, all values where the age IS 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.mask(df["age"] > 30)
Try it Yourself »

Definition and Usage

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

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


Syntax

dataframe.mask(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 True 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

×

Contact Sales

If you want to use W3Schools services as an educational institution, team or enterprise, send us an e-mail:
sales@w3schools.com

Report Error

If you want to report an error, or if you want to make a suggestion, send us an e-mail:
help@w3schools.com

W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookie and privacy policy.

Copyright 1999-2024 by Refsnes Data. All Rights Reserved. W3Schools is Powered by W3.CSS.