matlab.engine.connect_matlab

Connect shared MATLAB session to MATLAB Engine for Python

collapse all in page

Syntax

eng = matlab.engine.connect_matlab(name=None)
eng = matlab.engine.connect_matlab(___,async)

Description

example

eng = matlab.engine.connect_matlab(name=None) connects to the shared MATLAB® session, name, and returns a MatlabEngine object as eng. The input argument name specifies the name of a MATLAB session that is already running on your local machine.

  • If you specify name and the engine cannot find a shared MATLAB session of the same name, then you receive an EngineError exception.

  • If you do not specify name and the engine cannot find any shared MATLAB sessions, then it starts a new shared MATLAB session. If there are shared MATLAB sessions running, the engine connects to the first available session.

  • If you do not specify name and the engine finds multiple shared MATLAB sessions running, then it connects to the first available session.

eng = matlab.engine.connect_matlab(___,async) connects asynchronously if async is True.

Examples

collapse all

Connect to a shared MATLAB session that is already running on your local machine.

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

2.0

matlab.engine.connect_matlab connects to the first available shared MATLAB session. If no MATLAB sessions are shared, matlab.engine.connect_matlab starts a new session.

When there are multiple shared MATLAB sessions on your local machine, connect to two different sessions one at a time by specifying their names.

Connect to the first shared MATLAB session.

import matlab.engine
names = matlab.engine.find_matlab()
names

('MATLAB_6830', 'MATLAB_7090')

Connect to the second shared MATLAB session.

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

2.0

Input Arguments

collapse all

Name of the shared MATLAB session, specified as a character array.

Start MATLAB synchronously or asynchronously, specified as a logical keyword argument.

Example: matlab.engine.start_matlab(async=True)

Output Arguments

collapse all

Python variable for communicating with MATLAB, returned as a MatlabEngine object. eng communicates with a shared MATLAB session that is already running on your local machine

Limitations

  • Do not connect the engine multiple times to the same shared MATLAB session.

See Also

|

Topics

Introduced in R2015b

Was this topic helpful?
MATLAB Documentation
Support