Installazione e configurazione di Python per l'utilizzo in MATLAB

R2026b

Per chiamare Python^® da MATLAB^®, è necessario che una versione supportata dell'implementazione di riferimento (CPython) sia installata sul sistema. È inoltre necessario configurare l'ambiente Python affinché funzioni con MATLAB.

Verifica dell'installazione esistente di Python

Se Python è già installato, verificare se MATLAB supporta la versione di Python presente alla sezione Versions of Python Compatible with MATLAB Products by Release (Versioni di Python compatibili con i prodotti di MATLAB per release).

L'installazione di Python esistente deve inoltre soddisfare i seguenti requisiti specifici della piattaforma:

• Windows^®: è installata la versione a 64 bit di Python. Le versioni a 32 bit non sono supportate.

• Windows: Python non è stato installato dal Microsoft^® Store.

• Linux^® e Mac: se Python è stato compilato dalla sorgente, la build è stata configurata con l'opzione --enable-shared. Per i dettagli, vedere Configure Python (Configurazione di Python) nella documentazione di Python.

• Mac: le installazioni di MATLAB e Python hanno la stessa architettura (Apple silicon o processore Intel^®). Per maggiori informazioni, vedere How to use Python from MATLAB on Mac with Apple Silicon (Come utilizzare Python da MATLAB su Mac con Apple silicon).

Installazione di Python

Se sul sistema non è installata una versione supportata di Python, è possibile installarne una dal pannello Add-Ons (Componenti complementari) in MATLAB oppure da python.org.

Installazione di Python dal pannello Add-Ons (Componenti complementari) in MATLAB

Da R2026b

Per installare Python dal pannello Add-Ons (Componenti complementari) in MATLAB, seguire questi passaggi:

1. Aprire il pannello Add-Ons (Componenti complementari) facendo clic sull'icona Add-Ons (Componenti complementari) nella barra laterale sinistra del desktop. Qualora l'icona Add-Ons (Componenti complementari) non fosse presente, fare clic sul pulsante Open more panels (Apri altri pannelli) e selezionare il pannello Add-Ons (Componenti complementari).

2. Cercare il testo MATLAB Support for Python.

3. Selezionare il componente complementare per la versione di Python che si desidera installare.

4. Fare clic sul pulsante Install.

È ora possibile selezionare questa versione installata di Python come ambiente Python utilizzando pyenv o il pannello External Languages (Linguaggi esterni). Per maggiori informazioni, consultare Manage Python Environments Using External Languages Panel.

Installazione di Python da python.org

Per installare Python da python.org, seguire questi passaggi:

1. Andare a https://www.python.org/downloads/ e scorrere fino alla sezione Looking for a specific release.

2. Trovare la versione desiderata e fare clic su Download. 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).

3. Fare clic sul formato che si desidera installare e seguire le istruzioni online.

   • Su Windows, selezionare il formato a 64 bit.

   • Su Linux e Mac, se si compila l'eseguibile Python dalla sorgente, configurare la build con l'opzione --enable-shared. Per ulteriori dettagli, vedere Configure Python (Configurazione di Python) nella documentazione di Python.

Configurazione di MATLAB per utilizzare l'ambiente Python

È possibile configurare MATLAB in modo che utilizzi un ambiente di base (un'installazione di Python a livello di sistema) oppure un ambiente virtuale (una cartella isolata e specifica per il progetto contenente i pacchetti Python). Se non si dispone già di un ambiente virtuale, è possibile crearne uno dall'ambiente di base utilizzando il pannello External Languages (Linguaggi esterni) (vedere Manage Python Environments Using External Languages Panel). In alternativa, per creare un ambiente virtuale in modo programmatico, vedere l'articolo in MATLAB Python virtual environments with MATLAB (Ambienti virtuali Python con MATLAB) e il tutorial in Python Virtual Environments and Packages (Ambienti virtuali e pacchetti).

Per impostare l'ambiente Python, utilizzare il pannello External Languages (Linguaggi esterni), la funzione pyenv o la variabile di ambiente PYTHONHOME.

Selezione dell'ambiente Python utilizzando il pannello External Languages (Linguaggi esterni)

Da R2026a

Il modo più semplice per configurare MATLAB in modo che utilizzi Python consiste nel selezionare un ambiente di base o virtuale utilizzando il pannello External Languages (Linguaggi esterni).

1. Per aprire la vista Python nel pannello External Languages (Linguaggi esterni), fare clic sul pulsante Open more panels (Apri altri pannelli) in una qualsiasi barra laterale e fare clic su External Languages. Quindi, selezionare l'opzione Python dall'elenco dei linguaggi nella parte superiore sinistra del pannello.

2. Selezionare l'ambiente Python di base o virtuale preferito facendo clic con il tasto destro del mouse su un ambiente nella sezione All Python Environments e selezionando Set as Selected Environment.

L'ambiente selezionato viene visualizzato nella sezione Selected Python Environment del pannello External Languages (Linguaggi esterni).

Per maggiori dettagli, vedere Manage Python Environments Using External Languages Panel.

Impostazione della versione di Python su Windows

Se Python è stato installato utilizzando il programma di installazione standard, Python viene registrato nel registro di Windows. Utilizzare la coppia nome-valore Version di pyenv per specificare quale versione di Python utilizzare. Ad esempio:

pyenv(Version="3.13");

Se è stata eseguita un'installazione non standard, ad esempio copiando i file Python sul computer senza eseguire il programma di installazione, impostare la versione di Python utilizzando il percorso del file eseguibile Python per l'ambiente di base o virtuale. Ad esempio:

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

pyenv restituisce un oggetto PythonEnvironment contenente informazioni sull'ambiente Python attuale.

  PythonEnvironment with properties:

          Version: "3.13"
       Executable: "C:\Users\username\AppData\Local\Programs\Python\Python313\python.exe"
          Library: "C:\Users\username\AppData\Local\Programs\Python\Python313\python313.dll"
             Home: "C:\Users\username\AppData\Local\Programs\Python\Python313"
           Status: NotLoaded
    ExecutionMode: InProcess

Impostazione della versione di Python su Mac e Linux

Per impostare quale versione di Python utilizzare su Mac e Linux, utilizzare la coppia nome-valore Version di pyenv per specificare il percorso completo del file eseguibile Python per l'ambiente di base o virtuale. Ad esempio:

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

pyenv restituisce un oggetto PythonEnvironment contenente informazioni sull'ambiente Python attuale.

  PythonEnvironment with properties:

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

Utilizzo della variabile di ambiente PYTHONHOME

Quando possibile, utilizzare il pannello External Languages (Linguaggi esterni) o pyenv per impostare la versione di Python. Nei casi in cui il pannello o pyenv non siano utilizzabili, ad esempio durante l'esecuzione di applicazioni di MATLAB, un modo alternativo per impostare la versione consiste nell'utilizzare la variabile di ambiente PYTHONHOME. Se si imposta la versione con pyenv e PYTHONHOME, le versioni devono essere uguali.

• Per visualizzare il valore della variabile di ambiente, al prompt dei comandi di MATLAB, inserire getenv("PYTHONHOME"). Per visualizzare la versione impostata da pyenv, inserire 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, inserire unsetenv("PYTHONHOME").

Modifica della modalità di esecuzione (opzionale)

Dopo aver selezionato l'ambiente Python, MATLAB non carica immediatamente l'interprete di Python. Il caricamento avviene la prima volta che si chiama una funzione di Python in MATLAB. Prima di effettuare tale prima chiamata, è possibile modificare opzionalmente la modalità di esecuzione di Python. È possibile eseguire Python nello stesso processo di MATLAB (modalità InProcess) oppure in un processo separato (modalità OutOfProcess).

• Per impostazione predefinita, Python viene eseguito in modalità InProcess. Questa modalità di esecuzione offre vantaggi in termini di prestazioni ed è consigliata per eseguire codice Python esistente.

• Se si sta sviluppando attivamente codice Python, impostare la modalità di esecuzione su OutOfProcess. Questa modalità protegge la sessione di MATLAB dagli arresti anomali causati da codice instabile e consente di interrompere l'esecuzione di codice Python di lunga durata con Ctrl+C (CTRL+C). Utilizzare inoltre la modalità OutOfProcess se è necessario utilizzare librerie di terze parti in conflitto con MATLAB.

Per impostare la modalità di esecuzione, dal pannello External Languages (Linguaggi esterni), fare clic sul pulsante Settings (Impostazioni) e selezionare OutOfProcess. In alternativa, al prompt dei comandi di MATLAB, inserire pyenv(ExecutionMode="OutOfProcess"). Per maggiori informazioni, vedere Out-of-Process Execution of Python Functionality.

Conferma del funzionamento di Python con MATLAB

Per confermare che Python funzioni con MATLAB, caricare l'interprete di Python inserendo un'espressione di Python in MATLAB. Ad esempio:

py.list

ans = 

  Python list with values:

    []

    Use string, double, datetime or cell function to convert to a MATLAB array.

Se viene visualizzato il messaggio di errore Unable to resolve the name py.myfunc, dove myfunc è il nome della funzione, potrebbe essere presente un problema di installazione. Per assistenza nella risoluzione dei problemi, vedere Unable to Resolve the Name py.myfunc.

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

• Impostazioni utente per l'ambiente Python, configurate utilizzando la funzione pyenv. Se la versione specificata è in conflitto con quella indicata dalla variabile di ambiente PYTHONHOME, eliminare la variabile di ambiente prima di chiamare pyenv. Per eliminare la variabile di ambiente, al prompt dei comandi di MATLAB, inserire unsetenv("PYTHONHOME"). Il valore impostato da pyenv persiste tra le sessioni di MATLAB. Per maggiori informazioni, vedere Impostazione della versione di Python su Windows o Impostazione della versione di Python su Mac e Linux.

• La variabile di ambiente PYTHONHOME, specifica dove trovare le librerie standard di Python. MATLAB utilizza questa variabile solo quando il valore di pyenv.Status è NotLoaded. Per visualizzare il valore della variabile in MATLAB, inserire getenv("PYTHONHOME"). Per maggiori informazioni, vedere Utilizzo della variabile di ambiente PYTHONHOME.

• Variabile di ambiente del PATH di sistema. Per visualizzare il percorso di sistema in MATLAB, inserire getenv("PATH").

• Registro Windows.

Cambio dell'ambiente Python

È possibile modificare l'ambiente Python utilizzato da MATLAB tramite il pannello External Languages (Linguaggi esterni) oppure chiamando pyenv. La procedura per cambiare gli ambienti Python dipende dalla modalità di esecuzione.

• Se Python è caricato in modalità InProcess, innanzitutto riavviare MATLAB. Quindi, utilizzare il pannello External Languages (Linguaggi esterni) o pyenv per modificare l'ambiente Python.

• Se Python è caricato in modalità OutOfProcess, terminare innanzitutto il processo Python chiamando terminate(pyenv). Quindi, utilizzare il pannello External Languages (Linguaggi esterni) o pyenv per modificare l'ambiente Python.

Per rimuovere un vecchio ambiente Python dal pannello External Languages (Linguaggi esterni), fare clic con il tasto destro del mouse sull'ambiente nell'elenco All Python Environments e selezionare Remove Environment. La rimozione di un ambiente non comporta la sua eliminazione dal sistema. È possibile aggiungerlo nuovamente in un secondo momento. In questo modo non è possibile rimuovere un ambiente installato tramite il componente complementare MATLAB Support for Python. Per rimuovere quell'ambiente, disinstallare il pacchetto di supporto dal pannello Add-Ons (Componenti complementari), quindi aggiornare il pannello External Languages (Linguaggi esterni) utilizzando il pulsante Refresh (Aggiorna).

Vedi anche

Funzioni

• pyenv

Argomenti

• Versioni di Python compatibili con i prodotti di MATLAB per release
• Unable to Resolve the Name py.myfunc

Siti web esterni

• https://www.python.org/downloads/