Python Pandas Series le() Function

Pandas Series le() Function:

The le() method of the Pandas module compares series and other element-by-element for less than equal to and returns the outcome of the comparison. It’s the same as series <= other, but with the ability to provide a fill_value as one of the parameters to fill in missing data.

Syntax:

Series.le(other, level=None, fill_value=None, axis=0)

Parameters

other: This is required. It indicates a Series or a scalar value.

level: This is optional. To broadcast over a level, specify an int or a name that matches the Index values on the passed MultiIndex level. The type of this may be int or name. None is the default value.

fill_value: This is optional. It indicates a value to fill in any current missing (NaN) values, as well as any new elements required for successful Series alignment. The result will be missing if data is missing in both corresponding Series locations. The type of this may be float or None. None is the default value.

axis:  This is optional. To apply the method by rows, use 0 or ‘index,’ and to apply it by columns, use 1 or ‘columns.’

Return Value:

The result of the comparison i.e, a boolean series is returned.

Pandas Series le() Function in Python

Example1

Approach:

  • Import pandas module using the import keyword.
  • Pass some random list as an argument to the Series() function of the pandas module to create a series.
  • Store it in a variable.
  • Print the above-given series.
  • Apply le() function on all the elements of the given series by passing some random number to it and print the result.
  • Here it compares if all the elements of the given series are <= 40
  • The Exit of the Program.

Below is the implementation:

# Import pandas module using the import keyword.
import pandas as pd
# Pass some random list as an argument to the Series() function
# of the pandas module to create a series.
# Store it in a variable.
gvn_series = pd.Series([12, 25, 65, 40, 100])
# Print the above given series
print("The given series is:")
print(gvn_series)
print()
# Apply le() function on all the elements of the given series
# by passing some random number to it and print the result.
# Here it compares if all the elements of the given series are <= 40
print("Checking if all the elements of the given series are <= 40:")
print(gvn_series.le(40))

Output:

The given series is:
0     12
1     25
2     65
3     40
4    100
dtype: int64

Checking if all the elements of the given series are <= 40:
0     True
1     True
2    False
3     True
4    False
dtype: bool

Example2

Here a series is compared to another series for less than or equal to (<=) condition element by element.

Approach:

  • Import pandas module using the import keyword.
  • Import numpy module using the import keyword.
  • Pass some random list, index values as the arguments to the Series() function of the pandas module to create a series.
  • Store it in a variable.
  • Similarly, Pass some random list, index values as the arguments to the Series() function of the pandas module to create another series.
  • Store it in another variable.
  • Print the above first given series
  • Print the above second given series
  • Pass the given second series and fill_value as some random number as the arguments to the le() function and apply it to the first series and print the result.
  • Here, we compare gvn_series1 <= gvn_series2 element-by-element by filling NaN values with the given fill_value.
  • The Exit of the Program.

Below is the implementation:

# Import pandas module using the import keyword.
import pandas as pd
# Import numpy module using the import keyword.
import numpy as np
# Pass some random list, index values as the arguments to the 
# Series() function of the pandas module to create a series.
# Store it in a variable.
gvn_series1 = pd.Series([2, 15, 4, np.NaN, 30], 
              index=['P', 'Q', 'R', 'S', 'T'])
# Similarly, Pass some random list, index values as the arguments to the 
# Series() function of the pandas module to create another series.
# Store it in another variable.
gvn_series2 = pd.Series([5, 15, np.NaN, 2, 10], 
              index=['P', 'Q', 'R', 'S', 'T'])
# Print the above first given series
print("The given first series is:")
print(gvn_series1)
print()
# Print the above second given series
print("The given second series is:")
print(gvn_series2)
print()
# Pass the given second series and fill_value as some random number as the 
# arguments to the le() function and apply it to the first series and  
# print the result.
# Here, we compare gvn_series1 <= gvn_series2 element-by-element
# by filling NaN values with the given fill_value.
print("Comparing gvn_series1 <= gvn_series2 element-by-element:")
print(gvn_series1.le(gvn_series2, fill_value=10))

Output:

The given first series is:
P     2.0
Q    15.0
R     4.0
S     NaN
T    30.0
dtype: float64

The given second series is:
P     5.0
Q    15.0
R     NaN
S     2.0
T    10.0
dtype: float64

Comparing gvn_series1 <= gvn_series2 element-by-element:
P     True
Q     True
R     True
S    False
T    False
dtype: bool

Example3

Approach:

  • Import pandas module using the import keyword.
  • Pass some random key-value pair(dictionary) as arguments to the DataFrame() function of the pandas module to create a dataframe.
  • Store it in a variable.
  • Print the given dataframe.
  • Compare both the columns gvn_list1 and gvn_list2 using the le() function and store the result as a new column in the dataframe.
  • Here it checks if gvn_list1 <= gvn_list2 element-wise.
  • Print the dataframe after adding a new column(gvn_list1 <= gvn_list2).
  • The Exit of the Program.

Below is the implementation:

# Import pandas module using the import keyword.
import pandas as pd
# Pass some random key-value pair(dictionary) as arguments to the 
# DataFrame() function of the pandas module to create a dataframe
# Store it in a variable.
data_frme  = pd.DataFrame({
  "gvn_list1": [45, 24, 54, 90],
  "gvn_list2": [55, 7, 54, 44]
})
# Print the given dataframe
print("The given Dataframe:")
print(data_frme)
print()

# Compare both the columns gvn_list1 and gvn_list2 using the le() function
# and store the result as a new column in the dataframe.
# Here it checks if gvn_list1 <= gvn_list2 element-wise.
data_frme ['gvn_list1 <= gvn_list2'] = data_frme ['gvn_list1'].le(data_frme ['gvn_list2'])
# Print the dataframe after adding a new column(gvn_list1 <= gvn_list2)
print("The dataframe after adding a new column(gvn_list1 <= gvn_list2):")
print(data_frme )

Output:

The given Dataframe:
   gvn_list1  gvn_list2
0         45         55
1         24          7
2         54         54
3         90         44

The dataframe after adding a new column(gvn_list1 <= gvn_list2):
   gvn_list1  gvn_list2  gvn_list1 <= gvn_list2
0         45         55                    True
1         24          7                   False
2         54         54                    True
3         90         44                   False