Python控制Simulink提取MATLAB工作区变量报错的解决方法

错误原因 #

你直接用self.eng.workspace['out.simout']的写法，MATLAB会将整个字符串out.simout视为一个完整的变量名去工作区查找，但实际工作区中只有名为out的结构体变量，simout是该结构体的字段，这种嵌套的点号写法不符合MATLAB的变量访问规则，因此触发ValueError: variable name is not valid in MATLAB错误。

修正方案 #

需要分两步访问：先获取工作区中的out结构体，再通过字段名访问其内部的simout和tout。

方案1：直接访问结构体字段 #

修正后的getOutput方法：

def getOutput(self):
    # 先从工作区获取out结构体
    out_struct = self.eng.workspace['out']
    # 访问结构体的simout和tout字段
    simout_S = out_struct.simout
    tout_T = out_struct.tout
    return simout_S, tout_T

方案2：使用MATLAB的getfield函数 #

也可以调用MATLAB原生的getfield函数来访问结构体字段：

def getOutput(self):
    simout_S = self.eng.getfield(self.eng.workspace['out'], 'simout')
    tout_T = self.eng.getfield(self.eng.workspace['out'], 'tout')
    return simout_S, tout_T

完整仿真控制示例 #

以下是包含模型设置、仿真运行、结果提取的完整代码：

import matlab.engine
import numpy as np

class SimulinkController:
    def __init__(self):
        # 启动MATLAB引擎
        self.eng = matlab.engine.start_matlab()
    
    def setup_sim_params(self):
        # 设置Constant模块输入值为1
        self.eng.set_param('ToyExample_V2/Constant', 'Value', '1', nargout=0)
        # 设置仿真停止时间为10秒，固定步长0.1
        self.eng.set_param('ToyExample_V2', 'StopTime', '10', nargout=0)
        self.eng.set_param('ToyExample_V2', 'FixedStep', '0.1', nargout=0)
    
    def run_simulation(self):
        # 运行仿真并将结果保存到工作区的out变量中
        self.eng.sim('ToyExample_V2', 'ReturnWorkspaceOutputs', 'on', nargout=0)
    
    def getOutput(self):
        out_struct = self.eng.workspace['out']
        simout_S = out_struct.simout
        tout_T = out_struct.tout
        # 转换为NumPy数组方便Python处理
        return np.array(simout_S), np.array(tout_T)
    
    def close_engine(self):
        # 关闭MATLAB引擎
        self.eng.quit()

# 使用示例
if __name__ == '__main__':
    controller = SimulinkController()
    controller.setup_sim_params()
    controller.run_simulation()
    simout, tout = controller.getOutput()
    
    print("仿真时间步：")
    print(tout)
    print("\n仿真输出结果：")
    print(simout)
    
    controller.close_engine()

注意事项 #

• 调用MATLAB引擎的set_param、sim等无返回值函数时，必须指定nargout=0，否则会引发参数不匹配的错误。
• MATLAB返回的数组可以转换为NumPy数组，便于在Python中进行后续的数据处理和分析。

内容的提问来源于stack exchange，提问作者bleed_bits