Contenuto principale

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

Se Python è già installato, verificare di utilizzare una versione supportata da MATLAB engine. È possibile verificare quale versione di Python è installata inserendo python -V nel prompt del sistema operativo. 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 è ancora installato o si necessita di una versione diversa, vedere Configurazione del sistema per utilizzare Python.

Modalità di installazione dell'API di MATLAB Engine per Python

MATLAB offre diversi metodi per installare l'API di MATLAB Engine per Python.

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 l'installazione da PyPI, eseguire questo comando nel prompt del sistema operativo.

python -m pip install matlabengine 
Questo comando installa l'ultima versione dell'API di MATLAB Engine per Python disponibile in Python Package Index. Se non si dispone dell'ultima release di MATLAB, è necessario specificare una versione di MATLAB engine compatibile con la propria release. È possibile determinare una versione compatibile di MATLAB utilizzando PyPI page for MATLAB Engine API for Python (Pagina PyPI per l'API di MATLAB Engine per Python): Nella scheda Cronologia delle release, controllare la sezione Prodotti di MathWorks richiesti per ogni release di MATLAB engine.

Posizioni di installazione dell'API di MATLAB Engine per Python

È possibile eseguire l'installazione da MATLAB, dal sistema operativo o da Python Package Index e può essere effettuata nella posizione predefinita sotto l'interprete Python, in un'altra posizione non predefinita o in un ambiente virtuale. Per impostazione predefinita, il programma di installazione compila l'API di MATLAB Engine per Python nella cartella matlabroot/extern/engines/python. Il programma di installazione installa quindi MATLAB engine nella cartella predefinita Python. Se si utilizzano i metodi di installazione descritti nelle sezioni Installazione da MATLAB, Installazione dal sistema operativo o Installazione da Python Package Index, MATLAB engine viene compilato e installato nelle posizioni predefinite.

Installazione in una cartella non predefinita utilizzando setup.py

Se non si dispone dei permessi di scrittura per la cartella di installazione predefinita o si desidera installare MATLAB engine in una cartella diversa, è possibile specificare una posizione diversa.

Per compilare e installare engine in una cartella builddir non predefinita, eseguire questi comandi dal prompt del sistema operativo.

cd "matlabroot/extern/engines/python"
python setup.py build --build-base="builddir"
Per includere builddir nel percorso di ricerca dei pacchetti Python, aggiungere builddir alla variabile di ambiente PYTHONPATH.

Installazione in una cartella non predefinita utilizzando Python Package Index

Per installare engine in una cartella installdir non predefinita, eseguire questo comando dal prompt del sistema operativo. Questo metodo di installazione utilizza Python Package Index.

python -m pip install --target installdir matlabengine

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

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