MatlabSimulinkStateflow控制算法建模规范中文

Matlab/Simulink/Stateflow 控制算法建模规范

3.0 版

Mathworks 汽车咨询委员会

（MAAB）

1 修订历史

日期修订

2001.02.04 初始版本 1.0 版发布

2007.04.27 更新版本 2.0 版发布

2011.07.30 更新版本 3.0 版发布

2012.08.31 更新版本 4.0 版发布

2介绍

2.1 动机

MAAB建模规范无论是在组织内部还是在与合作伙伴和分包商合

作时都是项目成功与团队协作的重要基础。遵守建模规范是实现以下目标的重要前提：无问题的系统集成

明确定义的界面

统一的模型外观、编码及文件编制

可重用模型

可读的模型

无问题的模型交换

简单高效的过程

专业的文件编制

清晰易懂的展示

快速的软件变更

与分包商的合作

将研究或重建项目移交给产品开发

2.2 对

3.0 版的批注

本规范的现行版本 3.0 版支持 MATLAB算法，包括其R2007b 至R2011b版。3.0 版参考了《美国国家航空航天局猎户座指南》中的部

分规则。参考的规则均在“参见”部分中标明了该规则在《美国国家

航空航天局猎户座指南》中的编号。

2.3 规范模板

规范描述采用下列模板出具。建议想要附加其他规范的公司也采

用下列模板进行添加。

ID：标题XX_nnnn: 规范的标题( 须唯一且简短)

优先级强制要求/ 强烈建议/ 建议之一

适用范围MAAB, NA-MAAB, J-MAAB，特定公司( 本地公司可

选使用 )

MATLAB版本全部

RX, RY, RZ

RX及其之前的版本

RX 及其之后的版本

RX至RY的版本

ID+标题）前提到规范的链接，这是本规范的前提（描述对规范的描述

（文本，图像）理由制定规范的动机最终更改最终更改版本编号

注：本模板的各项元素是为使规范得到合理的理解与交流所必须

提供的最小项。允许对本模板的项目或卖主部分进行补充，只要补充

的部分不与原有部分在意义上重合即可。事实上，如果上述补充能有

助于整合其他规范模板并促使核心模板本身达到更广泛的接收度，这样的补充是受到鼓励的。

2.3.1 规范 ID

规范的 ID 由两个小写字母（表示规则的出处）和四位数字组成，中间用一段下

划线隔开。

一旦一份新规范有了ID，该 ID 将不再改变。

ID 用来指代相应的规范。

以“ na”、“jp ”、“jc ”、“eu”开头的 ID 预留给未来的 MAAB 规范使用。

保留以“ db”、“jm”、“hd”、“ar ”开头的 ID。

新规则的 ID 不得以上述字母开头。

2.3.2 规范标题

规范的标题应对该规范的应用领域进行简短且唯一的描述

（例如，名字的长度）。

规范的标题适用于前提条件部分及定制检测工具。

规范的标题应与到该规范的超链接同时写出。

注：标题不应为对规范内容的多余的简要描述。对规范内容的描述未来可能发生改变，但规范的标题始终不得更改。

2.3.3 优先级

每条规范都须根据下列优先顺序进行评级：

强制要求

强烈建议

建议

优先级描述该规范的重要程度并决定违反该规范的后果严重程

度：

强制要求强烈建议建议

定义

所有公司一致认被一致认定为良好为改进模型图的

定为绝对必不可做法，但遗留模型阻外观建议遵守的

少的规范碍了公司对该规范规范，但该规范

所有公司都100%的遵守对于模型的运行

100%遵守的规范模型须以可能的最并非起决定作用

大程度遵守该规范，如果遵守会更

但并未要求对其好，但并非必要

100%的遵守的规范

后果

如果违反了该规范

必要的项目出现缺失模型无法正常工作

质量和外观劣外观可能与

化其他项目不

可能对可维修一致

性、可携带型及

可重用性产生

不利影响

豁免政策

如果有意地忽略该规范

原因须备有文件

证明

2.3.4 适用范围

适用范围可以是以下三者之一：

MAAB (MathWorks汽车咨询委员会 )

J-MAAB ( 日本 MAAB)

NA-MAAB (北美 MAAB)

“ MAAB”是一个与 MathsWorks 紧密合作的汽车制造商及供应商的团队。 MAAB包括两个子团队，即日本 MAAB及北美 MAAB。

“ J-MAAB”是 MAAB的子团队，包括与 MathsWorks 紧密合作的日

本汽车制造商及供应商。J-MAAB规则的适用范围为日本当地。

“ NA-MAAB”是 MAAB的子团队，包括与 MathsWorks 紧密合作的美国及欧洲的汽车制造商及供应商。该规则是美国及欧洲当地的规

则。覆盖范围为美国和欧洲。

2.3.5 MATLAB版本

本规范适用于 MATLAB及 Simulink 所有版本的产品。如果一条规则仅适用于 MATLAB的某一个或某几个版本，则适用版本的信息应在MATLAB版本部分进行说明，说明格式为下列格式中的一种：

全部： MATLAB的所有版本

RX, RY, RZ ：MATLAB的某一特定版本

RX及其之前的版本： RX发布之前的 MATLAB版本

RX 及其之后的版本：RX 发布之后直至现行版本发布期间的

MATLAB版本

RX至 RY的版本 : RX 至 RY之间的 MATLAB版本

2.3.6 前提

该部分是到其他规范的链接，链接的规范均为本规范的前提

（逻辑关联）。

每个链接须注明相应规范的ID（为了一致性）和标题（为了

可读性）。“前提”部分不应包括任何其他文本。

2.3.7 描述

该部分包括对规范的详细描述。

如有需要，可添加图像和表格。