Skip to content
/ DMSim Public

DMSim is a simulator for decision-making with movable agents.

Notifications You must be signed in to change notification settings

NESTLab/DMSim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

DMSim

DMSim is a simulator for decision-making with movable agents.

Compilation

To compile DMSim, execute these commands:

$ mkdir build
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Release ../src
$ make

This will create the executable file build/dmsim.

Running DMSim

During execution, DMSim creates several data files. To have them all neatly in one place, create a directory data and run DMSim for there:

$ mkdir data
$ cd data

Then, launch DMSim with the following syntax:

$ ../build/dmsim <n> <k> <r1> <r2> <ce> <d> <m> <s> <g>

All the options are mandatory and have the following meaning:

Option Meaning
n number of agents
k k = n*epsilon
r1 switch rate for 1 neighbor
r2 switch rate for 2 neighbors
ce choose every ce simulation steps
d robot density
m maximum agent speed
s random seed
g gnuplot output, 0 = off, 1 = on

As said above, when you run dmsim you'll get several data files:

Extension Data type
com Communication among robots for every decision step
dec Decision counts at every decision step
exp Position, speed, and decision of each robot at each simulation step
nbr How many robots have 0, 1, or >= 2 neighbors at every decision step
grd Used to debug the grid-based algorithm that optimizes communication
gpl GNUPlot script that generates GIF animations (created if g=1)

To generate the GIF animation, run GNUPlot as follows:

$ gnuplot <file>.gpl

Be patient - GNUPlot will take quite some time to generate the animation!

About

DMSim is a simulator for decision-making with movable agents.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published