1Changes beyond 0.99.x 2===================== 3 4* The default behavior of :meth:`matplotlib.axes.Axes.set_xlim`, 5 :meth:`matplotlib.axes.Axes.set_ylim`, and 6 :meth:`matplotlib.axes.Axes.axis`, and their corresponding 7 pyplot functions, has been changed: when view limits are 8 set explicitly with one of these methods, autoscaling is turned 9 off for the matching axis. A new *auto* kwarg is available to 10 control this behavior. The limit kwargs have been renamed to 11 *left* and *right* instead of *xmin* and *xmax*, and *bottom* 12 and *top* instead of *ymin* and *ymax*. The old names may still 13 be used, however. 14 15* There are five new Axes methods with corresponding pyplot 16 functions to facilitate autoscaling, tick location, and tick 17 label formatting, and the general appearance of ticks and 18 tick labels: 19 20 + :meth:`matplotlib.axes.Axes.autoscale` turns autoscaling 21 on or off, and applies it. 22 23 + :meth:`matplotlib.axes.Axes.margins` sets margins used to 24 autoscale the :attr:`matplotlib.axes.Axes.viewLim` based on 25 the :attr:`matplotlib.axes.Axes.dataLim`. 26 27 + :meth:`matplotlib.axes.Axes.locator_params` allows one to 28 adjust axes locator parameters such as *nbins*. 29 30 + :meth:`matplotlib.axes.Axes.ticklabel_format` is a convenience 31 method for controlling the :class:`matplotlib.ticker.ScalarFormatter` 32 that is used by default with linear axes. 33 34 + :meth:`matplotlib.axes.Axes.tick_params` controls direction, size, 35 visibility, and color of ticks and their labels. 36 37* The :meth:`matplotlib.axes.Axes.bar` method accepts a *error_kw* 38 kwarg; it is a dictionary of kwargs to be passed to the 39 errorbar function. 40 41* The :meth:`matplotlib.axes.Axes.hist` *color* kwarg now accepts 42 a sequence of color specs to match a sequence of datasets. 43 44* The :class:`~matplotlib.collections.EllipseCollection` has been 45 changed in two ways: 46 47 + There is a new *units* option, 'xy', that scales the ellipse with 48 the data units. This matches the :class:'~matplotlib.patches.Ellipse` 49 scaling. 50 51 + The *height* and *width* kwargs have been changed to specify 52 the height and width, again for consistency with 53 :class:`~matplotlib.patches.Ellipse`, and to better match 54 their names; previously they specified the half-height and 55 half-width. 56 57* There is a new rc parameter ``axes.color_cycle``, and the color 58 cycle is now independent of the rc parameter ``lines.color``. 59 ``matplotlib.Axes.set_default_color_cycle`` is deprecated. 60 61* You can now print several figures to one pdf file and modify the 62 document information dictionary of a pdf file. See the docstrings 63 of the class :class:`matplotlib.backends.backend_pdf.PdfPages` for 64 more information. 65 66* Removed configobj_ and `enthought.traits`_ packages, which are only 67 required by the experimental traited config and are somewhat out of 68 date. If needed, install them independently. 69 70.. _configobj: http://www.voidspace.org.uk/python/configobj.html 71.. _`enthought.traits`: http://code.enthought.com/pages/traits.html 72 73* The new rc parameter ``savefig.extension`` sets the filename extension 74 that is used by :meth:`matplotlib.figure.Figure.savefig` if its *fname* 75 argument lacks an extension. 76 77* In an effort to simplify the backend API, all clipping rectangles 78 and paths are now passed in using GraphicsContext objects, even 79 on collections and images. Therefore:: 80 81 draw_path_collection(self, master_transform, cliprect, clippath, 82 clippath_trans, paths, all_transforms, offsets, 83 offsetTrans, facecolors, edgecolors, linewidths, 84 linestyles, antialiaseds, urls) 85 86 # is now 87 88 draw_path_collection(self, gc, master_transform, paths, all_transforms, 89 offsets, offsetTrans, facecolors, edgecolors, 90 linewidths, linestyles, antialiaseds, urls) 91 92 93 draw_quad_mesh(self, master_transform, cliprect, clippath, 94 clippath_trans, meshWidth, meshHeight, coordinates, 95 offsets, offsetTrans, facecolors, antialiased, 96 showedges) 97 98 # is now 99 100 draw_quad_mesh(self, gc, master_transform, meshWidth, meshHeight, 101 coordinates, offsets, offsetTrans, facecolors, 102 antialiased, showedges) 103 104 105 draw_image(self, x, y, im, bbox, clippath=None, clippath_trans=None) 106 107 # is now 108 109 draw_image(self, gc, x, y, im) 110 111* There are four new Axes methods with corresponding pyplot 112 functions that deal with unstructured triangular grids: 113 114 + :meth:`matplotlib.axes.Axes.tricontour` draws contour lines 115 on a triangular grid. 116 117 + :meth:`matplotlib.axes.Axes.tricontourf` draws filled contours 118 on a triangular grid. 119 120 + :meth:`matplotlib.axes.Axes.tripcolor` draws a pseudocolor 121 plot on a triangular grid. 122 123 + :meth:`matplotlib.axes.Axes.triplot` draws a triangular grid 124 as lines and/or markers. 125