Installer MATLAB Engine API pour Python

MATLAB® Engine API pour Python® permet d’appeler des fonctions MATLAB et d’exécuter des commandes MATLAB depuis un environnement Python. Pour utiliser le moteur MATLAB, vous devez avoir installé une version supportée de Python sur votre machine. Vous devez également installer MATLAB Engine API pour Python en tant que package Python.

Vérifier votre configuration

Si Python est déjà installé, vérifiez que vous utilisez une version supportée par le moteur MATLAB. Vous pouvez vérifier quelle version de Python est installée en saisissant python -V à l’invite du système d’exploitation. Déterminez ensuite si votre version de Python est compatible avec votre version MATLAB en consultant la page Versions of Python Compatible with MATLAB Products by Release (Versions de Python compatibles avec les produits MATLAB par version).

Vérifiez également que vous utilisez une version 64 bits de Python. Une version 64 bits de Python est nécessaire pour correspondre à l’architecture MATLAB. Pour déterminer si votre version de Python est 32 bits ou 64 bits, saisissez le code suivant à l’invite Python. Ce code renvoie True s’il s’agit d’une version 64 bits et False si c’est une version 32 bits. 

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

Si vous n’avez pas encore installé Python ou si vous avez besoin d’une autre version, consultez Configurer votre système pour utiliser Python.

Méthodes d’installation de MATLAB Engine API pour Python

MATLAB propose différentes méthodes pour installer MATLAB Engine API pour Python.

Installation à partir de MATLAB

Vous pouvez installer le moteur MATLAB directement à partir de MATLAB. Démarrez MATLAB et exécutez les commandes suivantes.

SystèmeCommandes MATLAB

Windows®

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

Linux® et macOS

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

Installation à partir du système d’exploitation

Vous pouvez également installer le moteur MATLAB à partir de l’invite du système d’exploitation. Tout d’abord, vous devez déterminer le chemin du dossier MATLAB Engine API pour Python. Pour localiser ce dossier, démarrez MATLAB et saisissez matlabroot dans la fenêtre de commande. Ensuite, exécutez les commandes suivantes en remplaçant matlabroot par le chemin renvoyé par MATLAB.

Assurez-vous de disposer de privilèges suffisants pour exécuter la commande install à partir de l’invite du système d’exploitation. Sous Windows, si nécessaire, ouvrez l’invite de commande avec l’option Exécuter en tant qu’administrateur.

SystèmeCommandes système

Windows

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

Linux et macOS

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

Installation à partir de Python Package Index

Vous pouvez également installer le moteur MATLAB à partir de Python Package Index (PyPI). Contrairement aux autres options d’installation, celle-ci ne nécessite pas d’accéder d’abord au dossier MATLAB Engine API pour Python. Pour installer le moteur à partir de PyPI, exécutez la commande suivante à l’invite du système d’exploitation. 

python -m pip install matlabengine
Cette commande installe la dernière version de MATLAB Engine API pour Python disponible dans Python Package Index. Si vous ne disposez pas de la dernière version de MATLAB, vous devez spécifier une version du moteur MATLAB compatible avec votre version. Vous pouvez identifier une version compatible du moteur MATLAB en consultant la page PyPI relative à MATLAB Engine API pour Python : Dans l’onglet « Historique des versions », consultez la section « Required MathWorks Products » (Produits MathWorks requis) pour chaque version du moteur MATLAB.

Où installer MATLAB Engine API pour Python

Vous pouvez procéder à l’installation à partir de MATLAB, du système d’exploitation ou de Python Package Index. L’emplacement d’installation peut être celui par défaut de votre interpréteur Python, un emplacement autre que celui par défaut ou un environnement virtuel. Par défaut, le programme d’installation compile MATLAB Engine API pour Python dans le dossier matlabroot/extern/engines/python. Il installe ensuite le moteur MATLAB dans le dossier Python par défaut. Si vous suivez les méthodes d’installation des sections Installation à partir de MATLAB, Installation à partir du système d’exploitation ou Installation à partir de Python Package Index, le moteur MATLAB est compilé et installé aux emplacements par défaut.

Installation dans un dossier autre que celui par défaut avec setup.py

Si vous ne disposez pas d’une autorisation en écriture sur le dossier d’installation par défaut ou si vous souhaitez installer le moteur MATLAB dans un autre dossier, vous pouvez spécifier un emplacement différent.

Pour compiler et installer le moteur dans un dossier builddir autre que celui par défaut, exécutez les commandes suivantes à partir de l’invite du système d’exploitation. 

cd "matlabroot/extern/engines/python"
python setup.py build --build-base="builddir"
Pour inclure builddir dans le chemin de recherche des packages Python, ajoutez builddir à la variable d’environnement PYTHONPATH.

Installation dans un dossier autre que celui par défaut avec Python Package Index

Pour installer le moteur dans un dossier installdir autre que celui par défaut, exécutez la commande suivante à partir de l’invite du système d’exploitation. Cette méthode d’installation utilise Python Package Index. 

python -m pip install --target installdir matlabengine

Pour inclure installdir dans le chemin de recherche des packages Python, ajoutez installdir à la variable d’environnement PYTHONPATH.

Installation dans un environnement virtuel

Vous pouvez installer MATLAB Engine API pour Python dans un environnement virtuel. Pour obtenir des instructions détaillées sur l’installation de MATLAB Engine API pour Python dans un environnement virtuel, consultez l’article MATLAB Answers™ intitulé Can I use the MATLAB Engine API for Python with a virtual environment? (Puis-je utiliser MATLAB Engine API pour Python avec un environnement virtuel ?). Pour plus d’informations sur les environnements virtuels Python, consultez le tutoriel Python intitulé Environnements virtuels et paquets. Vous devez activer l’environnement virtuel avant d’exécuter les commandes d’installation.

Démarrer le moteur MATLAB dans Python

Pour importer le package MATLAB Engine API pour Python et démarrer le moteur MATLAB, exécutez les commandes suivantes à l’invite Python.

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

Pour plus d’informations, consultez Start and Stop MATLAB Engine for Python.

Voir aussi

Rubriques

Sites web externes