Back to Matplotlib

Removals

doc/api/prev_api_changes/api_changes_3.3.0/removals.rst

3.10.911.1 KB
Original Source

Removals

The following deprecated APIs have been removed:

Modules

- ``backends.qt_editor.formlayout`` (use the formlayout module available on
  PyPI instead).

Classes, methods and attributes
  • artist.Artist.aname property (no replacement)

  • axis.Axis.iter_ticks (no replacement)

  • Support for custom backends that do not provide a backend_bases.GraphicsContextBase.set_hatch_color method

  • backend_bases.RendererBase.strip_math() (use cbook.strip_math() instead)

  • backend_wx.debug_on_error() (no replacement)

  • backend_wx.raise_msg_to_str() (no replacement)

  • backend_wx.fake_stderr (no replacement)

  • backend_wx.MenuButtonWx (no replacement)

  • backend_wx.PrintoutWx (no replacement)

  • _backend_tk.NavigationToolbar2Tk.set_active() (no replacement)

  • backend_ps.PsBackendHelper.gs_exe property (no replacement)

  • backend_ps.PsBackendHelper.gs_version property (no replacement)

  • backend_ps.PsBackendHelper.supports_ps2write property (no replacement)

  • backend_ps.RendererPS.afmfontd property (no replacement)

  • backend_ps.GraphicsContextPS.shouldstroke property (no replacement)

  • backend_gtk3.FileChooserDialog (no replacement)

  • backend_gtk3.SaveFigureGTK3.get_filechooser() (no replacement)

  • backend_gtk3.NavigationToolbar2GTK3.get_filechooser() (no replacement)

  • backend_gtk3cairo.FigureManagerGTK3Cairo (use backend_gtk3.FigureManagerGTK3 instead)

  • backend_pdf.RendererPdf.afm_font_cache property (no replacement)

  • backend_pgf.LatexManagerFactory (no replacement)

  • backend_qt5.NavigationToolbar2QT.buttons property (no replacement)

  • backend_qt5.NavigationToolbar2QT.adj_window property (no replacement)

  • bezier.find_r_to_boundary_of_closedpath() (no replacement)

  • cbook.dedent() (use inspect.cleandoc instead)

  • cbook.get_label() (no replacement)

  • cbook.is_hashable() (use isinstance(..., collections.abc.Hashable) instead)

  • cbook.iterable() (use numpy.iterable() instead)

  • cbook.safezip() (no replacement)

  • colorbar.ColorbarBase.get_cmap (use ScalarMappable.get_cmap instead)

  • colorbar.ColorbarBase.set_cmap (use ScalarMappable.set_cmap instead)

  • colorbar.ColorbarBase.get_clim (use ScalarMappable.get_clim instead)

  • colorbar.ColorbarBase.set_clim (use ScalarMappable.set_clim instead)

  • colorbar.ColorbarBase.set_norm (use ScalarMappable.set_norm instead)

  • dates.seconds() (no replacement)

  • dates.minutes() (no replacement)

  • dates.hours() (no replacement)

  • dates.weeks() (no replacement)

  • dates.strpdate2num and dates.bytespdate2num (use time.strptime or dateutil.parser.parse or .dates.datestr2num instead)

  • docstring.Appender (no replacement)

  • docstring.dedent() (use inspect.getdoc instead)

  • docstring.copy_dedent() (use docstring.copy() and inspect.getdoc instead)

  • font_manager.OSXInstalledFonts() (no replacement)

  • image.BboxImage.interp_at_native property (no replacement)

  • lines.Line2D.verticalOffset property (no replacement)

  • matplotlib.checkdep_dvipng (no replacement)

  • matplotlib.checkdep_ghostscript (no replacement)

  • matplotlib.checkdep_pdftops (no replacement)

  • matplotlib.checkdep_inkscape (no replacement)

  • matplotlib.get_py2exe_datafiles (no replacement)

  • matplotlib.tk_window_focus (use rcParams['tk.window_focus'] instead)

  • mlab.demean() (use mlab.detrend_mean() instead)

  • path.get_paths_extents() (use path.get_path_collection_extents() instead)

  • path.Path.has_nonfinite() (use not np.isfinite(self.vertices).all() instead)

  • projections.process_projection_requirements() (no replacement)

  • pyplot.plotfile() (Instead, load the data using pandas.read_csv or numpy.loadtxt or similar and use regular pyplot functions to plot the loaded data.)

  • quiver.Quiver.color() (use Quiver.get_facecolor() instead)

  • quiver.Quiver.keyvec property (no replacement)

  • quiver.Quiver.keytext property (no replacement)

  • rcsetup.validate_qt4() (no replacement)

  • rcsetup.validate_qt5() (no replacement)

  • rcsetup.validate_verbose() (no replacement)

  • rcsetup.ValidateInterval (no replacement)

  • scale.LogTransformBase (use scale.LogTransform instead)

  • scale.InvertedLogTransformBase (use scale.InvertedLogTransform instead)

  • scale.Log10Transform (use scale.LogTransform instead)

  • scale.InvertedLog10Transform (use scale.InvertedLogTransform instead)

  • scale.Log2Transform (use scale.LogTransform instead)

  • scale.InvertedLog2Transform (use scale.InvertedLogTransform instead)

  • scale.NaturalLogTransform (use scale.LogTransform instead)

  • scale.InvertedNaturalLogTransform (use scale.InvertedLogTransform instead)

  • scale.get_scale_docs() (no replacement)

  • sphinxext.plot_directive.plot_directive() (use the class PlotDirective instead)

  • sphinxext.mathmpl.math_directive() (use the class MathDirective instead)

  • spines.Spine.is_frame_like() (no replacement)

  • testing.decorators.switch_backend() (use @pytest.mark.backend decorator instead)

  • text.Text.is_math_text() (use cbook.is_math_text() instead)

  • text.TextWithDash() (use text.Annotation instead)

  • textpath.TextPath.is_math_text() (use cbook.is_math_text() instead)

  • textpath.TextPath.text_get_vertices_codes() (use textpath.text_to_path.get_text_path() instead)

  • textpath.TextToPath.glyph_to_path() (use font.get_path() and manual translation of the vertices instead)

  • ticker.OldScalarFormatter.pprint_val() (no replacement)

  • ticker.ScalarFormatter.pprint_val() (no replacement)

  • ticker.LogFormatter.pprint_val() (no replacement)

  • ticker.decade_down() (no replacement)

  • ticker.decade_up() (no replacement)

  • Tick properties gridOn, tick1On, tick2On, label1On, label2On (use set_visible() / get_visible() on Tick.gridline, Tick.tick1line, Tick.tick2line, Tick.label1, Tick.label2 instead)

  • widgets.SpanSelector.buttonDown property (no replacement)

  • mplot3d.proj3d.line2d() (no replacement)

  • mplot3d.proj3d.line2d_dist() (no replacement)

  • mplot3d.proj3d.line2d_seg_dist() (no replacement)

  • mplot3d.proj3d.mod() (use numpy.linalg.norm instead)

  • mplot3d.proj3d.proj_transform_vec() (no replacement)

  • mplot3d.proj3d.proj_transform_vec_clip() (no replacement)

  • mplot3d.proj3d.vec_pad_ones() (no replacement)

  • mplot3d.proj3d.proj_trans_clip_points() (no replacement)

  • mplot3d.art3d.norm_angle() (no replacement)

  • mplot3d.art3d.norm_text_angle() (no replacement)

  • mplot3d.art3d.path_to_3d_segment() (no replacement)

  • mplot3d.art3d.paths_to_3d_segments() (no replacement)

  • mplot3d.art3d.path_to_3d_segment_with_codes() (no replacement)

  • mplot3d.art3d.paths_to_3d_segments_with_codes() (no replacement)

  • mplot3d.art3d.get_patch_verts() (no replacement)

  • mplot3d.art3d.get_colors() (no replacement)

  • mplot3d.art3d.zalpha() (no replacement)

  • mplot3d.axis3d.get_flip_min_max() (no replacement)

  • mplot3d.axis3d.Axis.get_tick_positions() (no replacement)

  • axisartist.axis_artist.UnimplementedException (no replacement)

  • axisartist.axislines.SimpleChainedObjects (use axis_grid1.mpl_axes.SimpleChainedObjects instead)

  • axisartist.axislines.Axes.AxisDict (use axis_grid1.mpl_axes.Axes.AxisDict instead)

Arguments

- ``Axes.text()`` / ``pyplot.text()`` do not support the parameter ``withdash``
  anymore. Use ``Axes.annotate()`` and ``pyplot.annotate()`` instead.
- The first parameter of `matplotlib.use` has been renamed from ``arg`` to
  ``backend`` (only relevant if you pass by keyword).
- The parameter ``warn`` of `matplotlib.use` has been removed. A failure to
  switch the backend will now always raise an ``ImportError`` if ``force`` is
  set; catch that error if necessary.
- All parameters of `matplotlib.use` except the first one are now keyword-only.
- The unused parameters ``shape`` and ``imlim`` of `~.axes.Axes.imshow()` are
  now removed. All parameters beyond ``extent`` are now keyword-only.
- The unused parameter ``interp_at_native`` of `.BboxImage` has been removed.
- The parameter ``usetex`` of `.TextToPath.get_text_path` has been removed.
  Use ``ismath='TeX'`` instead.
- The parameter ``block`` of ``show()`` is now keyword-only, and arbitrary
  arguments or keyword arguments are no longer accepted.
- The parameter ``frameon`` of `.Figure.savefig` has been removed.  Use
  ``facecolor="none"`` to get a transparent background.
- Passing a ``wx.EvtHandler`` as the first argument to ``backend_wx.TimerWx``
  is not supported anymore; the signature of ``TimerWx`` is now consistent with
  `.TimerBase`.
- The ``manage_xticks`` parameter of `~.Axes.boxplot` and `~.Axes.bxp` has been
  renamed to ``manage_ticks``.
- The ``normed`` parameter of `~.Axes.hist2d` has been renamed to ``density``.
- The ``s`` parameter of `.Annotation` has been renamed to ``text``.
- For all functions in `.bezier` that supported a ``tolerance`` parameter, this
  parameter has been renamed to ``tolerance``.
- ``axis("normal")`` is not supported anymore. Use the equivalent
  ``axis("auto")`` instead.
- ``axis()`` does not accept arbitrary keyword arguments anymore.
- ``Axis.set_ticklabels()`` does not accept arbitrary positional arguments
  other than ``ticklabels``.
- ``mpl_toolkits.mplot3d.art3d.Poly3DCollection.set_zsort`` does not accept
  the value ``True`` anymore. Pass the equivalent value 'average' instead.
- `.AnchoredText` no longer accepts ``horizontalalignment`` or
  ``verticalalignment`` keyword arguments.
- `.ConnectionPatch` no longer accepts the ``arrow_transmuter`` and
  ``connector`` keyword arguments, which did nothing since 3.0.
- `.FancyArrowPatch` no longer accepts the ``arrow_transmuter`` and
  ``connector`` keyword arguments, which did nothing since 3.0.
- `.TextPath` no longer accepts arbitrary positional or keyword arguments.
- `.MaxNLocator.set_params()` no longer accepts arbitrary keyword arguments.
- `~.Axes.pie` no longer accepts and squeezes non-1D inputs; pass 1D input to
  the ``x`` argument.
- Passing (n, 1)-shaped error arrays to `.Axes.errorbar()` is no longer
  supported; pass a 1D array instead.

rcParams
~~~~~~~~
- The ``text.latex.unicode`` rcParam has been removed, with no replacement.
  Matplotlib now always supports unicode in usetex.
- The ``savefig.frameon`` rcParam has been removed.  Set
  :rc:`savefig.facecolor` to "none" to get a transparent background.
- The ``pgf.debug``, ``verbose.fileo`` and ``verbose.verbose.level`` rcParams,
  which had no effect, have been removed.
- Support for setting :rc:`mathtext.default` to "circled" has been removed.

Environment variables
  • MATPLOTLIBDATA (no replacement).

mathtext

- The ``\stackrel`` command (which behaved differently from its LaTeX version)
  has been removed.  Use ``\genfrac`` instead.
- The ``\mathcircled`` command has been removed.  Directly use Unicode
  characters, such as ``'\N{CIRCLED LATIN CAPITAL LETTER A}'``, instead.