Java Swarm 2.2 安装指南
整理：于同奎，管理科学与工程硕士，西南大学计算机与信息科学学院讲师。研究方向：复杂经济系统，经济系统仿真。邮箱：yutongkui@https://www.wendangku.net/doc/6811367637.html,。博客：https://www.wendangku.net/doc/6811367637.html,/blog/ytkui.htm。
时间仓促，错误难免。欢迎指正。
Java Swarm 2.2 安装指南(1)
SWARM是由SFI(圣塔菲研究所)开发的多主体仿真平台。SWARM把多主体仿真所需的基本功能开发并封装起来，使用户可以只关注模型的核心部分，而不需要为程序开发细节花费过多时间。所以SWARM开发不需要高超的编程能力，只要具备基本的面向对象开发的基本思想和简单的Java（SWARM本身是使用Object C的，后来提供Java版本，绝大多数人对Java要熟悉的多，本人也只会Java）程序设计的语法就可以了。当然要想进行熟练的Java Swarm 建模也必须具备基本的面向对象开发的基本思想和简单的Java语法。
但是SWARM的安装就让很多人非常头痛。因为它版本很多（2.1.1曾广泛使用，现推出2.2 stable release），同时需要安装很多软件（Cygwin、Java JDK、SWARM，还要涉及开发环境如Eclipse或JBuilder）。
在各种版本中，我强烈推荐由Pietro Terna整理并批注的
Swarm-2.2-pretest-10版本。因为Terna把所有Swarm安装所需的软件都打包压缩给我们，并撰写了详细的安装指南。据我的经验，该版本也最为稳定，每次都能成功运行。缺点是安装稍微复杂一点（据网上材料说Java Swarm2.2 stable release版本安装可能简单些，但我屡次尝试未成功）。好在有Terna 的精心准备的安装指南，按其步骤操作即可。另外Terna本人非常热心（虽然法国社会可能倾向支持藏独，但法国人民是无辜的，各国人民都是好人，错在误解和偏见），在我04年开始学习SWARM时给我不厌其烦的通过E-mail 指点技术细节（有时间以后可以给出，供可能遇到类似问题的SWARMER参考）。
下面结合我的安装经历介绍Terna批SWARM版本的安装过程，此内容主要参考Terna的安装指南。
首先下载安装软件，地址是：
http://eco83.econ.unito.it/swarm/materiale/cd/swarm_2.2_cd.iso。下载后解压得到swarm_2.2_cd文件夹（所有的安装文件都在这里），里面的内容如图所示。不是所有的都用得到，关键文件是cygwin-20030921-1.5.4-1.zip、
j2sdk-1_4_2-windows-i586.exe和Swarm-2.2-pretest-10.tar.gz。
Java Swarm 2.2 安装指南(2)
首先要安装cygwin。Cygwin是一个用于在windows平台模拟Linux环境的软件，在编译和运行Java Swarm模型的时候需要它。首先准备一个临时文件夹，Terna推荐在C盘下建c:\compr文件夹。我们会将解压的临时存放在此文件夹里，安装完成后可以删除。将swarm_2.2_cd中的
cygwin-20030921-1.5.4-1.zip解压得到c:\compr得到C:\compr\cygwin。运行其中的setup.exe安装。
选择下一步。
选择Install from local directory。
默认根目录（C:\cygwin），选择Just for me，默认Unix。下一步。
默认当地目录，C:\compr\cygwin，下一步，就开始安装了。
此过程需要一点时间。很快就出现对话框如下图。
点击中间的。这个动作会使系统变慢，并且需要较长的时间（要有耐心，我最初安装的时候还以为出错了呢），然后界面会变成下图所示。
原来的安装选择为default，现在全部变成了Install。点击下一步。
Cygwin正在安装，也需要较长时间。最后出现对话框如图。
默认设置，点完成。弹出类dos的界面。
还要运行一会，不要关闭这些界面。最后弹出完成提示。
这才算完成安装Cygwin。不过这才是完成第一步，后面还有很多事情要做。
Java Swarm 2.2 安装指南(3)
安装JAVA JDK。
这一步要简单一些。swarm_2.2_cd文件夹下有一个文件
j2sdk-1_4_2-windows-i586.exe。双击运行它，所有步骤都是按默认设置安装，直接点下一步就行了。注意尽量不要修改默认的安装目录c:\j2skd1.4.2\。
还有一个关键问题就是设置系统变量Path，这是为了方便JAVA编译，必需。现在大家都用XP或2000的系统，设置很简单了。右键点击我的电脑，选择属性。
弹出系统特性对话框。
选择高级—〉环境变量。
在系统变量中一般都已经有Path了，选择编辑，弹出对话框。
在最后面添加刚才JAVA安装的路径C:\j2sdk1.4.2。系统变量之间用分号分隔开。
添加后点确定。JAVA安装完成。
Java Swarm 2.2 安装指南(4)
安装SWARM。前面都是安装的必备基础软件，现在要安装的才是真正的SWARM。
在刚才创建的临时文件夹c:\compr下新建文件夹，命名为swarm。并将swarm_2.2_cd文件夹的Swarm-2.2-pretest-10.tar.gz复制过来。
打开cygwin。桌面上有快捷方式如图。得到类似界面。
输入命令：cd /cygdrive/c/ (注意cd后面有个空格)
得到如下结果。
注意输入命令必须一字不错，注意大小写，下同。
输入命令：tar zxf compr/swarm/Swarm-2.2-pretest-10.tar.gz
这需要花一定的时间，耐心等待，会得到结果。
输入命令：mkdir /Swarm-2.2
得到结果。
输入命令：mount 'c:\Swarm-2.2' /Swarm-2.2
注意输入命令必须一字不错，注意大小写、单引号和斜线方向。得到结果。
最后收入logout命令推出Cygwin。SWARM安装成功。
Java Swarm 2.2 安装指南(5)
为SWARM配置Cygwin。这是为了在Cygwin方便的建议运行SWARM 模型。必需。
找到文件夹c:\cygwin\home\accountName\。accountName是你所使用的用户名。这个目录是在安装Cygwin时创建的。
将swarm_2.2_cd文件夹中的dot_bashrc文件复制到文件夹
c:\cygwin\home\accountName\中。
打开Cygwin。
输入命令：mv dot_bashrc .bashrc
输入命令logout退出。
检验是否配置成功。打开Cygwin，输入命令：ls /
得到结果：
彩色说明配置成功。
到此为止，SWARM安装就完成了。
下一步是要运行一个示例程序，检验SWARM能否正常运行了。
Java Swarm 2.2 安装指南(6)
运行示例程序
将swarm_2.2_cd文件夹中的jheatbugs-2001-03-28.tar.gz解压到
c:\cygwin\home\accountName\中。
打开Cygwin。
输入命令：cd jheatbugs-2001-03-28/ （输入到jhea后按Tab键可以自动出现长文件名）
进入jheatbugs-2001-03-28/目录，如图。
输入命令：make （这是要编译该目录下的java文件）
得到结果如图。
编译成功。虽有warning，但不影响程序运行。
输入命令：javaswarm StartHeatbugs
其中javaswarm是SWARM的程序运行命令，后面是StartHeatbugs主程序所在的文件，注意文件名中不要任何java或class后缀，大小写敏感。
SWARM程序启动，如图。
点Start运行，如图。
恭喜你！SWARM安装成功了！
点stop暂停，点Quit退出。
后续工作
这才仅仅是软件可以运行了。具体的开发方法，以及自己模型的建立，还需要花一段时间学习和熟悉。
首先要学JAVA和面向对象编程思想。如果你还不会JAVA，你快学习吧，找本简单的书，学习基本语法，理解面向对象编程思想。如果你用过JAVA，你可以在一周之内熟悉SWARM模型开发。如果你是JAVA高手，你可以在一天之内掌握SWARM模型开发。如果你是JAVA专家，你就不用用SWARM 了，你自己就完全可以编写所有程序实现仿真，SWARM是为研究人员简化建模工作量而做的，对JAVA专家是没太大吸引力的，说不定还局限你的发挥。
我认为学习JAVA SWARM建模的最好的方法是边看例程边学习，循序渐进。swarm_2.2_cd文件夹中有一个文件JavaTutorial.zip。解压，里面有一个word教程，配有很多小的例程。我觉得这是最好的学习教材。我就是在学习这些小程序中学习JAVA SWARM建模的。
最后，祝你科研有成果，生活有滋味！