diff --git a/tutorials/introductory/usage.py b/tutorials/introductory/usage.py index bc1b4effbf12..26bea9bad82e 100644 --- a/tutorials/introductory/usage.py +++ b/tutorials/introductory/usage.py @@ -414,8 +414,9 @@ def my_plotter(ax, data1, data2, param_dict): # ============ ================================================================ # Qt5Agg Agg rendering in a :term:`Qt5` canvas (requires PyQt5_). This # backend can be activated in IPython with ``%matplotlib qt5``. -# ipympl Agg rendering embedded in a Jupyter widget. This can be enabled -# in a Jupyter notebook with ``%matplotlib ipympl`` +# ipympl Agg rendering embedded in a Jupyter widget. (requires ipympl) +# This can be enabled in a Jupyter notebook with +# ``%matplotlib ipympl`` # GTK3Agg Agg rendering to a :term:`GTK` 3.x canvas (requires PyGObject_ # and pycairo_ or cairocffi_) # This backend can be activated in IPython with @@ -465,6 +466,26 @@ def my_plotter(ax, data1, data2, param_dict): # .. _PyQt4: https://riverbankcomputing.com/software/pyqt/intro # .. _PyQt5: https://riverbankcomputing.com/software/pyqt/intro # +# ipympl +# ------ +# +# The Jupyter widget ecosystem is moving too fast to support directly in +# Matplotlib. To install ipympl +# +# .. code-block:: bash +# +# pip install ipympl +# jupyter nbextension enable --py --sys-prefix ipympl +# +# or +# +# .. code-block:: bash +# +# conda install ipympl -c conda-forge +# +# See `jupyter-matplotlib `__ +# for more details. +# # GTK and Cairo # ------------- #