You are reading an old version of the documentation (v2.2.0). For the latest version see https://matplotlib.org/stable/api/backend_nbagg_api.html
Version 2.2.0
matplotlib
Fork me on GitHub

This Page

matplotlib.backends.backend_nbagg

Interactive figures in the IPython notebook

class matplotlib.backends.backend_nbagg.CommSocket(manager)

Bases: object

Manages the Comm connection between IPython and the browser (client).

Comms are 2 way, with the CommSocket being able to publish a message via the send_json method, and handle a message with on_message. On the JS side figure.send_message and figure.ws.onmessage do the sending and receiving respectively.

is_open()
on_close()
on_message(message)
send_binary(blob)
send_json(content)
matplotlib.backends.backend_nbagg.FigureCanvas

alias of matplotlib.backends.backend_nbagg.FigureCanvasNbAgg

class matplotlib.backends.backend_nbagg.FigureCanvasNbAgg(*args, **kwargs)

Bases: matplotlib.backends.backend_webagg_core.FigureCanvasWebAggCore

new_timer(*args, **kwargs)

Creates a new backend-specific subclass of backend_bases.Timer. This is useful for getting periodic events through the backend’s native event loop. Implemented only for backends with GUIs.

Other Parameters:
 

interval : scalar

Timer interval in milliseconds

callbacks : List[Tuple[callable, Tuple, Dict]]

Sequence of (func, args, kwargs) where func(*args, **kwargs) will be executed by the timer every interval.

callbacks which return False or 0 will be removed from the timer.

Examples

>>> timer = fig.canvas.new_timer(callbacks=[(f1, (1, ), {'a': 3}),])
matplotlib.backends.backend_nbagg.FigureManager

alias of matplotlib.backends.backend_nbagg.FigureManagerNbAgg

class matplotlib.backends.backend_nbagg.FigureManagerNbAgg(canvas, num)

Bases: matplotlib.backends.backend_webagg_core.FigureManagerWebAgg

ToolbarCls

alias of NavigationIPy

clearup_closed()

Clear up any closed Comms.

connected
destroy()
display_js()
classmethod get_javascript(stream=None)
remove_comm(comm_id)
reshow()

A special method to re-show the figure in the notebook.

show()

For GUI backends, show the figure window and redraw. For non-GUI backends, raise an exception to be caught by show(), for an optional warning.

class matplotlib.backends.backend_nbagg.NavigationIPy(canvas)

Bases: matplotlib.backends.backend_webagg_core.NavigationToolbar2WebAgg

toolitems = [('Home', 'Reset original view', 'fa fa-home icon-home', 'home'), ('Back', 'Back to previous view', 'fa fa-arrow-left icon-arrow-left', 'back'), ('Forward', 'Forward to next view', 'fa fa-arrow-right icon-arrow-right', 'forward'), (None, None, None, None), ('Pan', 'Pan axes with left mouse, zoom with right', 'fa fa-arrows icon-move', 'pan'), ('Zoom', 'Zoom to rectangle', 'fa fa-square-o icon-check-empty', 'zoom'), (None, None, None, None), ('Download', 'Download plot', 'fa fa-floppy-o icon-save', 'download')]
matplotlib.backends.backend_nbagg.connection_info()

Return a string showing the figure and connection status for the backend. This is intended as a diagnostic tool, and not for general use.

matplotlib.backends.backend_nbagg.new_figure_manager_given_figure(num, figure)

Create a new figure manager instance for the given figure.

matplotlib.backends.backend_nbagg.show(*args, **kwargs)

Show all figures.

show blocks by calling mainloop if block is True, or if it is None and we are neither in IPython’s %pylab mode, nor in interactive mode.