Hauptinhalt

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.

Überprüfen der Konfiguration

Wenn Python bei Ihnen bereits 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 installiert haben, indem Sie python -V in der Eingabeaufforderung Ihres Betriebssystems eingeben. 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 noch nicht installiert haben oder eine andere Version benötigen, sehen Sie unter Konfigurieren Ihres Systems zum Verwenden von Python nach.

Methoden zur Installation der MATLAB Engine API for Python

In MATLAB stehen verschiedene Methoden zur Installation der MATLAB Engine API for Python zur Verfügung.

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. Führen Sie den folgenden Befehl in der Eingabeaufforderung Ihres Betriebssystems aus, um über den PyPI zu installieren.

python -m pip install matlabengine 
Dieser Befehl installiert die neueste Version der MATLAB Engine API for Python, die im Python-Paket-Index verfügbar ist. Wenn Sie nicht über die neueste Version von MATLAB verfügen, müssen Sie eine Version der MATLAB-Engine angeben, die mit Ihrer Version kompatibel ist. Auf der PyPI-Seite für die MATLAB Engine API for Python können Sie eine kompatible Version der MATLAB-Engine ermitteln: Überprüfen Sie auf der Registerkarte „Release history“ (Versionshistorie) den Abschnitt „Required MathWorks Products“ (Erforderliche MathWorks-Produkte) für jede MATLAB-Engine-Version.

Installationsort der MATLAB Engine API for Python

Sie können von MATLAB, dem Betriebssystem oder dem Python-Paket-Index aus und am Standardspeicherort Ihres Python-Interpreters, an einem anderen Speicherort oder in einer virtuellen Umgebung installieren. Standardmäßig erstellt das Installationsprogramm die MATLAB Engine API for Python im Ordner matlabroot/extern/engines/python. Das Installationsprogramm installiert dann die MATLAB Engine in den Python-Standardordner. Wenn Sie die Installationsmethoden in den Abschnitten Installieren von MATLABaus, Installieren vom Betriebssystem aus oder Installieren vom Python-Paket-Index aus verwenden, wird die MATLAB Engine an den Standardspeicherorten erstellt und installiert.

Installieren in einen anderen Ordner als den Standardordner mit setup.py

Wenn Sie keine Schreibrechte für den Standard-Installationsordner haben oder die MATLAB Engine in einem anderen Ordner installieren möchten, können Sie einen anderen Ort angeben.

Führen Sie folgende Befehle in der Eingabeaufforderung Ihres Betriebssystems aus, um die Engine im nicht standardmäßigen Ordner builddir zu erstellen und zu installieren.

cd "matlabroot/extern/engines/python"
python setup.py build --build-base="builddir"
Fügen Sie builddir zur Umgebungsvariablen PYTHONPATH hinzu, um builddir in den Suchpfad für Python-Pakete aufzunehmen.

Installieren in einen anderen Ordner als den Standardordner mit dem Python-Paket-Index

Führen Sie den folgenden Befehl in der Eingabeaufforderung Ihres Betriebssystems aus, um die Engine in den nicht standardmäßigen Ordner installdir zu installieren. Diese Installationsmethode verwendet den Python-Paket-Index.

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.

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