Installazione dell'API di MATLAB Engine per Python

L'API di MATLAB® Engine per Python® consente di chiamare le funzioni di MATLAB ed eseguire i comandi di MATLAB da un ambiente Python. Per utilizzare MATLAB, è necessario avere installata sulla propria macchina una versione di Python supportata e installare l'API di MATLAB Engine per Python come pacchetto Python.

Verifica della configurazione e installazione di Python

Se Python è installato, verificare di utilizzare una versione supportata da MATLAB Engine. È possibile verificare quale versione di Python è installata su un sistema Windows® inserendo python -V nel prompt del sistema operativo. Sui sistemi Linux® o macOS, utilizzare invece python3 -V. Quindi, determinare se la versione di Python è compatibile con la release di MATLAB controllando la pagina Versions of Python Compatible with MATLAB Products by Release (Versioni di Python compatibili con i prodotti di MATLAB per release).

Inoltre, verificare di utilizzare una versione a 64 bit di Python. È necessaria una versione a 64 bit di Python per adattarsi all'architettura di MATLAB. Per verificare se la versione di Python è a 32 bit o a 64 bit, inserire questo codice nel prompt di Python. Questo codice restituisce True se la versione è a 64 bit e False se la versione è a 32 bit. 

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

Se Python non è installato o si necessita di una versione diversa, vedere Configurazione del sistema per utilizzare Python.

Installazione dell'API di MATLAB Engine per Python

MATLAB offre diversi metodi per installare l'API di MATLAB Engine per Python. È anche possibile utilizzare una versione preinstallata dell'API di MATLAB per Python fornita con MATLAB. (da R2026a)

Installazione da MATLAB

È possibile installare MATLAB engine direttamente da MATLAB. Avviare MATLAB ed eseguire i seguenti comandi.

SistemaComandi di MATLAB

Windows

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

Linux e macOS

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

Installazione dal sistema operativo

In alternativa, è possibile installare MATLAB dal prompt del sistema operativo. Innanzitutto, è necessario il percorso alla cartella dell'API di MATLAB Engine per Python. Per individuare questa cartella, avviare MATLAB e inserire matlabroot nella finestra di comando. Quindi sostituire matlabroot nei seguenti comandi con il valore del percorso restituito da MATLAB.

Assicurarsi di disporre dei privilegi sufficienti per eseguire il comando install dal prompt del sistema operativo. Su Windows, se necessario, aprire il prompt dei comandi con l'opzione Esegui come amministratore.

SistemaComandi di sistema

Windows

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

Linux e macOS

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

Installazione da Python Package Index

In alternativa, è possibile installare MATLAB engine da Python Package Index (PyPI). A differenza delle altre opzioni di installazione, non è necessario spostarsi prima nella cartella dell'API di MATLAB Engine per Python.

Per installare l'ultima versione di MATLAB Engine disponibile su PyPI, eseguire questo comando dal prompt del sistema operativo:

python -m pip install matlabengine

L'ultima versione di MATLAB Engine è compatibile solo con la release più recente di MATLAB (attualmente R2026a). Non è compatibile con le versioni pre-release di MATLAB.

Se non si dispone dell'ultima release di MATLAB, specificare una versione di MATLAB Engine compatibile con la propria release. Eseguire questo comando dal prompt del sistema operativo, dove n.n.n è la versione di MATLAB Engine.

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

Per determinare quale versione è compatibile con la propria release di MATLAB:

  1. Andare a PyPI release history page for MATLAB Engine API for Python (Cronologia delle release PyPI per l'API di MATLAB Engine per Python).

  2. Aprire ciascuna pagina di release di MATLAB Engine e confrontare la release di MATLAB mostrata sotto Required MathWorks Products con la propria release di MATLAB fino a trovare una corrispondenza.

    È quindi possibile sostituire n.n.n con la versione di MATLAB Engine indicata nella pagina corrispondente.

PyPI installa MATLAB Engine nella cartella predefinita del pacchetto per l'interprete Python utilizzato per chiamare il programma di installazione di MATLAB Engine. Per installare engine in una cartella diversa da quella predefinita, eseguire questo comando dal prompt del sistema operativo, dove installdir è la cartella in cui eseguire l'installazione.

python -m pip install --target installdir matlabengine

Per includere installdir nel percorso di ricerca dei pacchetti Python, aggiungere installdir alla variabile di ambiente PYTHONPATH.

Utilizzo della versione preinstallata dell'API di MATLAB Engine per Python

Da R2026a

MATLAB include una versione preinstallata dell'API di MATLAB Engine per Python. Questa versione preinstallata engine si trova nella cartella matlabroot/extern/engines/python/dist, dove matlabroot è la cartella visualizzata quando si esegue matlabroot nella finestra di comando.

Per utilizzare la versione preinstallata di MATLAB Engine, aggiungere la cartella matlabroot/extern/engines/python/dist alla variabile di ambiente PYTHONPATH. In alternativa, è possibile inserirlo nel sys.path di Python prima di importare engine.

Installazione in ambiente virtuale

È possibile installare l'API di MATLAB Engine per Python in un ambiente virtuale. Per istruzioni dettagliate sull'installazione dell'API di MATLAB Engine per Python in un ambiente virtuale, vedere l'articolo MATLAB Answers™ Use the MATLAB Engine API for Python with a Virtual Environment (Utilizzare l'API di MATLAB Engine per Python con un ambiente virtuale). Per informazioni sugli ambienti virtuali Python, vedere il tutorial di Python Virtual Environments and Packages (Ambienti virtuali e pacchetti). È necessario attivare l'ambiente virtuale prima di eseguire i comandi di installazione.

Avvio di MATLAB Engine in Python

Per importare l'API di MATLAB Engine per il pacchetto Python e avviare MATLAB, eseguire questi comandi dal prompt di Python.

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

Per maggiori informazioni, vedere Start and Stop MATLAB Engine for Python.

Vedi anche

Argomenti

Siti web esterni