[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 main page

(Difference between revisions)

(Swarm Main Page '''UNDER CONSTRUCTION''')
 
(10 intermediate revisions by one user not shown)
Line 1: Line 1:
 
{{SwarmNavigation}}
 
{{SwarmNavigation}}
 
=Swarm Main Page '''UNDER CONSTRUCTION'''=
 
 
Swarm is a platform for agent-based models (ABMs) that includes:  
 
Swarm is a platform for agent-based models (ABMs) that includes:  
 
* A conceptual framework for designing, describing, and conducting experiments on ABMs;
 
* A conceptual framework for designing, describing, and conducting experiments on ABMs;
 
* Software implementing that framework and providing many handy tools; and
 
* Software implementing that framework and providing many handy tools; and
 
* A community of users and developers that share ideas, software, and experience.  
 
* A community of users and developers that share ideas, software, and experience.  
See this [[Introduction_to_Swarm|short introduction]].
 
  
Swarm materials are organized here in three categories:
+
Swarm materials are organized in three categories, each with its own main page on this wiki: [[Swarm:_software_main_page|Software]], [[Swarm:_documentation_main_page|Documentation and learning materials]], and [[Swarm:_applications_and_user_contributions_main_page|example applications and contributed code]].
* Software
+
* Documentation and learning materials
+
* Applications and examples
+
  
==Which version should I get?==
 
  
Most people should attempt to download and install the current stable release: 2.2
+
==Getting started if you are new to Swarm==
 +
First, see this [[Introduction_to_Swarm|short introduction]].
  
Occasionally we make development snapshots based on the version in CVS (which is the version we make bugfixes in). There are no development versions at this time.
+
Next, it is important to develop an understanding of Swarm's conceptual framework: how you organize and describe a model using concepts such as swarms, collections, actions, schedules, observers, etc. The original Santa Fe Institute [[Image:MinarEtAl96.pdf|working paper describing Swarm]] is a good way to learn Swarm's basic structure and motivation. The [[Swarm:_documentation_main_page|Documentation and learning materials]] page provides additional reading that is essential before trying to start using the software (even---especially---if you are an experienced programmer).  
  
==Where do I find Swarm software and directions for installing it?==
+
Finally, you will want to install Swarm software and use its documentation and examples to learn how to implement your models. (You might first want to visit the  wiki's [[Main_Page#Agent-_and_Individual-based_Modeling_Resources|ABM resources section]] to see if there are other software platforms to consider.) To get started with the software (including deciding whether to use Swarm with Java or Objective-C), go to the [[Swarm:_software_main_page|main page for Swarm software]].
  
On the [[Swarm: stable release|stable release page]].
 
  
==Where do I get user support?==
+
==Getting Swarm software and documentation==
 +
See the [[Swarm:_software_main_page|software page]] for information on Swarm software. To download the current version, go to the [[Swarm: stable release|stable release page]].
  
User support is obtained by joining the [[Swarm:_Mailing_lists|Swarm support email list]], where questions are likely to be answered by one of your many generous fellow Swarm users.
+
See the [[Swarm:_documentation_main_page|documentation page]] for the Swarm reference manual, users guide, and other materials.
  
==Where Swarm development happens: GNU Savannah site==
+
Our download site for Swarm software (source, example applications, documentation, packages) is http://ftp.swarm.org/pub/swarm
  
The CVS, bug tracking and development for Swarm is hosted on GNU Savannah: run by the Free Software Foundation for hosting free software projects.
 
  
*'''http://savannah.gnu.org/projects/swarm/'''
+
==Finding example Swarm applications==
 +
Hundreds of models have been built with Swarm. To see, download, and try some examples (along with additions to Swarm contributed by users), see the [[Swarm:_applications_and_user_contributions_main_page|example applications and contributed code]].
  
The latest source tarballs for Swarm and swarmapps will be made available there, so it acts as a partial mirror if you can't access ftp.swarm.org or one of the other mirrors. In the future, we plan to use some of Savannah's features for co-ordinating projects and/or allow users to co-ordinate their own Swarm-related projects.
 
  
Several users also use SourceForge for co-ordinating their projects, these are independent from the SDG:
+
==Getting modeling and Swarm software user support==
 +
User support is obtained by joining the [[Swarm:_Mailing_lists|Swarm email lists]]. The swarm modelling list is for discussion and questions about agent-based modeling in general. The swarm support list is where your questions about Swarm software are likely to be answered by one of your many generous fellow users.
  
* Artificial Stock Market: http://sourceforge.net/projects/artstkmkt/
 
* Evo: http://sourceforge.net/projects/evo/
 
 
==Download site==
 
 
Swarm software (source, example applications, documentation, packages) is available at:
 
http://ftp.swarm.org/pub/swarm
 
 
(But first see the [[Swarm: stable release|stable release]] page.)
 
  
 
==Numbering convention==
 
==Numbering convention==
 
 
Swarm is divided into three main pieces: source, documentation, and applications. They are each bestowed version numbers that are independently increased except for major releases of the source. The version map right now is:
 
Swarm is divided into three main pieces: source, documentation, and applications. They are each bestowed version numbers that are independently increased except for major releases of the source. The version map right now is:
  
Line 68: Line 52:
  
 
The code for the docs is mainly a document generating system, which produces documentation from comments in the source code.  It is only usable by those with a good understanding of SGML/XML in general and DocBook in particular.  If that is not you leave it alone.-->
 
The code for the docs is mainly a document generating system, which produces documentation from comments in the source code.  It is only usable by those with a good understanding of SGML/XML in general and DocBook in particular.  If that is not you leave it alone.-->
 +
 +
 +
__NOEDITSECTION__

Latest revision as of 19:27, 5 March 2007

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

Swarm is a platform for agent-based models (ABMs) that includes:

  • A conceptual framework for designing, describing, and conducting experiments on ABMs;
  • Software implementing that framework and providing many handy tools; and
  • A community of users and developers that share ideas, software, and experience.

Swarm materials are organized in three categories, each with its own main page on this wiki: Software, Documentation and learning materials, and example applications and contributed code.


Contents

Getting started if you are new to Swarm

First, see this short introduction.

Next, it is important to develop an understanding of Swarm's conceptual framework: how you organize and describe a model using concepts such as swarms, collections, actions, schedules, observers, etc. The original Santa Fe Institute File:MinarEtAl96.pdf is a good way to learn Swarm's basic structure and motivation. The Documentation and learning materials page provides additional reading that is essential before trying to start using the software (even---especially---if you are an experienced programmer).

Finally, you will want to install Swarm software and use its documentation and examples to learn how to implement your models. (You might first want to visit the wiki's ABM resources section to see if there are other software platforms to consider.) To get started with the software (including deciding whether to use Swarm with Java or Objective-C), go to the main page for Swarm software.


Getting Swarm software and documentation

See the software page for information on Swarm software. To download the current version, go to the stable release page.

See the documentation page for the Swarm reference manual, users guide, and other materials.

Our download site for Swarm software (source, example applications, documentation, packages) is http://ftp.swarm.org/pub/swarm


Finding example Swarm applications

Hundreds of models have been built with Swarm. To see, download, and try some examples (along with additions to Swarm contributed by users), see the example applications and contributed code.


Getting modeling and Swarm software user support

User support is obtained by joining the Swarm email lists. The swarm modelling list is for discussion and questions about agent-based modeling in general. The swarm support list is where your questions about Swarm software are likely to be answered by one of your many generous fellow users.


Numbering convention

Swarm is divided into three main pieces: source, documentation, and applications. They are each bestowed version numbers that are independently increased except for major releases of the source. The version map right now is:

source: 2.2 
docs: 2.2
apps: 2.1.1 (being updated)
       heatbugs: 2.1.1
       template: 2.1.1
         market: 2.1.1
      mousetrap: 2.1.1
       tutorial: 2.1.1
    hello-world: 2.1.1