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 et installer Python

Si Python est 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 sur un système Windows® en saisissant python -V à l’invite du système d’exploitation. Sur les systèmes Linux® ou macOS, utilisez plutôt python3 -V. 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 installé Python ou si vous avez besoin d’une autre version, consultez Configurer votre système pour utiliser Python.

Installer MATLAB Engine API pour Python

MATLAB propose différentes méthodes pour installer MATLAB Engine API pour Python. Vous pouvez également utiliser une version préinstallée de MATLAB Engine API pour Python incluse avec MATLAB. (depuis R2026a)

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 la dernière version du moteur MATLAB disponible à partir de PyPI, exécutez la commande suivante à partir de l’invite du système d’exploitation :

python -m pip install matlabengine

La dernière version du moteur MATLAB n’est compatible qu’avec la version la plus récente de MATLAB (actuellement R2026a). Elle n’est pas compatible avec les versions préliminaires de MATLAB.

Si vous ne disposez pas de la dernière version de MATLAB, spécifiez une version du moteur MATLAB compatible avec votre version. Exécutez la commande suivante à partir de l’invite du système d’exploitation, où n.n.n est la version du moteur MATLAB.

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

Pour déterminer quelle version du moteur est utilisée par votre version MATLAB :

  1. Accédez à la page d’historique des versions de PyPI pour MATLAB Engine API pour Python.

  2. Ouvrez chaque page de version du moteur MATLAB et comparez la version MATLAB indiquée sous Required MathWorks Products à votre propre version MATLAB jusqu’à ce qu’elles correspondent.

    Vous pouvez alors remplacer n.n.n par la version du moteur MATLAB indiquée sur la page correspondante.

PyPI installe le moteur MATLAB dans le dossier de package par défaut de l’interpréteur Python utilisé pour appeler le programme d’installation du moteur MATLAB. Pour installer le moteur dans un dossier autre que celui par défaut, exécutez la commande suivante à partir de l’invite du système d’exploitation, où installdir est le dossier où effectuer l’installation.

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.

Utiliser la version préinstallée de MATLAB Engine API pour Python

Depuis R2026a

MATLAB inclut une version préinstallée de MATLAB Engine API pour Python. Cette version préinstallée du moteur se trouve dans le dossier matlabroot/extern/engines/python/dist, où matlabroot est le dossier qui s’affiche lorsque vous exécutez matlabroot dans la fenêtre de commande.

Pour utiliser la version préinstallée du moteur MATLAB, ajoutez le dossier matlabroot/extern/engines/python/dist à la variable d’environnement PYTHONPATH. Vous pouvez également l’insérer dans le chemin sys.path de Python avant d’importer le moteur.

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