AnyLogic示例模型如何可视化agent行为并关联statechart与Main

1. Agent行为展示与Statechart可视化实现 #

两种常用方案，按需选择即可：

• 单Agent状态详情查看：在人群Agent（即你定义的行人类型，通常命名为Person/Pedestrian）的演示编辑页，从右侧「演示」面板拖入原生State Chart控件，绑定你已经搭建好的行为状态机。模型运行时，点击场景内任意一个行人，弹出的Agent详情窗口里就会实时显示它当前所处的状态、历史跳转路径。
• 全局行为分布可视化：给状态机的每个状态添加入口动作，给Agent设置不同的填充色做区分，比如正常疏散状态写setColor(Color.BLUE)，恐慌状态写setColor(Color.RED)，已疏散状态写setColor(Color.GREEN)。运行时不用点选个体，直接通过人群颜色就能直观看到不同行为的传播、分布情况。
• 如果需要行为日志做调试，直接在状态转移的动作栏加traceln("行人"+getIndex()+" 于时刻"+time()+" 从"+sourceState.name+" 跳转至"+targetState.name)，控制台会自动打印所有个体的行为变化记录。

2. 恐慌行为切换CheckBox实现 #

完全支持，操作步骤如下：

• 第一步打开Main的编辑画布，从「控件」面板拖入CheckBox组件放到画布边角位置，修改组件标签为「启用恐慌行为」，给组件设置变量名cb_panicSwitch，默认选中状态按需设置即可。
• 第二步修改行人状态机里的恐慌逻辑：找到恐慌状态的入口转移，在原有的触发条件末尾追加判断main.cb_panicSwitch.isSelected()，确保开关未打开时，不管其他触发条件是否满足，都不会进入恐慌状态。
• 如果需要支持运行过程中实时切换开关，给CheckBox添加「值更改时」的触发动作：遍历所有现存的行人实例，开关打开时给符合恐慌触发阈值（比如距离危险点过近、周边人群密度过高）的个体发送恐慌触发事件；开关关闭时，给当前处于恐慌状态的个体发送事件，强制切回正常行走状态即可。
  示例代码：

// CheckBox值更改时的动作
for (Person p : pedestrians) {
    if (cb_panicSwitch.isSelected() && p.densityAround > 4) {
        p.statechart.fireEvent("TRIGGER_PANIC");
    } else if (!cb_panicSwitch.isSelected() && p.statechart.isStateActive(Person.statePanic)) {
        p.statechart.fireEvent("EXIT_PANIC");
    }
}

3. Statechart与Main的连接配置 #

这个操作没有特殊的绑定步骤，核心是理清AnyLogic的层级引用规则即可：

• 首先不要把行人的行为状态机建在Main下：疏散、恐慌这类属于单个人的行为逻辑，状态机必须建在行人Agent类型的内部，建在Main下会无法关联到个体属性。
• 引用规则：
  • 行人状态机内部要访问Main的全局参数、控件、环境数据时，直接加main.前缀调用即可，比如读取开关状态、读取全局危险点位置、读取出口分布数据，都直接写main.对应变量名，不需要额外做关联配置。
  • Main里要触发行人的状态机跳转时，先拿到行人的实例引用，再调用状态机的事件触发方法即可，比如全局疏散启动时给所有行人发信号的代码：

    for (Person p : pedestrians) {
        p.statechart.fireEvent("EVAC_START");
    }
    

• 常见踩坑：不要把状态机的初始触发逻辑写在Main的「启动时」回调里，要写在行人Agent自身的「启动时」回调里，否则会出现Agent实例未初始化完成就调用状态机的空指针报错。

内容的提问来源于stack exchange，提问作者xxffaw