use fractional width for pad colorbar keyword

Author: Jeffrey Whitaker

doc/users/figures/make.py

@@ -9,9 +9,10 @@
 #mplshell = IPython.Shell.MatplotlibShell('mpl') # for Ipython 0.10
 mplshell = IPython.core.interactiveshell.InteractiveShell() # for Ipython 0.11
 
-formats = [('png', 100),
-           ('hires.png', 200),
-           ('pdf', 72)]
+#formats = [('png', 100),
+#           ('hires.png', 200),
+#           ('pdf', 72)]
+formats = [('png', 100)]
 
 def figs():
     print 'making figs'

doc/users/figures/plotetopo5.py

@@ -39,10 +39,8 @@
 m.drawparallels(parallels,labels=[1,0,0,1])
 meridians = np.arange(10.,360.,30.)
 m.drawmeridians(meridians,labels=[1,0,0,1])
-# use axes_grid toolkit to make colorbar axes.
-divider = make_axes_locatable(ax)
-cax = divider.append_axes("right", size="5%", pad=0.1)
-cb = fig.colorbar(im,cax=cax)
+# add colorbar
+cb = m.colorbar(im,"right", size="5%", pad='2%')
 ax.set_title('ETOPO5 Topography - Lambert Conformal Conic')
 fig.savefig('etopo5.png')
 

doc/users/figures/plotprecip.py

@@ -42,9 +42,8 @@
 clevs = [0,1,2.5,5,7.5,10,15,20,30,40,50,70,100,150,200,250,300,400,500,600,750]
 cs = m.contourf(x,y,data,clevs,cmap=cm.s3pcpn)
 # add colorbar.
-cbar = m.colorbar(cs,location='bottom',pad=0.25)
+cbar = m.colorbar(cs,location='bottom',pad="5%")
 cbar.set_label('mm')
 # add title
 plt.title(prcpvar.long_name+' for period ending '+prcpvar.dateofdata)
 plt.savefig('plotprecip.png')
-plt.show()

doc/users/figures/plotsst.py

@@ -48,10 +48,8 @@
 # draw parallels and meridians, but don't bother labelling them.
 m.drawparallels(np.arange(-90.,120.,30.))
 m.drawmeridians(np.arange(0.,420.,60.))
-# use axes_grid toolkit to make colorbar axes.
-divider = make_axes_locatable(ax)
-cax = divider.append_axes("bottom", size="5%", pad=0.1)
-cb = plt.colorbar(im1,orientation='horizontal',cax=cax)
+# add colorbar
+cb = m.colorbar(im1,"bottom", size="5%", pad="2%")
 # add a title.
 ax.set_title('SST and ICE analysis for %s'%date)
 plt.savefig('plotsst.png')

doc/users/figures/plotwindvec.py

@@ -64,10 +64,8 @@
 m.drawcoastlines(linewidth=1.5)
 m.drawparallels(parallels)
 m.drawmeridians(meridians)
-# use axes_grid toolkit to make colorbar axes.
-divider = make_axes_locatable(ax)
-cax = divider.append_axes("bottom", size="5%", pad=0.1)
-cb = plt.colorbar(CS2,orientation='horizontal',cax=cax)
+# add colorbar
+cb = m.colorbar(CS2,"bottom", size="5%", pad="2%")
 cb.set_label('hPa')
 # set plot title
 ax.set_title('SLP and Wind Vectors '+str(date))
@@ -85,10 +83,8 @@
 m.drawcoastlines(linewidth=1.5)
 m.drawparallels(parallels)
 m.drawmeridians(meridians)
-# use axes_grid toolkit to make colorbar axes.
-divider = make_axes_locatable(ax)
-cax = divider.append_axes("bottom", size="5%", pad=0.1)
-cb = plt.colorbar(CS2,orientation='horizontal',cax=cax)
+# add colorbar
+cb = m.colorbar(CS2,"bottom", size="5%", pad="2%")
 cb.set_label('hPa')
 # set plot title.
 ax.set_title('SLP and Wind Barbs '+str(date))

lib/mpl_toolkits/basemap/__init__.py

@@ -3671,13 +3671,14 @@ def drawmapscale(self,lon,lat,lon0,lat0,length,barstyle='simple',\
             rets = [ret.set_zorder(zorder) for ret in rets]
         return rets
 
-    def colorbar(self,mappable=None,location='right',size="5%",pad=0.1,fig=None,ax=None,**kwargs):
+    def colorbar(self,mappable=None,location='right',size="5%",pad='2%',fig=None,ax=None,**kwargs):
         """
         Add colorbar to axes associated with a map.
         The colorbar axes instance is created using the axes_grid toolkit.
 
         .. tabularcolumns:: |l|L|
 
+        ==============   ====================================================
         Keywords         Description
         ==============   ====================================================
         mappable         the Image, ContourSet, etc. to which the colorbar
@@ -3686,10 +3687,10 @@ def colorbar(self,mappable=None,location='right',size="5%",pad=0.1,fig=None,ax=N
         location         where to put colorbar ('top','bottom','left','right')
                          Default 'right'.
         size             width of colorbar axes (string 'N%', where N is
-                         an integer describing the percentage of the parent
+                         an integer describing the fractional width of the parent
                          axes). Default '5%'.
         pad              Padding between parent axes and colorbar axes in
-                         inches. Default 0.1.
+                         same units as size. Default '2%'.
         fig              Figure instance the map axes instance is associated
                          with. Default None, and matplotlib.pyplot.gcf() is used
                          to retrieve the current active figure instance.