241

I have an existing plot that was created with pandas like this:

df['myvar'].plot(kind='bar')

The y axis is format as float and I want to change the y axis to percentages. All of the solutions I found use ax.xyz syntax and I can only place code below the line above that creates the plot (I cannot add ax=ax to the line above.)

How can I format the y axis as percentages without changing the line above?

Here is the solution I found but requires that I redefine the plot:

import matplotlib.pyplot as plt
import numpy as np
import matplotlib.ticker as mtick

data = [8,12,15,17,18,18.5]
perc = np.linspace(0,100,len(data))

fig = plt.figure(1, (7,4))
ax = fig.add_subplot(1,1,1)

ax.plot(perc, data)

fmt = '%.0f%%' # Format you want the ticks, e.g. '40%'
xticks = mtick.FormatStrFormatter(fmt)
ax.xaxis.set_major_formatter(xticks)

plt.show()

Link to the above solution: Pyplot: using percentage on x axis

1

10 Answers 10

364

This is a few months late, but I have created PR#6251 with matplotlib to add a new PercentFormatter class. With this class you just need one line to reformat your axis (two if you count the import of matplotlib.ticker):

import ...
import matplotlib.ticker as mtick

ax = df['myvar'].plot(kind='bar')
ax.yaxis.set_major_formatter(mtick.PercentFormatter())

PercentFormatter() accepts three arguments, xmax, decimals, symbol. xmax allows you to set the value that corresponds to 100% on the axis. This is nice if you have data from 0.0 to 1.0 and you want to display it from 0% to 100%. Just do PercentFormatter(1.0).

The other two parameters allow you to set the number of digits after the decimal point and the symbol. They default to None and '%', respectively. decimals=None will automatically set the number of decimal points based on how much of the axes you are showing.

Update

PercentFormatter was introduced into Matplotlib proper in version 2.1.0.

17
  • 1
    Oh, i think it's because the default is decimal=None, which auto-generates the number of decimals depending on the range. So if the range is less than 50%, it does 10.0%. More than 50% it does 10%. So apologies - your answer is correct, depending on other parameters.
    – Dr Xorile
    Commented Dec 9, 2020 at 20:48
  • 2
    Nive answer! In my case, I used plt.gca().yaxis.set_major_formatter(mtick.PercentFormatter()) to avoid saving a ax plot first.
    – igorkf
    Commented Nov 17, 2021 at 13:50
  • 2
    Very strange: For me, this simply added '%', but without multiplying by 100. OTOH, the answer by erwanp worked as expected. I didn't explore the issue further. Commented Dec 30, 2022 at 8:30
  • 3
    @MadPhysicist - I was using it with no arguments, as you posted. Using PercentFormatter(1.0) did the job. It seems the default is PercentFormatter(100), which is most unexpected. Commented Dec 30, 2022 at 8:46
  • 3
    @MadPhysicist - Because 1.0=100%, they are the same number! It's as if changing to scientific notation using x1e6 changed 1000000 into 1000000x1e6... it changes the numbers. I would have never thought otherwise, and that is certainly the reason why the answer by erwanp works as expected without needing any further input parameters, as in PercentFormatter. It's possibly nice to have the further flexibility of xmax, but the default is clearly wrong, it is not "no transformation". I must be missing something... Commented Dec 30, 2022 at 8:56
169

pandas dataframe plot will return the ax for you, And then you can start to manipulate the axes whatever you want.

import pandas as pd
import numpy as np

df = pd.DataFrame(np.random.randn(100,5))

# you get ax from here
ax = df.plot()
type(ax)  # matplotlib.axes._subplots.AxesSubplot

# manipulate
vals = ax.get_yticks()
ax.set_yticklabels(['{:,.2%}'.format(x) for x in vals])

enter image description here

5
  • 6
    This will have undesired effects as soon as you pan/zoom the graph interactively
    – hitzg
    Commented Jul 12, 2015 at 9:15
  • 4
    Million times easier than trying to use matplotlib.ticker function formatters!
    – Jarad
    Commented Jul 21, 2016 at 19:41
  • How do you then limit the y axis to say (0,100%)? I tried ax.set_ylim(0,100) but that doesn't seem to work!!
    – mpour
    Commented Nov 20, 2018 at 4:36
  • 2
    @mpour only the labels of the yticks are changed, so the limits are still in natural units. Setting ax.set_ylim(0, 1) will do the trick.
    – Joeran
    Commented Apr 25, 2019 at 23:01
  • Not sure why but this answer mislabelled the ticks whereas erwanp's correctly labeled axross the entire axis. Commented Feb 24, 2021 at 20:18
97

Jianxun's solution did the job for me but broke the y value indicator at the bottom left of the window.

I ended up using FuncFormatterinstead (and also stripped the uneccessary trailing zeroes as suggested here):

import pandas as pd
import numpy as np
from matplotlib.ticker import FuncFormatter

df = pd.DataFrame(np.random.randn(100,5))

ax = df.plot()
ax.yaxis.set_major_formatter(FuncFormatter(lambda y, _: '{:.0%}'.format(y))) 

Generally speaking I'd recommend using FuncFormatter for label formatting: it's reliable, and versatile.

enter image description here

3
  • 22
    You can simplify the code even more: ax.yaxis.set_major_formatter(FuncFormatter('{0:.0%}'.format)). AKA no need for the lambda, let format do the work. Commented Nov 9, 2016 at 16:24
  • @DanielHimmelstein can you explain this a little bit? Particularly inside the { }. Not sure how my 0.06 gets turned into 6% using that with the python format. Also great solution. Seems to work much more reliably than using .set_ticklabels
    – DChaps
    Commented Apr 18, 2017 at 7:17
  • 4
    @DChaps '{0:.0%}'.format creates a formatting function. The 0 before the colon tells the formatter to replace the curly-brackets and its contents with the first argument passed to the function. The part after the colon, .0%, tells the formatter how to render the value. The .0 specifies 0 decimal places and % specifies rendering as a percent. Commented Apr 18, 2017 at 15:49
60

For those who are looking for the quick one-liner:

plt.gca().set_yticklabels([f'{x:.0%}' for x in plt.gca().get_yticks()]) 

or, if you've saved your matplotlib.axes.Axes object into variable ax:

ax.set_yticklabels([f'{x:.0f}%' for x in ax.get_yticks()]) 

this assumes

  • import: from matplotlib import pyplot as plt
  • Python >=3.6 for f-String formatting. For older versions, replace f'{x:.0%}' with '{:.0%}'.format(x)
2
  • 1
    For me, Daniel Himmelstein's answer worked whereas this answer changed the scale
    – R. Cox
    Commented Jun 10, 2020 at 11:39
  • If setting tick labels changes the scale, you should issue the scale selection command after this. Commented Dec 30, 2022 at 8:18
20

I'm late to the game but I just realize this: ax can be replaced with plt.gca() for those who are not using axes and just subplots.

Echoing @Mad Physicist answer, using the package PercentFormatter it would be:

import matplotlib.ticker as mtick

plt.gca().yaxis.set_major_formatter(mtick.PercentFormatter(1))
#if you already have ticks in the 0 to 1 range. Otherwise see their answer
6

I propose an alternative method using seaborn

Working code:

import pandas as pd
import seaborn as sns
data=np.random.rand(10,2)*100
df = pd.DataFrame(data, columns=['A', 'B'])
ax= sns.lineplot(data=df, markers= True)
ax.set(xlabel='xlabel', ylabel='ylabel', title='title')
#changing ylables ticks
y_value=['{:,.2f}'.format(x) + '%' for x in ax.get_yticks()]
ax.set_yticklabels(y_value)

enter image description here

5

You can do this in one line without importing anything: plt.gca().yaxis.set_major_formatter(plt.FuncFormatter('{}%'.format))

If you want integer percentages, you can do: plt.gca().yaxis.set_major_formatter(plt.FuncFormatter('{:.0f}%'.format))

You can use either ax.yaxis or plt.gca().yaxis. FuncFormatter is still part of matplotlib.ticker, but you can also do plt.FuncFormatter as a shortcut.

0
3

Based on the answer of @erwanp, you can use the formatted string literals of Python 3,

x = '2'
percentage = f'{x}%' # 2%

inside the FuncFormatter() and combined with a lambda expression.

All wrapped:

ax.yaxis.set_major_formatter(FuncFormatter(lambda y, _: f'{y}%'))
3

Another one line solution if the yticks are between 0 and 1:

plt.yticks(plt.yticks()[0], ['{:,.0%}'.format(x) for x in plt.yticks()[0]])
0

add a line of code

ax.yaxis.set_major_formatter(ticker.PercentFormatter())

Not the answer you're looking for? Browse other questions tagged or ask your own question.