规范和模板的目的

MathWorks® 咨询委员会 (MAB) 规范规定了在 Simulink® 和 Stateflow® 中建模的重要基本规则。这些建模规范的总体目的是让控制系统模型的建模者和使用方能实现简单、共同的理解。

这些规范的主要目标是：

  • 可读性

    • 提高图形的可理解性

    • 提高功能分析的可读性

    • 防止连接错误

    • 注释等

  • 仿真与验证

    • 实现仿真的机制

    • 可测试性

  • 代码生成

    • 提高代码生成的效率（ROM、RAM 效率）

    • 确保生成代码的稳健性

注意

模型运行时错误和无法实施的建议不在这些规则的范围内。

规范是使用标准模板记录的。在创建原始规范时建议使用此模板。

注意

此模板指定了理解规范所需的最低要求。只要与现有信息不重复，就可以将新项目添加到模板中。

章节标题格式章节描述
规则 ID：标题XX_nnnn:规范的标题（唯一、简短）

规则 ID 用于标识规范，由两个小写字母和一个四位数字组成。字母和数字组合用下划线分隔。例如 xx_nnnn。规则 ID 是永久的，不会改变。

注意

规则 ID 中的两个字母标识规范的作者。

子 ID 建议

NA-MAAB：x、y、z

JMAAB：x、y、z

指定 NA-MAAB（北美MathWorks 汽车咨询委员会）和 JMAAB（日本MathWorks 汽车咨询委员会）建模标准组织推荐使用的规范子 ID。每个组织都是汽车原始设备制造商和供应商的特定区域联盟；NA-MAAB 代表北美和欧洲。JMAAB 代表日本。

MATLAB® 版本全部
RX、RY、RZ
RX 及更早版本
RX 及更高版本
RX 到 RY

MAB 规范支持所有版本的 MATLAB 和 Simulink 产品。当规则仅适用于特定版本时，将使用以下格式之一在 MATLAB 版本字段中标识该版本：

  • 全部 - MATLAB 的所有版本

  • RX、RY、RZ - MATLAB 的特定版本

  • RX 及更早版本 - RX 及之前的所有 MATLAB 版本

  • RX 及更高版本 - 从 RX 到当前最新的所有 MATLAB 版本

  • RX 到 RY - 从 RX 到 RY 的所有 MATLAB 版本

规则 > 子 ID

使用子 ID 指定规则的条件。每个规则 ID 可以有多个子 ID。

子 ID 的子部分包括：

  • 自定义参数

  • （可选）例外

  • （可选）示例

指定规则的条件。子 ID 指定为：

  • 可选 - 由一个小写字母组成（按字母顺序排列）。是否采用可选子 ID 的选择权留给用户。

  • 互斥 - 由一个小写字母（按字母顺序排列）和一个单个数字组成。在选择接受或拒绝一个互斥的子 ID 时，只能选择一个选项。

例如，规范 xy_0000 的子 ID 为：

  • xy_0000a - 表示可选（用户的选择）选项

  • xy_0000b1

    xy_0000b2

    - 互斥（如果使用，请从 xy_0000b1 或 xy_0000b2 中做出选择）

对于包含自定义参数的规则，所选值是针对所描述项特定的。描述字段中提供了对象和值的示例。然而，在指定自定义参数时，应该综合评估工程的流程、控制目标的状况以及工程师的技能水平。

理由子 ID 的动机

从可读性、验证效率、代码生成后的代码效率等方面对该规范的使用提供了理由。

验证

验证方法

验证模型是否符合规范条件的方法，例如：

  • 模型顾问检查

  • 人工验证方法

上次更改R<年份>包含规范的最新更新的 MATLAB 修订版。例如，R2020a。
另请参阅参考资料

有助于更好地理解该规范的附加信息。