Configurazione del sistema per utilizzare Python

Supporto Python

Per chiamare i moduli di Python® in MATLAB®, è necessario disporre di una versione supportata dell'implementazione di riferimento (CPython) installata sul proprio sistema. Installare una distribuzione, come quelle disponibili su https://www.python.org/downloads/. MATLAB non supporta le versioni CPython installate dallo store di Microsoft®. Per informazioni sulle versioni supportate, vedere Versions of Python Compatible with MATLAB Products by Release (Versioni di Python compatibili con i prodotti di MATLAB per release).

MATLAB seleziona e carica un interprete di Python quando si digita un'espressione di Python da MATLAB utilizzando lo spazio dei nomi py, ad esempio py.list. Per cambiare l'interprete:

  • Se Python è caricato in InProcess ExecutionMode, riavviare MATLAB e chiamare pyenv con le nuove informazioni sulla versione o la nuova modalità di esecuzione.

  • Se Python è caricato in modalità OutOfProcess, terminare il processo associato all'interprete di Python chiamando terminate prima di chiamare pyenv con le nuove informazioni sulla versione o la nuova modalità di esecuzione.

MATLAB accede a queste impostazioni durante il caricamento dell'interprete di Python:

Per verificare che Python sia installato sul proprio sistema, aprire l'interprete di Python dal prompt del sistema e chiamare le funzioni di Python.

Per determinare quale versione sta utilizzando MATLAB, chiamare pyenv. Ad esempio, su 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

Su 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

Installazione di implementazioni Python supportate

Se viene visualizzato il messaggio di errore Unable to resolve the name py.myfunc, potrebbe essere presente un problema di installazione.

Installazione di Python in ambiente virtuale

È possibile creare un ambiente virtuale per una versione specifica di Python utilizzando il modulo Python venv. È inoltre possibile installare l'API di MATLAB Engine per Python in un ambiente virtuale. Per le istruzioni venv, vedere l'articolo MATLAB Answers™ Python virtual environments with MATLAB (Ambienti virtuali Python con MATLAB). Per informazioni sugli ambienti virtuali Python, vedere il tutorial di Python Virtual Environments and Packages (Ambienti virtuali e pacchetti).

Impostazione della versione di Python sulla piattaforma Windows

Sulle piattaforme Windows, utilizzare:

pyenv(Version="version")

oppure

pyenv(Version="executable")

dove executable è il percorso completo del file eseguibile Python. Per maggiori informazioni, vedere l'argomento nome-valore Version per pyenv. Ad esempio, su un sistema Windows, impostare la versione di Python su 3.11.

pyenv(Version="3.11");

Nota

Se si è eseguito il download di un interprete di Python ma non lo si è registrato nel registro Windows, utilizzare:

pyenv(Version="executable")

Ad esempio, digitare:

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

Download della versione a 64 bit di Python su piattaforme Windows

L'architettura di Python deve corrispondere all'architettura di MATLAB. Per maggiori informazioni, vedere Installazione di implementazioni Python supportate.

Impostazione della versione di Python su piattaforme Mac e Linux

Per impostare la versione, digitare:

pyenv(Version="executable")

dove executable è il percorso completo del file eseguibile Python. Per maggiori informazioni, vedere l'argomento nome-valore Version per pyenv. Ad esempio, digitare:

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

Requisiti per lo sviluppo dell'eseguibile Python

Sui sistemi Linux e macOS, se si compila l'eseguibile Python, configurare la build con l'opzione --enable-shared. È possibile consultare le opzioni dello script configure di Python in Configure Python documentation (Documentazione relativa alla configurazione di Python).

Utilizzo della variabile di ambiente PYTHONHOME

Quando possibile, utilizzare pyenv per impostare l'interprete di Python. Nei casi in cui pyenv non è utilizzabile, ad esempio durante l'esecuzione di applicazioni MATLAB, un modo alternativo per impostare l'interprete è utilizzare la variabile di ambiente PYTHONHOME. Se si imposta la versione con pyenv e PYTHONHOME, le versioni devono essere uguali.

  • Per visualizzare la variabile in MATLAB, digitare getenv("PYTHONHOME"). Per visualizzare la versione impostata da pyenv, digitare e = pyenv; e.Version

  • Per impostare PYTHONHOME, vedere https://docs.python.org/3/using/cmdline.html#envvar-PYTHONHOME. Per informazioni sull'impostazione delle variabili di ambiente, fare riferimento alla documentazione del sistema operativo. È inoltre possibile impostare la variabile utilizzando setenv. Tuttavia, questa impostazione si applica solo alla sessione attuale di MATLAB.

  • Per eliminare PYTHONHOME dalla sessione attuale di MATLAB, digitare unsetenv("PYTHONHOME").

Non è possibile modificare la versione di Python se l'interprete è già stato caricato. MATLAB carica un interprete di Python quando si digita una dichiarazione di Python da MATLAB utilizzando lo spazio dei nomi py, ad esempio py.sys.path. Per cambiare l'interprete:

  • Se Python è caricato in InProcess ExecutionMode in una singola sessione di MATLAB, riavviare MATLAB ed eseguire pyenv con le nuove informazioni sulla versione.

  • Se Python è caricato in modalità OutOfProcess, chiamare terminate prima di chiamare pyenv con le nuove informazioni sulla versione.

Vedi anche

Argomenti

Siti web esterni