Contenido principal

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

Si ya 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 introduciendo python -V en el cuadro de diálogo de su sistema operativo. 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 todavía no tiene instalado Python o necesita una versión distinta, consulte Configurar su sistema para utilizar Python.

Formas de instalar la API del motor de MATLAB para Python

MATLAB proporciona diversos métodos para instalar la API del motor de MATLAB para Python.

Instalar desde MATLAB

Puede instalar el motor de MATLAB directamente desde MATLAB. Inicie MATLAB y ejecute los comandos siguientes.

SistemaComandos 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 el cuadro de diálogo 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 el cuadro de diálogo del sistema operativo. En Windows, si es necesario, abra la línea de comandos con la opción Run as administrator.

SistemaComandos 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 desde PyPi, ejecute este comando en el cuadro de diálogo de su sistema operativo.

python -m pip install matlabengine 
Este comando instala la versión más reciente de la API del motor de MATLAB para Python que está disponible en el índice de paquetes de Python. Si no dispone de la versión más reciente de MATLAB, debe especificar una versión del motor de MATLAB que sea compatible con su versión. Puede determinar una versión compatible del motor de MATLAB usando PyPI page for MATLAB Engine API for Python: Desde la pestaña del historial de versiones, revise la sección Required MathWorks Products para cada versión del motor de MATLAB.

Dónde instalar la API del motor de MATLAB para Python

Puede instalar desde MATLAB, el sistema operativo o el índice de paquetes de Python, y puede instalar en la ubicación predeterminada en su intérprete Python, otra ubicación no predeterminada o un entorno virtual. De forma predeterminada, el instalador crea la API del motor de MATLAB para Python en la carpeta matlabroot/extern/engines/python. Luego el instalador instala el motor de MATLAB en la carpeta predeterminada Python. Si utiliza los métodos de instalación de las secciones Instalar desde MATLAB, Instalar desde el sistema operativo o Instalar desde el índice de paquetes de Python, el motor de MATLAB crea e instala en las ubicaciones predeterminadas.

Instalar en una carpeta no predeterminada usando setup.py

Si no tiene permiso de escritura para la carpeta de instalación predeterminada o desea instalar el motor de MATLAB en una carpeta distinta, puede especificar una ubicación diferente.

Para crear e instalar el motor en una carpeta no predeterminada builddir, ejecute estos comandos desde el cuadro de diálogo de su sistema operativo.

cd "matlabroot/extern/engines/python"
python setup.py build --build-base="builddir"
Para incluir builddir en la ruta de búsqueda para los paquetes de Python, añada builddir en la variable de entorno PYTHONPATH.

Instalar en una carpeta no predeterminada usando el índice de paquetes de Python

Para instalar el motor en una carpeta no predeterminada installdir, ejecute este comando desde el cuadro de diálogo de su sistema operativo. Este método de instalación utiliza el índice de paquetes de Python.

python -m pip install --target installdir matlabengine

Para incluir installdir en la ruta de búsqueda para paquetes de Python, añada installdir a la variable de entorno PYTHONPATH.

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 el cuadro de diálogo 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

Sitios web externos