Chapter1 Introduction

1.1 指南目的

MathWorks咨询委员会（MAB）指南规定了Simulink和Stateflow建模的重要基本规则。这些建模指南的总体目的是让建模者和控制系统模型的使用者能够简单、共同地理解。

指南的主要目标是：

• 可读性
 提高图形可理解性
 提高功能分析的可读性
 防止连接错误
 注释等

• 仿真和验证
 启用仿真的机制
 可测试性

• 代码生成
 提高代码生成的效率（ROM、RAM 效率）
 确保生成的代码的鲁棒性

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

---

本文档的各章节提供以下信息：

第1章 - 这些指南的目的以及指南模板的概述。
第2章至第5章 - 指南规则
第6章 - 术语表
第7章 - 评估和实施指南的项目流程
第8章 - 高级用户所需的模型架构和操作。
第9章 - 有关Simulink/Stateflow功能的额外解释和建模信息，包括建模模式。

1.2 指南模板

指南通过使用标准模板进行记录。建议在创建原始指南时使用此模板。
注：此模板指定了理解指南所需的最低要求。只要不重复现有信息，就可以向模板添加新项。

Rule ID 规则ID
用于识别指南的规则ID由两个小写字母和一个四位数字组成。字母和数字的组合以下划线分隔。例如，xx_nnnn。Rule ID是永久的，不会更改。
注：规则ID中的两个字母标识指南作者。db、jm、hd、ar用于Ver 1.0的指南。na和jc用于从Ver 2.0到现在创建的指南。

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

MATLAB® Versions
MAB指南支持所有版本的MATLAB和Simulink产品。当一个规则仅适用于特定版本时，通过MATLAB版本字段中的以下格式进行标识：

• All - 所有版本的MATLAB
• RX，RY，RZ - MATLAB的特定版本
• RX及更早版本 - 直到RX版本的MATLAB版本
• RX及以后版本 - 从RX版本到当前版本的MATLAB版本
• RX到RY - 在RX和RY之间的MATLAB版本

Sub ID 子ID
指定规则的条件。每个规则ID可以有多个子ID，这些子ID被指定为以下之一：
• 可选择的 - 由一个小写字母组成（按字母顺序）。是否采用可选择的子ID取决于用户。
• 互斥的 - 由一个小写字母（按字母顺序）和一个单个数字组成。在选择接受或拒绝互斥的子ID时，只能选择一个选项。
举个栗子：

> xy_0000 → xy_0000a 可选择的（用户选择）
> 	 	  → xy_0000b1 互斥的（如果使用，从xy_0000b1或xy_0000b2中选择）
>         → xy_0000b2 互斥的（如果使用，从xy_0000b1或xy_0000b2中选择）

Title 标题
标题是唯一的，并提供了对指南的简要描述。

Description 描述
描述使用图表提供指南规则的详细信息。
本表识别了描述中使用的字符

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

Rational 理由

理由提供了关于使用指南的原因，涉及可读性、验证效率、代码生成后代码效率等方面的推理。

See Also 另请参阅
此可选部分仅适用于具有额外参考信息的指南，这些信息可能有助于更好地理解指南。

---

返回目录：MAB规范（1）：概览介绍