30分钟实战：用AnyLogic行人库打造商场疏散仿真Demo
第一次打开AnyLogic时，我被它复杂的界面吓到了——直到发现行人库(Pedestrian Library)这个神器。作为一个曾经花两周时间手动编写行人行为逻辑的建模师，我可以负责任地说，这个内置库能帮你节省90%的初学时间。今天我们就用它快速构建一个可运行、可观察的多层商场疏散仿真，让你在喝杯咖啡的时间里获得第一个可视化成果。
1. 准备工作：认识你的数字沙盘
在开始拖拽组件前，我们需要先理解AnyLogic的三维空间逻辑。不同于其他仿真软件，AnyLogic采用多层画布设计：
- Main：整个模型的容器，负责楼层间的协调
- MyFloor1/MyFloor2：各楼层的独立空间（建议高度差设为40单位）
- 演示视图：最终呈现给用户的3D可视化窗口
提示：按住Alt键+鼠标拖动可以自由旋转3D视角，滚轮控制缩放
安装好AnyLogic 8.8+版本后，新建模型时建议选择"Blank Model"模板。你会看到左侧面板中的行人库组件：
PedSource ➔ 行人生成点 PedGoTo ➔ 路径导航 PedSink ➔ 目的地/出口 PedWait ➔ 停留行为 PedService ➔ 服务节点(如收银台)2. 一楼基础布局：5个关键组件速建
删除默认的Main画布内容，我们开始构建第一个楼层：
右键项目树 → New → Active Object Class → 命名为"MyFloor1"
从行人库拖拽以下组件到MyFloor1画布：
组件 关键属性设置 作用说明 PedSource Agent type: Ped 行人出生点 PedGoTo Target line: (自定义坐标) 引导向安全出口 PedWait Delay time: uniform(1.5, 2.0) 模拟购物停留 PedService Delay time: uniform(0.5, 1.0) 模拟收银/服务耗时 PedSink 保留默认设置 安全撤离点 用Wall组件绘制商场平面图（建议简单矩形+通道）
在Main画布拖入MyFloor1实例，添加3D窗口(ViewArea)
// 在MyFloor1的"启动时执行"代码区注入初始人流 pedSource.inject(20); // 生成20个初始顾客点击运行，你应该已经能看到行人在商场中移动——虽然他们现在只会盲目游走。别急，我们马上让仿真变得智能。
3. 动态路径规划：让行人"聪明"起来
原始的行人移动缺乏目的性，我们需要改进PedGoTo的逻辑。以下是实现智能疏散的关键步骤：
- 在MyFloor1创建集合(Collection)命名为colOut
- 添加多个目标线(TargetLine)作为备选出口
- 为PedGoTo编写动态目标选择逻辑：
// 在PedGoTo的"目标线"属性中使用行动图(ActionChart) actionChart(ped); // 根据算法选择最优出口 // 对应的行动图代码： int k = 0; double minDistance = Double.MAX_VALUE; for(int i=0; i<colOut.size(); i++){ double curDistance = ped.distanceTo(colOut.get(i).getX(), colOut.get(i).getY()); if(curDistance < minDistance){ k = i; minDistance = curDistance; } } return k;这个逻辑会让行人自动选择最近的可用出口。测试时可以通过按钮触发紧急疏散：
// 疏散按钮点击事件 myFloor1.pedService.cancelAll(); myFloor1.pedGoTo.cancelAll(); myFloor1.pedWait.cancelAll();4. 扩展多层逻辑：二楼与楼梯衔接
复制MyFloor1创建MyFloor2，我们需要处理两个关键衔接：
- 楼梯连接：
- 在MyFloor1添加PedEnter组件作为楼梯入口
- 在MyFloor2添加PedExit组件作为楼梯出口
- 设置PedExit的离开时代码：
main.myFloor1.enter.take(agent); // 将行人转移到一楼- 分层控制：
- 为Ped添加stairIndex变量记录目标楼梯
- 修改各楼层的PedGoTo逻辑：
// MyFloor2的PedGoTo进入时代码 ped.stairIndex = actionChart(ped); // 记住选择的出口索引 // MyFloor1的PedEnter目标线设置 colIn.get(ped.stairIndex); // 根据记忆的索引选择入口在Main中调整MyFloor2的Z轴位置为40，运行后你会看到行人能在楼层间自然流动。通过两个独立的疏散按钮，可以观察分层疏散的效果差异。
5. 调优与可视化技巧
完成基础功能后，这些技巧能让你的Demo更专业：
人流密度热图： 右键3D窗口 → Add Overlay → Heatmap 设置数据源为各楼层的PedService组件
实时统计面板： 使用Dataset组件记录疏散人数 添加TimePlot显示撤离曲线
参数优化建议：
参数 合理范围 影响效果 PedSource生成间隔 exponential(0.5) 控制人流密度 PedWait延迟时间 uniform(1.0,3.0) 模拟不同停留时长 PedService效率 triangular(0.3,0.8,1.2) 服务台处理速度波动
最后分享一个实际项目中的发现：当疏散通道宽度小于行人密度的15%时，会出现明显的瓶颈效应。在测试时可以尝试调整Wall的开口尺寸观察拥堵情况。
