mATLAB engine.connect_matlab

Соедините совместно использованный сеанс работы с MATLAB с MATLAB Engine для Python

Синтаксис

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

Описание

пример

eng = matlab.engine.connect_matlab(name=None) подключения к разделяемому сеансу MATLAB®, name, и возвращают объект MatlabEngine как eng. name входного параметра задает имя сеанса работы с MATLAB, который уже работает на вашей локальной машине.

  • Если вы задаете name, и механизм не может найти разделяемый сеанс работы с MATLAB того же имени, то вы получаете исключение EngineError.

  • Если вы не задаете name, и механизм не может найти разделяемые сеансы работы с MATLAB, то это запускает новый разделяемый сеанс работы с MATLAB.

  • Если вы не задаете name, и механизм находит несколько разделяемых выполнений сеансов работы с MATLAB, то это соединяется с первым созданным сеансом.

eng = matlab.engine.connect_matlab(___,background) подключения асинхронно, если background является True. Можно использовать этот синтаксис с входным параметром name в предыдущем синтаксисе.

eng = matlab.engine.connect_matlab(___,async) подключения асинхронно, если async является True. Не рекомендуемый. Используйте аргумент background вместо этого. Не используйте для Python® Version 3.7. Для получения дополнительной информации см. Вопросы совместимости.

Примеры

свернуть все

Соединитесь с разделяемым сеансом работы с MATLAB, который уже работает на вашей локальной машине.

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

matlab.engine.connect_matlab соединяется с первым созданным разделяемым сеансом работы с MATLAB. Если никакие сеансы работы с MATLAB не совместно используются, то matlab.engine.connect_matlab запускает новый сеанс.

Когда существует несколько разделяемых сеансов работы с MATLAB на вашей локальной машине, соединяются с двумя различными сеансами по одному путем определения их имен.

Соединитесь с первым созданным сеансом работы с MATLAB.

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

Соединитесь со следующим сеансом работы с MATLAB.

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

Входные параметры

свернуть все

Имя разделяемого сеанса работы с MATLAB, заданного как символьный массив.

Соединитесь с MATLAB синхронно или асинхронно, заданные в качестве логического аргумента ключевого слова.

Пример: matlab.engine.connect_matlab(background=True)

Соединитесь с MATLAB синхронно или асинхронно, заданные в качестве логического аргумента ключевого слова.

Выходные аргументы

свернуть все

Переменная Python для связи с MATLAB, возвращенным как объект MatlabEngine. eng связывается с разделяемым сеансом работы с MATLAB, который уже работает на вашей локальной машине

Ограничения

  • Не соединяйте механизм многократно с тем же разделяемым сеансом работы с MATLAB.

Вопросы совместимости

развернуть все

Введенный в R2015b

Для просмотра документации необходимо авторизоваться на сайте