Skip to content

Displays

Jump to bottom
benoitgaudou edited this page Aug 4, 2019 · 40 revisions

Displays

GAMA allows modelers to define several kinds of displays in a GUI experiment:

  • java 2D displays
  • OpenGL displays

These 2 kinds of display allows the modeler to display the same objects (agents, charts, texts ...). The OpenGL display offers extended features in particular in terms of 3D visualisation. The OpenGL displays offers in addition better performance when zooming in and out.

Table of contents

Classical displays (java2D)

The classical displays displaying any kind of content can be manipulated via the mouse (if no mouse event has been defined):

  • the mouse left press and move allows to move the camera (in 2D),
  • the mouse right click opens a context menu allowing the modeler to inspect displayed agents,
  • the wheel allows the modeler to zoom in or out.

images/display-java2D.png

Each display provides several buttons to manipulate the display (from left to right):

  • Show/hide side bar,
  • Show/hide overlay,
  • Browse through all displayed agents: open a context menu to inspect agents,
  • Update every X step: configure the refresh frequence of the display,
  • Pause the-display: when pressed, the display will not be displayed anymore, the simulation is still running,
  • Synchronize the display and the execution of the model,
  • Zoom in,
  • Zoom to fit view,
  • Zoom out,
  • Take a snapshot: take a snapshot saved as a png image in the snapshots folder of the models folder.

The Show/Hide side bar button opens a side panel in the display allowing the modeler to configure:

  • Properties of the display: background and highlight color, display the scale bar
  • For each layer, we can configure visibility, transparency, position and size of the layer. For grid layers, we can in addition show/hide grids. For species layers, we can also configure the displayed aspect. For text layers, we can the expression displayed with the color and the font.

The bottom overlay bar displays information about the way it is displayed:

  • the position of the mouse in the display,
  • the zoom ratio,
  • the scale of the display (depending on the zoom).

images/display-sidebar-overlay.png

OpenGL displays

The OpenGL display has an additional button 3D Options providing 3D features:

  • Use FreeFly camera/Use Arcball camera: switch between cameras, the default camera is the Arcball one,
  • Use mouse to rotate/Use mouse to drag (only with Arcball camera): use left click for one of the 2 actions, left click + Ctrl for the other of the 2 actions.
  • Apply inertia (only with Arcball camera): in inertia mode, when the modeler stops moving the camera, there is no straight halt but a kind of inertia.
  • Rotate scene: rotate the scene around an axis orthogonal to the scene,
  • Split layers/Merge layers: display each layer at a distinct height,
  • Triangulate scene: display the polygon primitives.

images/display-OpenGL.png

In addition, the bottom overlay bar provides the Camera position in 3D.

FreeFly camera commands

Key Function
Double Click Zoom Fit
+ Zoom In
- Zoom Out
Up Move forward
Down Move backward
Left Strafe left
Right Strafe right
SHIFT+Up Look up
SHIFT+Down Look down
SHIFT+Left Look left
SHIFT+Right Look right
MOUSE Makes the camera look up, down, left and right
MouseWheel Zoom-in/out to the current target (center of the screen)

ArcBall camera commands

Key Function
Double Click Zoom Fit
+ Zoom In
- Zoom Out
Up Horizontal movement to the top
Down Horizontal movement to the bottom
Left Horizontal movement to the left
Right Horizontal movement to the right
SHIFT+Up Rotate the model up (decrease the phi angle of the spherical coordinates)
SHIFT+Down Rotate the model down (increase the phi angle of the spherical coordinates)
SHIFT+Left Rotate the model left (increase the theta angle of the spherical coordinates)
SHIFT+Right Rotate the model right (decrease the theta angle of the spherical coordinates)
SPACE Reset the pivot to the center of the envelope
KEYPAD 2,4,6,8 Quick rotation (increase/decrease phi/theta by 30°)
CMD+MOUSE1 Makes the camera rotate around the model
ALT+LEFT_MOUSE Enables ROI Agent Selection
SHIFT+LEFT_MOUSE Enables ROI Zoom
SCROLL Zoom-in/out to the current target (center of the sphere)
WHEEL CLICK Reset the pivot to the center of the envelope

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 Model Section
    1. Runtime Concepts
    2. Optimizing Models
  8. Multi-Paradigm Modeling
    1. Control Architecture
    2. Defining Differential Equations

Recipes

  1. Manipulate OSM Data
  2. Diffusion
  3. Using Database
  4. Using FIPA ACL
  5. Using BDI with BEN
  6. Using Driving Skill
  7. Manipulate dates
  8. Manipulate lights
  9. Using comodel
  10. Save and restore Simulations
  11. Using network
  12. Headless mode
  13. Using Headless
  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. 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 GIT version
  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. 3D Tutorial
  4. Incremental Model
  5. Luneray's flu
  6. BDI Agents

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
Clone this wiki locally