Konfigurieren Ihres Systems zum Verwenden von Python

Python-Support

Damit Sie das Python®-Modul in MATLAB® aufrufen können, muss auf Ihrem System eine unterstützte Version der Referenzimplementierung (CPython) installiert sein. Installieren Sie eine der Distributionen, die Sie unter https://www.python.org/downloads/ finden. MATLAB unterstützt keine CPython-Versionen, die aus dem Microsoft® Store stammen. Informationen zu unterstützten Versionen finden Sie unter Mit MATLAB-Produkten nach Version kompatible Python Versionen.

MATLAB wählt und lädt einen Python-Interpreter, wenn Sie einen Python-Ausdruck von MATLAB aus eingeben und dabei den py-Namensraum verwenden, z. B. py.list. Den Interpreter können Sie wie folgt wechseln:

  • Wenn Python im InProcess ExecutionMode (Ausführungsmodus) geladen ist, starten Sie MATLAB neu und rufen Sie pyenv mit den neuen Versionsinformationen oder dem Ausführungsmodus auf.

  • Wenn Python im OutOfProcess-Modus geladen ist, beenden Sie den mit dem Python-Interpreter verbundenen Prozess, indem Sie terminate vor dem Aufruf von pyenv mit den neuen Versionsinformationen oder dem Ausführungsmodus aufrufen.

MATLAB greift beim Laden des Python-Interpreters auf folgende Einstellungen zu:

  • Benutzereinstellungen für die Python-Umgebung, die mithilfe der pyenv-Funktion konfiguriert werden. Falls die von Ihnen angegebene Version im Widerspruch zu der von PYTHONHOME angegebenen Version steht, löschen Sie vor dem Aufrufen von pyenv die Umgebungsvariable. Der durch pyenv festgelegte Wert ist über MATLAB-Sitzungen hinweg persistent. Weitere Informationen finden Sie unter Einstellen der Python-Version auf der Windows-Plattform oder Einstellen der Python-Version auf Mac- und Linux-Plattformen.

  • Die Umgebungsvariable PYTHONHOME gibt an, wo sich die Python-Standardbibliotheken befinden, wenn pyenv.Status den Wert NotLoaded besitzt. Geben Sie getenv("PYTHONHOME") ein, um den Wert der Variablen in MATLAB anzuzeigen. Weitere Informationen finden Sie unter Verwenden der Umgebungsvariable PYTHONHOME.

  • Umgebungsvariable PATH (Systempfad) Geben Sie getenv("PATH") ein, um den Systempfad in MATLAB anzuzeigen.

  • Windows-Registry

Öffnen Sie den Python-Interpreter von der Systemsteuerung aus und rufen Sie Python-Funktionen auf, um zu überprüfen, ob Python auf Ihrem System installiert ist.

Rufen Sie pyenv auf, um festzustellen, welche Version MATLAB verwendet. Zum Beispiel in Windows:

pe = pyenv

pe = 

  PythonEnvironment with properties:

          Version: "3.10"
       Executable: "C:\Users\username\AppData\Local\Programs\Python\Python310\pythonw.exe"
          Library: "C:\Users\username\AppData\Local\Programs\Python\Python310\python310.dll"
             Home: "C:\Users\username\AppData\Local\Programs\Python\Python310"
           Status: NotLoaded
    ExecutionMode: InProcess

In Linux:

pe = pyenv

pe = 

  PythonEnvironment with properties:

          Version: "3.9"
       Executable: "/usr/bin/python3"
          Library: "libpython3.9.so.1.0"
             Home: "/usr"
           Status: NotLoaded
    ExecutionMode: InProcess

Installieren einer unterstützten Python-Implementierung

Falls Sie die Fehlermeldung Unable to resolve the name py.myfunc erhalten, haben Sie möglicherweise ein Installationsproblem.

Installieren von Python in einer virtuellen Umgebung

Sie können mithilfe des Python venv-Moduls eine virtuelle Umgebung für eine bestimmte Version von Python erstellen. Sie können in einer virtuellen Umgebung auch die MATLAB Engine API for Python installieren. Anweisungen zu venv finden Sie im MATLAB Answers™-Artikel Virtuelle Umgebungen für Python in MATLAB. Informationen über virtuelle Python-Umgebungen finden Sie im Python-Tutorial Virtuelle Umgebungen und Pakete.

Einstellen der Python-Version auf der Windows-Plattform

Verwenden Sie auf einer Windows-Plattform entweder:

pyenv(Version="version")

oder

pyenv(Version="executable")

wobei executable der vollständige Pfad zur Python-Ausführungsdatei ist. Weitere Informationen finden Sie unter dem Version-Name-Wert-Argument von pyenv. Stellen Sie zum Beispiel in einem Windows-System die Python-Version auf 3.11 ein.

pyenv(Version="3.11");

Hinweis

Wenn Sie einen Python-Interpreter heruntergeladen, ihn aber nicht in der Windows-Registry registriert haben, verwenden Sie:

pyenv(Version="executable")

Geben Sie zum Beispiel Folgendes ein:

pyenv(Version="C:\Users\username\AppData\Local\Programs\Python\Python311\python.exe");

Herunterladen der 64-Bit Version von Python auf Windows-Plattformen

Die Python-Architektur muss mit der MATLAB-Architektur übereinstimmen. Weitere Informationen finden Sie unter Installieren einer unterstützten Python-Implementierung.

Einstellen der Python-Version auf Mac- und Linux-Plattformen

Geben Sie zum Einstellen der Version Folgendes ein:

pyenv(Version="executable")

wobei executable der vollständige Pfad zur Python-Ausführungsdatei ist. Weitere Informationen finden Sie unter dem Version-Name-Wert-Argument von pyenv. Geben Sie zum Beispiel Folgendes ein:

pyenv(Version="/usr/bin/python3.11")

Anforderungen für das Erstellen von Python-Ausführungsdateien

Konfigurieren Sie beim Erstellen der Python-Ausführungsdatei in Linux- und macOS-Systemen den Build mit der Option --enable-shared. Sie können die configure-Skriptoptionen für Python in der Dokumentation zum Konfigurieren von Python nachschlagen.

Verwenden der Umgebungsvariable PYTHONHOME

Legen Sie den Python-Interpreter wenn möglich mithilfe von pyenv fest. In Fällen, in denen pyenv nicht verwendbar ist, z. B. bei der Ausführung von MATLAB-Apps, können Sie den Interpreter über die Umgebungsvariable PYTHONHOME festlegen. Falls Sie die Version über pyenv und PYTHONHOME einstellen, müssen die Versionen übereinstimmen.

  • Geben Sie getenv("PYTHONHOME") ein, um die Variable in MATLAB anzuzeigen. Geben Sie e = pyenv; e.Version ein, um die über pyenv eingestellte Version anzuzeigen.

  • Informationen zum Einstellen von PYTHONHOME finden sie unter https://docs.python.org/3/using/cmdline.html#envvar-PYTHONHOME. Informationen zum Setzen von Umgebungsvariablen finden Sie in der Dokumentation Ihres Betriebssystems. Sie können die Variable auch mit setenv setzen. Diese Einstellung gilt jedoch nur für die aktuelle MATLAB-Sitzung.

  • Geben Sie unsetenv("PYTHONHOME") ein, um PYTHONHOME für die aktuelle MATLAB-Sitzung zu löschen.

Sie können die Python-Version nicht ändern, wenn Sie den Interpreter bereits geladen haben. MATLAB lädt einen Python-Interpreter, wenn Sie eine Python-Anweisung von MATLAB aus unter Verwendung des Namensraums py eingeben, zum Beispiel py.sys.path. Den Interpreter können Sie wie folgt wechseln:

  • Wenn Python im InProcess ExecutionMode (Ausführungsmodus) in einer einzigen MATLAB-Sitzung geladen ist, starten Sie MATLAB neu und führen Sie pyenv mit den neuen Versionsinformationen aus.

  • Wenn Python im OutOfProcess-Modus geladen wird, rufen Sie terminate (beenden) auf, bevor Sie pyenv mit den neuen Versionsinformationen aufrufen.

Siehe auch

Themen

Externe Websites