安装用于 Python 的 MATLAB 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
在哪里安装 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 引擎。