Plug your GAMA model

Suggest edits
Documentation > Plug

Contents

Preliminary remark 🔗

GAMA is a modelling and simulation development environment for building spatially explicit agent-based simulations. OpenMOLE supports GAMA model natively through the GAMATask.
The GAMATask uses the Singularity container system. You should install Singularity on your system otherwise you won't be able to use it.

The GAMATask 🔗

GAMA by example 🔗

You can provide your .gaml file to the GAMATask to run your model and explore it with OpenMOLE. The example below illustrates an exploration of the predator-prey model of the GAMA model library using a direct sampling:

// Declare the variables
val numberOfPreys = Val[Double]
val nbPreysInit = Val[Int]
val seed = Val[Long]

// Gama task
// The first argument is the gaml file
// The second argument is the Gama experiment name
// The third argument is the number of steps
val gama =
  GAMATask(workDirectory / "predatorPrey.gaml", experiment = "prey_predatorExp", finalStep = 100, seed = seed) set (
    inputs += (nbPreysInit mapped "nb_preys_init"),
    outputs += (numberOfPreys mapped "Number of preys")
  )

// Explore and replicate the model
DirectSampling(
  evaluation =
    Replication(
      evaluation = gama,
      seed = seed,
      sample = 10,
      aggregation = Seq(numberOfPreys aggregate average)) hook(workDirectory / "result.csv"),
  sampling = nbPreysInit in (0 to 200 by 50)
)

Task arguments 🔗

The GAMA task uses the following arguments:
  • gamlOrWorkspace the location of your .gaml file or the location of your GAMA workspace directory (in this case the model argument must be set), mandatory
  • model the relative path of your .gaml file in your work directory, optional this parameter must bet set only when gamlOrWorkspace is a directory
  • experiment the name of your experiment as implemented in the .gaml file, mandatory
  • finalStep the last simulation step of you simulation, mandatory
  • frameRate the frame rate to sample you simulation dynamics, optional
  • seed the OpenMOLE variable used to set the GAMA random number generator seed, optional the seed is randomly drawn if not set
  • version the tag of the GAMA container used by OpenMOLE, optional
  • install some command to run on the host system to initialise the container, for instance Seq("apt update", "apt install mylib"), optional
  • clearContainerCache to remove existing GAMA container in OpenMOLE cache, download the image from the docker hub, and recreate it locally when set to true, optional