Instalar la API del motor de MATLAB para Python
La API del motor de MATLAB® para Python® permite llamar a las funciones de MATLAB y ejecutar comandos de MATLAB desde dentro de un entorno Python. Para utilizar el motor de MATLAB, debe tener una versión compatible de Python instalada en su máquina, y debe instalar la API del motor de MATLAB para Python como paquete de Python.
Verificar la configuración e instalar Python
Si tiene instalado Python, verifique que esté usando una versión compatible con el motor de MATLAB. Puede comprobar qué versión de Python tiene instalada en un sistema Windows® introduciendo python -V en la línea de comandos de su sistema operativo. En sistemas Linux® o macOS, utilice python3 -V en su lugar. Después, determine si su versión de Python es compatible con su versión de MATLAB consultando la página Versions of Python Compatible with MATLAB Products by Release.
Además, verifique que esté usando una versión de Python de 64 bits. Se requiere una versión de Python de 64 bits para que coincida con la arquitectura de MATLAB. Para probar si su versión de Python es de 32 bits o de 64 bits, introduzca el siguiente código en la línea de comandos de Python. Este código devuelve True si la versión es de 64 bits y False si es de 32 bits.
import sys
print(sys.maxsize > 2**32)Si no tiene instalado Python o necesita una versión distinta, consulte Configurar su sistema para utilizar Python.
Instalar la API del motor de MATLAB para Python
MATLAB proporciona diversos métodos para instalar la API del motor de MATLAB para Python. También puede utilizar una versión preinstalada de la API del motor de MATLAB para Python que se incluye en MATLAB. (desde R2026a)
Instalar desde MATLAB
Puede instalar el motor de MATLAB directamente desde MATLAB. Inicie MATLAB y ejecute los comandos siguientes.
| Sistema | Comandos de MATLAB |
|---|---|
Windows |
cd (fullfile(matlabroot,"extern","engines","python")) system("python -m pip install .") |
Linux y macOS |
cd (fullfile(matlabroot,"extern","engines","python")) system("python3 -m pip install .") |
Instalar desde el sistema operativo
De manera alternativa, puede instalar el motor de MATLAB desde la línea de comandos de su sistema operativo. En primer lugar, necesita la ruta a la carpeta que contiene la API del motor de MATLAB para Python. Para localizar esta carpeta, inicie MATLAB y escriba matlabroot en la ventana de comandos. Luego, sustituya matlabroot en los comandos siguientes con el valor de ruta que MATLAB devolvió.
Asegúrese de que dispone de privilegios suficientes para ejecutar el comando install desde la línea de comandos del sistema operativo. En Windows, si es necesario, abra la línea de comandos con la opción Run as administrator.
| Sistema | Comandos del sistema |
|---|---|
Windows |
cd "matlabroot\extern\engines\python"
python -m pip install .
|
Linux y macOS |
cd "matlabroot/extern/engines/python"
python3 -m pip install .
|
Instalar desde el índice de paquetes de Python
De manera alternativa, puede instalar el motor de MATLAB desde el índice de paquetes de Python (PyPI). A diferencia de otras opciones de instalación, no necesita navegar primero hasta la carpeta de la API del motor de MATLAB para Python.
Para instalar la versión más reciente del motor de MATLAB disponible en PyPI, ejecute este comando desde la línea de comandos de su sistema operativo:
python -m pip install matlabengine
La versión más reciente del motor de MATLAB solo es compatible con la versión más reciente de MATLAB (actualmente, la versión R2026a). No es compatible con versiones preliminares de MATLAB.
Si no dispone de la versión más reciente de MATLAB, especifique una versión del motor de MATLAB que sea compatible con su versión. Ejecute este comando desde la línea de comandos de su sistema operativo, donde n.n.n
python -m pip install matlabengine==n.n.n
Para determinar qué versión es compatible con su versión de MATLAB:
Vaya a la Página del historial de versiones de PyPI para la API del motor de MATLAB para Python.
Abra cada página de versión del motor de MATLAB y compare la versión de MATLAB que se muestra en Required MathWorks Products con su versión de MATLAB hasta que encuentre la que coincida.
Luego, puede reemplazar
n.n.n
PyPI instala el motor de MATLAB en la carpeta de paquetes predeterminada para el intérprete de Python que se utilizó para llamar al instalador del motor de MATLAB. Para instalar el motor en una carpeta no predeterminada, ejecute este comando desde la línea de comandos de su sistema operativo, donde installdir
python -m pip install --target installdir matlabengine
Para incluir installdirinstalldirPYTHONPATH.
Utilizar una versión preinstalada de la API del motor de MATLAB para Python
Desde R2026a
MATLAB incluye una versión preinstalada de la API del motor de MATLAB para Python. Esta versión preinstalada del motor está ubicada en la carpeta matlabroot/extern/engines/python/distmatlabrootmatlabroot en la ventana de comandos.
Para utilizar una versión preinstalada del motor de MATLAB, añada la carpeta matlabroot/extern/engines/python/distPYTHONPATH. De forma alternativa, puede insertarla en sys.path de Python antes de importar el motor.
Instalar en un entorno virtual
Puede instalar la API del motor de MATLAB para Python en un entorno virtual. Para obtener instrucciones detalladas sobre cómo instalar la API del motor de MATLAB para Python en un entorno virtual, consulte el artículo de MATLAB Answers™ Use the MATLAB Engine API for Python with a Virtual Environment. Para obtener información sobre los entornos virtuales de Python, consulte el tutorial de Python sobre entornos virtuales y paquetes. Debe activar el entorno virtual antes de ejecutar los comandos de instalación.
Inicie el motor de MATLAB en Python
Para importar el paquete de la API del motor de MATLAB para Python e iniciar el motor de MATLAB, ejecute estos comandos desde la línea de comandos de Python.
import matlab.engine
eng = matlab.engine.start_matlab()
Para obtener más información, consulte Iniciar y detener el motor de MATLAB para Python.
Consulte también
Temas
- Versiones de Python compatibles con los productos de MATLAB por versión
- Configurar su sistema para utilizar Python
