Skip to content

Latest commit

 

History

History

swarsim-3d

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
ann
ann
 
 
core
core
 
 
display
display
 
 
gflags
gflags
 
 
main
main
 
 
models
models
 
 
plugin
plugin
 
 
user_plugin
user_plugin
 
 
util
util
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 
swarmsim
swarmsim
 
 

README.md

Swarmsim

Note: The code for 3D simulation is taken and adopted from this repo.

Swarmsim is a lightweight simulator of robotic swarms. It is flexible and it allows anyone to change the behavior of both robots and supervisor agents.

Currently, Swarmsim support both differential robots (based on the Khepera III) and quadrotors (based on the AscTec Hummingbird). Swarmsim offers a nice GUI that shows in 3D the behavior of the swarm.

To keep things lightweight, robots perform simple collision avoidance (to get trajectories closer to reality) using the 4 nearest neighbor per default. Communication is not included per se, but one can easily create a new robot type that offers basic broadcast mechanism.

Install

To compile Swarmsim, FLTK and OpenGL (e.g., freeglut) libraries are needed. It should successfully compile as is on Mac and Linux.

# For MacOSX: Install XCode and Homebrew.
xcode-select --install
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
# Install FLTK (OpenGL should be installed with XCode).
brew install fltk --devel

# For Linux.
sudo apt-get install libfltk1.3-dev freeglut3-dev
sudo apt-get install build-essentials  # For make.

Performance.

Swarmsim provides around a 30-50x speedup w.r.t. realtime when simulating 1000 robots without the GUI, and about 4-6x speedup when showing the GUI (on MacBook Pro 2011 2.6 GHz Intel Core i7 with an NVIDIA GeForce GT 650M).

Get started.

make
./swarmsim --help

./swarmsim --timestep=0.05 --nogui --duration=60
./swarmsim --default_supervisor_nrobots=20

Creating your own robot controller

  1. Copy the template_ground_robot.[cc|h] in the user_plugin folder.
  2. Copy the template_supervisor.[cc|h].
  3. Change the class names and registration names. Update the code.
  4. Recompile.
  5. You can then run your controller in swarmsim by setting the --supervisor flag.
cd user_plugin
cp template_ground_robot.cc my_ground_robot.cc
cp template_ground_robot.h my_ground_robot.h
cp template_supervisor.cc my_supervisor.cc
cp template_supervisor.h my_supervisor.h

# Edit the files.
# You can find examples of ground and flying robot code in plugin/default_* files.

make
./swarmsim --supervisor=MySupervisor