Matlab Simulink Stateflow控制算法建模规范 中文

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

3.0版

Mathworks汽车咨询委员会

（MAAB）

1 修订历史

日期 2001.02.04 2007.04.27 2011.07.30 2012.08.31 修订 初始版本1.0版发布 更新版本2.0版发布 更新版本3.0版发布 更新版本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 描述

? 该部分包括对规范的详细描述。 ? 如有需要，可添加图像和表格。

注：如果正式表达（数学符号、正规表达式、语法图及精确数值/范围）可用，应使用正式表达对规范进行清楚明白的描述并指定一项自动检测。此外，为了日常参考，还须提供一份人性化的、可理解的、非正式的描述。 2.3.8 理由

规范的建议可出于以下一种或多种原因： ? 可读性：易于理解的算法

? 可读的模型

? 统一的模型外观、编码及文件编制 ? 清洁的界面 ? 专业的文件编制

? 工作流：高效的发展进程及工作流

? 易于维护 ? 迅速的改型设计 ? 可重复使用的部件 ? 无问题的模型交换 ? 模型可携带型

? 模拟：高效的模拟与分析

? 模拟速率 ? 模拟内存 ? 模型检测

? 验证&确认：有能力对模型及生成的代码就下列因素进行验证和确

认：

? 需求的可追溯性 ? 测试

? 无问题的系统集成 ? 清洁的界面

? 代码生成：生成对内嵌系统有效的代码

? 快速的软件变更 ? 生成的代码的稳健性

2.3.9 最终更改

“最终更改部分”包括文件版本编号。 2.4 文件使用

以下段落提供的信息是关于使用本文件作为参考以及参照本文件编写具体项目的规范文件的。附件A中可以找到关于对本规范进行自动校核的信息。 2.4.1规范交互作用语义

本文件的起始段“命名规范与模型架构”提供了适用于各种模型的基本规范。其后的 “Simulink与Stateflow”部分提供上述环境中的具体规则。某些规范是依赖于其他规范的，模板中自始至终都对其作了明确说明。

2.4.2隐匿的子系统及可读性规则

如果用户没有查看模型内部隐匿子系统的内容，则关于可读性的规范不再适

3 软件环境 3.1 总则

3.1.1 na_0026:一致的软件环境

ID：标题 优先级 适用范围 MATLAB版本 前提 描述 na_0026:一致的软件环境 建议 北美MAAB 见“描述” 在软件开发过程中，建议在整个项目中始终使用一致的软件开发环境。此处所说的软件包括但不仅限于： ? MATLAB ? Simulink ? C Compiler (供模拟) ? C Compiler (供目标硬件) 理由 ?可读性 □工作流 □模拟 □验证&确认 ?代码生成 参见 jh_0042：必需的软件 最终更改 3.00版 3.1.2 na_0027: 仅有标准库模块的使用

ID：标题 优先级 适用范围 MATLAB版本 前提 描述 na_0027: 仅有标准库模块的使用 建议 北美MAAB 全部 公司在开发模型时应指定Simulink的一个子集以供使用。模块列表可包括由公司或第三方开发的自定义模块库。模型应仅由这些模块构成。 开发过程中可使用非兼容性模块。如果使用了非兼容性模块，须用一种颜色/图标和/或注释进行标记。这些非兼容性模块在用于生成生产代码之前必须移除。 理由 ?可读性 □工作流 ?模拟 ?验证&确认 ?代码生成 参见 最终更改 hyl_0201: 只使用标准库模块 3.00版

? 不得出现回车符 允许的字符 名称： a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 _ 下划线 名称： ? ? ? ? 可使用下划线分离各个部分 不得连续使用一个以上的下划线 不得以下划线开头 不得以下划线结尾 理由 ?可读性 □工作流 □模拟 □验证&确认 □代码生成 最终更改 2.20版 4.2.3jc_0221：信号线名称可用字符 ID：标题 优先级 适用范围 jc_0221：信号线名称可用字符 强烈建议 MAAB MATLAB版本 全部 前提 描述 所有信号线名称均应符合以下约束条件： 形式 名称： ? 不得以数字开头 ? 不得出现空白间隔 ? 不得出现回车符 允许的字符 名称： a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 _ 下划线 名称： ? ? ? ? 可使用下划线分离各个部分 不得连续使用一个以上的下划线 不得以下划线开头 不得以下划线结尾 理由 ?可读性 □工作流 □模拟 □验证&确认 □代码生成 最终更改 2.20版 4.2.4 na_0030：Simulink公交车名称可用字符 ID：标题 优先级 适用范围 na_0030：Simulink公交车名称可用字符 强烈建议 北美MAAB MATLAB版本 全部 前提 描述 所有Simulink公交车名称均应符合以下约束条件： 形式 名称： ? 不得以数字开头 ? 不得出现空白间隔 ? 不得出现回车符 允许的字符 名称： a b c d e f g h I j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 _ 下划线 名称： ? ? ? ? 可使用下划线分离各个部分 不得连续使用一个以上的下划线 不得以下划线开头 不得以下划线结尾 理由 ?可读性 □工作流 □模拟 □验证&确认 □代码生成 参见 最终更改 jh_0040：Simulink公交车名称可用字符 3.00版 4.2.5 jc_0231：模块名称可用字符 ID：标题 优先级 适用范围 jc_0231：模块名称可用字符 强烈建议 MAAB MATLAB版本 全部 前提 描述 jc_0201:子系统名称可用字符 所有模块名称均应符合以下约束条件： 形式 名称： ? 不得以数字开头 ? 不得出现空白间隔 ? 不得出现回车符 允许的字符 名称： a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 _ 注：本规则不适用于子系统模块。 理由 ?可读性 □工作流 □模拟 □验证&确认 □代码生成 最终更改 2.00版 4.2.6 na_0014：使用Simulink及Stateflow的本地语言 ID：标题 优先级 适用范围 na_0014：使用Simulink及Stateflow的本地语言 强烈建议 日本MAAB MATLAB版本 全部 前提 描述 本地语言只能在描述字段使用。描述字段是不影响代码生成及模拟的文本切入点。描述字段示例包括 Simulink示例： ? 模块属性的描述字段 ? 直接进入模型的文本注释 Stateflow示例 ? 图表或状态参数的描述字段

本文来源：https://www.bwwdw.com/article/vb8d.html