gama-platform/gama
1
1
Fork 0
mirror of https://github.com/gama-platform/gama.git synced 2026-07-09 18:21:00 +00:00
Code Issues Projects Releases Packages Wiki Activity
Page: UsingGamaFlags
Pages
3D_Graph 3D_shapefile_loading ASCII_File_to_DEM_Representation Accessing_Fields Agent_Based_Clustering AnalysingCodePerformance Anisotropic_Diffusion_Simple_Field AntsForaging.gaml AntsForaging Boids_3D_Motion CallingR Casting_Images Changelog City_Evacuation CleaningGISData CodeExamples Community Computation_of_the_shortest_path_on_a_Grid_of_Cells ContinuousFieldofVision.gaml ContinuousMove Contour_Lines_Import CreatingAReleaseOfGama Creating_color_and_sort_cubes_by_color DEM_Generator DXF_to_Agents_Model Developing Plugins DifferentialEquations Directed_Graph_Model Drive_Random ESRI_ASCII_to_grid_model Ensure model reproducibility Eroding_Volcano Exhaustive list of GAMA Keywords FallingObjects Flow_on_Terrain GEOJSON_File_Loading G__BlankPage G__GraphicalEditor G__GraphicalEditorTutorial GamlReferences GetGamaDevCodeUsingEclipsePlugin Graph_Generation Graph_Generation_using_Agents Headless mode for dummies HeadlessBatch HeadlessLegacy HeadlessServer HeadlessTutorial Home HydrologicaModel Image_Manipulation Image_Vectorisation Index InstallingDevVersion Introduction To Gama Java API K_Nearest_Neighbors Life MODAVI MondrianCity Movement_of_an_agent_on_different_paths Movement_on_a_Graph_created_by_Polygons Movement_on_a_Grid_of_Cells Movement_on_a_Grid_of_Cells_ Moving3D Moving_3D_Object NetlogoTrafficmodel2 ODE_LotkaVolterra OSM_file_to_Agents Pedagogical Materials PlayPool PreviousConferences Resources_TrainingVideos RunningHeadless SIRAnalysis SIRAnalysis_step1 SIRAnalysis_step2 SIRAnalysis_step3 SIRAnalysis_step4 SIRAnalysis_step5 SIRAnalysis_step6 SIRAnalysis_step7 SIR_Split_in_Agents_Multiple_Strains Save and restore simulations Segregation_Agents Series Shapefile_to_Agents Simple_Intersection Simple_Traffic_Model Soccer_Game SpatialGraph3d Stochastic_Differential_Equations Strahler Sugarscape Team Traffic_and_Pollution TreesAndSeasons UserResources Using extensions UsingGamaFlags Wander Waterflowgridelevation Writing_Tests comparison_ABM_EBM_SIR developingGAMA generate_pedestrian_paths pedestrian_complex_environment pedestrian_simple_environment stairs
1 UsingGamaFlags
RoiArthurB edited this page 2024-02-22 19:17:53 +07:00
Table of Contents

Using GAMA flags

What are flags

GAMA and some of its components (software libraries) make it possible to change some of the software behaviors by setting up "flags". Those are mainly for advanced users and should not be much of a concern for most users.

Gama flags

GAMA flags are flags that are build directly by GAMA developers, they have to be set in the Gama.ini file as a new line item (or as a VM argument) like this -D<FLAGNAME>=true/false. For example :

-Denable_logging=false

Available flags

  • enable_debug: Set to true by default, it enable logging the debug messages (DEBUG.OUT(...), DEBUG.ERR(...) which will follow the declaration of DEBUG.ON() on the classes). Set to false to suppress all debug logging (but regular logging using DEBUG.LOG(...) or DEBUG.TIMER(...) will still operate).
  • enable_logging: Set to true by default, it enables simple logging activities using DEBUG.LOG(...), DEBUG.TIMER(...). Set to false to prevent all logging activities (incl. debug ones)
  • use_global_preference_store: set to true by default, it saves the preferences in the global (managed by the JRE) preference store. Set to false to save them in each GAMA instance preference store.
  • read_only: set to false by default, set to true if you want the files in the gaml editor to be read-only (impossible to modify them)

Using Eclipse and SWT flags

GAMA 1.9.2 uses Eclipse 2022-12 as the based component for the IDE.

More precisely, GAMA uses the Eclipse Runtime which provides the foundational support for plug-ins, extension points and extensions (among other facilities), it's the application structure and is built on top of the OSGi framework.

GAMA also uses the Standard Widget Toolkit (or SWT for short). SWT is designed to provide efficient, portable access to the user-interface facilities of the operating systems on which it is implemented.

Available flags

Both components can be tweaked thanks to the eclipse's Rich Client Platform interface using some flags and parameters documented in the official documentation for Eclipse 2022-12.

Here are some links to more detailed explanations about both components and their respective flags:

Using JOGL flags

JOGL in addition with Glugen (both from JOGAMP) are the two libraries used in GAMA for 3D Graphics, Multimedia and Processing.

Available flags

Most of them are documented on the official documentation website.

Home

  1. What's new (Changelog)

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. Headless Batch
    2. Headless Server
    3. Headless Legacy
  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. Exploring Models
    1. Run Several Simulations
    2. Batch Experiments
    3. Exploration Methods
  7. Optimizing Models
    1. Runtime Concepts
    2. Analyzing code performance
    3. Optimizing Models
  8. 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 FIPA ACL
  6. Using BDI with BEN
  7. Using Driving Skill
  8. Manipulate dates
  9. Manipulate lights
  10. Using comodel
  11. Save and restore Simulations
  12. Using network
  13. Headless mode
  14. Using Headless
  15. Writing Unit Tests
  16. Ensure model's reproducibility
  17. 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. Expressions
    1. Literals
    2. Units and Constants
    3. Pseudo Variables
    4. Variables And Attributes
    5. Operators [A-A]
    6. Operators [B-C]
    7. Operators [D-H]
    8. Operators [I-M]
    9. Operators [N-R]
    10. Operators [S-Z]
  8. 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

Community

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

Versions of GAMA

Resources

  1. Videos
  2. Conferences
  3. Code Examples
  4. Pedagogical materials