Skip to content

PredatorPrey_step6

RoiArthurB edited this page Sep 11, 2023 · 14 revisions

6. Breeding

So far we have created agents only during the initialization of the simulation. In this sixth step, we illustrate how to create new agents during a simulation of a dynamic species.

Formulation

  • Adding of a reproduce behavior for the prey and predator species:
    • When an agent has enough energy, it has a certain probability to have a certain number of offspring.
    • The energy of the offspring is equal to the parent energy divided by the number of offspring.
    • The parent gets the same energy as its offspring.

Model Definition

parameters

We add six new parameters related to breeding:

  • The reproduction probability for prey agents
  • The max number of offspring for prey agents
  • The minimum energy to reproduce for prey agents
  • The reproduction probability for predator agents
  • The max number of offspring for predator agents
  • The minimum energy to reproduce for predator agents

We define six new global variables in the global section:

global {
    ...
    float prey_proba_reproduce <- 0.01;
    int prey_nb_max_offsprings <- 5; 
    float prey_energy_reproduce <- 0.5; 
    float predator_proba_reproduce <- 0.01;
    int predator_nb_max_offsprings <- 3;
    float predator_energy_reproduce <- 0.5;
    ...
}

We define then the six corresponding parameters in the experiment:

parameter "Prey probability reproduce: " var: prey_proba_reproduce category: "Prey" ;
parameter "Prey nb max offsprings: " var: prey_nb_max_offsprings category: "Prey" ;
parameter "Prey energy reproduce: " var: prey_energy_reproduce category: "Prey" ;
parameter "Predator probability reproduce: " var: predator_proba_reproduce category: "Predator" ;
parameter "Predator nb max offsprings: " var: predator_nb_max_offsprings category: "Predator" ;
parameter "Predator energy reproduce: " var: predator_energy_reproduce category: "Predator" ;

parent species

The reproduction dynamics is the same for both prey and predator species, it can thus be implemented only once inside the parent species. But the values of the parameters will depend on the species, and thus have to be set with different values inside each of them.

We add three new variables for the generic_species:

  • proba_reproduce
  • nb_max_offsprings
  • energy_reproduce

We add as well a new reflex called reproduce:

  • this reflex is activated only when:
    • The energy of the agent is greater or equals to energy_reproduce
    • AND according to the probability proba_reproduce: for this second condition, we use the flip(proba) operator that returns true according to the probability proba (false otherwise).
  • this reflex creates nb_offsprings (random number between 1 and nb_max_offsprings) new agents of the species of the agent using the create statement: we use a species casting operator on the current agent.
    • the created agents are initialized as follows:
      • my_cell: my_cell of the agent creating the agents,
      • location: location of my_cell,
      • energy: energy of the agent creating the agents (use of keyword myself) divided by the number of offsprings.
  • after the agent creation, the reflex updates the energy value of the current agent with the value: energy / nb_offsprings.
species generic_species {
    ...
    float proba_reproduce ;
    int nb_max_offsprings;
    float energy_reproduce;
    ... 
    reflex reproduce when: (energy >= energy_reproduce) and (flip(proba_reproduce)) {
        int nb_offsprings <- rnd(1, nb_max_offsprings);
        create species(self) number: nb_offsprings {
            my_cell <- myself.my_cell ;
            location <- my_cell.location ;
            energy <- myself.energy / nb_offsprings ;
        }
        energy <- energy / nb_offsprings ;
    }
}

Note that two keywords (pseudo-variables) can be used to make explicit references to some agents:

  • The agent that is currently executing the statements inside the block (for example a newly created agent): self
  • The agent that is executing the statement that contains this block (for instance, the agent that has called the create statement): myself

prey species

We specialize the prey species from the generic_species species as follows:

  • definition of the initial value of the agent variables
   species prey parent: generic_species {
      ...
      float proba_reproduce <- prey_proba_reproduce ;
      int nb_max_offsprings <- prey_nb_max_offsprings ;
      float energy_reproduce <- prey_energy_reproduce ;
      ...
   }

predator species

As done for the prey species, we specialize the predator species from the generic_species species:

  • definition of the initial value of the agent variables:
   species predator parent: generic_species {
      ...
      float proba_reproduce <- predator_proba_reproduce ;
      int nb_max_offsprings <- predator_nb_max_offsprings ;
      float energy_reproduce <- predator_energy_reproduce ;
      ...
   }

Complete Model

https://github.com/gama-platform/gama/blob/GAMA_1.9.2/msi.gama.models/models/Tutorials/Predator%20Prey/models/Model%2006.gaml
  1. What's new (Changelog)
  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
  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
  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
  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
  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

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

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

Resources

  1. Videos
  2. Conferences
  3. Code Examples
  4. Pedagogical materials
Clone this wiki locally