python调用matlab函数（内置 + 自定义） —— 安装matlab.engine

文章目录

一、简介

matlab.engine（MATLAB Engine API for Python）：是 MATLAB 提供的一个 Python 接口，允许你在 Python 环境中与 MATLAB 进行交互。通过 matlab.engine，你可以在 Python 中启动 MATLAB 引擎，调用 MATLAB 函数，传递数据，以及执行 MATLAB 脚本和命令。

主要功能：

启动 MATLAB 引擎：在 Python 中， 使用 matlab.engine.start_matlab() 启动 MATLAB 引擎，并通过该引擎执行命令。

调用 MATLAB 函数：在 Python 中，直接调用 MATLAB 的内置函数或自定义函数（.m），例如：result = eng.sqrt(16.0)

数据传递：支持在 Python 和 MATLAB 之间传递数据，包括数组、矩阵、字符串等。例如：y = eng.my_function(x=[1.0, 2.0, 3.0])

执行 MATLAB 脚本或命令： 可以通过 eng.eval("disp('Hello from MATLAB!')", nargout=0) 来执行 MATLAB 脚本或命令。

关闭 MATLAB 引擎：： 执行完任务后，使用 eng.quit() 关闭 MATLAB 引擎。

优势：

MATLAB 与 Python 的结合：可以将 Python 的优势与 MATLAB 强大的数学计算、符号计算、数据分析等功能相结合，进行更复杂的分析。

科学计算和模拟：在 MATLAB 中进行数值计算和建模，再将结果传递到 Python 中进行可视化和进一步分析。

方便的调试和交互：可以在 Python 环境中实时调试 MATLAB 代码，快速验证和测试。

多平台支持：matlab.engine 支持多种操作系统，包括 Windows、Linux 和 macOS。

二、安装matlab.engine

2.1、基于 CMD 安装

（1）打开 CMD 命令提示符，并指定 Python 环境，用于与 MATLAB 引擎绑定：若需要激活环境，则执行以下代码：conda activate py39，其中 py39 为指定的虚拟环境名称。

（2）切换到 MATLAB 安装路径下的 extern\engines\python 目录：cd D:\MATLAB2023b\MATLAB\R2023b\extern\engines\python

（3）在当前目录下创建安装目录（可选）：mkdir dist

通常 setup.py 会自动创建 dist 目录，若没有，则需要手动创建以避免错误。

备注：可以在查看 MATLAB 安装目录时，确认是否存在 dist 目录而决定。

（4）开始安装

最经典方法（已弃用，但仍可使用）：python setup.py install。系统将警告提示：SetuptoolsDeprecationWarning: setup.py install is deprecated.

使用 pip 安装（最新方法）：python -m pip install .。该命令将从当前目录安装，而 setup.py 文件通常会在同一目录下。

如果遇到权限问题，使用 –user 参数安装到用户本地目录，而不是全局安装：python setup.py install --user

2.2、基于 MATLAB 安装（不建议）

打开 MATLAB 命令窗口，输入以下命令来安装：

cd (fullfile(matlabroot,'extern','engines','python'))
system('python setup.py install')

报错提示：若返回 9009 ，表明命令未成功运行。

原因分析：由于命令行找不到 python 或者路径配置有问题。—— 当 system 调用 python 命令时，MATLAB 依赖系统环境变量 PATH 来定位 Python。如果 Python 没有被正确添加到环境变量中，会导致找不到 python 命令，从而报错。

解决方法：将 setup.py 替换为 MATLAB 安装目录

三、python调用matlab函数（内置 + 自定义）

一文读懂如何用python调用matlab函数（windows环境）

启动和关闭 MATLAB 引擎是一个较为耗时的操作，若需要频繁调用MATLAB函数，可以将启动 MATLAB 引擎提取到外部函数中，以实现只启动一次。

import matlab.engine

eng = matlab.engine.start_matlab()  # 启动 MATLAB 引擎
#########################################################################################
print("调用 MATLAB 版本号: ", eng.version())  # 获取 MATLAB 版本号
print("调用 MATLAB 内置函数: ", eng.sqrt(4.0))
print("调用 MATLAB 脚本文件(.m): ", eng.count(1.0, 2.0))
#########################################################################################
eng.quit()  # 关闭 MATLAB 引擎

"""
     3

调用 MATLAB 版本号:  23.2.0.2365128 (R2023b)
调用 MATLAB 内置函数:  2.0
调用 MATLAB 脚本文件(.m):  3.0
"""

function a = count(c, d)
    % 输入参数: c 和 d
    % 输出参数: a
    
    a = c + d;  % 函数执行功能
    disp(a);    % 显示输出结果
end

作者：胖墩会武术