What is the DataFrame.clear() function in Polars Python?

Polars, a Rust-based library, outperforms pandas for large data manipulation, especially with tabular data. It offers a high-speed DataFrame for efficient slicing, filtering, and transformations in Python and Rust.

The clear() function

The DataFrame.clear() method generates a copy of the null-filled DataFrame. It accepts a value as a parameter, e.g., $n$. If $n$is $0$, it returns an empty DataFrame and if $n$ is greater than $0$, it creates a new DataFrame with $n$ rows, filling them with null values. The new DataFrame maintains the same structure as the original one, and it can have more rows than the original DataFrame.

Syntax

Here’s the syntax of the DataFrame.clear() function:

Here n represents the number of rows filled with null values in the cleared frame.

Code example

Let’s have a look at a coding example of clearing the Dataframe using clear() method in polars:

Explanation

In the above code:

• Line 1: We import the polars library as pl.

• Lines 3–10: We define our DataFrame as df, which includes Country, City, Salary, and Role.

• Lines 13–17: We implement the clear() method to the created Dataframe, passing different arguments, resulting in an empty DataFrame, a DataFrame with 2 rows, and another DataFrame containing more than the defined rows (7) in the original DataFrame.

Conclusion

In conclusion, the DataFrame.clear() function in polars Python generates a null-filled DataFrame copy. It produces an empty DataFrame for $n$=0 value and a new DataFrames with $n$ null-filled rows for non-zero values, maintaining the original structure.