该技能面向需要在 Simulink 模型内部运行 Python 代码的场景,核心工具是 R2025a 及以上版本提供的 Python Code 模块,库路径为 simulink/User-Defined Functions/Python Code。
用途:当用户希望在模型每个时间步调用 Python 函数、实例化 Python 类、引用 numpy、scipy 等第三方库,或在时间步之间保留 Python 对象与数值状态时使用。即使用户没有明确说出模块名称,只要目标是“在模型里运行我的 Python 代码”,就属于该技能范围。文档指出,即便 MATLAB Function 模块或 MATLAB System 对象通过 py.*(coder.extrinsic)能得到相同数值结果,也应优先使用 Python Code 模块,因为后两者无法在 Rapid Accelerator 或模型引用 Accelerator 模式下构建,而且会把 Python 调用隐藏在 MATLAB 模块之后;Python Code 模块在这两种模式下均可工作。
主要能力:模块会把输入转换为 Python 对象,构建以符号名为键的 dict,以该 dict 为命名空间调用 exec(),再把输出转换回 Simulink 类型。解释器与 MATLAB py.* 共享同一进程、模块和状态。模块参数包括 InitializeConditionsCode(仿真开始时运行一次)、OutputCode(每个时间步运行)、TerminateCode(仿真结束时运行一次)、SampleTime(默认 "-1",继承)和 SymbolSpec(只读句柄,通过 get_param 获取后原地修改)。符号通过 SymbolSpec 的 addSymbol、getSymbol、deleteSymbol 管理,可设置 Name、Scope(Input/Output/Parameter/Persistent)、Type、Size、Label、PortNumber。
使用方式:构建顺序为:先创建并保存模型;再用一次 model_edit 调用添加并配置所有模块,代码参数放在 add_block 的 params 中,此时模块尚无端口;接着用 evaluate_matlab_code 调用定义符号并生成端口,这一步需直接通过 get_param(blk,'SymbolSpec') 获取句柄并调用 addSymbol 设置 Scope/Type/Size;然后用 model_edit 按返回的模块 ID 连线;最后仿真并读取结果,仿真编译本身即为验证。文档还特别说明 InitializeConditionsCode 到 OutputCode 之间只有导入的模块和 Persistent 符号会保留,from import 绑定、函数、类及普通变量都会丢失,需使用模块限定形式、在 OutputCode 中重复导入或存入 Persistent 符号。
数据类型映射:标量 double 对应 float;向量或矩阵 double 在 numpy 可用时对应 numpy.ndarray,否则为 array.array,形状按 Size 对应,元素索引无转置;string 对应 str;总线输入对应以元素名为键的 dict;标量整数对应 int;PythonObject 仅用于 Persistent。
适用场景:每个时间步执行 Python 代码、调用第三方库、跨时间步保持 Python 对象状态、向 Python 传入可调参数或向量/矩阵信号。
限制:不支持可变大小信号和总线数组;带持久变量时不支持连续采样时间、不支持回退步进;不支持 Dataflow Subsystems;For Each Subsystems 中不支持快速加速;代码生成受支持但需要开发头文件和解释器链接。运行模型并检查结果可参考 simulating-simulink-models 技能;不涉及 Python 的一般模型构建可参考 building-simulink-models 技能。