259

I cannot get the colorbar on imshow graphs like this one to be the same height as the graph, short of using Photoshop after the fact. How do I get the heights to match?Example of the colorbar size mismatch

4
  • Have you tried the suggestions from stackoverflow.com/questions/16702479/…
    – lmjohns3
    Aug 12, 2013 at 20:11
  • @imjohns3 Nothing in that post seems to do anything to the color bar. It stays the same size no matter what I set. If I set fraction and shrink, though, the size of the graph will change while the color bar stays the same, until we get back to what I have already, then they stop doing anything.
    – Elliot
    Aug 12, 2013 at 20:48
  • Check out the docs -- matplotlib.org/api/colorbar_api.html -- and use fraction or shrink args. Feb 23, 2017 at 22:31
  • Can you use pcolormesh instead of imshow?
    – cssstudent
    May 5, 2022 at 2:26

9 Answers 9

307

This combination (and values near to these) seems to "magically" work for me to keep the colorbar scaled to the plot, no matter what size the display.

plt.colorbar(im,fraction=0.046, pad=0.04)

It also does not require sharing the axis which can get the plot out of square.

9
  • 7
    This may work in some cases, but in general it doesn't. Try, e.g., plotting something like in the original question, which has a width twice the height.
    – Matthias
    Nov 3, 2015 at 17:07
  • 1
    The fraction option still seems to work in the case you mention, if scaled to match the height of the plot. (mpl v1.4.3)
    – skytaker
    Nov 4, 2015 at 15:57
  • 7
    This is the only universal way of doing it. The solutions with axex_grid1 will not work for projected axes such as GeoAxes.
    – Bogdan
    Oct 9, 2016 at 19:36
  • 12
    In response to @Matthias comment. You can correct for the case where image is too wide using this trick: im_ratio = data.shape[0]/data.shape[1] plt.colorbar(im,fraction=0.046*im_ratio, pad=0.04) where data is your image.
    – eindzl
    Oct 23, 2018 at 15:00
  • 1
    The shrink keyword argument, which defaults to 1.0, may also be useful for further fine tuned adjustments. I found that shrink=0.9 helped get it just right when I had two square subplots side by side.
    – vanPelt2
    Sep 1, 2021 at 5:51
267

You can do this easily with a matplotlib AxisDivider.

The example from the linked page also works without using subplots:

import matplotlib.pyplot as plt
from mpl_toolkits.axes_grid1 import make_axes_locatable
import numpy as np
    
plt.figure()
ax = plt.gca()
im = ax.imshow(np.arange(100).reshape((10,10)))
    
# create an axes on the right side of ax. The width of cax will be 5%
# of ax and the padding between cax and ax will be fixed at 0.05 inch.
divider = make_axes_locatable(ax)
cax = divider.append_axes("right", size="5%", pad=0.05)
   
plt.colorbar(im, cax=cax)

enter image description here

13
  • 3
    I am not working inside a subplot, so this is not applicable.
    – Elliot
    Aug 12, 2013 at 20:25
  • 16
    This is slightly changing the sizing of the graphs. I have 4 in a 2x2 grid, but only want the two on the right to have bars (scale applies by row). However this makes them not the same size. I tried just not having the colorbar call (with the divider call), but of course this leaves an empty white box and numbers on the side. How do I get them to have a consistent size without putting bars on all of them?
    – Elliot
    Aug 12, 2013 at 22:35
  • 1
    @bogatron Unfortunately this does not work with projected axes
    – Bogdan
    Oct 9, 2016 at 19:22
  • 1
    If you want to add a title using plt.title, it will be displayed swaped to the right. Is there a way to overcome this? Feb 23, 2017 at 11:08
  • 2
    @user2820579, you could just call the plt.title before adding the colorbar. That will center the title on the main figure at least ...
    – S.A.
    Nov 8, 2017 at 16:58
68

I appreciate all the answers above. However, like some answers and comments pointed out, the axes_grid1 module cannot address GeoAxes, whereas adjusting fraction, pad, shrink, and other similar parameters cannot necessarily give the very precise order, which really bothers me. I believe that giving the colorbar its own axes might be a better solution to address all the issues that have been mentioned.

Code

import matplotlib.pyplot as plt
import numpy as np

fig=plt.figure()
ax = plt.axes()
im = ax.imshow(np.arange(100).reshape((10,10)))

# Create an axes for colorbar. The position of the axes is calculated based on the position of ax.
# You can change 0.01 to adjust the distance between the main image and the colorbar.
# You can change 0.02 to adjust the width of the colorbar.
# This practice is universal for both subplots and GeoAxes.

cax = fig.add_axes([ax.get_position().x1+0.01,ax.get_position().y0,0.02,ax.get_position().height])
plt.colorbar(im, cax=cax) # Similar to fig.colorbar(im, cax = cax)

Result

enter image description here

Later on, I find matplotlib.pyplot.colorbar official documentation also gives ax option, which are existing axes that will provide room for the colorbar. Therefore, it is useful for multiple subplots, see following.

Code

fig, ax = plt.subplots(2,1,figsize=(12,8)) # Caution, figsize will also influence positions.
im1 = ax[0].imshow(np.arange(100).reshape((10,10)), vmin = -100, vmax =100)
im2 = ax[1].imshow(np.arange(-100,0).reshape((10,10)), vmin = -100, vmax =100)
fig.colorbar(im1, ax=ax)

Result

enter image description here

Again, you can also achieve similar effects by specifying cax, a more accurate way from my perspective.

Code

fig, ax = plt.subplots(2,1,figsize=(12,8))
im1 = ax[0].imshow(np.arange(100).reshape((10,10)), vmin = -100, vmax =100)
im2 = ax[1].imshow(np.arange(-100,0).reshape((10,10)), vmin = -100, vmax =100)
cax = fig.add_axes([ax[1].get_position().x1-0.25,ax[1].get_position().y0,0.02,ax[0].get_position().y1-ax[1].get_position().y0])
fig.colorbar(im1, cax=cax)

Result

enter image description here

5
  • 1
    Really amazing answer. Thank you!! May 28, 2020 at 6:23
  • This is the only answer I found that worked! All the other questions I found that seem to fix everyones issue with the size of colorbar didn't work for me. In my case the plot was too long and the colorbar was too short. This fixed it. Thanks!
    – M.O.
    Jun 25, 2021 at 21:17
  • Works great for me, I just wonder how I can make it work properly with fullscreen images. Jan 25, 2022 at 9:47
  • IMO this is the correct answer, as it entirely bypasses Matplotlib's non-configurable axis-adjusting logic. It's really frustrating that "make the colorbar the same height as the ax= axis" is not a feature, and requires dropping down to low-level figure/axis fiddling like this. Feb 16 at 14:28
  • The Matplotlib docs suggest using ax.inset_axes to create a "child axis" instead of creating a standalone axis with fig.add_axes: matplotlib.org/stable/gallery/subplots_axes_and_figures/… Feb 16 at 14:31
44

@bogatron already gave the answer suggested by the matplotlib docs, which produces the right height, but it introduces a different problem. Now the width of the colorbar (as well as the space between colorbar and plot) changes with the width of the plot. In other words, the aspect ratio of the colorbar is not fixed anymore.

To get both the right height and a given aspect ratio, you have to dig a bit deeper into the mysterious axes_grid1 module.

import matplotlib.pyplot as plt
from mpl_toolkits.axes_grid1 import make_axes_locatable, axes_size
import numpy as np

aspect = 20
pad_fraction = 0.5

ax = plt.gca()
im = ax.imshow(np.arange(200).reshape((20, 10)))
divider = make_axes_locatable(ax)
width = axes_size.AxesY(ax, aspect=1./aspect)
pad = axes_size.Fraction(pad_fraction, width)
cax = divider.append_axes("right", size=width, pad=pad)
plt.colorbar(im, cax=cax)

Note that this specifies the width of the colorbar w.r.t. the height of the plot (in contrast to the width of the figure, as it was before).

The spacing between colorbar and plot can now be specified as a fraction of the width of the colorbar, which is IMHO a much more meaningful number than a fraction of the figure width.

image plot with colorbar

UPDATE:

I created an IPython notebook on the topic, where I packed the above code into an easily re-usable function:

import matplotlib.pyplot as plt
from mpl_toolkits import axes_grid1

def add_colorbar(im, aspect=20, pad_fraction=0.5, **kwargs):
    """Add a vertical color bar to an image plot."""
    divider = axes_grid1.make_axes_locatable(im.axes)
    width = axes_grid1.axes_size.AxesY(im.axes, aspect=1./aspect)
    pad = axes_grid1.axes_size.Fraction(pad_fraction, width)
    current_ax = plt.gca()
    cax = divider.append_axes("right", size=width, pad=pad)
    plt.sca(current_ax)
    return im.axes.figure.colorbar(im, cax=cax, **kwargs)

It can be used like this:

im = plt.imshow(np.arange(200).reshape((20, 10)))
add_colorbar(im)
2
  • 2
    This is a really helpful little function! One word of warning is that it does not work when you want to add multiple colorbars, because they appear on top of each other.
    – David Hall
    Mar 23, 2016 at 15:15
  • Fantastic answer. With regards to the problem mentioned by @DavidHall to make it work on multiple subplots, just replace current_ax with the axes of the subplot you want to add the color bar to. Sep 13, 2022 at 7:51
15

When you create the colorbar try using the fraction and/or shrink parameters.

From the documents:

fraction 0.15; fraction of original axes to use for colorbar

shrink 1.0; fraction by which to shrink the colorbar

3
  • 1
    If I set shrink 1.0 and fraction to anything, it shrinks the graph, not affecting the colorbar size at all, until changing fraction causes it to be exactly what I already have, at which point changing them stops doing anything.
    – Elliot
    Aug 12, 2013 at 20:30
  • Where exactly are you specifying them they have to be parameters to the colorbar() function or method. Aug 12, 2013 at 20:35
  • Thanks. just need to specify the shrink parameter and it works like magic!
    – CodingNow
    Nov 21, 2019 at 18:16
15

All the above solutions are good, but I like @Steve's and @bejota's the best as they do not involve fancy calls and are universal.

By universal I mean that works with any type of axes including GeoAxes. For example, it you have projected axes for mapping:

projection = cartopy.crs.UTM(zone='17N')
ax = plt.axes(projection=projection)
im = ax.imshow(np.arange(200).reshape((20, 10)))

a call to

cax = divider.append_axes("right", size=width, pad=pad)

will fail with: KeyException: map_projection

Therefore, the only universal way of dealing colorbar size with all types of axes is:

ax.colorbar(im, fraction=0.046, pad=0.04)

Work with fraction from 0.035 to 0.046 to get your best size. However, the values for the fraction and paddig will need to be adjusted to get the best fit for your plot and will differ depending if the orientation of the colorbar is in vertical position or horizontal.

2
  • 1
    We can also add shrink parameter when fraction together with pad do not produce desired results enough.
    – Fei Yao
    Jul 5, 2019 at 9:02
  • The neatest answer.
    – giammi56
    May 28, 2021 at 13:49
12

An alternative is

shrink=0.7, aspect=20*0.7

shrink scales the height and width, but the aspect argument restores the original width. Default aspect ratio is 20. The 0.7 is empirically determined.

1
  • This was the fastest road to Rome for my one off plot, and I appreciate it! Jun 10, 2021 at 13:30
2

I encountered this problem recently, I used ax.twinx() to solve it. For example:

from matplotlib import pyplot as plt

# Some other code you've written
...

# Your data generation goes here
xdata = ...
ydata = ...
colordata = function(xdata, ydata)

# Your plotting stuff begins here
fig, ax = plt.subplots(1)
im = ax.scatterplot(xdata, ydata, c=colordata)

# Create a new axis which will be the parent for the colour bar
# Note that this solution is independent of the 'fig' object
ax2 = ax.twinx()
ax2.tick_params(which="both", right=False, labelright=False)

# Add the colour bar itself
plt.colorbar(im, ax=ax2)

# More of your code
...

plt.show()

I found this particularly useful when creating functions that take in matplotlib Axes objects as arguments, draw on them, and return the object because I then don't need to pass in a separate axis I had to generate from the figure object, or pass the figure object itself.

0

If you don't want to declare another set of axes, the simplest solution I have found is changing the figure size with the figsize call.

In the above example, I would start with

fig = plt.figure(figsize = (12,6))

and then just re-render with different proportions until the colorbar no longer dwarfs the main plot.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

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