Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

安装用于 PythonMATLAB 引擎 API

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

每个 MATLAB 版本都有一个 Python setup.py 包。当您使用该包时,它将运行指定的 MATLAB 版本。要在 MATLAB 版本之间切换,您需要在 Python 包之间切换。有关详细信息,请参阅安装支持的 Python 实现

验证您的配置

在安装之前,确认您的 Python 和 MATLAB 配置。

  • 检查您的系统是否具有受支持的 Python 版本和 MATLAB R2014b 或更新版本。有关详细信息,请参阅 MATLAB 产品(按版本)所支持的 Python 版本

  • 要检查您的系统上是否已安装 Python,请在操作系统提示符下运行 Python。

  • 将包含 Python 解释器的文件夹添加到您的路径(如果尚未在该路径中)。

  • 找到 MATLAB 文件夹的路径。启动 MATLAB,并在命令行窗口中键入 matlabroot。复制 matlabroot 所返回的路径。

安装引擎 API

要安装引擎 API,请选择以下选项之一。您必须在指定的文件夹中调用此 python 安装命令。

  • 在 Windows 操作系统提示符下(您可能需要管理员特权才能执行这些命令)-

    cd "matlabroot\extern\engines\python"
    python setup.py install
    
  • macOS 或 Linux 操作系统提示符下(您可能需要管理员特权才能执行这些命令)-

    cd "matlabroot/extern/engines/python"
    python setup.py install
    
  • 在 MATLAB 命令提示符下 -

    cd (fullfile(matlabroot,'extern','engines','python'))
    system('python setup.py install')
  • 使用在非默认位置安装用于 Python 的 MATLAB 引擎 API 中所述的非默认选项之一。

启动 MATLAB 引擎

启动 Python,导入模块,然后启动 MATLAB 引擎:

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

为多个 MATLAB 版本安装 Python 引擎

通过将 MATLAB Python 包安装到特定于版本的位置,可以从 Python 脚本指定要运行的 MATLAB 版本。例如,假设您要从 Python 版本 3.6 脚本中调用 MATLAB R2019a 或 R2019b。

从 Windows 系统提示符下,将 R2019a 包安装在名为 matlab19aPy36 的子文件夹中:

cd "c:\Program Files\MATLAB\R2019a\extern\engines\python" 
python setup.py install --prefix="c:\work\matlab19aPy36"

将 R2019b 包安装在 matlab19bPy36 子文件夹中:

cd "c:\Program Files\MATLAB\R2019b\extern\engines\python" 
python setup.py install --prefix="c:\work\matlab19bPy36"

从 Linux 系统提示符下:

cd "/usr/local/MATLAB/R2019a/bin/matlab/extern/engines/python"
python setup.py install --prefix="/local/work/matlab19aPy36"
cd "/usr/local/MATLAB/R2019b/bin/matlab/extern/engines/python"
python setup.py install --prefix="/local/work/matlab19bPy36"

Mac 终端:

cd "/Applications/MATLAB_R2019a.app/extern/engines/python"
python setup.py install --prefix="/local/work/matlab19aPy36"
cd "/Applications/MATLAB_R2019b.app/extern/engines/python"
python setup.py install --prefix="/local/work/matlab19bPy36"

启动特定 MATLAB 引擎版本

要启动特定版本的 MATLAB 引擎,请将 PYTHONPATH 环境变量设置为包的位置。以下代码假设您使用了上一节中显示的设置。要将 Windows 上的 PYTHONPATH 设置为调用 MATLAB R2019b,请键入:

sys.path.append("c:\work\matlab19bPy36")

在 Linux 或 Mac 上:

sys.path.append("/local/work/matlab19bPy36")

要检查导入了哪个版本的 MATLAB,请在 Python 中键入:

import matlab
print(matlab.__file__)

用于 PythonMATLAB 引擎 API 安装故障排除

  • 请确保您的 MATLAB 版本支持您的 Python 版本。请参阅 MATLAB 产品(按版本)所支持的 Python 版本

  • 您必须从指定的 MATLAB 文件夹中运行 Python 安装命令。请参阅 安装引擎 API

    python setup.py install
    
  • 确保您有管理员特权以从操作系统提示符执行安装命令。在 Windows 上,使用 以管理员身份运行 选项打开命令提示符。

  • 安装程序将引擎安装在默认的 Python 文件夹中。要使用非默认位置,请参阅在非默认位置安装用于 Python 的 MATLAB 引擎 API

  • 如果您将包安装在非默认文件夹中,请确保设置 PYTHONPATH 环境变量。例如,假设您使用了以下安装命令:

    python setup.py install --prefix=" matlab19bPy36"
    

    在 Python 中,使用以下命令更新 PYTHONPATH

    sys.path.append("matlab19bPy36")

相关主题

外部网站