Installation#

In den meisten Fällen müssen Sie nur

pip install ipympl

oder alternativ mit mamba/conda

mamba install -c conda-forge ipympl

und starten Sie dann Jupyter neu.

Jupyterlab < 3#

Wenn Sie JupyterLab 2 verwenden, müssen Sie die Labextension immer noch manuell installieren

conda install -c conda-forge nodejs
jupyter labextension install @jupyter-widgets/jupyterlab-manager jupyter-matplotlib

Google Colab#

Um ipympl in Colab zu verwenden, führen Sie diese Zeilen aus

from google.colab import output
output.enable_custom_widget_manager()

Vermischung von Frontend- und Backend-Versionen#

ipympl bietet sowohl ein Frontend (in Javascript), das für die Anzeige von Plots und die Verarbeitung von Interaktionsereignissen zuständig ist, als auch ein Backend (in Python), das die Plots rendert und mit dem Benutzercode Schnittstellen bildet. Diese beiden Teile müssen miteinander kommunizieren können, damit alles funktioniert. In der häufigsten Situation, in der Ihr Frontend und Backend aus derselben Python-Umgebung stammen, sollten Sie durch die Installation von ipympl kompatible Versionen erhalten haben.

Es gibt jedoch Situationen, in denen Sie unterschiedliche Versionen von ipympl im Frontend und Backend haben können. In diesem Fall müssen Sie sicherstellen, dass Sie kompatible Versionen des Frontends und Backends haben. Details und eine erste Kompatibilitätstabelle finden Sie in der Diskussion zu diesem Github-Issue.

Kompatibilitätstabelle#

Nicht alle Versionen von ipympl sind mit verschiedenen Versionen von Jupyterlab oder allen Versionen von Matplotlib kompatibel. Die folgende Tabelle bietet einen Anhaltspunkt, welche Versionen kompatibel sind.

ipympl

jupyter-matplotlib

JupyterLab

Matplotlib

0.9.5-7

0.11.5-7

>=2,<5

>=3.5.0

0.9.3-4

0.11.3-4

>=2,<5

3.4.0>=

0.9.0-2

0.11.0-2

>=2,<5

3.4.0>= <3.7

0.8.8

0.10.x

3 oder 2

3.3.1>= <3.7

0.8.0-7

0.10.x

3 oder 2

3.3.1>=, <3.6

0.7.0

0.9.0

3 oder 2

3.3.1>=

0.6.x

0.8.x

3 oder 2

3.3.1>=, <3.4

0.5.8

0.7.4

1 oder 2

3.3.1>=, <3.4

0.5.7

0.7.3

1 oder 2

3.2.*

0.5.3

0.7.2

1 oder 2

0.5.2

0.7.1

1

0.5.1

0.7.0

1

0.5.0

0.6.0

1

0.4.0

0.5.0

1

0.3.3

0.4.2

1

0.3.2

0.4.1

1

0.3.1

0.4.0

0 oder 1