文档

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

用于 Python 的 MATLAB API

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

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

MATLAB 函数

全部展开

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 包形式的引擎 API。MATLAB 提供了标准的 Python setup.py 文件,用于通过 distutils 模块编译和安装引擎。您可以使用相同的 setup.py 命令在 Windows®Mac 或 Linux® 系统上编译和安装引擎。

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

默认情况下,安装程序将在 matlabroot\extern\engines\python 文件夹构建用于 Python 的引擎 API。安装程序将引擎安装在默认的 Python 文件夹中。

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

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

Connect Python to Running MATLAB Session

How to connect the MATLAB Engine for Python to a shared MATLAB session that is already running on your local machine.

通过 Python 调用 MATLAB 函数

如何从 MATLAB 函数返回输出参数。如何从函数读取多个输出。当 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.

通过 Python 调用用户脚本和函数

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

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.

Use MATLAB Engine Workspace in Python

This example shows how to add variables to the MATLAB engine workspace in 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.

Use MATLAB Arrays in Python

This example shows how to create a MATLAB array in Python and pass it as the input argument to the MATLAB sqrt function.

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.

Get Help for MATLAB Functions from Python

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

概念

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

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

System Requirements for MATLAB Engine API for Python

What you need to write and build MATLAB engine applications.

从 Python 将数据传递到 MATLAB

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

Handle Data Returned from MATLAB to Python

When MATLAB functions return output arguments, the MATLAB Engine API for Python converts the data into equivalent Python data types.

MATLAB Arrays as Python Variables

The matlab Python package provides array classes to represent arrays of MATLAB numeric types as Python variables so that MATLAB arrays can be passed between Python and MATLAB.

Default Numeric Types in MATLAB and Python

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

疑难解答

Limitations to MATLAB Engine API for Python

The engine cannot start or connect to MATLAB on a remote machine.

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.

相关信息

此主题对您有帮助吗?