跳到主要内容

控制器

符号

Controllers_image1.png

功能

用于便捷设置数据对象取值的人机交互场合

要点

控制对象

格式为Number,String,Bool,DateTime的全局变量

不同控制交互支持的数据格式

数据类型或对象 | 控制方式滑块开关选择器输入框日历按钮
Number
String
Bool
DateTime
条件事件

运行机制

  • 非模拟运行状态时,设置变量初值和调整控制器完全同步等价

Controllers_image1+1.png

  • 模拟运行过程中,任何时候设定控制器会将数据对象状态重置为当前设置值
提示

如果建模逻辑需要在多个Tick读取被控变量,当模型在运行期间你调整了控制器,那么将会按最新设置值运行,详见篇尾案例

设置方法

包括选择控制目标和配置交互方式

选择控制对象

下拉菜单选择模型中当前及以上域中、符合格式的数据对象

Controllers_image2.png

提示

如果在实体内创建一个控制器来设置实体个体属性的取值,这意味着你在设置该个体属性的默认取值,而不是所有个体该属性的实时值。也就是说,已经存在的个体的该属性不会因为控制器调整而改变,但当按该属性默认值创建新个体时,会执行控制器当前设定值。

选择数据格式

Controllers_image3.png

  • 下拉菜单选择支持的数据类型:Number / String / Boolean

配置交互方式

  • 系统将按照数据格式自动列出支持的交互方式呈现在菜单中

Controllers_image3+1.png

滑块

Controllers_image4.png

用于控制Number格式对象

Controllers_image5.png

  • 最小值设置
  • 最大值设置
  • 步进值设置

开关

Controllers_image6.png

用于控制Bool类型对象,无需配置

选择器

Controllers_image7.png

用于控制枚举的Number、String和Datetime格式的对象

Controllers_image8.png

  • 枚举内容输入:标签输入框
    • 输入枚举值后回车完成一个枚举值的输入
    • 删除:点击目标枚举值标签上的"X"

输入框

Controllers_image9.png

用于控制Number,String和DateTime格式的数据对象

Controllers_image10.png

无需设置,使用时直接在画布的控制对象输入框中输入即可

案例

模型案例

一个模拟鸟群飞行行为的模型

  • floyNum全局变量决定了模型中飞鸟的数量
  • 你可以通过同名控制器控制该变量,观察效果