Alexis Drogoul edited this page Sep 27, 2016 · 46 revisions



Changes from 1.6.1 to 1.7


  1. Installation and Launching
    1. Installation
    2. Launching GAMA
    3. Headless Mode
    4. Updating GAMA
    5. Installing Plugins
    6. Troubleshooting
  2. Workspace, Projects and Models
    1. Navigating in the Workspace
    2. Changing Workspace
    3. Importing Models
  3. Editing Models
    1. GAML Editor (Generalities)
    2. GAML Editor Toolbar
    3. Validation of Models
  4. Running Experiments
    1. Launching Experiments
    2. Experiments User interface
    3. Menus and commands
    4. Parameters view
    5. Inspectors and monitors
    6. Displays
    7. Batch Specific UI
    8. Errors View
  5. Preferences

Learn GAML step by step

  1. Introduction
  2. Start with GAML
    1. Organization of a Model
    2. Basic programming concepts in GAML
  3. Manipulate basic Species
    1. Global Species
    2. Regular Species
    3. Defining Actions and Behaviors
    4. Interaction between Agents
    5. Attaching Skills
    6. Inheritance
  4. Defining Advanced Species
    1. Grid Species
    2. Graph Species
    3. Mirror Species
    4. Multi-Level Architecture
  5. Defining GUI Experiment
    1. Defining Parameters
    2. Defining Displays Generalities
    3. Defining Charts
    4. Defining 3D Displays
    5. Defining Monitors and Inspectors
    6. Defining Export files
    7. Defining User Interaction
  6. Exploring Models
    1. Run Several Simulations
    2. Batch Experiments
    3. Exploration Methods
  7. Optimizing Model Section
    1. Runtime Concepts
    2. Optimizing Models
  8. Multi-Paradigm Modeling
    1. Control Architecture
    2. Defining Equations


  1. Manipulate OSM Datas
  2. Diffusion
  3. Using Database
  4. Calling R
  5. Using FIPA ACL
  6. Using GamAnalyzer
  7. Using BDI
  8. Using Driving Skill
  9. Manipulate dates
  10. Manipulate lights
  11. Using comodel
  12. FAQ
  13. Known Issues

GAML References

  1. Built-in Species
    1. Agent Built-in
    2. Model Built-in
    3. Experiment Built-in
  2. Built-in Skills
  3. Built-in Architecture
  4. Statements
  5. Data Type
  6. File Type
  7. Expressions
    1. Literals
    2. Units and Constants
    3. Pseudo Variables
    4. Variables And Attributes
    5. Operators [A-C]
    6. Operators [D-M]
    7. Operators [N-Z]
  8. Index


  1. Predator Prey
  2. Road Traffic
  3. 3D Tutorial
  4. Incremental Model
  5. Luneray's flu

Pedagogical materials

Developing Extensions

  1. Installing the GIT version
  2. Architecture of GAMA
  3. Developing a Plugin
  4. Developing a Skill
  5. Developing a Statement
  6. Developing an Operator
  7. Developing a Type
  8. Developing a Species
  9. Developing a Control Architecture
  10. Index of annotations
  11. IScope
  12. Creating a release of GAMA
  13. Documentation generation
  14. Website generation

Scientific References

Projects using GAMA

Training Session


Older versions

Coding Camp

Clone this wiki locally

The new website of GAMA is now available at this address : gama-platform.org

GAMA is a modeling and simulation development environment for building spatially explicit agent-based simulations.

Its latest version, 1.7, can be freely downloaded or built from source, and comes pre-loaded with several models, tutorials and a complete on-line documentation.

Multiple application domains

GAMA has been developed with a very general approach, and can be used for many application domains. Some additional plugins had been developed to fit with particular needs.

Example of application domains where GAMA is mostly present :

  • Transport
  • Urban planning
  • Epidemiology
  • Environment

Some training sessions about topics such as "urban management", "epidemiology", "risk management" are also provided by the team. Since GAMA is an open-source software that continues to grow, if you have any particular needs of improvement, feel free to share it to its active community !

High level and intuitive language

Thanks to its high-level and intuitive language, GAMA has been developed to be used by non-computer scientists. You can declare your species, giving them some special behaviors, create them in your world, and display them in less than 10 minutes.

GAML is the language used in GAMA, coded in Java. It is an agent-based language, that provides you the possibility to build your model with several paradigms of modeling. Once your model is ready, some features allows you to explore and calibrate it, using the parameters you defined as input of your simulation.

We provides you a continual support through the active mailing list where the team will answer your questions. Besides, you can learn GAML on your own, following the step by step tutorial, or personal learning path in order reach the point you are interested in.

GIS and Data-Driven models

GAMA (GIS Agent-based Modeling Architecture) provides you, since its creation, the possibility to load easily GIS (Geographic Information System).

You can import a large number of data types, such as text, files, CSV, shapefile, OSM (open street map data), grid, images, SVG, but also 3D files, such as 3DS or OBJ, with their texture.

Some advanced features provides you the possibility to connect GAMA to databases, and also to use powerful statistical tools such as R.

GAMA has been used in large-scale projects, using a great number of agents (up to millions of agents).

Declarative user interface

GAMA provides you the possibility to have multiple displays for the same model. You can add as much visual representations as you want for the same model, in order to highlight a certain aspect of your simulation. Add easily new visual aspects to your agents.

Advanced 3D displays are provided : you can control lights, cameras, and also adding textures to your 3D objects. In an other hand, dedicated statements allows you to define easily charts, such as series, histogram, or pies.

During the simulations, some advanced features are available to inspect the population of your agents. To make your model more interactive, you can add easily some user-controlled action panels, or mouse events.

GAMA is developed by several teams under the umbrella of the IRD/UPMC international research unit UMMISCO:


YourKit supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.