Installieren der MATLAB Engine API for Python

Die MATLAB® Engine API for Python® ermöglicht den Aufruf von MATLAB-Funktionen und die Ausführung von MATLAB-Befehlen von einer Python-Umgebung aus. Zum Verwenden der MATLAB Engine muss auf Ihrem Rechner eine unterstützte Version von Python installiert sein, und Sie müssen die MATLAB Engine API for Python als Python-Paket installieren.

Verifizieren Ihrer Konfiguration und Installieren von Python

Wenn Python bei Ihnen installiert ist, überprüfen Sie, ob Sie eine von der MATLAB-Engine unterstützte Version verwenden. Sie können überprüfen, welche Version von Python Sie auf einem Windows®-System installiert haben, indem Sie python -V in der Eingabeaufforderung Ihres Betriebssystems eingeben. Verwenden Sie auf Linux®- oder macOS-Systemen stattdessen python3 -V. Sehen Sie dann auf der Seite Mit MATLAB-Produkten kompatible Python-Versionen nach Release nach, ob Ihre Python-Version mit Ihrer MATLAB-Version kompatibel ist.

Überprüfen Sie außerdem, ob Sie eine 64-Bit-Version von Python verwenden. Die 64-Bit-Version von Python ist notwendig, da sie der MATLAB-Architektur entspricht. Geben Sie den folgenden Code in der Python-Eingabeaufforderung ein, um zu testen, ob es sich um die 32-Bit- oder 64-Bit-Version von Python handelt. Dieser Code gibt bei einer 64-Bit-Version True und bei einer 32-Bit-Version False zurück. 

import sys 
print(sys.maxsize > 2**32)

Wenn Sie Python nicht installiert haben oder eine andere Version benötigen, sehen Sie unter Konfigurieren Ihres Systems zum Verwenden von Python nach.

Installieren der MATLAB Engine API for Python

In MATLAB stehen verschiedene Methoden zur Installation der MATLAB Engine API for Python zur Verfügung. Zudem können Sie eine vorinstallierte Version des MATLAB Engine API for Python verwenden, die mit MATLAB geliefert wird. (seit R2026a)

Installieren von MATLAB aus

Sie können die MATLAB Engine direkt von MATLAB aus installieren. Starten Sie MATLAB und führen Sie die folgenden Befehle aus.

SystemMATLAB-Befehle

Windows

cd (fullfile(matlabroot,"extern","engines","python"))
system("python -m pip install .")

Linux und macOS

cd (fullfile(matlabroot,"extern","engines","python"))
system("python3 -m pip install .")

Installieren vom Betriebssystem aus

Sie können die MATLAB Engine auch über die Eingabeaufforderung des Betriebssystems installieren. Zunächst benötigen Sie den Pfad zum Ordner der MATLAB Engine API for Python. Starten Sie MATLAB und geben Sie matlabroot in das Befehlsfenster ein, um diesen Ordner zu finden. Ersetzen Sie dann matlabroot in den folgenden Befehlen durch den von MATLAB zurückgegeben Pfadwert.

Vergewissern Sie sich, dass Sie über ausreichende Berechtigungen verfügen, um den install-Befehl über die Eingabeaufforderung des Betriebssystems auszuführen. Öffnen Sie die Eingabeaufforderung in Windows gegebenenfalls mit der Option Als Administrator ausführen.

SystemSystembefehle

Windows

cd "matlabroot\extern\engines\python"
python -m pip install .

Linux und macOS

cd "matlabroot/extern/engines/python"
python3 -m pip install .

Installieren vom Python-Paket-Index aus

Sie können die MATLAB-Engine auch vom Python-Paket-Index (PyPI) aus installieren. Im Gegensatz zu den anderen Installationsoptionen müssen Sie hier nicht zuerst zum Ordner der MATLAB Engine API for Python navigieren.

Um die neueste auf PyPI verfügbare Version der MATLAB-Engine zu installieren, führen Sie diesen Befehl in der Eingabeaufforderung Ihres Betriebssystems aus:

python -m pip install matlabengine

Die neueste Version der MATLAB-Engine ist nur mit der neuesten MATLAB-Version (aktuell R2026a) kompatibel. Sie ist nicht mit Vorversionen von MATLAB kompatibel.

Wenn Sie nicht über die neueste Version von MATLAB verfügen, geben Sie eine Version der MATLAB-Engine an, die mit Ihrer Version kompatibel ist. Führen Sie den folgenden Befehl in der Eingabeaufforderung Ihres Betriebssystems aus, wobei n.n.n die MATLAB-Engineversion ist.

python -m pip install matlabengine==n.n.n

Um zu ermitteln, welche Version mit Ihrer MATLAB-Version kompatibel ist:

  1. Gehen Sie zur PyPI release history page for MATLAB Engine API for Python (PyPI-Versionsverlaufseite für das MATLAB Engine API für Python).

  2. Öffnen Sie die MATLAB Engine-Versionsseiten und vergleichen Sie die unter Required MathWorks Products angezeigte MATLAB-Version mit Ihrer MATLAB-Version, bis die Versionen übereinstimmen.

    Daraufhin können Sie n.n.n durch die auf der entsprechenden Seite angezeigte Version der MATLAB-Engine ersetzen.

PyPI installiert die MATLAB-Engine in den Standard-Paketordner des Python-Interpreters, mit dem das MATLAB Engine-Installationsprogramm aufgerufen wurde. Führen Sie den folgenden Befehl in der Eingabeaufforderung Ihres Betriebssystems aus, um die Engine in einem nicht standardmäßigen Ordner zu installieren, wobei installdir für den Installationsordner steht.

python -m pip install --target installdir matlabengine

Fügen Sie installdir zur Umgebungsvariablen PYTHONPATH hinzu, um installdir in den Suchpfad für Python-Pakete aufzunehmen.

Verwenden einer vorinstallierten Version des MATLAB Engine API für Python

Seit R2026a

MATLAB umfasst eine vorinstallierte Version des MATLAB Engine API for Python. Diese vorinstallierte Version der Engine befindet sich im Ordner matlabroot/extern/engines/python/dist, wobei matlabroot für den Ordner steht, der angezeigt wird, wenn Sie matlabroot im Befehlsfenster ausführen.

Um die vorinstallierte Version der MATLAB-Engine zu verwenden, fügen Sie den Ordner matlabroot/extern/engines/python/dist der Umgebungsvariable PYTHONPATH hinzu. Alternativ können Sie ihn vor dem Import der Engine in sys.path von Python einfügen.

Installieren in einer virtuellen Umgebung

Sie können die MATLAB Engine API for Python in einer virtuellen Umgebung installieren. Detaillierte Anweisungen zur Installation der MATLAB Engine API for Python in einer virtuellen Umgebung finden Sie im MATLAB Answers™-Artikel Verwenden der MATLAB Engine API for Python mit einer virtuellen Umgebung. Informationen über virtuelle Python-Umgebungen finden Sie im Python-Tutorial Virtuelle Umgebungen und Pakete. Sie müssen die virtuelle Umgebung aktivieren, bevor Sie die Installationsbefehle ausführen.

Starten der MATLAB-Engine in Python

Führen Sie folgende Befehle von der Python-Eingabeaufforderung aus, um das Paket der MATLAB Engine API for Python zu importieren und die MATLAB-Engine zu starten.

import matlab.engine
eng = matlab.engine.start_matlab()

Weitere Informationen finden Sie unter Start and Stop MATLAB Engine for Python.

Siehe auch

Themen

Externe Websites