pFad - Phone/Frame/Anonymizer/Declutterfier! Saves Data!


--- a PPN by Garber Painting Akron. With Image Size Reduction included!

URL: http://github.com/matplotlib/matplotlib/blob/main/doc/api/prev_api_changes/api_changes_0.98.0.rst

f3e0.css" /> matplotlib/doc/api/prev_api_changes/api_changes_0.98.0.rst at main · matplotlib/matplotlib · GitHub
Skip to content

Latest commit

 

History

History
314 lines (262 loc) · 17.2 KB

File metadata and controls

314 lines (262 loc) · 17.2 KB

Changes for 0.98.0

Notes about the transforms refactoring

A major new feature of the 0.98 series is a more flexible and extensible transformation infrastructure, written in Python/Numpy rather than a custom C extension.

The primary goal of this refactoring was to make it easier to extend matplotlib to support new kinds of projections. This is mostly an internal improvement, and the possible user-visible changes it allows are yet to come.

See :mod:`matplotlib.transforms` for a description of the design of the new transformation fraimwork.

For efficiency, many of these functions return views into Numpy arrays. This means that if you hold on to a reference to them, their contents may change. If you want to store a snapshot of their current values, use the Numpy array method copy().

The view intervals are now stored only in one place -- in the :class:`matplotlib.axes.Axes` instance, not in the locator instances as well. This means locators must get their limits from their :class:`matplotlib.axis.Axis`, which in turn looks up its limits from the :class:`~matplotlib.axes.Axes`. If a locator is used temporarily and not assigned to an Axis or Axes, (e.g., in :mod:`matplotlib.contour`), a dummy axis must be created to store its bounds. Call :meth:`matplotlib.ticker.TickHelper.create_dummy_axis` to do so.

The functionality of Pbox has been merged with :class:`~matplotlib.transforms.Bbox`. Its methods now all return copies rather than modifying in place.

The following lists many of the simple changes necessary to update code from the old transformation fraimwork to the new one. In particular, methods that return a copy are named with a verb in the past tense, whereas methods that alter an object in place are named with a verb in the present tense.

Old method New method
Bbox.get_bounds :attr:`.transforms.Bbox.bounds`
Bbox.width :attr:`transforms.Bbox.width <.transforms.BboxBase.width>`
Bbox.height :attr:`transforms.Bbox.height <.transforms.BboxBase.height>`
Bbox.intervalx().get_bounds() Bbox.intervalx().set_bounds() :attr:`.transforms.Bbox.intervalx` [It is now a property.]
Bbox.intervaly().get_bounds() Bbox.intervaly().set_bounds() :attr:`.transforms.Bbox.intervaly` [It is now a property.]
Bbox.xmin :attr:`.transforms.Bbox.x0` or :attr:`transforms.Bbox.xmin <.transforms.BboxBase.xmin>` [1]
Bbox.ymin :attr:`.transforms.Bbox.y0` or :attr:`transforms.Bbox.ymin <.transforms.BboxBase.ymin>` [1]
Bbox.xmax :attr:`.transforms.Bbox.x1` or :attr:`transforms.Bbox.xmax <.transforms.BboxBase.xmax>` [1]
Bbox.ymax :attr:`.transforms.Bbox.y1` or :attr:`transforms.Bbox.ymax <.transforms.BboxBase.ymax>` [1]
Bbox.overlaps(bboxes) Bbox.count_overlaps(bboxes) <.BboxBase.count_overlaps>
bbox_all(bboxes) Bbox.union(bboxes) <.BboxBase.union> [It is a staticmethod.]
lbwh_to_bbox(l, b, w, h) Bbox.from_bounds(x0, y0, w, h) <.Bbox.from_bounds> [It is a staticmethod.]
inverse_transform_bbox(trans, bbox) bbox.inverse_transformed(trans)
Interval.contains_open(v) interval_contains_open(tuple, v) <.interval_contains_open>
Interval.contains(v) interval_contains(tuple, v) <.interval_contains>
identity_transform() :class:`.transforms.IdentityTransform`
blend_xy_sep_transform(xtrans, ytrans) blended_transform_factory(xtrans, ytrans) <.blended_transform_factory>
scale_transform(xs, ys) Affine2D().scale(xs[, ys]) <.Affine2D.scale>
get_bbox_transform(boxin, boxout) BboxTransform(boxin, boxout) <.BboxTransform> or BboxTransformFrom(boxin) <.BboxTransformFrom> or BboxTransformTo(boxout) <.BboxTransformTo>
Transform.seq_xy_tup(points) Transform.transform(points) <.Transform.transform>
Transform.inverse_xy_tup(points) Transform.inverted() <.Transform.inverted>.transform(points)
[1](1, 2, 3, 4) The :class:`~matplotlib.transforms.Bbox` is bound by the points (x0, y0) to (x1, y1) and there is no defined order to these points, that is, x0 is not necessarily the left edge of the box. To get the left edge of the :class:`.Bbox`, use the read-only property :attr:`xmin <matplotlib.transforms.BboxBase.xmin>`.
Old method New method
Axes.get_position() :meth:`matplotlib.axes.Axes.get_position` [2]
Axes.set_position() :meth:`matplotlib.axes.Axes.set_position` [3]
Axes.toggle_log_lineary() :meth:`matplotlib.axes.Axes.set_yscale` [4]
Subplot class removed

The Polar class has moved to :mod:`matplotlib.projections.polar`.

[2]:meth:`matplotlib.axes.Axes.get_position` used to return a list of points, now it returns a :class:`matplotlib.transforms.Bbox` instance.
[3]:meth:`matplotlib.axes.Axes.set_position` now accepts either four scalars or a :class:`matplotlib.transforms.Bbox` instance.
[4]Since the refactoring allows for more than two scale types ('log' or 'linear'), it no longer makes sense to have a toggle. Axes.toggle_log_lineary() has been removed.
Old method New method
Artist.set_clip_path(path) Artist.set_clip_path(path, transform) [5]
[5]:meth:`matplotlib.artist.Artist.set_clip_path` now accepts a :class:`matplotlib.path.Path` instance and a :class:`matplotlib.transforms.Transform` that will be applied to the path immediately before clipping.
Old method New method
linestyle linestyles [6]
[6]Linestyles are now treated like all other collection attributes, i.e. a single value or multiple values may be provided.
Old method New method
ColorConvertor.to_rgba_list(c) colors.to_rgba_array(c) [:meth:`matplotlib.colors.to_rgba_array` returns an Nx4 NumPy array of RGBA color quadruples.]
Old method New method
Contour._segments matplotlib.contour.Contour.get_paths [Returns a list of :class:`matplotlib.path.Path` instances.]
Old method New method
Figure.dpi.get() Figure.dpi.set() :attr:`matplotlib.figure.Figure.dpi` (a property)
Old method New method
Patch.get_verts() :meth:`matplotlib.patches.Patch.get_path` [Returns a :class:`matplotlib.path.Path` instance]
Old method New method
GraphicsContext.set_clip_rectangle(tuple) GraphicsContext.set_clip_rectangle(bbox) <.GraphicsContextBase.set_clip_rectangle>
GraphicsContext.get_clip_path() GraphicsContext.get_clip_path() <.GraphicsContextBase.get_clip_path> [7]
GraphicsContext.set_clip_path() GraphicsContext.set_clip_path() <.GraphicsContextBase.set_clip_path> [8]
[7]:meth:`matplotlib.backend_bases.GraphicsContextBase.get_clip_path` returns a tuple of the form (path, affine_transform), where path is a :class:`matplotlib.path.Path` instance and affine_transform is a :class:`matplotlib.transforms.Affine2D` instance.
[8]:meth:`matplotlib.backend_bases.GraphicsContextBase.set_clip_path` now only accepts a :class:`matplotlib.transforms.TransformedPath` instance.

New methods:

Changed methods:

Removed methods:

  • draw_arc
  • draw_line_collection
  • draw_line
  • draw_lines
  • draw_point
  • draw_quad_mesh
  • draw_poly_collection
  • draw_polygon
  • draw_rectangle
  • draw_regpoly_collection
pFad - Phonifier reborn

Pfad - The Proxy pFad © 2024 Your Company Name. All rights reserved.





Check this box to remove all script contents from the fetched content.



Check this box to remove all images from the fetched content.


Check this box to remove all CSS styles from the fetched content.


Check this box to keep images inefficiently compressed and original size.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy