主要内容

安装用于 PythonMATLAB Engine API

MATLAB® Engine API for Python® 允许您从 Python 环境中调用 MATLAB 函数并执行 MATLAB 命令。要使用 MATLAB 引擎,您必须在计算机上安装受支持的 Python 版本,并且必须将 MATLAB Engine API for Python 作为 Python 包安装。

验证您的配置

如果您已安装 Python,请验证您使用的是 MATLAB 引擎支持的版本。您可以通过在操作系统提示符下输入 python -V 来检查已安装的 Python 的具体版本。然后通过检查 MATLAB 产品(按版本)兼容的 Python 版本页来确定您的 Python 版本是否与您的 MATLAB 版本兼容。

此外,请验证您使用的是 64 位版本的 Python。64 位版本的 Python 是匹配 MATLAB 架构所必需的。要测试您的 Python 版本是 32 位还是 64 位,请在 Python 提示符下输入以下代码。如果版本是 64 位,则以下代码返回 True,如果版本是 32 位,则返回 False

import sys 
print(sys.maxsize > 2**32)

如果您尚未安装 Python 或需要不同版本,请参阅配置您的系统使用 Python

安装 MATLAB Engine API for Python 的方法

MATLAB 提供多种安装 MATLAB Engine API for Python 的方法。

MATLAB 安装

您可以直接从 MATLAB 安装 MATLAB 引擎。启动 MATLAB 并运行以下命令。

系统MATLAB 命令

Windows®

cd (fullfile(matlabroot,"extern","engines","python"))
system("python -m pip install .")

Linux®macOS

cd (fullfile(matlabroot,"extern","engines","python"))
system("python3 -m pip install .")

从操作系统安装

您也可以从操作系统提示符安装 MATLAB 引擎。首先,您需要 MATLAB Engine API for Python 文件夹的路径。要定位此文件夹,请启动 MATLAB 并在命令行窗口中输入 matlabroot。然后用 MATLAB 返回的路径值替换以下命令中的 matlabroot

确保您有足够的特权以从操作系统提示符执行 install 命令。在 Windows 上,如有必要,使用以管理员身份运行选项打开命令提示符。

系统系统命令

Windows

cd "matlabroot\extern\engines\python"
python -m pip install .

Linux 和 macOS

cd "matlabroot/extern/engines/python"
python3 -m pip install .

Python Package Index 安装

您也可以从 Python Package Index (PyPI) 安装 MATLAB 引擎。与其他安装选项不同,您不需要先导航到 MATLAB Engine API for Python 文件夹。要从 PyPI 安装,请在操作系统提示符下运行以下命令。

python -m pip install matlabengine 
此命令安装 Python Package Index 中可用的最新版本的 MATLAB Engine API for Python。如果您没有最新版本的 MATLAB,您需要指定与您的版本兼容的 MATLAB 引擎的版本。您可以通过使用 MATLAB Engine API for Python 的 PyPI 页来确定兼容的 MATLAB 引擎的版本:从 Release history 选项卡中,查看每个 MATLAB 引擎版本的 Required MathWorks Products 部分。

在哪里安装 MATLAB Engine API for Python

您可以从 MATLAB、操作系统或 Python Package Index 安装,并且可以安装到 Python 解释器下的默认位置、另一个非默认位置或虚拟环境中。默认情况下,安装程序将在 matlabroot/extern/engines/python 文件夹中编译 MATLAB Engine API for Python。然后,安装程序将 MATLAB 引擎安装在默认的 Python 文件夹中。如果您使用从 MATLAB 安装从操作系统安装从 Python Package Index 安装部分中的安装方法,则 MATLAB 引擎将编译并安装到默认位置。

使用 setup.py 在非默认文件夹中安装

如果您没有默认安装文件夹的写入权限或希望将 MATLAB 引擎安装在不同文件夹中,您可以指定不同位置。

要在非默认文件夹 builddir 中编译并安装引擎,请从操作系统提示符运行以下命令。

cd "matlabroot/extern/engines/python"
python setup.py build --build-base="builddir"
要将 builddir 包含在 Python 包的搜索路径中,请将 builddir 添加到 PYTHONPATH 环境变量中。

使用 Python Package Index 在非默认文件夹中安装

要在非默认文件夹 installdir 中安装引擎,请从操作系统提示符运行以下命令。此安装方法使用 Python Package Index。

python -m pip install --target installdir matlabengine

要将 installdir 包含在 Python 包的搜索路径中,请将 installdir 添加到 PYTHONPATH 环境变量中。

在虚拟环境中安装

您可以在虚拟环境中安装 MATLAB Engine API for Python。有关在虚拟环境中安装 MATLAB Engine API for Python 的详细说明,请参阅 MATLAB Answers™ 文章在虚拟环境中使用 MATLAB Engine API for Python。有关虚拟 Python 环境的信息,请参阅 Python 教程虚拟环境和包。在运行安装命令之前,您必须激活虚拟环境。

Python 中启动 MATLAB 引擎

要导入 MATLAB Engine API for Python 包并启动 MATLAB 引擎,请从 Python 提示符运行以下命令。

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

有关详细信息,请参阅启动和停止用于 Python 的 MATLAB 引擎

另请参阅

主题

外部网站