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 会话时都会重新分配此属性的值,并且在删除对象后可能会回收该值。
对象函数
find | Identify specified objects in hierarchy |
getChildren | 标识对象的子级 |
defaultTransitions | 识别指定对象中的默认转移 |
dialog | 打开属性对话框 |
view | 在编辑环境中显示对象 |
fitToView | 放大图形对象 |
示例
版本历史记录
在 R2006a 之前推出在以后的版本中,属性 UserSpecifiedStateTransitionExecutionOrder 将被删除。此属性仅适用于使用 C 语言作为动作语言的图。
当您启用此属性时,图会按照您创建这些图的顺序执行转移和并行状态。您也可以手动确定执行顺序。
禁用此属性时,图根据物理位置定义的隐式顺序执行转移和并行状态。
转移根据以下条件执行:
每个转移的父级的层级。
转移的标签,按以下顺序确定优先级:
带事件和条件的标签。
带事件的标签。
带条件的标签。
无标签。
转移源的角位。具有最小时钟位置的转移具有最高优先级。例如,相对对象具有 2 点钟时钟位置的转移的优先级高于具有 4 点钟时钟位置的转移。相对源对象具有 12 点钟时钟位置的转移的优先级最低。
并行状态按以下顺序执行:
从上到下。
从左到右。
为确保隐式排序的图保持兼容,请将 UserSpecifiedStateTransitionExecutionOrder 设置为 true。
要将图转换为状态转移表,请使用函数 convertToSTT。
使用新属性 TreatDimensionOfLengthOneAsFixedSize,您可以指定当至少一个维度的长度为 1 时,图如何处理非标量数据。在 R2023a 之前,图将维度长度为 1 的非标量数据视为固定大小,无论您是否将该数据指定为可变大小都是如此。
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
选择网站
选择网站以获取翻译的可用内容,以及查看当地活动和优惠。根据您的位置,我们建议您选择:。
您也可以从以下列表中选择网站:
如何获得最佳网站性能
选择中国网站(中文或英文)以获得最佳网站性能。其他 MathWorks 国家/地区网站并未针对您所在位置的访问进行优化。
美洲
- América Latina (Español)
- Canada (English)
- United States (English)
欧洲
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)