1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
Removals
--------
The following deprecated APIs have been removed:
Removed behaviour
~~~~~~~~~~~~~~~~~
- The "smart bounds" functionality on `~.axis.Axis` and `.Spine` has been
deleted, and the related methods have been removed.
- Converting a string with single color characters (e.g. ``'cymk'``) in
`~.colors.to_rgba_array` is no longer supported. Instead, the colors can be
passed individually in a list (e.g. ``['c', 'y', 'm', 'k']``).
- Returning a factor equal to ``None`` from ``mpl_toolkits.axisartist``
Locators (which are **not** the same as "standard" tick Locators), or passing
a factor equal to ``None`` to axisartist Formatters (which are **not** the
same as "standard" tick Formatters) is no longer supported. Pass a factor
equal to 1 instead.
Modules
~~~~~~~
- The entire ``matplotlib.testing.disable_internet`` module has been removed.
The `pytest-remotedata package
<https://github.com/astropy/pytest-remotedata>`_ can be used instead.
- The ``mpl_toolkits.axes_grid1.colorbar`` module and its colorbar
implementation have been removed in favor of `matplotlib.colorbar`.
Classes, methods and attributes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- The `.animation.MovieWriterRegistry` methods ``.set_dirty()``,
``.ensure_not_dirty()``, and ``.reset_available_writers()`` do nothing and
have been removed. The ``.avail()`` method has been removed; use ``.list()``
instead to get a list of available writers.
- The ``matplotlib.artist.Artist.eventson`` and
``matplotlib.container.Container.eventson`` attributes have no effect and
have been removed.
- ``matplotlib.axes.Axes.get_data_ratio_log`` has been removed.
- ``matplotlib.axes.SubplotBase.rowNum``; use
``ax.get_subplotspec().rowspan.start`` instead.
- ``matplotlib.axes.SubplotBase.colNum``; use
``ax.get_subplotspec().colspan.start`` instead.
- ``matplotlib.axis.Axis.set_smart_bounds`` and
``matplotlib.axis.Axis.get_smart_bounds`` have been removed.
- ``matplotlib.colors.DivergingNorm`` has been renamed to
`~matplotlib.colors.TwoSlopeNorm`.
- ``matplotlib.figure.AxesStack`` has been removed.
- ``matplotlib.font_manager.JSONEncoder`` has been removed; use
`.font_manager.json_dump` to dump a `.FontManager` instance.
- The ``matplotlib.ft2font.FT2Image`` methods ``.as_array()``,
``.as_rgba_str()``, ``.as_str()``, ``.get_height()`` and ``.get_width()``
have been removed. Convert the ``FT2Image`` to a NumPy array with
``np.asarray`` before processing it.
- ``matplotlib.quiver.QuiverKey.quiverkey_doc`` has been removed; use
``matplotlib.quiver.QuiverKey.__init__.__doc__`` instead.
- ``matplotlib.spines.Spine.set_smart_bounds`` and
``matplotlib.spines.Spine.get_smart_bounds`` have been removed.
- ``matplotlib.testing.jpl_units.UnitDbl.checkUnits`` has been removed; use
``units not in self.allowed`` instead.
- The unused ``matplotlib.ticker.Locator.autoscale`` method has been removed
(pass the axis limits to `.Locator.view_limits` instead). The derived methods
``Locator.autoscale``, ``AutoDateLocator.autoscale``,
``RRuleLocator.autoscale``, ``RadialLocator.autoscale``,
``ThetaLocator.autoscale``, and ``YearLocator.autoscale`` have also been
removed.
- ``matplotlib.transforms.BboxBase.is_unit`` has been removed; check the
`.Bbox` extents if needed.
- ``matplotlib.transforms.Affine2DBase.matrix_from_values(...)`` has been
removed; use (for example) ``Affine2D.from_values(...).get_matrix()``
instead.
* ``matplotlib.backend_bases.FigureCanvasBase.draw_cursor`` has been removed.
* ``matplotlib.backends.backend_gtk.ConfigureSubplotsGTK3.destroy`` and
``matplotlib.backends.backend_gtk.ConfigureSubplotsGTK3.init_window`` methods
have been removed.
* ``matplotlib.backends.backend_gtk.ConfigureSubplotsGTK3.window`` property has
been removed.
* ``matplotlib.backends.backend_macosx.FigureCanvasMac.invalidate`` has been
removed.
* ``matplotlib.backends.backend_pgf.RendererPgf.latexManager`` has been removed.
* ``matplotlib.backends.backend_wx.FigureFrameWx.statusbar``,
``matplotlib.backends.backend_wx.NavigationToolbar2Wx.set_status_bar``, and
``matplotlib.backends.backend_wx.NavigationToolbar2Wx.statbar`` have been
removed. The status bar can be retrieved by calling standard wx methods
(``frame.GetStatusBar()`` and
``toolbar.GetTopLevelParent().GetStatusBar()``).
* ``matplotlib.backends.backend_wx.ConfigureSubplotsWx.configure_subplots`` and
``matplotlib.backends.backend_wx.ConfigureSubplotsWx.get_canvas`` have been
removed.
- ``mpl_toolkits.axisartist.grid_finder.GridFinderBase`` has been removed; use
`.GridFinder` instead.
- ``mpl_toolkits.axisartist.axis_artist.BezierPath`` has been removed; use
`.patches.PathPatch` instead.
Functions
~~~~~~~~~
- ``matplotlib.backends.backend_pgf.repl_escapetext`` and
``matplotlib.backends.backend_pgf.repl_mathdefault`` have been removed.
- ``matplotlib.checkdep_ps_distiller`` has been removed.
- ``matplotlib.cm.revcmap`` has been removed; use `.Colormap.reversed`
instead.
- ``matplotlib.colors.makeMappingArray`` has been removed.
- ``matplotlib.compare_versions`` has been removed; use comparison of
``distutils.version.LooseVersion``\s instead.
- ``matplotlib.dates.mx2num`` has been removed.
- ``matplotlib.font_manager.createFontList`` has been removed;
`.font_manager.FontManager.addfont` is now available to register a font at a
given path.
- ``matplotlib.get_home`` has been removed; use standard library instead.
- ``matplotlib.mlab.apply_window`` and ``matplotlib.mlab.stride_repeat`` have
been removed.
- ``matplotlib.rcsetup.update_savefig_format`` has been removed; this just
replaced ``'auto'`` with ``'png'``, so do the same.
- ``matplotlib.rcsetup.validate_animation_writer_path`` has been removed.
- ``matplotlib.rcsetup.validate_path_exists`` has been removed; use
`os.path.exists` or `pathlib.Path.exists` instead.
- ``matplotlib.style.core.is_style_file`` and
``matplotlib.style.core.iter_style_files`` have been removed.
- ``matplotlib.testing.is_called_from_pytest`` has been removed.
- ``mpl_toolkits.mplot3d.axes3d.unit_bbox`` has been removed; use `.Bbox.unit`
instead.
Arguments
~~~~~~~~~
- Passing more than one positional argument to `.axes.Axes.axis` will now
raise an error.
- Passing ``"range"`` to the *whis* parameter of `.Axes.boxplot` and
`.cbook.boxplot_stats` to mean "the whole data range" is no longer
supported.
- Passing scalars to the *where* parameter in `.axes.Axes.fill_between` and
`.axes.Axes.fill_betweenx` is no longer accepted and non-matching sizes now
raise a `ValueError`.
- The *verts* parameter to `.Axes.scatter` has been removed; use *marker* instead.
- The *minor* parameter in `.Axis.set_ticks` and ``SecondaryAxis.set_ticks`` is
now keyword-only.
- `.scale.ScaleBase`, `.scale.LinearScale` and `.scale.SymmetricalLogScale` now
error if any unexpected keyword arguments are passed to their constructors.
- The *renderer* parameter to `.Figure.tight_layout` has been removed; this
method now always uses the renderer instance cached on the `.Figure`.
- The *locator* parameter to
`mpl_toolkits.axes_grid1.axes_grid.CbarAxesBase.colorbar` has been removed in
favor of its synonym *ticks* (which already existed previously,
and is consistent with :mod:`matplotlib.colorbar`).
- The *switch_backend_warn* parameter to ``matplotlib.test`` has no effect and
has been removed.
- The *dryrun* parameter to the various ``FigureCanvas*.print_*`` methods has
been removed.
rcParams
~~~~~~~~
- The ``datapath`` rcParam has been removed. Use `matplotlib.get_data_path`
instead.
- The ``mpl_toolkits.legacy_colorbar`` rcParam has no effect and has been
removed.
- Setting :rc:`boxplot.whiskers` to ``"range"`` is no longer valid; set it to
``0, 100`` instead.
- Setting :rc:`savefig.format` to ``"auto"`` is no longer valid; use ``"png"``
instead.
- Setting :rc:`text.hinting` to `False` or `True` is no longer valid; set it to
``"auto"`` or ``"none"`` respectively.
sample_data removals
~~~~~~~~~~~~~~~~~~~~
The sample datasets listed below have been removed. Suggested replacements for
demonstration purposes are listed in parentheses.
- ``None_vs_nearest-pdf.png``,
- ``aapl.npz`` (use ``goog.npz``),
- ``ada.png``, ``grace_hopper.png`` (use ``grace_hopper.jpg``),
- ``ct.raw.gz`` (use ``s1045.ima.gz``),
- ``damodata.csv`` (use ``msft.csv``).
|
