import re from matplotlib import path, transforms from matplotlib.backend_bases import ( FigureCanvasBase, KeyEvent, LocationEvent, MouseButton, MouseEvent, NavigationToolbar2, RendererBase) from matplotlib.backend_tools import RubberbandBase from matplotlib.figure import Figure from matplotlib.testing._markers import needs_pgf_xelatex import matplotlib.pyplot as plt import numpy as np import pytest _EXPECTED_WARNING_TOOLMANAGER = ( r"Treat the new Tool classes introduced in " r"v[0-9]*.[0-9]* as experimental for now; " "the API and rcParam may change in future versions.") def test_uses_per_path(): id = transforms.Affine2D() paths = [path.Path.unit_regular_polygon(i) for i in range(3, 7)] tforms_matrices = [id.rotate(i).get_matrix().copy() for i in range(1, 5)] offsets = np.arange(20).reshape((10, 2)) facecolors = ['red', 'green'] edgecolors = ['red', 'green'] def check(master_transform, paths, all_transforms, offsets, facecolors, edgecolors): rb = RendererBase() raw_paths = list(rb._iter_collection_raw_paths( master_transform, paths, all_transforms)) gc = rb.new_gc() ids = [path_id for xo, yo, path_id, gc0, rgbFace in rb._iter_collection( gc, range(len(raw_paths)), offsets, transforms.AffineDeltaTransform(master_transform), facecolors, edgecolors, [], [], [False], [], 'screen')] uses = rb._iter_collection_uses_per_path( paths, all_transforms, offsets, facecolors, edgecolors) if raw_paths: seen = np.bincount(ids, minlength=len(raw_paths)) assert set(seen).issubset([uses - 1, uses]) check(id, paths, tforms_matrices, offsets, facecolors, edgecolors) check(id, paths[0:1], tforms_matrices, offsets, facecolors, edgecolors) check(id, [], tforms_matrices, offsets, facecolors, edgecolors) check(id, paths, tforms_matrices[0:1], offsets, facecolors, edgecolors) check(id, paths, [], offsets, facecolors, edgecolors) for n in range(0, offsets.shape[0]): check(id, paths, tforms_matrices, offsets[0:n, :], facecolors, edgecolors) check(id, paths, tforms_matrices, offsets, [], edgecolors) check(id, paths, tforms_matrices, offsets, facecolors, []) check(id, paths, tforms_matrices, offsets, [], []) check(id, paths, tforms_matrices, offsets, facecolors[0:1], edgecolors) def test_canvas_ctor(): assert isinstance(FigureCanvasBase().figure, Figure) def test_get_default_filename(): assert plt.figure().canvas.get_default_filename() == 'image.png' def test_canvas_change(): fig = plt.figure() # Replaces fig.canvas canvas = FigureCanvasBase(fig) # Should still work. plt.close(fig) assert not plt.fignum_exists(fig.number) @pytest.mark.backend('pdf') def test_non_gui_warning(monkeypatch): plt.subplots() monkeypatch.setenv("DISPLAY", ":999") with pytest.warns(UserWarning) as rec: plt.show() assert len(rec) == 1 assert ('FigureCanvasPdf is non-interactive, and thus cannot be shown' in str(rec[0].message)) with pytest.warns(UserWarning) as rec: plt.gcf().show() assert len(rec) == 1 assert ('FigureCanvasPdf is non-interactive, and thus cannot be shown' in str(rec[0].message)) def test_grab_clear(): fig, ax = plt.subplots() fig.canvas.grab_mouse(ax) assert fig.canvas.mouse_grabber == ax fig.clear() assert fig.canvas.mouse_grabber is None @pytest.mark.parametrize( "x, y", [(42, 24), (None, 42), (None, None), (200, 100.01), (205.75, 2.0)]) def test_location_event_position(x, y): # LocationEvent should cast its x and y arguments to int unless it is None. fig, ax = plt.subplots() canvas = FigureCanvasBase(fig) event = LocationEvent("test_event", canvas, x, y) if x is None: assert event.x is None else: assert event.x == int(x) assert isinstance(event.x, int) if y is None: assert event.y is None else: assert event.y == int(y) assert isinstance(event.y, int) if x is not None and y is not None: assert re.match( f"x={ax.format_xdata(x)} +y={ax.format_ydata(y)}", ax.format_coord(x, y)) ax.fmt_xdata = ax.fmt_ydata = lambda x: "foo" assert re.match("x=foo +y=foo", ax.format_coord(x, y)) def test_pick(): fig = plt.figure() fig.text(.5, .5, "hello", ha="center", va="center", picker=True) fig.canvas.draw() picks = [] def handle_pick(event): assert event.mouseevent.key == "a" picks.append(event) fig.canvas.mpl_connect("pick_event", handle_pick) KeyEvent("key_press_event", fig.canvas, "a")._process() MouseEvent("button_press_event", fig.canvas, *fig.transFigure.transform((.5, .5)), MouseButton.LEFT)._process() KeyEvent("key_release_event", fig.canvas, "a")._process() assert len(picks) == 1 def test_interactive_zoom(): fig, ax = plt.subplots() ax.set(xscale="logit") assert ax.get_navigate_mode() is None tb = NavigationToolbar2(fig.canvas) tb.zoom() assert ax.get_navigate_mode() == 'ZOOM' xlim0 = ax.get_xlim() ylim0 = ax.get_ylim() # Zoom from x=1e-6, y=0.1 to x=1-1e-5, 0.8 (data coordinates, "d"). d0 = (1e-6, 0.1) d1 = (1-1e-5, 0.8) # Convert to screen coordinates ("s"). Events are defined only with pixel # precision, so round the pixel values, and below, check against the # corresponding xdata/ydata, which are close but not equal to d0/d1. s0 = ax.transData.transform(d0).astype(int) s1 = ax.transData.transform(d1).astype(int) # Zoom in. start_event = MouseEvent( "button_press_event", fig.canvas, *s0, MouseButton.LEFT) fig.canvas.callbacks.process(start_event.name, start_event) stop_event = MouseEvent( "button_release_event", fig.canvas, *s1, MouseButton.LEFT) fig.canvas.callbacks.process(stop_event.name, stop_event) assert ax.get_xlim() == (start_event.xdata, stop_event.xdata) assert ax.get_ylim() == (start_event.ydata, stop_event.ydata) # Zoom out. start_event = MouseEvent( "button_press_event", fig.canvas, *s1, MouseButton.RIGHT) fig.canvas.callbacks.process(start_event.name, start_event) stop_event = MouseEvent( "button_release_event", fig.canvas, *s0, MouseButton.RIGHT) fig.canvas.callbacks.process(stop_event.name, stop_event) # Absolute tolerance much less than original xmin (1e-7). assert ax.get_xlim() == pytest.approx(xlim0, rel=0, abs=1e-10) assert ax.get_ylim() == pytest.approx(ylim0, rel=0, abs=1e-10) tb.zoom() assert ax.get_navigate_mode() is None assert not ax.get_autoscalex_on() and not ax.get_autoscaley_on() def test_widgetlock_zoompan(): fig, ax = plt.subplots() ax.plot([0, 1], [0, 1]) fig.canvas.widgetlock(ax) tb = NavigationToolbar2(fig.canvas) tb.zoom() assert ax.get_navigate_mode() is None tb.pan() assert ax.get_navigate_mode() is None @pytest.mark.parametrize("plot_func", ["imshow", "contourf"]) @pytest.mark.parametrize("orientation", ["vertical", "horizontal"]) @pytest.mark.parametrize("tool,button,expected", [("zoom", MouseButton.LEFT, (4, 6)), # zoom in ("zoom", MouseButton.RIGHT, (-20, 30)), # zoom out ("pan", MouseButton.LEFT, (-2, 8)), ("pan", MouseButton.RIGHT, (1.47, 7.78))]) # zoom def test_interactive_colorbar(plot_func, orientation, tool, button, expected): fig, ax = plt.subplots() data = np.arange(12).reshape((4, 3)) vmin0, vmax0 = 0, 10 coll = getattr(ax, plot_func)(data, vmin=vmin0, vmax=vmax0) cb = fig.colorbar(coll, ax=ax, orientation=orientation) if plot_func == "contourf": # Just determine we can't navigate and exit out of the test assert not cb.ax.get_navigate() return assert cb.ax.get_navigate() # Mouse from 4 to 6 (data coordinates, "d"). vmin, vmax = 4, 6 # The y coordinate doesn't matter, it just needs to be between 0 and 1 # However, we will set d0/d1 to the same y coordinate to test that small # pixel changes in that coordinate doesn't cancel the zoom like a normal # axes would. d0 = (vmin, 0.5) d1 = (vmax, 0.5) # Swap them if the orientation is vertical if orientation == "vertical": d0 = d0[::-1] d1 = d1[::-1] # Convert to screen coordinates ("s"). Events are defined only with pixel # precision, so round the pixel values, and below, check against the # corresponding xdata/ydata, which are close but not equal to d0/d1. s0 = cb.ax.transData.transform(d0).astype(int) s1 = cb.ax.transData.transform(d1).astype(int) # Set up the mouse movements start_event = MouseEvent( "button_press_event", fig.canvas, *s0, button) stop_event = MouseEvent( "button_release_event", fig.canvas, *s1, button) tb = NavigationToolbar2(fig.canvas) if tool == "zoom": tb.zoom() tb.press_zoom(start_event) tb.drag_zoom(stop_event) tb.release_zoom(stop_event) else: tb.pan() tb.press_pan(start_event) tb.drag_pan(stop_event) tb.release_pan(stop_event) # Should be close, but won't be exact due to screen integer resolution assert (cb.vmin, cb.vmax) == pytest.approx(expected, abs=0.15) def test_toolbar_zoompan(): with pytest.warns(UserWarning, match=_EXPECTED_WARNING_TOOLMANAGER): plt.rcParams['toolbar'] = 'toolmanager' ax = plt.gca() assert ax.get_navigate_mode() is None ax.figure.canvas.manager.toolmanager.trigger_tool('zoom') assert ax.get_navigate_mode() == "ZOOM" ax.figure.canvas.manager.toolmanager.trigger_tool('pan') assert ax.get_navigate_mode() == "PAN" def test_toolbar_home_restores_autoscale(): fig, ax = plt.subplots() ax.plot(range(11), range(11)) tb = NavigationToolbar2(fig.canvas) tb.zoom() # Switch to log. KeyEvent("key_press_event", fig.canvas, "k", 100, 100)._process() KeyEvent("key_press_event", fig.canvas, "l", 100, 100)._process() assert ax.get_xlim() == ax.get_ylim() == (1, 10) # Autolimits excluding 0. # Switch back to linear. KeyEvent("key_press_event", fig.canvas, "k", 100, 100)._process() KeyEvent("key_press_event", fig.canvas, "l", 100, 100)._process() assert ax.get_xlim() == ax.get_ylim() == (0, 10) # Autolimits. # Zoom in from (x, y) = (2, 2) to (5, 5). start, stop = ax.transData.transform([(2, 2), (5, 5)]) MouseEvent("button_press_event", fig.canvas, *start, MouseButton.LEFT)._process() MouseEvent("button_release_event", fig.canvas, *stop, MouseButton.LEFT)._process() # Go back to home. KeyEvent("key_press_event", fig.canvas, "h")._process() assert ax.get_xlim() == ax.get_ylim() == (0, 10) # Switch to log. KeyEvent("key_press_event", fig.canvas, "k", 100, 100)._process() KeyEvent("key_press_event", fig.canvas, "l", 100, 100)._process() assert ax.get_xlim() == ax.get_ylim() == (1, 10) # Autolimits excluding 0. @pytest.mark.parametrize( "backend", ['svg', 'ps', 'pdf', pytest.param('pgf', marks=needs_pgf_xelatex)] ) def test_draw(backend): from matplotlib.figure import Figure from matplotlib.backends.backend_agg import FigureCanvas test_backend = pytest.importorskip( f'matplotlib.backends.backend_{backend}' ) TestCanvas = test_backend.FigureCanvas fig_test = Figure(constrained_layout=True) TestCanvas(fig_test) axes_test = fig_test.subplots(2, 2) # defaults to FigureCanvasBase fig_agg = Figure(constrained_layout=True) # put a backends.backend_agg.FigureCanvas on it FigureCanvas(fig_agg) axes_agg = fig_agg.subplots(2, 2) init_pos = [ax.get_position() for ax in axes_test.ravel()] fig_test.canvas.draw() fig_agg.canvas.draw() layed_out_pos_test = [ax.get_position() for ax in axes_test.ravel()] layed_out_pos_agg = [ax.get_position() for ax in axes_agg.ravel()] for init, placed in zip(init_pos, layed_out_pos_test): assert not np.allclose(init, placed, atol=0.005) for ref, test in zip(layed_out_pos_agg, layed_out_pos_test): np.testing.assert_allclose(ref, test, atol=0.005) @pytest.mark.parametrize( "key,mouseend,expectedxlim,expectedylim", [(None, (0.2, 0.2), (3.49, 12.49), (2.7, 11.7)), (None, (0.2, 0.5), (3.49, 12.49), (0, 9)), (None, (0.5, 0.2), (0, 9), (2.7, 11.7)), (None, (0.5, 0.5), (0, 9), (0, 9)), # No move (None, (0.8, 0.25), (-3.47, 5.53), (2.25, 11.25)), (None, (0.2, 0.25), (3.49, 12.49), (2.25, 11.25)), (None, (0.8, 0.85), (-3.47, 5.53), (-3.14, 5.86)), (None, (0.2, 0.85), (3.49, 12.49), (-3.14, 5.86)), ("shift", (0.2, 0.4), (3.49, 12.49), (0, 9)), # snap to x ("shift", (0.4, 0.2), (0, 9), (2.7, 11.7)), # snap to y ("shift", (0.2, 0.25), (3.49, 12.49), (3.49, 12.49)), # snap to diagonal ("shift", (0.8, 0.25), (-3.47, 5.53), (3.47, 12.47)), # snap to diagonal ("shift", (0.8, 0.9), (-3.58, 5.41), (-3.58, 5.41)), # snap to diagonal ("shift", (0.2, 0.85), (3.49, 12.49), (-3.49, 5.51)), # snap to diagonal ("x", (0.2, 0.1), (3.49, 12.49), (0, 9)), # only x ("y", (0.1, 0.2), (0, 9), (2.7, 11.7)), # only y ("control", (0.2, 0.2), (3.49, 12.49), (3.49, 12.49)), # diagonal ("control", (0.4, 0.2), (2.72, 11.72), (2.72, 11.72)), # diagonal ]) def test_interactive_pan(key, mouseend, expectedxlim, expectedylim): fig, ax = plt.subplots() ax.plot(np.arange(10)) assert ax.get_navigate() # Set equal aspect ratio to easier see diagonal snap ax.set_aspect('equal') # Mouse move starts from 0.5, 0.5 mousestart = (0.5, 0.5) # Convert to screen coordinates ("s"). Events are defined only with pixel # precision, so round the pixel values, and below, check against the # corresponding xdata/ydata, which are close but not equal to d0/d1. sstart = ax.transData.transform(mousestart).astype(int) send = ax.transData.transform(mouseend).astype(int) # Set up the mouse movements start_event = MouseEvent( "button_press_event", fig.canvas, *sstart, button=MouseButton.LEFT, key=key) stop_event = MouseEvent( "button_release_event", fig.canvas, *send, button=MouseButton.LEFT, key=key) tb = NavigationToolbar2(fig.canvas) tb.pan() tb.press_pan(start_event) tb.drag_pan(stop_event) tb.release_pan(stop_event) # Should be close, but won't be exact due to screen integer resolution assert tuple(ax.get_xlim()) == pytest.approx(expectedxlim, abs=0.02) assert tuple(ax.get_ylim()) == pytest.approx(expectedylim, abs=0.02) def test_toolmanager_remove(): with pytest.warns(UserWarning, match=_EXPECTED_WARNING_TOOLMANAGER): plt.rcParams['toolbar'] = 'toolmanager' fig = plt.gcf() initial_len = len(fig.canvas.manager.toolmanager.tools) assert 'forward' in fig.canvas.manager.toolmanager.tools fig.canvas.manager.toolmanager.remove_tool('forward') assert len(fig.canvas.manager.toolmanager.tools) == initial_len - 1 assert 'forward' not in fig.canvas.manager.toolmanager.tools def test_toolmanager_get_tool(): with pytest.warns(UserWarning, match=_EXPECTED_WARNING_TOOLMANAGER): plt.rcParams['toolbar'] = 'toolmanager' fig = plt.gcf() rubberband = fig.canvas.manager.toolmanager.get_tool('rubberband') assert isinstance(rubberband, RubberbandBase) assert fig.canvas.manager.toolmanager.get_tool(rubberband) is rubberband with pytest.warns(UserWarning, match="ToolManager does not control tool 'foo'"): assert fig.canvas.manager.toolmanager.get_tool('foo') is None assert fig.canvas.manager.toolmanager.get_tool('foo', warn=False) is None with pytest.warns(UserWarning, match="ToolManager does not control tool 'foo'"): assert fig.canvas.manager.toolmanager.trigger_tool('foo') is None def test_toolmanager_update_keymap(): with pytest.warns(UserWarning, match=_EXPECTED_WARNING_TOOLMANAGER): plt.rcParams['toolbar'] = 'toolmanager' fig = plt.gcf() assert 'v' in fig.canvas.manager.toolmanager.get_tool_keymap('forward') with pytest.warns(UserWarning, match="Key c changed from back to forward"): fig.canvas.manager.toolmanager.update_keymap('forward', 'c') assert fig.canvas.manager.toolmanager.get_tool_keymap('forward') == ['c'] with pytest.raises(KeyError, match="'foo' not in Tools"): fig.canvas.manager.toolmanager.update_keymap('foo', 'c')