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