Overview
- The Series.pow() function when called on a pandas Series instance raises its elements to the power given by another series.
- Calling Series.pow() is equivalent to using the exponential operator (**). However, the pow() function enables to replace the NaN/None values by a default value through fill_value parameter.
Example - Raise the elements of one pandas Series to the power given by the elements of another pandas Series
# An example Python program to raise the elements of a pandas Series
# to the power given by the elements of another Series
import pandas as pds
# Create pandas Series instances
series1 = pds.Series([1, 2, 3, 4, 6, 8]);
series2 = pds.Series([2, 4, 6, 8, 10, 12]);
# Raise the first series to the power given by the second series
result = series1.pow(series2);
print("Elements of the first Series:");
print(series1);
print("Elements of the second Series:");
print(series2);
print("Elements of the first Series raised to the power by the elements of the second series:")
print(result);Output
Elements of the first Series:
0 1
1 2
2 3
3 4
4 6
5 8
dtype: int64
Elements of the second Series:
0 2
1 4
2 6
3 8
4 10
5 12
dtype: int64
Elements of the first Series raised to the power by the elements of the second series:
0 1
1 16
2 729
3 65536
4 60466176
5 68719476736
dtype: int64Example – Applying pow() on a pandas Series using a Python Sequence
This example calls Series.pow() on a pandas Series instance using a Python list as a parameter.
# Example python program that uses Series.pow() function
# to raise elements of one pandas series to the power
# defined by the elements of a Python Sequence
import pandas as pds
# Create a pandas Series
pandasSeries = pds.Series([5, 10, 15, 20, 25]);
# Creata a Python List
pythonList = [2, 4, 8, 12, 16];
# Raise elements of the series by the values from the Python list
result = pandasSeries.pow(pythonList);
print("Elements of the pandas Series:");
print(pandasSeries);
print("Elements of the Python list:");
print(pythonList);
print("Elements of pandas Series raised to the power of elements from the Python list:");
print(result);Output
Elements of the pandas Series:
0 5
1 10
2 15
3 20
4 25
dtype: int64
Elements of the Python list:
[2, 4, 8, 12, 16]
Elements of pandas Series raised to the power of elements from the Python list:
0 25
1 10000
2 2562890625
3 4096000000000000
4 3273344365508751233
dtype: int64Example – First Series as base and the second Series as exponent while replacing the NaN/None values with default values
The following Python example program uses two pandas Series instances. The elements of the first pandas Series are used as base values. The elements of the second Series are used as exponent values. The Series.pow() is called on the first Series by using the second Series as the parameter. The fill_value parameter repalces any NaN/None values with default values. A new series is returned by Series.pow(), which has the series1 elements raised to the power given by the series2 elements.
# Using the elements of a pandas Series as base
# and using the elements of another pandas Series as exponent
# while replacing NaN/None values with the default values
import pandas as pds
# Create two pandas.Series instances
s1 = pds.Series([0.25, 0.5, 0.75, 1.0, 1.25]);
s2 = pds.Series([2, None, 3, 4, None]);
# Raise s1 elements, using the elements from s2 as exponents
s3 = s1.pow(s2, fill_value=2);
print("s1:");
print(s1);
print("s2:");
print(s2);
print("s1 elements raised to power by the elements of s2:");
print(s3);Output
s1:
0 0.25
1 0.50
2 0.75
3 1.00
4 1.25
dtype: float64
s2:
0 2.0
1 NaN
2 3.0
3 4.0
4 NaN
dtype: float64
s1 elements raised to power by the elements of s2:
0 0.062500
1 0.250000
2 0.421875
3 1.000000
4 1.562500
dtype: float64