本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

用于 Python 的 MATLAB API

编写可用于 MATLAB® 的 Python® 程序

用于 Python 的 MATLAB 引擎 API 可提供一个包,供 Python 将 MATLAB 作为计算引擎来调用。该引擎支持 Python 的参考实现 (CPython) 版本 2.7、3.5 和 3.6。

函数

全部展开

matlab.engine.start_matlabStart MATLAB Engine for Python
matlab.engine.find_matlabFind shared MATLAB sessions to connect to MATLAB Engine for Python
matlab.engine.connect_matlabConnect shared MATLAB session to MATLAB Engine for Python
matlab.engine.shareEngine将正在运行的 MATLAB 会话转换为共享会话
matlab.engine.engineName返回共享 MATLAB 会话的名称
matlab.engine.isEngineShared确定 MATLAB 会话是否共享

全部展开

matlab.engine.MatlabEnginePython object using MATLAB as computational engine within Python session
matlab.engine.FutureResultResults of asynchronous call to MATLAB function stored in Python object

主题

安装

用于 Python 的 MATLAB 引擎 API 的系统要求

编写和编译用于 Python 的 MATLAB 引擎应用程序的要求。

安装用于 Python 的 MATLAB 引擎 API

要在 Python 会话内启动 MATLAB 引擎,必须先安装 Python 包形式的引擎 API。MATLAB 提供了标准的 Python setup.py 文件,用于通过 distutils 模块编译和安装引擎。您可以使用相同的 setup.py 命令在 Windows®Mac 或 Linux® 系统上编译和安装引擎。

在非默认位置安装用于 Python 的 MATLAB 引擎 API

默认情况下,安装程序将在 matlabroot\extern\engines\python 文件夹编译用于 Python 的引擎 API。如果安装在另一个文件夹中,请更新 PYTHONPATH 变量。

快速入门

用于 Python 的 MATLAB 引擎 API 快速入门

用于 Python 的 MATLAB 引擎 API 提供了名为 matlab 的 Python 包,使您能够通过 Python 调用 MATLAB 函数。该包仅安装一次,然后您便可在当前或未来的 Python 会话中调用引擎。有关安装或启动引擎的帮助,请参阅:

启动和停止用于 Python 的 MATLAB 引擎

用以启动用于 Python 的 MATLAB 引擎的选项。

通过 Python 调用 MATLAB 函数

如何从 MATLAB 函数返回输出参数。如何从函数读取多个输出。当 MATLAB 函数没有返回输出参数时应该怎么做。

Get Help for MATLAB Functions from Python

From Python, you can access supporting documentation for all MATLAB functions.

会话管理

将 Python 连接到正在运行的 MATLAB 会话

如何将用于 Python 的 MATLAB 引擎连接到已在您的本地机器上运行的共享 MATLAB 会话。

使用 MATLAB 工作区

在 Python 中使用 MATLAB 引擎工作区

此示例说明如何在 Python 中将变量添加到 MATLAB 引擎工作区。

数据交换和映射

在 Python 中使用 MATLAB 数组

此示例说明如何在 Python 中创建 MATLAB 数组并将其作为输入参数传递给 MATLAB sqrt 函数。

MATLAB 数组作为 Python 变量

matlab Python 包提供数组类以将 MATLAB 数值类型的数组表示为 Python 变量,以便 MATLAB 数组可以在 Python 和 MATLAB 之间传递。

从 Python 将数据传递到 MATLAB

当您将 Python 数据作为输入参数传递到 MATLAB 函数时,用于 Python 的 MATLAB 引擎会将数据转换为等效的 MATLAB 数据类型。

处理从 MATLAB 返回到 Python 的数据

当 MATLAB 函数返回输出参数时,用于 Python 的 MATLAB 引擎 API 会将数据转换为等同的 Python 数据类型。

Use MATLAB Handle Objects in Python

This example shows how to create an object from a MATLAB handle class and call its methods in Python.

Default Numeric Types in MATLAB and Python

MATLAB stores all numeric values as double-precision floating point numbers by default.

调用 MATLAB 函数

从 Python 中调用用户脚本和函数

此示例显示如何通过 Python 来调用 MATLAB 脚本,以计算三角形的面积。

Sort and Plot MATLAB Data from Python

This example shows how to sort data about patients into lists of smokers and nonsmokers in Python and plot blood pressure readings for the patients with MATLAB.

Call MATLAB Functions Asynchronously from Python

This example shows how to call the MATLAB sqrt function asynchronously from Python and retrieve the square root later.

Redirect Standard Output and Error to Python

This example shows how to redirect standard output and standard error from a MATLAB function to Python StringIO objects.

疑难解答

Limitations to MATLAB Engine API for Python

Features Not Supported in MATLAB

Troubleshoot MATLAB Errors in Python

When a MATLAB function raises an error, the MATLAB Engine for Python stops the function and catches the exception raised by MATLAB.