AnyLogic使用帮助文档
一概要
本文档内容包含AnyLogic的简单介绍，AnyLogic使用入门以及在使用过程中常见的一些问题。且所有内容仅针对pedestrian模型。
二安装
除按正常模式安装AnyLogic以外，我们还需要额外添加一个shp文件导入控件，以及安装neatbean。
控件的安装方法很简单，把InputShape_1.0.0.jar和openmap.jar复制到C:\Program Files\AnyLogic 6 Professional\plugins下即可(具体路径请参考自己的anylogic安装路径)。
三创建一个简单的pedestrian模型
1 打开anylogic程序，File->new->model。
2 输入模型文件相关信息，next。
3 选择use template to create model，并选择Pedestrian Dynamics。Next。
4 Add waiting area和Add service and queue都不勾选。Finish。
5 运行程序观察效果。
四基础对象介绍
关于各个对象的属性行为，仅说明一些比较常用的。
构建一个完整的模型，以下对象是必不可少的。PedConfiguration，PedGround，PedSource，PedSink，PedGoTo。下面一一介绍。
1 PedConfiguration
PedConfiguration主要标示模型中的一些配置信息。
1）Time step, seconds
时间步长，即pedestrian每隔多久移动1次。
0.3是通过社会调查获得的一个比较合理的数据。这个值越小，peds移动的更精确，但是需要更多的计算。
2）Animation scale, pixels per meter
PedConfiguration中需要格外关注一个数据，即多少像素为1米。模型中的单位分为像素和米，所以在使用中需要注意他们之前的差别。
3）Render ped as
Ped的显示样式。
circle在表现上要好看一些，但是会让程序慢一下。Cross会让程序跑的快一些，point会更快，但是point无法表现出ped的大小。
2 PedGround
PedGround主要表示模型的模拟器环境。可以简单的理解为墙的设置。
1）Walls (group, optional)
peds不能穿过的地方，简称为墙。可以通过walls来表示实际的模拟器环境。
参数可以null，不为null时必须为group。
2）Walls touch tolerance, pixels
人与墙之间的间隔，单位为像素。
0.2米是一个比较合适的值。
3）Additional ties (group of lines, optional)
额外的ties
当PedGoto的寻路方式为manual时会使用到该参数。可以为空4）Show advanced parameters
勾选将显示一些高级设置。
a） Gap between tie and wall, meters
系统自动生成的tie和墙之间的距离。缺省值为0.3米。
这个值必须大于0。
b）Maximum tie length, meters
系统自动生成的tie的最大长度。缺省值为5米。
在某些模型里面，将该参数设置到最小，可以显著提高性能。
c）Minimum angle between ties, radian
tie之间的最小角度。单位为弧度。缺省值为0.3。
由两点之间生成的tie，如果与角平分线之间的角度小于该值，将会被移除。
d）Delete crossing ties
是否删除相交的tie。
e）Show nodes
程序运行过程中，是否显示节点。
f）Color for nodes
节点颜色。
g）Show edges
是否显示边缘。
h）Color for edges
边缘颜色。
i）Show ties
是否显示tie
j）Color for ties
tie的颜色
k）Show obstacles
显示障碍
l）Color for obstacles
障碍的颜色
3 PedSource
PedSource主要作用是生成ped。通常作为模型的起点。
1）Creation mode
选择ped生成模式，是单个模式还是组模式。
2）Ped arrivals defined by
指定生成ped的模式。
a）Arrival rate, peds per time unit
按时间比率生成。如1000/hour()。
b）Ped interarrival time
间隔时间生成。如：exponential( 1000 / hour() )。具体时间间隔由
AngLogic内部定义，该参数仅定义生成比率。
c) Rate table, peds per minute
生成比率有Table Function提供。
d) Arrival table
生成比率有Table Function提供。
Table Function中一个条目（20，10）表示第20s生成10个人。
e） Manual (call inject() method)
手动调用inject(int n)函数生成人。
3) Group arrivals defined by
group和ped的区别主要在于，ped每次生成时单个的。group生成每次生成是以group的size大小的人为1个单位生成的。如group的size为10，则每次生成人的时候都是10人。生成模式与ped相同。
4）Limited number of arrivals
是否限制生成ped的数量。如果选择是，则需要输入人数上限。
5）New ped
ped实例化。可以实例为new ped()或者ped的子类。
6）Diameter, meters
ped的大小。单位为米。
7）Comfortable speed, meters per sec.
ped的速度，米/秒。默认值为uniform(0.5,1)。
8）Animation shape
设定动画演示时的形状。具体用途还没摸索出来^^
9）color
设定生成的ped的颜色。默认情况下为空，随机设置颜色。
10）Arrival ground (PedGround)
ped生成时所处的环境。
11）Appears at (line, polyline)
ped生成时所处的位置。
12）Initial Spedd，meter per second
初始速度。单位为米/秒。
13）With offset，meters
定义ped生成位置位于线上的位置。缺省位置为uniform（0,length）。如果改成
uniform(0.5*length,0.75*length),则表示生成的均匀分布在线段/折线距离起点1/2
线段/折线长度到3/4长度的这一部分。起点为折线/线段上带+的点。
14）initial direction，radian
ped生成时的初始朝向。单位为弧度。可选择下拉单提供的North，South，East，West。
15）On exit
可以在这里编码。ped离开该组件时会调用这段代码。
16）advanced parameters—Ped simulation algorithm
ped的模拟器算法。默认值为pedConf.algorithmSocialForceModel。这个参数我
没有深入研究过。高端人士可以自己编写模拟器算法来试验一下。
4 PedGoTo
设定ped的行走目的地和路线。
1）Target(point,line)
ped的目的地，可以是line，也可以是point。
2）Path choice mode
有两种模式，auto和Manual。
auto模式，ped会自动计算到达目的地的路径。
Manual模式，ped则根据指定的path行走。若选择Manual模式，则必须在Parameters栏path项填写设定的path。path为ShapePolyLine。
3）Target reach tolerance，meters
定义ped距离目的地多少范围内算完成pedgoto。
4）On enter, On exit, On cancel
分别定义ped进入，离开，取消pedGoto时的行为。
5）Blocking detection timeout
当ped进入一个死角，从该位置无法沿既定路径到达目的地，则会进入timeout 计时，超时后会重新计算路径。
5 PedSink
ped的最终端，进入该对象的ped会从画面消失。
1）On enter
自定义进入该对象的行为。
以上为该模型中对象的基本介绍。其他模型介绍请参考help文档。
关于其他对象的示例，请查看help->Sample Models。Pedestrian Dynamics的三个示例。
五进阶功能。
这一块内容比较乱，基本上以我在做地铁疏散遇到的问题为主。
1 path的画法
可以这样理解，ped按path行走，实际是按于path关联的一连串ties行走。表示path 的polyline，以+点为起点，每条tie必须放在polyline的点上面。
以上polyline2位path。左下带+的点为path起点，ped先到达line2上一点，再通过line3上一点，以此来完成该path。line2和line3为ties。创建一个group，把这两条line加入这个group，并把group名填入PedGround的Addtional ties，这些ties才被认可，可以起作用。
2 pedGoto target缓冲区的实现。
本身PedGoto有一个参数Target reach tolerance来实现该功能，但是由于实际效果来看，该参数对point target效果很不错，但是对line target支持很不好。
实现该方法时，需指定pedGoto cancel端口连接的对象。
方法一：自定义算法计算缓冲区。代码如下：
distanceLine(double ax, double ay, double bx, double by, double cx, double cy)
{
double f = (bx-ax)*(cx-ax)+(by-ay)*(cy-ay);
//c到直线ab的投影点不在线段ab上，而且离a点最近
if (f<0) return distancePoints(ax, ay, cx, cy);
double d = (bx-ax)*(bx-ax)+(by-ay)*(by-ay);
//c到直线ab的投影点不在线段ab上，而且离b点最近
if ( f>d) return distancePoints(bx, by, cx, cy);
// c在ab线段上的投影点在线段ab上
f = f/d;
double fDx = ax + f * (bx-ax);
double fDy = ay + f * (by-ay);
double fDistanceCD = sqrt(pow((cx-fDx),2) + pow((cy-fDy),2));
return fDistanceCD;
}
distanceLine(double ax, double ay, double bx, double by)
{
double fDistance = sqrt(pow((ax-bx),2) + pow((ay-by),2));
return fDistance;
}
该方法主要是计算ped与targetline的距离。如果距离小于某个值，判定ped已经实现该pedGoto，调用PedGoto.cancel（ped）进入下一个对象。
方法二：利用pedArea自定义缓冲区。
当ped进入pedArea以后，判定ped已经实现该pedGoto，调用PedGoto.cancel（ped）进入下一个对象。
3 pedArea的几个用途
1) 电梯。
pedArea有一个参数Ground is Moving。可以设定地面的移动速度。
2) 可以控制区域开关。
Enable access control可以控制区域开关。当选定该参数之后，可以调用pedArea.setOpen(boolean sOpen) 来设置区域开关。一个比较常见的用法就是当区域内人数达到一定限制后，就不允许再继续进去了。
3) 可以实现靠边行走。
Keep direction参数会给进入区域的每一个ped指定方法的加速度，该方向就是Keep direction的值，可以是下拉列表的east，west，sourth，north，也可以是特定的弧度值。
4) 限制区域内peds的行走速度。
可以通过Speed is Limited来限制ped的最大速度。
5) 每个ped的速度增加百分比的速度。
可以通过Speed is multiplied来给每个ped设定百分比。
pedArea的缺陷。
由于pedArea在计算时，会把当前pedGround里所有的ped都计算一遍，所以，当pedArea的数量过多时，会极大地增加数据计算量。
4 函数的用法。
函数的用途主要体现在复杂数据的处理。比如main的初始化，比如多对象的选择。
函数的使用，在一定程度上可以大幅度的简化模型的复杂度，把流程相同的对象画在同一条流程图上面。
下面举个例子，当进入pedGoto的peds有同一个目的地，但是可以选择两条不同的路径时，选择函数来实现路径的选择是一个很好的办法。
从General中拖一个Function控件到模型中。设置参数，返回值，然后编码。
请注意返回值类型必须与path的类型保持一致，都必须是ShapePolyLine。
5 事件的用法。
事件有三种模型，一个是时间模型，当时间到了触发事件。具体又可以分为Occurs once，Cyclic和user control。第二个是Rate，比率模型。第三个是Condition，条件模型。结合函数，基本可以满足我们的需求。
6 队列的实现。
AnyLogic提供了一种队列的模型，PedService。PedService中有一个名为Service的参数，参数类型为PedServices。
PedServices具体实现队列模型。PedServices包含两种队列，一个是服务队列，Services，该队列存在两种模式，just delay，Delay and pass through。就好比地铁买票和过闸机。买票接受服务时，只需要站在原地和地铁工作人员交流就可以了，可以选择just delay模式，而过闸机接受的服务则是先刷卡，然后沿着闸机口过去，则是Delay and pass through。
PedServices的另外一个队列则是Queues，即排队队列。该队列存在两种选择模式，一是选择队列的方式，Shortest queue, Closest queue, Manual一个是选择服务队列的方式Longest queue, Closest queue, Manual。可以根据具体的需求来选择。
7 环境切换。
环境的切换。例如从二楼走到一楼这种。两个环境原本是相互独立的，可以通过Ped change ground来实现切换。该模型的参数设置很简单，仅Destination ground一个。但在
在画的时候有些地方需要注意，切换ground前需要到达的目的地和两种环境的边缘保持一定的空间，以方便进行切换。
8 导入shp文件。
其中原点坐标X，原点坐标Y需要记录下来，因为后续录像时会用到。比例需要与Ped Configuration中的Animation scale，pixels per meter一致。数据名称自定义。其他数据自定义，相互关联不大。
六NetBeans下的Anylogic
已经有了AnyLogic，为何还需要一个专门把AnyLogic中的代码拷贝到NetBeans下运行？主要是因为之前我们重载的时候，都在netbeans中进行的。我们制作录像时，需要记录每个ped的坐标位置，还有其他一些信息，但是这里面有很多数据是我们无法直接调用的，需要首先继承一些类，然后通过重载等方法，使这些数据可以为我们所用。
例如要获取ped的坐标，但是，在ped中，坐标变量是friendly类型的，所以我们就需要在com.xj.anylogic.libraries.pedestrian包中创建一个ped的子类MyPed。然后在MyPed中新建一个public函数，返回ped的x，y坐标。这样就可以实现我们的要求了。
在使用既有工程中的代码时，有几个注意点。
1 SimMain中有个函数chargePos(MyPed ped, double x, double y)，该函数的作用是将录像中的xy坐标还原为实际的xy坐标。我们在导入地图数据的时候，记录了一个原点坐标，那么现在模型中的坐标只需要按照这个原点坐标进行偏移就可以还原为实际坐标了。
2 Simulation里面的Main全部改为SimMain，因为我们在SimMain里重载了一些函数。
3 Simulation仅仅是一个模拟器的一些运行设置，可以不用拷贝。直接使用工程原有的代码。但是main的代码必须从AnyLogic从拷贝到NetBeans的工程中。为了拷贝方便，可以将NetBeans的包名称与AnyLogic的包名称保持一致。
4 ped等的子类，应该放在com.xj.anylogic.libraries.pedestrian下面。并注意修改代码中的package，改为package com.xj.anylogic.libraries.pedestrian;
5 现在的NetBeans对AnyLogic的支持并不完美。在使用6.5的库的时候，并不支持
PedSelectOutput。我们在建立模型的时候需要SelectOutput替代。
6 可以使用java的反编译器查看库的源代码。
7 当从别人那里拷贝NetBeans工程到本地之后，请确认项目属性的项目文件夹是否一致。
七AnyLogic创建自己的对象
AnyLogic现有的对象，不一定可以完全满足我们的需求，在某些特定的需求之下，我们需要创建属于自己的对象，来实现我们的目标。
一个很简单的例子，我们需要在一个特定的多边形范围内随机生成指定数量的peds。
而现有的对象，都是在线或者点上生成。为了实现这一需求，我们需要自己创建一个新的对象。
建立一个新的对象，需要考虑是out还是in。我们创建的对象，没有进，只有出，所有只有一个out端口。
右键选项目名称->new->Active Object Class。Name定义PedDispose。
首先添加一个out端口。将General中的port拖到界面中。命名为out。并将show name 的勾选去掉。在Constructor code中填入OutPortPush( this )，指定该port的构造函数。若是in端口，则填InPort( this ).
然后画PedDispose在模型中的显示图标。画一个圆，并用一条line连接起来。注意圆和line都要勾选icon。
下面就要定义一些生成ped所相关的信息。
创建一个参数。例如生成多少人。
从general中拖Parameter控件到界面中。填写所需的一些参数设置。
编写注释。
使用同样的方法添加其它参数。在这里我们需要的有speed，diameter，color三种初始属性。pedGround，pedConfig，初始配置信息。pedInitNumber，pedInitShape，生成ped数量和生成范围。onCreaterPed，onOut，生成ped和ped离开时自定义代码。
创建一个变量，pedVector，用来保存生成的peds。
创建4个函数，InitPed，GoOut，GoOutAll，PedDisposeCreate。
由于ped的成员变量都是friendly，只能在同一个包中访问，所以要实现该对象，必须NetBeans的工程下完成。
public
boolean
PedDispose( ) {
if(pedInitShape == null || pedConf == null)
return false;
ArrayList ary = pedInitShape.getShapes();
for(int i = 0; i < ary.size(); i++)//教室编码
{
double xmin,xmax,ymin,ymax,x1,y1;
ShapePolyLine pl = (ShapePolyLine)ary.get(i);
int n = pl.getNPoints();
xmin = xmax = pl.x + pl.getPointDx(0) ;
ymin = ymax = pl.y + pl.getPointDy(0);
for(int j=1; j < n; j++)
{
x1 = pl.x + pl.getPointDx(j);
y1 = pl.y+ pl.getPointDy(j);