exponenta event banner

matlab.engine.connect_matlab

Подключение общего сеанса MATLAB к модулю MATLAB для Python

Описание

пример

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 ® версии 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