matlab.engine.start_matlab

启动 MATLAB Engine for Python

全页折叠

语法

eng = matlab.engine.start_matlab()
eng = matlab.engine.start_matlab(option)
eng = matlab.engine.start_matlab(background)
eng = matlab.engine.start_matlab(async)
eng = matlab.engine.start_matlab(___)

说明

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 桌面。

示例

如果 background 为 True，则 eng = matlab.engine.start_matlab(background) 会异步启动 MATLAB。

示例

如果 async 为 True，则 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，指定为逻辑关键字参量。background 是 async 的别名。

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

同步或异步启动 MATLAB，指定为逻辑关键字参量。不推荐。请改用 background 参量。有关详细信息，请参阅版本历史记录。

输出参量

全部折叠

用于与 MATLAB 通信的 Python 变量，如果 async 或 background 设置为 False，则以 MatlabEngine 对象形式返回；如果 async 或 background 设置为 True，则以 FutureResult 对象形式返回。

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

限制

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

  • -h

  • -help

  • -?

  • -n

  • -e

  • -logfile

有关 MATLAB 启动选项的信息，请参阅常用启动选项。

版本历史记录

在 R2014b 中推出

全部展开

另请参阅

| |

主题