@@ -13,6 +13,72 @@ For new features that were added to Matplotlib, please see
1313API Changes in 2.1.0
1414====================
1515
16+ cbook deprecations
17+ ------------------
18+
19+ Many unused or near-unused cbook functions and classes have been deprecated:
20+ ``converter ``, ``tostr ``, ``todatetime ``, ``todate ``, ``tofloat ``, ``toint ``,
21+ ``unique ``, ``is_string_like ``, ``is_sequence_of_strings ``, ``is_scalar ``,
22+ ``Sorter ``, ``Xlator ``, ``soundex ``, ``Null ``, ``dict_delall ``, ``RingBuffer ``,
23+ ``get_split_ind ``, ``wrap ``, ``get_recursive_filelist ``, ``pieces ``,
24+ ``exception_to_str ``, ``allequal ``, ``alltrue ``, ``onetrue ``, ``allpairs ``,
25+ ``finddir ``, ``reverse_dict ``, ``restrict_dict ``, ``issubclass_safe ``,
26+ ``recursive_remove ``, ``unmasked_index_ranges ``.
27+
28+
29+ Improved Delaunay triangulations with large offsets
30+ ---------------------------------------------------
31+
32+ Delaunay triangulations now deal with large x,y offsets in a better
33+ way. This can cause minor changes to any triangulations calculated
34+ using Matplotlib, i.e. any use of `matplotlib.tri.Triangulation ` that
35+ requests that a Delaunay triangulation is calculated, which includes
36+ `matplotlib.pyplot.tricontour `, `matplotlib.pyplot.tricontourf `,
37+ `matplotlib.pyplot.tripcolor `, `matplotlib.pyplot.triplot `,
38+ `mlab.griddata ` and `mpl_toolkits.mplot3d.plot_trisurf `.
39+
40+
41+ Deprecation in EngFormatter
42+ ---------------------------
43+
44+ Passing a string as *num * argument when calling an instance of
45+ `matplotlib.ticker.EngFormatter ` is deprecated and will be removed in 2.3.
46+
47+
48+ :meth: `matpltolib.cbook.CallbackRegistry.process ` suppresses exceptions by default
49+ ----------------------------------------------------------------------------------
50+
51+ Matplotlib uses instances of :obj: `~matplotlib.cbook.CallbackRegistry `
52+ as a bridge between user input event from the GUI and user callbacks.
53+ Previously, any exceptions raised in a user call back would bubble out
54+ of of the ``process `` method, which is typically in the GUI event
55+ loop. Most GUI frameworks simple print the traceback to the screen
56+ and continue as there is not always a clear method of getting the
57+ exception back to the user. However PyQt5 now exits the process when
58+ it receives and un-handled python exception in the event loop. Thus,
59+ :meth: `~matplotlib.cbook.CallbackRegistry.process ` now suppresses and
60+ prints tracebacks to stderr by default.
61+
62+ What :meth: `~matplotlib.cbook.CallbackRegistry.process ` does with exceptions
63+ is now user configurable via the ``exception_handler `` attribute and kwarg. To
64+ restore the previous behavior pass ``None `` ::
65+
66+ cb = CallbackRegistry(exception_handler=None)
67+
68+
69+ A function which take and ``Exception `` as its only argument may also be passed ::
70+
71+ def maybe_reraise(exc):
72+ if isinstance(exc, RuntimeError):
73+ pass
74+ else:
75+ raise exc
76+
77+ cb = CallbackRegistry(exception_handler=maybe_reraise)
78+
79+
80+
81+
1682`mpl_toolkits.axes_grid ` has been deprecated
1783--------------------------------------------
1884
0 commit comments