[Main Page] Main Page | Recent changes | View source | Page history

Printable version | All content dual-licensed under the GNU FDL and the Creative Commons Share-alike Attribution license. | Privacy policy | Latest revision

Not logged in
Log in | Help
 

Swarm: applications

(Difference between revisions)

m (Reverted edit of 148.244.150.58, changed back to last version by Alex)
 
(29 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{SoftwareNavigation}}
+
{{SwarmNavigation}}
==Objective C Swarm Applications==
+
  
Swarm applications are distributed separately: You will need to download and unpack applications independently. You will next need to change the definition of the SWARMHOME environment variable to point to the location of your Swarm installation (typically /usr/local/ or /usr/ if you've installed it from a binary package on a GNU/Linux system). All you need to do to compile an application is type make, and it will compile and link.
+
We make a wide variety of Swarm models available. These illustrate the many different kinds of research questions  addressed using agent-based models, and provide example ideas and software for other modelers.
  
There is a new package of applications for Swarm-2.2.  This is a revised version, correcting a couple of glitches in saving of screen snapshots: http://lark.cc.ku.edu/~pauljohn/Swarm/swarmapps-objc-2.2-2.tar.gz. Please keep testing and let me know how it works.
 
  
That package contains example Swarm applications, including classics like the Swarm tutorial, heatbugs and mousetrap, as well as some new programs like arborgamesII (a simulation of forests), schellingII (Schelling's neighborhood segregation model), conway (the Game of Life), and sss (Swarm Sugar Scape).  We are soliciting volunteers who want to maintain some 'orphaned' applications from swarmapps-2.1.1.  These apps that need love and attention are market, template, and hello-world.  If you are interested in taking on one of those applications, or offering up other applications, contact [[User:Pauljohn|PJ]] 22:40, 22 April 2005(EST).
+
==Demo page==
 +
For newcomers, [[Examples_of_Swarm_applications|here is a peek at a couple of classic Swarm applications]].
  
==Java Swarm Applications==
+
==How to choose and run example applications==
 +
(For a discussion of Java vs. Objective-C, see the FAQ: [[Swarm_FAQ]])
  
Java applications can be run in the development environment of your choice. You must ensure that the javaswarm DLL is in the PATH and that swarm.jar is available as a library (e.g. in the CLASSPATH).
+
===Objective-C applications===
  
As of 2.0.1, Sun JDK 1.1, Sun JDK 1.2, and Kaffe are known to work. Swarm 2.0.1 is known to work with JBuilder3 and Visual Caf� and not to work with Visual Age 2.
+
Listed below are sites where you can download Objective-C Swarm models. To run them:
  
For users that prefer or require a command line interface, we provide the scripts javaswarm and javacswarm for running and compiling Java Swarm applications, respectively.
+
*Download and un-zip the archive. The archives are usually in TAR GZIP format (e.g., HeatBugs.tar.gz), which you can unzip (in a Linux terminal window or, if using Windows, in Cygwin) by typing "tar xzvf HeatBugs.tar.gz".
 +
*Change directories into the newly unzipped directory of source code (in a Linux terminal window or, if using Windows, in Cygwin).
 +
*If your Swarm installation is set up correctly, you can then compile the application by simply typing "make". (If you get a message something like "Makefile: ... /Makefile.appl: No such file or directory..." then you do not have the environment variable SWARMHOME set correctly. Keep reading...)
 +
*If compilation is successful, you will have a new executable file (e.g., "heatbugs.exe" in Windows; "heatbugs" in Linux). Then you can start the model by typing "./heatbugs.exe" (or, in Linux, "./heatbugs").
 +
*A common problem is not having your system's SWARMHOME environment variable correctly pointed to the location of your Swarm installation. SWARMHOME should typically be /usr/local/ or /usr/ if you've installed it from a binary package on a GNU/Linux system. For Windows, see [[Windows_binary_notes]]
  
'''''For some notes and problems on running Swarm Java applications from Tim Howe, see: [[Talk:Swarm: applications]]'''''
+
===Java applications===
  
-----
+
We provide step-by-step [[instructions]] for compiling and running the Java program Jheatbugs-3.0 on Windows XP using Swarm 2.2. Our demo covers interactive (visual) mode as well as batch mode (multiple runs with output to files).
  
There are Java versions of the Swarm classics heatbugs and mousetrap.  The versions that worked with Swarm-2.1.1 and also with Swarm-2.2 are currently available in the testing subdirectory of the ftp archive. Look for [ftp://ftp.swarm.org/pub/swarm/apps/java/sdg/testing/jheatbugs-2001-03-28.tar.gz jheatbugs-2001-03-28.tar.gz] and [ftp://ftp.swarm.org/pub/swarm/apps/java/sdg/testing/jmousetrap-2001-09-13.tar.gz jmousetrap-2001-09-13.tar.gz]. We are currently in the process of working out all the kinks in a new and improved version of jheatbugs (based on the work of Tim  Howe).  
+
Other Java Swarm models are listed below.
  
*[[jheatbugs-3.0.txt]] (unauthorized) with Straight-Shot Unambiguous Instructions for Installing Swarm
+
==Official applications archive==
 +
Our official archive of Swarm applications is at http://ftp.swarm.org/pub/swarm/apps/. Even though these models are generally old, many of them still work in Swarm 2.2. There are far more Objective-C than Java applications in the archive.
  
These are the versions that worked with Swarm-2.1 (not with 2.1.1 or after)
+
The archive includes Java versions of the Swarm classics heatbugs and mousetrap.  The versions that worked with Swarm-2.1.1 and Swarm-2.2 are currently available in the testing subdirectory of the ftp archive. Look for [http://ftp.swarm.org/pub/swarm/apps/java/sdg/testing/jheatbugs-2001-03-28.tar.gz jheatbugs-2001-03-28.tar.gz] and [http://ftp.swarm.org/pub/swarm/apps/java/sdg/testing/jmousetrap-2001-09-13.tar.gz jmousetrap-2001-09-13.tar.gz].
*[ftp://ftp.swarm.org/pub/swarm/apps/java/sdg/jheatbugs-2.1.tar.gz jheatbugs-2.1.tar.gz]
+
*[ftp://ftp.swarm.org/pub/swarm/apps/java/sdg/jmousetrap-2.1.tar.gz jmousetrap-2.1.tar.gz]
+
  
==Support Software==
+
We strongly encourage people to contribute new applications! The site includes a form for describing contributions.
  
The statistical package [http://www.r-project.org/ R], a SPlus clone, can read and write [http://hdf.ncsa.uiuc.edu/HDF5 HDF5] files in a form compatible with Swarm object-serialization features, with a [ftp://ftp.swarm.org/pub/swarm/src/support/R/hdf5_0.3.tar.gz source] or [ftp://ftp.swarm.org/pub/swarm/binaries/w32/R/hdf5.zip w32] module.
+
 
 +
==Paul Johnson's package of Objective-C applications==
 +
[[User:Pauljohn|Paul Johnson]] has generously assembled a new package of applications for Swarm-2.2.  This is a revised version, correcting a couple of glitches in saving of screen snapshots. It is available from Paul's web site: http://www.ku.edu/~pauljohn/Swarm/swarmapps-objc-2.2-2.tar.gz and also at the Swarm download site: http://ftp.swarm.org/pub/swarm/apps/objc/sdg/swarmapps-objc-2.2-2.tar.gz. Please keep testing and let Paul know how it works.
 +
 
 +
The package contains classic example Swarm applications, including:
 +
*The Swarm tutorial (discussed in [[Swarm:_documentation_main_page#Swarm_User_Guide|the Swarm User Guide]])
 +
*Heatbugs
 +
*Mousetrap
 +
*ArborgamesII (a simulation of forests used in publications by M. Savage et al.)
 +
*SchellingII (Schelling's neighborhood segregation model)
 +
*Conway (the Game of Life)
 +
*sss (Swarm Sugar Scape). 
 +
We are soliciting volunteers who want to maintain some 'orphaned' applications from swarmapps-2.1.1.  These apps that need love and attention are market, template, and hello-world.  If you are interested in taking on one of those applications, or offering up other applications, contact [[User:Pauljohn|PJ]].
 +
 
 +
==Additional links==
 +
*The world-famous Artificial Stock Market has its own homepage at http://artstkmkt.sourceforge.net (Objective-C)
 +
*Paul Johnson keeps many examples of Swarm-related code, his own models, and other people's models, at: http://www.ku.edu/~pauljohn/Swarm/
 +
*Keep your eye on the [[ABM_Resources|Agent-based modeling community pages]] for projects using Swarm.
 +
*See the [[ABM_Resources#Software_Resources|software resources at the ABM Resources area of the wiki]] for a series of template models in Java and Objective-C Swarm, and for guidance on using Swarm with integrated development environments.
 +
 
 +
----

Latest revision as of 05:57, 16 August 2011

Wiki main page
Swarm main page
Software main page
Stable release
Development snapshot
License
Platforms
Prior releases
Documentation main page
Doc set & reference guide
User guide
FAQ
User support email list
Applications & contrib code
Applications
User-contributed code
Release Management
Checklist
Swarm-logo.jpg

We make a wide variety of Swarm models available. These illustrate the many different kinds of research questions addressed using agent-based models, and provide example ideas and software for other modelers.


Contents

[edit] Demo page

For newcomers, here is a peek at a couple of classic Swarm applications.

[edit] How to choose and run example applications

(For a discussion of Java vs. Objective-C, see the FAQ: Swarm_FAQ)

[edit] Objective-C applications

Listed below are sites where you can download Objective-C Swarm models. To run them:

  • Download and un-zip the archive. The archives are usually in TAR GZIP format (e.g., HeatBugs.tar.gz), which you can unzip (in a Linux terminal window or, if using Windows, in Cygwin) by typing "tar xzvf HeatBugs.tar.gz".
  • Change directories into the newly unzipped directory of source code (in a Linux terminal window or, if using Windows, in Cygwin).
  • If your Swarm installation is set up correctly, you can then compile the application by simply typing "make". (If you get a message something like "Makefile: ... /Makefile.appl: No such file or directory..." then you do not have the environment variable SWARMHOME set correctly. Keep reading...)
  • If compilation is successful, you will have a new executable file (e.g., "heatbugs.exe" in Windows; "heatbugs" in Linux). Then you can start the model by typing "./heatbugs.exe" (or, in Linux, "./heatbugs").
  • A common problem is not having your system's SWARMHOME environment variable correctly pointed to the location of your Swarm installation. SWARMHOME should typically be /usr/local/ or /usr/ if you've installed it from a binary package on a GNU/Linux system. For Windows, see Windows_binary_notes

[edit] Java applications

We provide step-by-step instructions for compiling and running the Java program Jheatbugs-3.0 on Windows XP using Swarm 2.2. Our demo covers interactive (visual) mode as well as batch mode (multiple runs with output to files).

Other Java Swarm models are listed below.

[edit] Official applications archive

Our official archive of Swarm applications is at http://ftp.swarm.org/pub/swarm/apps/. Even though these models are generally old, many of them still work in Swarm 2.2. There are far more Objective-C than Java applications in the archive.

The archive includes Java versions of the Swarm classics heatbugs and mousetrap. The versions that worked with Swarm-2.1.1 and Swarm-2.2 are currently available in the testing subdirectory of the ftp archive. Look for jheatbugs-2001-03-28.tar.gz and jmousetrap-2001-09-13.tar.gz.

We strongly encourage people to contribute new applications! The site includes a form for describing contributions.


[edit] Paul Johnson's package of Objective-C applications

Paul Johnson has generously assembled a new package of applications for Swarm-2.2. This is a revised version, correcting a couple of glitches in saving of screen snapshots. It is available from Paul's web site: http://www.ku.edu/~pauljohn/Swarm/swarmapps-objc-2.2-2.tar.gz and also at the Swarm download site: http://ftp.swarm.org/pub/swarm/apps/objc/sdg/swarmapps-objc-2.2-2.tar.gz. Please keep testing and let Paul know how it works.

The package contains classic example Swarm applications, including:

  • The Swarm tutorial (discussed in the Swarm User Guide)
  • Heatbugs
  • Mousetrap
  • ArborgamesII (a simulation of forests used in publications by M. Savage et al.)
  • SchellingII (Schelling's neighborhood segregation model)
  • Conway (the Game of Life)
  • sss (Swarm Sugar Scape).

We are soliciting volunteers who want to maintain some 'orphaned' applications from swarmapps-2.1.1. These apps that need love and attention are market, template, and hello-world. If you are interested in taking on one of those applications, or offering up other applications, contact PJ.

[edit] Additional links