Main Content

matlab.engine.connect_matlab

Conectar una sesión compartida de MATLAB al motor de MATLAB para Python

Descripción

ejemplo

eng = matlab.engine.connect_matlab(name=None) se conecta a la sesión compartida de MATLAB®, name, y devuelve un objeto MatlabEngine como eng. El argumento de entrada name especifica el nombre de una sesión de MATLAB que ya se está ejecutando en su equipo local.

  • Si especifica name y el motor no puede encontrar una sesión compartida de MATLAB con ese nombre, recibe una excepción EngineError.

  • Si no especifica name y el motor no puede encontrar ninguna sesión compartida de MATLAB, inicia una nueva sesión compartida de MATLAB.

  • Si no especifica name y el motor encuentra varias sesiones compartidas de MATLAB ejecutándose, se conecta a la primera sesión creada.

eng = matlab.engine.connect_matlab(___,background) se conecta de forma asíncrona si background es True. Puede utilizar esta sintaxis con el argumento de entrada name en la sintaxis anterior.

eng = matlab.engine.connect_matlab(___,async) se conecta de forma asíncrona si async es True. No se recomienda. En su lugar, utilice el argumento background. No lo utilice para la versión 3.7 o posterior de Python®. Para obtener más información, consulte Consideraciones sobre compatibilidad.

Ejemplos

contraer todo

Conéctese a una sesión compartida de MATLAB que ya se está ejecutando en su equipo local.

import matlab.engine
eng = matlab.engine.connect_matlab()
eng.sqrt(4.0)
2.0

matlab.engine.connect_matlab se conecta a la primera sesión compartida de MATLAB creada. Si no hay sesiones de MATLAB compartidas, matlab.engine.connect_matlab inicia una nueva sesión.

Cuando hay varias sesiones compartidas de MATLAB en su equipo local, conéctese a dos sesiones distintas, una cada vez, especificando sus nombres.

Conéctese a la primera sesión de MATLAB creada.

import matlab.engine
names = matlab.engine.find_matlab()
names
('MATLAB_6830', 'MATLAB_7090')

Conéctese a la siguiente sesión de MATLAB.

eng = matlab.engine.connect_matlab('MATLAB_7090')
eng.sqrt(4.0)
2.0

Argumentos de entrada

contraer todo

Nombre de la sesión compartida de MATLAB, especificado como arreglo de caracteres. El nombre debe ser un nombre de variable de MATLAB válido.

Conectarse a MATLAB de forma síncrona o asíncrona, especificado como argumento de palabra clave lógica.

Ejemplo: matlab.engine.connect_matlab(background=True)

Conectarse a MATLAB de forma síncrona o asíncrona, especificado como argumento de palabra clave lógica. No se recomienda. En su lugar, utilice el argumento background. Para obtener más información, consulte Compatibility Considerations.

Argumentos de salida

contraer todo

Variable de Python para comunicación con MATLAB, devuelta como objeto MatlabEngine. eng se comunica con una sesión compartida de MATLAB que ya se está ejecutando en su equipo local.

Limitaciones

  • No conecte el motor varias veces a la misma sesión compartida de MATLAB.

Historial de versiones

Introducido en R2015b

expandir todo