主要内容

Stateflow.Chart

R2026b

有限状态机的图形表示

    描述

    使用 Stateflow.Chart 对象创建一个基于状态转移图的有限状态机的图形表示。在 Chart 模块中,状态和转移构成了时序逻辑系统的基本构建块。状态对应于工作模式,转移表示状态之间的路径。有关详细信息,请参阅对有限状态机建模和使用 Stateflow API 创建图。

    创建对象

    要创建一个 Stateflow.Chart 对象,请调用函数 sfnew。例如,要在名为 myModel 的新 Simulink® 模型中创建一个空图,请输入:

    sfnew myModel

    您也可以使用函数 add_block (Simulink) 将新图添加到现有模型中:

    add_block("sflib/Chart","myModel/Chart")

    然后,要访问 Stateflow.Chart 对象,请为 Simulink.Root 对象调用 find 函数:

    chart = find(sfroot,"-isa","Stateflow.Chart", ...
        Path="myModel/Chart");

    属性

    全部展开

    Stateflow® API 对象具有与您在 Stateflow 编辑器中设置的值对应的属性。要访问或修改属性,请使用圆点表示法。要访问或修改多个 API 对象的多个属性,请分别使用 get 和 set 函数。有关详细信息,请参阅Modify Properties and Call Functions of Stateflow Objects。

    内容

    图的名称,指定为字符串标量或字符向量。

    用于为图编程的动作语言,指定为 "MATLAB" 或 "C"。有关详细信息,请参阅使用 MATLAB 和 C 语言作为动作语言语法时的差异。

    由图实现的状态机语义,指定为 "Classic"、"Mealy" 或 "Moore"。有关详细信息,请参阅米利和摩尔状态机概述。

    图是否支持可变大小数据,指定为数值或逻辑值 1 (true) 或 0 (false)。有关详细信息,请参阅Declare Variable-Size Data in Stateflow Charts。

    自 R2023a 起

    图是否将维度长度为 1 的非标量数据视为固定大小,指定为数值或逻辑值 0 (false) 或 1 (true)。当此属性为 true 时,无论您是否将数据指定为可变大小,图都会将至少有一个维度长度为 1 的非标量数据视为固定大小。当此属性为 false 时,如果您将数据指定为具有可变大小,则图将非标量数据视为可变大小。

    状态分解

    图中最顶层包含关系下的子状态的分解方式,指定为 "EXCLUSIVE_OR" 或 "PARALLEL_AND"。有关详细信息,请参阅通过使用状态分解定义互斥和并行模式。

    图初始化

    是否在仿真开始时激活图,指定为数值或逻辑值 1 (true) 或 0 (false)。有关详细信息,请参阅初始化时的图执行。

    当函数调用输入事件重新启用图时状态的行为,指定为以下值之一:

    • "" - 图不包含函数调用输入事件。

    • "held" - 图保持状态的最新值。

    • "reset" - 图还原到状态的初始条件。

    有关详细信息,请参阅控制由函数调用输入事件启用的图中的状态。

    是否在每次图唤醒时初始化输出数据,指定为数值或逻辑值 1 (true) 或 0 (false)。有关详细信息,请参阅每次图唤醒时初始化输出。

    激活状态输出

    是否为图创建激活状态数据输出端口,指定为数值或逻辑值 1 (true) 或 0 (false)。有关详细信息,请参阅通过激活状态数据监控状态活动。

    此 属性 为只读。

    图的激活状态数据对象,指定为 Stateflow.Data 对象。此属性仅在图的 HasOutputData 属性为 true 时适用。

    图的激活状态数据对象的名称,指定为字符串标量或字符向量。此属性仅在图的 HasOutputData 属性为 true 时适用。

    激活状态输出数据的监控模式,指定为 "ChildActivity" 或 "LeafStateActivity"。

    图的激活状态数据对象的枚举数据类型名称,指定为字符串标量或字符向量。有关详细信息,请参阅枚举名称。

    是否手动定义激活状态数据输出的枚举数据类型,指定为数值或逻辑值 1 (true) 或 0 (false)。有关详细信息,请参阅定义状态活动枚举类型。

    离散和连续时间语义

    图的激活方法,指定为 "CONTINUOUS"、"DISCRETE" 或 "INHERITED"。

    激活图的采样时间,指定为字符串标量或字符向量。此属性仅在图的 ChartUpdate 属性为 "DISCRETE" 时适用。

    是否对图中的状态转移启用过零检测,指定为数值或逻辑值 1 (true) 或 0 (false)。此属性仅在图的 ChartUpdate 属性设置为 "CONTINUOUS" 时适用。有关详细信息,请参阅Disable Zero-Crossing Detection。

    Stateflow 在仿真和代码生成期间分析哪些模块变体,指定为以下值之一:

    • update diagram analyze all choices - Stateflow 分析激活和非激活选择项的信号属性不兼容性,并只为激活选择项生成代码。

    • code compile - Stateflow 分析变体转移的激活和非激活选择项,并为激活和非激活选择项都生成代码。这些选择项包含在 C 预处理器条件句 #if 和 #endif 中,当您编译生成的代码时,这些条件句会有条件地编译。

    超时间步语义

    是否为图启用超时间步语义,指定为数值或逻辑值 1 (true) 或 0 (false)。有关详细信息,请参阅Super Step Semantics。

    图在一个超时间步中可以执行的最大转移数,指定为整数标量。此属性仅在图的 EnableNonTerminalStates 属性为 true 时适用。

    图的超时间步在达到稳态之前超出 NonTerminalMaxCounts 属性指定的最大转移数时的行为,可以指定为以下值之一:

    • "Proceed" - 图以上次激活状态配置进入休眠状态。

    • "Throw Error" - 图生成错误。

    此属性仅在图的 EnableNonTerminalStates 属性为 true 时适用。

    导出的函数

    是否将图级别函数导出到 Simulink 模型中的其他模块,指定为数值或逻辑值 1 (true) 或 0 (false)。有关详细信息,请参阅导出 Stateflow 函数以供重用。

    从图中导出的函数在 Simulink 模型中是否全局可见,指定为数值或逻辑值 1 (true) 或 0 (false)。启用此属性后,整个模型中的模块都可以调用从图中导出的函数,而无需使用限定表示法。此属性仅在图的 ExportChartFunctions 属性为 true 时适用。

    整数和定点数据

    图中的数据是否对整数溢出进行饱和处理,指定为数值或逻辑值 1 (true) 或 0 (false)。当此属性禁用时,图中的数据会在整数溢出时绕回。有关详细信息,请参阅Handle Integer and Enumeration Overflow for Chart Data。

    继承的 Simulink 信号被视为 Fixed-Point Designer™ fi 对象,指定为以下值之一:

    • "Fixed-point" - 图将所有定点输入视为 fi 对象。

    • "Fixed-point & Integer" - 图将所有定点输入和整数输入视为 fi 对象。

    此属性仅适用于使用 MATLAB® 语言作为动作语言的图。

    图的默认 fimath 属性,指定为以下值之一:

    • "Same as MATLAB Default" - 使用与当前默认 fimath 对象相同的 fimath 属性。

    • "Other:UserSpecified" - 使用 InputFimath 属性指定默认 fimath 对象。

    此属性仅在图的 ActionLanguage 属性为 "MATLAB" 时适用。

    默认 fimath 对象,指定为字符串标量或字符向量。当图的 EmlDefaultFimath 属性为 "Other:UserSpecified" 时,您可以使用此属性:

    • 输入构造 fimath 对象的表达式。

    • 输入 MATLAB 或模型工作区中 fimath 对象的变量名称。

    此属性仅适用于使用 MATLAB 语言作为动作语言的图。

    代码生成

    生成代码是否包含图中变体条件的预处理器条件句,指定为数值或逻辑值 1 (true) 或 0 (false)。此属性仅在使用 Embedded Coder® 生成代码时适用。有关详细信息,请参阅Control Indicator Lamp Dimmer Using Variants。

    C 动作语言

    是否在图中的状态和转移动作中使用位运算,指定为数值或逻辑值 1 (true) 或 0 (false)。此属性仅适用于使用 C 语言作为动作语言的图。

    调试

    图的调试器属性,指定为具有以下属性的 Stateflow.ChartDebug 对象:

    • Breakpoints.OnEntry - 是否设置 On Chart Entry 断点,指定为数值或逻辑值 1 (true) 或 0 (false)。

    有关详细信息,请参阅Set Breakpoints to Debug Charts。

    示例: chart.Debug.Breakpoints.OnEntry = true;

    图形外观

    此 属性 为只读。

    图的编辑器,指定为 Stateflow.Editor 对象。您可以使用此对象控制 Stateflow 编辑器窗口的位置、大小和放大级别。

    Stateflow 编辑器窗口是否正在显示图,指定为数值或逻辑值 1 (true) 或 0 (false)。

    图的背景颜色,指定为 [red green blue] 形式的三元素数值向量,用于指定红色、绿色和蓝色的值。每个元素必须在 0 到 1 之间的范围内。

    图中框、函数和状态的颜色,指定为 [red green blue] 形式的三元素数值向量,用于指定红色、绿色和蓝色的值。每个元素必须在 0 到 1 之间的范围内。

    图中转移的颜色,指定为 [red green blue] 形式的三元素数值向量,用于指定红色、绿色和蓝色的值。每个元素必须在 0 到 1 之间的范围内。

    图中结点的颜色,指定为 [red green blue] 形式的三元素数值向量,用于指定红色、绿色和蓝色的值。每个元素必须在 0 到 1 之间的范围内。

    图中框、函数和状态标签的字体,指定为具有以下属性的 Stateflow.StateFont 对象:

    • Name - 字体名称,指定为字符串标量或字符向量。此属性还确定图中注解的字体。

    • Angle - 字体角度,指定为 "NORMAL" 或 "ITALIC"。

    • Weight - 字体粗细,指定为 "NORMAL" 或 "BOLD"。

    • Size - 新的框、函数和状态的默认字体大小,指定为标量。此属性还确定图中新注解的默认字体大小。

    示例: chart.StateFont.Name = "Arial";

    示例: chart.StateFont.Angle = "ITALIC";

    示例: chart.StateFont.Weight = "BOLD;

    示例: chart.StateFont.Size = 8;

    图中框、函数和状态标签的颜色,指定为 [red green blue] 形式的三元素数值向量,用于指定红色、绿色和蓝色的值。每个元素必须在 0 到 1 之间的范围内。

    图中转移标签的字体,指定为具有以下属性的 Stateflow.TransFont 对象:

    • Name - 字体名称,指定为字符串标量或字符向量。

    • Angle - 字体角度,指定为 "NORMAL" 或 "ITALIC"。

    • Weight - 字体粗细,指定为 "NORMAL" 或 "BOLD"。

    • Size - 新转移的默认字体大小,指定为标量。

    示例: chart.TransitionFont.Name = "Arial";

    示例: chart.TransitionFont.Angle = "ITALIC";

    示例: chart.TransitionFont.Weight = "BOLD";

    示例: chart.TransitionFont.Size = 8;

    图中转移标签的颜色,指定为 [red green blue] 形式的三元素数值向量,用于指定红色、绿色和蓝色的值。每个元素必须在 0 到 1 之间的范围内。

    层次结构

    此 属性 为只读。

    包含图的状态机,指定为 Stateflow.Machine 对象。

    此 属性 为只读。

    图在模型层次结构中的位置,指定为字符向量。

    图在打开或保存后是否已更改,指定为数值或逻辑值 1 (true) 或 0 (false)。

    图是否已锁定,指定为数值或逻辑值 1 (true) 或 0 (false)。启用此属性可防止图中发生更改。

    此 属性 为只读。

    图是否已锁定,指定为数值或逻辑值 1 (true) 或 0 (false)。此属性等效于属性 Locked,但在内部用于防止仿真期间图中发生更改。

    标识

    图的描述,指定为字符串标量或字符向量。

    图的文档链接,指定为字符串标量或字符向量。

    图的用户定义的标记,指定为任何类型的数据。

    此 属性 为只读。

    唯一标识符,指定为整数标量。使用此属性区分图与模型中的其他对象。每次启动新 MATLAB 会话时都会重新分配此属性的值,并且在删除对象后可能会回收该值。

    对象函数

    findIdentify specified objects in hierarchy
    getChildren标识对象的子级
    defaultTransitions识别指定对象中的默认转移
    dialog打开属性对话框
    view在编辑环境中显示对象
    fitToView放大图形对象

    示例

    全部折叠

    调用函数 sfnew 以打开一个包含空 Stateflow 图的新 Simulink 模型。

    sfnew

    通过调用 sfroot 函数访问 Simulink.Root 对象。

    rt = sfroot;

    通过为 Simulink.Root 对象调用 find 函数访问 Stateflow.Chart 对象。

    chart = find(rt,"-isa","Stateflow.Chart");

    版本历史记录

    在 R2006a 之前推出

    全部展开