Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

matlab.engine.start_matlab

启动用于 PythonMATLAB 引擎

说明

示例

eng = matlab.engine.start_matlab() 启动一个新 MATLAB® 进程,并返回 Python® 变量 eng,它是用于与 MATLAB 进程通信的 MatlabEngine 对象。

如果无法启动 MATLAB,引擎将引发 EngineError 异常。

示例

eng = matlab.engine.start_matlab(option) 使用 option 指定的启动选项。

例如,调用 matlab.engine.start_matlab('-desktop') 以从 Python 启动 MATLAB 桌面。

示例

如果 backgroundTrue,则 eng = matlab.engine.start_matlab(background) 会异步启动 MATLAB。

如果 asyncTrue,则 eng = matlab.engine.start_matlab(async) 会异步启动 MATLAB。不推荐。请改用 background 参数。请不要用于 Python 版本 3.7 或更高版本。有关详细信息,请参阅兼容性考虑

示例

eng = matlab.engine.start_matlab(___) 可以包括先前语法中的任何输入参数。

示例

全部折叠

从 Python 命令行启动引擎和新 MATLAB 进程。

import matlab.engine
eng = matlab.engine.start_matlab()

从每个引擎启动一个不同的 MATLAB 进程。

import matlab.engine
eng1 = matlab.engine.start_matlab()
eng2 = matlab.engine.start_matlab()

随引擎启动 MATLAB 桌面。

import matlab.engine
eng = matlab.engine.start_matlab("-desktop")

您也可以在启动引擎后启动桌面。

import matlab.engine
eng = matlab.engine.start_matlab()
eng.desktop(nargout=0)

注意

从桌面和 Python 都可以调用 MATLAB 函数。

使用 background=True 启动引擎。在 MATLAB 启动时,您可以在 Python 命令行中输入命令。

import matlab.engine
future = matlab.engine.start_matlab(background=True)
eng = future.result()
eng.sqrt(4.)
2.0

输入参数

全部折叠

MATLAB 进程的启动选项,指定为字符串。您可以指定多个启动选项。该引擎支持所有 MATLAB 启动选项,但局限性中列出的选项除外。有关选项列表,请参阅特定于平台的命令 matlab (Windows)matlab (macOS)matlab (Linux)

要启动 MATLAB 桌面,请使用 '-desktop' 选项。

示例: matlab.engine.start_matlab('-desktop -r "format short"') 从 Python 启动桌面。引擎会将 '-r "format short"' 传递给 MATLAB。

同步或异步启动 MATLAB,指定为逻辑关键字参数。backgroundasync 的别名。

示例: matlab.engine.start_matlab(background=True)

同步或异步启动 MATLAB,指定为逻辑关键字参数。不推荐。请改用 background 参数。有关详细信息,请参阅兼容性考虑

输出参数

全部折叠

用于与 MATLAB 通信的 Python 变量,如果 asyncbackground 设置为 False,则以 MatlabEngine 对象形式返回;如果 asyncbackground 设置为 True,则以 FutureResult 对象形式返回。

每次您调用 matlab.engine.start_matlab 时,它都会启动一个新 MATLAB 进程。

局限性

该引擎不支持下列 MATLAB 启动选项:

  • -h

  • -help

  • -?

  • -n

  • -e

  • -softwareopengl

  • -logfile

版本历史记录

在 R2014b 中推出

全部展开