一、简介

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.engineeng = 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
"""

• 若调用脚本文件（自定义函数），则（.m）与（.py）必须在同一个文件夹下。
• 有趣的现象，MATLAB打印结果也会在 Python 中显示。
• 若在非绑定的 Python 环境下运行，则异常提示：ModuleNotFoundError: No module named 'matlab'

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