Python | Pandas Series.rename()

Pandas series is a One-dimensional ndarray with axis labels. The labels need not be unique but must be a hashable type. The object supports both integer- and label-based indexing and provides a host of methods for performing operations involving the index.

Pandas Series.rename() function is used to alter Series index labels or name for the given Series object.

Syntax: Series.rename(index=None, **kwargs)

Parameter :
index : dict-like or functions are transformations to apply to the index
copy : Also copy underlying data
inplace : Whether to return a new Series. If True then value of copy is ignored.
level : In case of a MultiIndex, only rename labels in the specified level.

Returns : Series, DataFrame, or None

Example #1: Use Series.rename() function to rename the name of the given Series object.




# importing pandas as pd
import pandas as pd
  
# Creating the Series
sr = pd.Series([10, 25, 3, 11, 24, 6])
  
# Create the Index
index_ = ['Coca Cola', 'Sprite', 'Coke', 'Fanta', 'Dew', 'ThumbsUp']
  
# set the index
sr.index = index_
  
# Print the series
print(sr)


Output :

Now we will use Series.rename() function to rename the name of the given series object.




<div id="highlighter_492672" class="syntaxhighlighter nogutter  "><table border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="code"><div class="container"><div class="line number1 index0 alt2"><code class="comments"># rename the series </code></div><div class="line number2 index1 alt1"><code class="plain">result </code><code class="keyword">=</code> <code class="plain">sr.rename(</code><code class="string">'Beverages'</code><code class="plain">) </code></div><div class="line number3 index2 alt2"><code class="undefined spaces"> </code> </div><div class="line number4 index3 alt1"><code class="comments"># Print the result </code></div><div class="line number5 index4 alt2"><code class="functions">print</code><code class="plain">(result) </code></div></div></td></tr></tbody></table></div>


Output :


As we can see in the output, the Series.rename() function has successfully renamed the given series object.

Example #2: Use Series.rename() function to rename the MultiIndex axis of the given Series object.




<div id="highlighter_720867" class="syntaxhighlighter nogutter  "><table border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="code"><div class="container"><div class="line number1 index0 alt2"><code class="comments"># importing pandas as pd </code></div><div class="line number2 index1 alt1"><code class="keyword">import</code> <code class="plain">pandas as pd </code></div><div class="line number3 index2 alt2"><code class="undefined spaces"> </code> </div><div class="line number4 index3 alt1"><code class="comments"># Creating the Series </code></div><div class="line number5 index4 alt2"><code class="plain">sr </code><code class="keyword">=</code> <code class="plain">pd.Series([</code><code class="string">'New York'</code><code class="plain">, </code><code class="string">'Chicago'</code><code class="plain">, </code><code class="string">'Toronto'</code><code class="plain">, </code><code class="string">'Lisbon'</code><code class="plain">, </code><code class="string">'Rio'</code><code class="plain">]) </code></div><div class="line number6 index5 alt1"><code class="undefined spaces"> </code> </div><div class="line number7 index6 alt2"><code class="comments"># Create the MultiIndex </code></div><div class="line number8 index7 alt1"><code class="plain">index_ </code><code class="keyword">=</code> <code class="plain">pd.MultiIndex.from_product([[</code><code class="string">'Names'</code><code class="plain">], [</code><code class="string">'City 1'</code><code class="plain">, </code><code class="string">'City 2'</code><code class="plain">, </code><code class="string">'City 3'</code><code class="plain">, </code><code class="string">'City 4'</code><code class="plain">, </code><code class="string">'City 5'</code><code class="plain">]], </code></div><div class="line number9 index8 alt2"><code class="undefined spaces">                                                                      </code><code class="plain">names </code><code class="keyword">=</code><code class="plain">[</code><code class="string">'Level 1'</code><code class="plain">, </code><code class="string">'Level 2'</code><code class="plain">]) </code></div><div class="line number10 index9 alt1"><code class="undefined spaces"> </code> </div><div class="line number11 index10 alt2"><code class="comments"># set the index </code></div><div class="line number12 index11 alt1"><code class="plain">sr.index </code><code class="keyword">=</code> <code class="plain">index_ </code></div><div class="line number13 index12 alt2"><code class="undefined spaces"> </code> </div><div class="line number14 index13 alt1"><code class="comments"># Print the series </code></div><div class="line number15 index14 alt2"><code class="functions">print</code><code class="plain">(sr) </code></div></div></td></tr></tbody></table></div>


Output :

Now we will use Series.rename() function to rename the 0th level of the given series object.




<div id="highlighter_690347" class="syntaxhighlighter nogutter  "><table border="0" cellpadding="0" cellspacing="0"><tbody><tr><td class="code"><div class="container"><div class="line number1 index0 alt2"><code class="comments"># rename the 0th level </code></div><div class="line number2 index1 alt1"><code class="plain">result </code><code class="keyword">=</code> <code class="plain">sr.rename(level </code><code class="keyword">=</code> <code class="value">0</code><code class="plain">, index </code><code class="keyword">=</code> <code class="string">'Row_axis'</code><code class="plain">) </code></div><div class="line number3 index2 alt2"><code class="undefined spaces"> </code> </div><div class="line number4 index3 alt1"><code class="comments"># Print the result </code></div><div class="line number5 index4 alt2"><code class="functions">print</code><code class="plain">(result) </code></div></div></td></tr></tbody></table></div>


Output :

As we can see in the output, the Series.rename() function has successfully renamed the 0th level of the given series object.



Contact Us