Skip to content

GamlLanguage

Jump to bottom
RoiArthurB edited this page Jul 29, 2026 · 5 revisions

GAML Language Reference

This page provides cross-links to all GAML constructs organized by category. For complete operator and statement documentation, see the Statements and Expressions reference pages.

Core Types

Type Documentation
action Defining Actions and Behaviors
float Data Type#float
int Data Type#int
bool Data Type#bool
string Data Type#string
point Data Type#point
color Data Type#rgb
list Data Type#list
matrix Data Type#matrix
map Data Type#map
geometry Data Type#geometry
type Data Type#gaml_type
image Data Type#image

Declarations

Keyword Documentation
species Manipulate basic Species + Defining Advanced Species
experiment Defining GUI Experiment
model Organization of a Model
global Organization of a Model
action Defining Actions and Behaviors
variable declarations Variables And Attributes
class Statements#class
object Classes and Objects
default Literals
virtual Inheritance#virtual-action

Control Flow

Keyword Documentation
if Basic programming concepts in GAML
else Basic programming concepts in GAML
loop Statements#loop
switch / match Statements#switch
do Statements#do
do_rule Built-in Architectures#rules

Actions & Invocation

Keyword Documentation
action: (deprecated) Defining Actions and Behaviors — use action: without colon or do
do Statements#do
invoke Statements#invoke

Operators

Operator Category Documentation
Arithmetic Arithmetic operators
Logical Logical operators
Comparison Comparison operators
String Strings-related operators
List / Container Containers-related operators
Map Map-related operators
Matrix Matrix-related operators
Dataframe Dataframe-related operators
Spatial / Geometry Spatial operators
Point Points-related operators
Color Color-related operators

See also Data Types for type-specific operators.

Pattern Matching

Operator Documentation
match_regex Statements#match_regex
match_one, match_between Statements#match_one, Statements#match_between

Output & Data

Keyword Documentation
data Statements#data
datalist Statements#datalist
output Organization of a Model

Debugging & System

Keyword Documentation
benchmark Statements#benchmark
abort Statements#abort

Environment & Layout

Keyword Documentation
highlight Statements#highlight
layout Statements#layout
migrate Statements#migrate
mesh Statements#mesh
reflex Built-in Architectures#reflex
init Statements#init

Advanced Species

Feature Documentation
grid Grid Species
graph Graph Species
mirror Mirror Species
parent: Inheritance

File Types

Type Documentation
simulation Save and restore Simulations
csv Defining Export files
image / picture Defining Displays Generalities

Pseudo Variables

See Pseudo Variables for the full list of built-in pseudo variables (self, super, myself, each).

Operators Reference

See Expressions → Operators [A-A] through Operators [S-Z].

Home

  1. What's new (Changelog)
  2. Migration Guide (2025-06 → 2026-06)

Platform

  1. Installation and Launching
    1. Installation
    2. Launching GAMA
    3. Updating GAMA
    4. Installing Plugins
  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 Tools
    3. Validation of Models
  4. Running Experiments
    1. Launching Experiments
    2. Experiments User interface
    3. Controls of experiments
    4. Parameters view
    5. Inspectors and monitors
    6. Displays
    7. Batch Specific UI
    8. Errors View
  5. Running Headless
    1. Getting Started
    2. Headless Legacy
    3. Headless Batch
  6. Preferences
  7. Troubleshooting

Learn GAML step by step

  1. Introduction
    1. Start with GAML
    2. Organization of a Model
    3. Basic programming concepts in GAML
  2. Manipulate basic Species
  3. Global Species
    1. Regular Species
    2. Defining Actions and Behaviors
    3. Interaction between Agents
    4. Attaching Skills
    5. 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 3D Displays
    4. Defining Charts
    5. Defining Monitors and Inspectors
    6. Defining Export files
    7. Defining User Interaction
  6. Classes and Objects
    1. Class Definition and Instantiation
    2. Attributes and Actions
    3. Inheritance
    4. Virtual Classes
    5. Advanced Features
  7. Exploring Models
    1. Run Several Simulations
    2. Batch Experiments
    3. Exploration Methods
  8. Optimizing Models
    1. Runtime Concepts
    2. Analyzing code performance
    3. Optimizing Models
  9. Multi-Paradigm Modeling
    1. Control Architecture
    2. Defining Differential Equations

Recipes

  1. Manipulate OSM Data
  2. Cleaning OSM Data
  3. Diffusion
  4. Using Database
  5. Using Dataframes
  6. Using FIPA ACL
  7. Using BDI with BEN
  8. Using Driving Skill
  9. Manipulate dates
  10. Manipulate lights
  11. Using comodel
  12. Save and restore Simulations
  13. Using network
  14. Writing Unit Tests
  15. Ensure model's reproducibility
  16. Going further with extensions
    1. Calling R
    2. Using Graphical Editor
    3. Using Git from GAMA

GAML References

  1. Built-in Species
  2. Built-in Skills
  3. Built-in Architecture
  4. Statements
  5. Data Type
  6. File Type
  7. Stats Extension
  8. Sound Extension
  9. BDI Extension
  10. FIPA Skill
  11. Expressions
    1. Literals
    2. Units and Constants
    3. Pseudo Variables
    4. Variables And Attributes
    5. Operators (Definition)
    6. Operators [A-A]
    7. Operators [B-C]
    8. Operators [D-H]
    9. Operators [I-M]
    10. Operators [N-R]
    11. Operators [S-Z]
  12. Exhaustive list of GAMA Keywords

Developing GAMA

  1. Installing the development version
    1. Install GAMA source code with Eclipse plugin
  2. Developing Extensions
    1. Developing Plugins
    2. Developing Skills
    3. Developing Statements
    4. Developing Operators
    5. Developing Types
    6. Developing Species
    7. Developing Control Architectures
    8. Index of annotations
  3. Introduction to GAMA Java API
    1. Architecture of GAMA
    2. IScope
  4. Using GAMA flags
  5. Creating a release of GAMA
  6. Documentation generation

Tutorials

  1. Predator Prey
  2. Road Traffic
  3. Incremental Model
  4. Luneray's flu
  5. BDI Agents
  6. Forager RL
  7. SIR Analysis
  8. 3D Model

Community

  1. Team
  2. Projects using GAMA
  3. Scientific References
  4. Training Sessions

Versions of GAMA

Resources

  1. Videos
  2. Conferences
  3. Pedagogical materials

Clone this wiki locally